View a markdown version of this page

Creación y administración de registros - Base amazónica AgentCore
Cree un registroEnumera los registros de registroVer detalles del registroActualizar un registro de registroEnvíe un registro para su aprobaciónEliminar un registro de registroValidación del esquema

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación y administración de registros

La migración ya está abierta

AWS El registro de agentes se ha lanzado en el nuevo espacio de agent-registry nombres. La compatibilidad con el espacio de bedrock-agentcore nombres de versión preliminar pública dejará de funcionar el 17 de septiembre de 2026. Para obtener instrucciones sobre la migración, consulta la Guía Guía completa de migración de registros completa de migración del registro.

Cree un registro

Consola

ejemplo
AWS Agent Registry namespace

  1. Abra la página de detalles del registro en la consola del registro del AWS agente.

  2. En la sección Registros del registro, seleccione Crear registro.

  3. Elige un tipo de fuente:

    1. Sincronizar desde el punto final: proporcione una URL de punto final y credenciales opcionales para invocar el punto final, y el registro obtendrá los metadatos del origen. Disponible únicamente para los tipos de registro MCP y Agent. Para actualizar el registro después de que cambie el origen, debe activar la sincronización manualmente. Consulte Sincronizar registros de fuentes externas para obtener más información.

    2. Manual: configure manualmente los detalles del registro y la configuración del protocolo.

Sincronizar desde el punto final

  1. En Detalles del registro, seleccione el tipo de registro: MCP o Agente.

    nota

    La sincronización solo se admite para los tipos de registro MCP y Agent. Los tipos de registro personalizados y de habilidades de agente no admiten la sincronización; en su lugar, utilice el tipo de fuente manual.

  2. Introduzca la URL del punto final. Debe ser una URL HTTPS válida.

  3. En Tipo de credencial, elige cómo se autoriza el registro con el punto final:

    1. IAM: proporcione un ARN de rol para la firma de Sigv4 y un nombre de servicio (por ejemplo,,,). agent-registry execute-api lambda Si lo desea, especifique una región para la firma.

    2. OAuth: seleccione o introduzca el ARN del proveedor de credenciales desde Identity. AgentCore Si lo desea, configure los ámbitos y los parámetros personalizados en Configuración adicional.

    3. Ninguno: sin autorización (para terminales públicos).

  4. Elija Crear registro.

    El registro se crea en estado de CREACIÓN. El registro se conecta al punto final, extrae los metadatos y rellena los descriptores del registro. Una vez finalizada la sincronización, el registro pasa a DRAFT. Si la sincronización falla, el registro pasa al estado CREATE_FAILED y los detalles del error están disponibles en el campo Motivo del estado de la página de detalles del registro. Para solucionar problemas, consulte Errores de sincronización de registros. Para actualizar el registro cuando cambie el origen, elija Administrar y, a continuación, elija Sincronización en la página de detalles del registro, o elija Administrar → Editar y seleccione Re-sync desde el punto final.

Para ver ejemplos de la AWS CLI y el SDK sobre la creación de registros con sincronización, consulte Sincronizar registros de fuentes externas.

Manual

  1. En la sección Detalles del registro, en Nombre, introduzca un nombre único para el registro. El nombre debe ser único en el registro; la combinación de Name y Record version debe ser única. El nombre debe empezar por un carácter alfanumérico. Los caracteres válidos son a-z, A—Z, 0—9, _ (guión bajo), - (guión), (punto) y . (barra diagonal). / El nombre puede tener hasta 255 caracteres.

  2. (Opcional) En Nombre para mostrar, introduzca una etiqueta legible para el registro. Aparece en la tabla de registros del registro y en los resultados de la búsqueda junto con el nombre técnico del registro.

  3. (Opcional) En Descripción, introduzca una descripción para el registro. La descripción puede tener de 1 a 4.096 caracteres.

  4. En Versión del registro, introduzca un identificador de versión para el registro (por ejemplo, 1.0.0 ov2.1).

  5. En la sección Tipo de registro y descriptor:

    1. En Tipo, seleccione el tipo semántico del registro. El tipo determina qué claves descriptoras principales son válidas.

      • MCP: protocolo diseñado para las comunicaciones entre agentes y herramientas de IA. Gestiona la gestión del contexto y los formatos de mensajes estructurados.

      • Agente: protocolo diseñado para interacciones seguras entre agentes. Permite flujos de trabajo distribuidos e intercambio de información.

      • Habilidades: registre las habilidades de los agentes con la documentación de Markdown y una definición estructurada opcional.

      • Personalizado: implementación de protocolos personalizados para patrones de comunicación especializados. Defina sus propias especificaciones de interfaz y requisitos de integración.

    2. En Descriptor, elija la forma de los datos descriptores del registro. Las opciones disponibles dependen del tipo que haya seleccionado:

      • MCP → Servidor MCP o personalizado

      • Agente → Tarjeta de agente A2A, servidor MCP o personalizada

      • Habilidades → Definición de habilidades de agente o personalizadas

      • Personalizado → Personalizado

  6. Aparece un editor específico para un descriptor en función de su selección de descriptores. Introduzca la configuración de su protocolo en formato JSON. En el caso de los descriptores del servidor MCP y de la tarjeta de agente A2A, active Mostrar esquema oficial para mostrar el esquema de referencia uno al lado del otro. La consola valida tu JSON comparándolo con el esquema oficial y muestra los errores en línea (por ejemplo, «Falta el 'nombre' de la propiedad») con el botón Diagnosticar con Amazon Q. Para obtener información sobre la configuración por descriptor, consulte Tipos de registros admitidos.

  7. (Opcional) En la sección Etiquetas, elija Agregar nueva etiqueta para adjuntar una o más etiquetas al registro. Cada etiqueta tiene una clave y un valor opcional.

  8. Elija una de las siguientes opciones:

    1. Crear como borrador: crea el registro en estado Borrador.

    2. Crear y enviar para su aprobación: crea el registro y lo envía inmediatamente para su aprobación.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abre la página de detalles del registro en la Bedrock-AgentCore consola.

  2. En la sección Registros del registro, selecciona Crear registro.

  3. Elige un tipo de fuente:

    1. Sincronizar desde el punto final: proporcione una URL de punto final y credenciales opcionales para invocar el punto final, y el registro obtendrá los metadatos del origen. Disponible únicamente para los tipos de registro MCP y Agent. Para actualizar el registro después de que cambie el origen, debe activar la sincronización manualmente. Consulte Sincronizar registros de fuentes externas para obtener más información.

    2. Manual: configure manualmente los detalles del registro y la configuración del protocolo.

Sincronizar desde el punto final

  1. En Detalles del registro, seleccione el tipo de registro: MCP o Agente.

    nota

    La sincronización solo se admite para los tipos de registro MCP y Agent. Los tipos de registro personalizados y de habilidades de agente no admiten la sincronización; en su lugar, utilice el tipo de fuente manual.

  2. Introduzca la URL del punto final. Debe ser una URL HTTPS válida.

  3. En Tipo de credencial, elige cómo se autoriza el registro con el punto final:

    1. IAM: proporcione un ARN de rol para la firma de Sigv4 y un nombre de servicio (por ejemplo,,,). bedrock-agentcore execute-api lambda Si lo desea, especifique una región para la firma.

    2. OAuth: seleccione o introduzca el ARN del proveedor de credenciales desde Identity. AgentCore Si lo desea, configure los ámbitos y los parámetros personalizados en Configuración adicional.

    3. Ninguno: sin autorización (para terminales públicos).

  4. Elija Crear registro.

    El registro se crea en estado de CREACIÓN. El registro se conecta al punto final, extrae los metadatos y rellena los descriptores del registro. Una vez finalizada la sincronización, el registro pasa a DRAFT. Si la sincronización falla, el registro pasa al estado CREATE_FAILED y los detalles del error están disponibles en el campo Motivo del estado de la página de detalles del registro. Para solucionar problemas, consulte Errores de sincronización de registros. Para actualizar el registro cuando cambie el origen, utilice el botón Sincronizar de la página de detalles del registro o seleccione un Re-sync punto final durante la edición.

Para ver ejemplos de la AWS CLI y el SDK sobre la creación de registros con sincronización, consulte Sincronizar registros de fuentes externas.

Manual

  1. En Detalles del registro, introduzca:

    1. Nombre: debe comenzar con una letra o un dígito. Los caracteres válidos son a-z A-Z, 0-9, _ (guión bajo), - (guión),. (punto) y/(barra diagonal). El nombre puede tener hasta 255 caracteres.

    2. Descripción (opcional): de 1 a 4.096 caracteres.

    3. Versión del registro: especifique la versión de este registro (por ejemplo, 1.0.0, v2.1).

  2. En Tipo de registro, seleccione uno de los siguientes: MCP, Agent, Agent Skills o Custom.

  3. Aparece un editor de tipo específico. Introduzca la configuración de su protocolo en formato JSON.

    1. Para los tipos de agente y MCP, active Mostrar esquema oficial para mostrar el esquema de referencia uno al lado del otro como guía.

    2. La consola valida tu JSON comparándolo con el esquema oficial y muestra los errores en línea (por ejemplo, «Falta el 'nombre' de la propiedad») con el botón Diagnosticar con Amazon Q.

  4. Elija una de las siguientes opciones:

    1. Crear como borrador: crea el registro en estado Borrador.

    2. Crear y enviar para su aprobación: crea el registro y lo envía inmediatamente para su aprobación.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "my-mcp-server" \
  --display-name "MyMCPServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3
import json

client = boto3.client('agent-registry-control')

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='MyMCPServer',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11'
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
nota

En el espacio de agent-registry nombres, name es la clave única de un registro (el signo name + recordVersion combinado debe ser único). displayNameUtilícela para la etiqueta legible por humanos. La descriptors estructura es plana y está codificada según el tipo de descriptor principal (mcpServer,, a2aAgentCardagentSkillsDefinition,custom); los schemaVersion camposinlineContent/anteriores pasan a llamarse/. data dataSchemaVersion

Enumera los registros de registro

Consola

ejemplo
AWS Agent Registry namespace

  1. Abra la página de detalles del registro en la consola del registro del AWS agente.

  2. La sección de registros del registro muestra:

    1. Contadores de resumen de estado: total enviado, pendiente de aprobación, aprobado, obsoleto, rechazado.

    2. Tabla de registros con columnas: nombre, nombre para mostrar, descripción, estado, tipo de registro, ARN del registro, última actualización.

  3. Usa la barra de búsqueda de registros para filtrar por nombre.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra la página de detalles del registro en la Bedrock-AgentCore consola.

  2. La sección de registros del registro muestra:

    1. Contadores de resumen de estado: total enviado, pendiente de aprobación, aprobado, obsoleto, rechazado.

    2. Tabla de registros con columnas: nombre, descripción, estado, tipo de registro, ARN del registro, última actualización.

  3. Usa la barra de búsqueda de registros para filtrar por nombre.

  4. Usa el menú desplegable Actualizar estado para realizar cambios de estado masivos en los registros seleccionados.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")
nota

En el espacio de agent-registry nombres, ListRegistryRecords acepta un filters parámetro estructurado (una lista de {"name": "<dotted.path>", "values": […​]} entradas) en lugar de parámetros de consulta discretos por campo. Nombres de filtros compatibles: namestatus, y. recordType

Ver detalles del registro

Consola

ejemplo
AWS Agent Registry namespace

  1. En la página de detalles del registro de la consola del registro del AWS agente, elija un nombre de registro de la tabla de registros.

  2. La página de detalles del registro muestra:

    1. Sección de detalles del registro: nombre, nombre para mostrar, descripción, ARN del registro, estado (se muestra como una insignia junto al nombre del registro), versión, fecha de la última actualización, tipo de registro, identificador de registro y fecha de creación.

    2. Sección de configuración de la sincronización (si está configurada): tipo de sincronización, URL de origen y detalles del proveedor de credenciales (ARN del rol de IAM, ARN del servicio, región o proveedor de OAuth, tipo de concesión, alcances, parámetros personalizados).

    3. Sección de configuración del protocolo: el contenido del descriptor se muestra en formato JSON (por ejemplo, «tarjeta de agente» para los registros A2A, «servidor» y «herramientas» para los registros MCP).

    4. Sección de etiquetas: muestra las etiquetas asociadas al registro en forma de tabla de valores clave. Para agregar, eliminar o modificar etiquetas, elija Editar en esta sección para abrir la página Editar etiquetas.

  3. Acciones disponibles:

    1. Menú desplegable de actualización de estado: enviar para su aprobación, aprobar, rechazar o desaprobar.

    2. Botón Administrar: seleccione Editar para modificar el registro, Eliminar para eliminarlo permanentemente o Sincronizar para activar una nueva sincronización desde el punto final configurado (solo registros de MCP y de agente). La sincronización abre un cuadro de diálogo de confirmación; el registro pasa al estado de ACTUALIZACIÓN durante la sincronización.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. En la página de detalles del registro de la Bedrock-AgentCore consola, elija un nombre de registro de la tabla de registros.

  2. La página de detalles del registro muestra:

    1. Sección de detalles del registro: nombre, descripción, ARN del registro, estado (se muestra como una insignia junto al nombre del registro), versión, fecha de la última actualización, tipo de registro, identificador del registro y fecha de creación.

    2. Sección de configuración de la sincronización (si está configurada): tipo de sincronización, URL de origen y detalles del proveedor de credenciales (ARN del rol de IAM, ARN del servicio, región o proveedor de OAuth, tipo de concesión, alcances, parámetros personalizados).

    3. Sección de configuración del protocolo: el contenido del descriptor se muestra en formato JSON (por ejemplo, «tarjeta de agente» para los registros A2A, «servidor» y «herramientas» para los registros MCP).

  3. Acciones disponibles:

    1. Botón de sincronización (solo los registros del MCP y del agente): activa una nueva sincronización desde el punto final configurado. Abre un cuadro de diálogo de confirmación antes de continuar. El registro pasa al estado de ACTUALIZACIÓN durante la sincronización.

    2. Menú desplegable de estado de actualización: enviar para su aprobación, aprobar, rechazar o desaprobar.

    3. Three-dot menú () — Editar o eliminar.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name (dedup key): {response['name']}")
print(f"Display Name: {response['displayName']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Record Type: {response['recordType']}")
print(f"Version: {response['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Actualizar un registro de registro

Consola

ejemplo
AWS Agent Registry namespace

  1. En la página de detalles del registro de la consola del registro del AWS agente, seleccione Administrar y, a continuación, seleccione Editar.

  2. En la página Editar registro, actualice cualquiera de las siguientes opciones:

    1. Nombre, nombre para mostrar , descripción y versión del registro en Detalles del registro.

    2. Tipo de registro y descriptor: cambie la forma del descriptor del tipo semántico and/or si es necesario. Para cambiar el tipo, es posible que tengas que seleccionar un nuevo descriptor y volver a introducir el contenido del descriptor.

  3. (Solo registros de MCP y de agente) En Sincronizar desde el punto final, si lo desea, configure la sincronización:

    Puede actualizar los registros mediante la sincronización, independientemente de si se crearon originalmente con la sincronización. Cuando se activa la sincronización durante una actualización, el registro pasa al estado de ACTUALIZACIÓN. Si se realiza correctamente, se crea una nueva versión del registro en estado BORRADOR. Si se produce un error, el registro pasa al estado UPDATE_FAILED con los detalles del error en el campo Motivo del estado. Los datos sincronizados sobrescriben el nombre, la descripción, la versión, las definiciones de herramientas y las definiciones del servidor del registro con los valores que se encuentran en el origen, pero no modifican los campos que el origen no proporciona. Un administrador o curador debe revisar y aprobar el nuevo borrador para que aparezca en las búsquedas. Hasta entonces, se podrá buscar la revisión anterior aprobada (si la hubiera). Para obtener más información sobre el comportamiento de la doble revisión, consulte Ciclo de vida de los registros.

    1. Introduzca una URL de punto final para habilitar la sincronización. Los campos de tipo de credencial aparecen cuando se proporciona un punto final. Si el registro ya tiene configurada la sincronización, los campos del punto final y del proveedor de credenciales se rellenan previamente con la configuración existente.

    2. Elija un tipo de credencial (IAM, OAuth o Ninguna) y rellene los campos obligatorios. Si el registro se configuró previamente con un proveedor de credenciales, los valores existentes se rellenan previamente.

    3. Seleccione un Re-sync punto final para activar una nueva sincronización al guardar. El registro pasa al estado de ACTUALIZACIÓN durante la sincronización.

    4. Para eliminar la sincronización, seleccione el botón de borrar situado junto al campo del punto final. Esto restablece el punto final y todos los campos de credenciales.

  4. En Configuración del registro, actualice las definiciones del registro en el editor JSON.

    1. Puedes configurar ambos extremos para la sincronización y editar manualmente las definiciones del registro. Cuando se activa la sincronización, el registro obtiene los metadatos más recientes del punto final y actualiza el nombre, la descripción, la versión, las definiciones de herramientas y las definiciones del servidor del registro con los valores encontrados en el origen, teniendo prioridad sobre cualquier edición manual de esos campos. Los campos que no proporciona la fuente no se modifican.

  5. La consola valida tu JSON comparándolo con el esquema oficial y muestra los errores en línea con el botón Diagnosticar con Amazon Q.

  6. Elija una de las siguientes opciones:

    1. Guardar cambios: guarda el registro como borrador.

    2. Guardar y enviar para su aprobación: guarda y envía en un solo paso.

Un anuncio de éxito confirma que: «[Nombre] se actualizó y se envió correctamente para su aprobación».

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. En la página de detalles del registro de la Bedrock-AgentCore consola, selecciona el menú de tres puntos () y, a continuación, selecciona Editar.

  2. En la página Editar registro, actualiza cualquiera de las siguientes opciones:

    1. Nombre , descripción y versión del registro en Detalles del registro.

    2. Tipo de registro: cambie el tipo de protocolo si es necesario.

  3. (Solo registros de MCP y de agente) En Sincronizar desde el punto final, si lo desea, configure la sincronización:

    Puede actualizar los registros mediante la sincronización, independientemente de si se crearon originalmente con la sincronización. Cuando se activa la sincronización durante una actualización, el registro pasa al estado de ACTUALIZACIÓN. Si se realiza correctamente, se crea una nueva versión del registro en estado BORRADOR. Si se produce un error, el registro pasa al estado UPDATE_FAILED con los detalles del error en el campo Motivo del estado. Los datos sincronizados sobrescriben el nombre, la descripción, la versión, las definiciones de herramientas y las definiciones del servidor del registro con los valores que se encuentran en el origen, pero no modifican los campos que el origen no proporciona. Un administrador o curador debe revisar y aprobar el nuevo borrador para que aparezca en las búsquedas. Hasta entonces, se podrá buscar la revisión anterior aprobada (si la hubiera). Para obtener más información sobre el comportamiento de la doble revisión, consulte Ciclo de vida de los registros.

    1. Introduzca una URL de punto final para habilitar la sincronización. Los campos de tipo de credencial aparecen cuando se proporciona un punto final. Si el registro ya tiene configurada la sincronización, los campos del punto final y del proveedor de credenciales se rellenan previamente con la configuración existente.

    2. Elija un tipo de credencial (IAM, OAuth o Ninguna) y rellene los campos obligatorios. Si el registro se configuró previamente con un proveedor de credenciales, los valores existentes se rellenan previamente.

    3. Seleccione un Re-sync punto final para activar una nueva sincronización al guardar. El registro pasa al estado de ACTUALIZACIÓN durante la sincronización.

    4. Para eliminar la sincronización, seleccione el botón de borrar situado junto al campo del punto final. Esto restablece el punto final y todos los campos de credenciales.

  4. En Configuración del registro, actualice las definiciones del registro en el editor JSON.

    1. Puedes configurar ambos extremos para la sincronización y editar manualmente las definiciones del registro. Cuando se activa la sincronización, el registro obtiene los metadatos más recientes del punto final y actualiza el nombre, la descripción, la versión, las definiciones de herramientas y las definiciones del servidor del registro con los valores encontrados en el origen, teniendo prioridad sobre cualquier edición manual de esos campos. Los campos que no proporciona la fuente no se modifican.

  5. La consola valida tu JSON comparándolo con el esquema oficial y muestra los errores en línea con el botón Diagnosticar con Amazon Q.

  6. Elija una de las siguientes opciones:

    1. Guardar cambios: guarda el registro como borrador.

    2. Guardar y enviar para su aprobación: guarda y envía en un solo paso.

Un anuncio de éxito confirma que: «[Nombre] se actualizó y se envió correctamente para su aprobación».

nota

Las etiquetas no se editan desde la página de edición de registros de la consola del registro del AWS agente. Para modificar las etiquetas, vaya a la página de detalles del registro, seleccione Editar en la sección Etiquetas, añada o elimine etiquetas en la página Editar etiquetas y seleccione Guardar cambios. (Las etiquetas solo se admiten en la consola de registro del AWS agente).

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Envíe un registro para su aprobación

Consola

Desde la página de detalles del registro -

  1. Selecciona el menú desplegable Estado de actualización

  2. A continuación, selecciona Enviar para su aprobación.

    1. También puedes usar Crear y enviar para su aprobación o Guardar y enviar para su aprobación durante la creación o la edición.

nota

Si la Auto-Approval configuración del Registro está establecida en TRUE, al enviar un registro para su aprobación se aprueba automáticamente. De lo contrario, si la Auto-Approval configuración se establece en FALSE, el registro pasa al estado «Pendiente de aprobación» y espera a que el responsable lo apruebe o lo rechace. Además, se activa una EventBridge notificación de Amazon que indica que se ha solicitado la aprobación de un nuevo registro.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Eliminar un registro de registro

Consola

ejemplo
AWS Agent Registry namespace

  1. En la página de detalles del registro de la consola del registro del AWS agente, seleccione Administrar y, a continuación, seleccione Eliminar.

  2. Confirme la eliminación escribiendo delete cuando se le pida.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. En la página de detalles del registro de la Bedrock-AgentCore consola, selecciona el menú de tres puntos () y, a continuación, selecciona Eliminar.

  2. Para confirmar la eliminación, escribe delete cuando se te pida.

La eliminación es permanente y no se puede deshacer.

AWS CLI

ejemplo
AWS Agent Registry namespace
aws agent-registry-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

ejemplo
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Validación del esquema

Al crear o editar un registro, la consola y la API validan la configuración del protocolo comparándola con el esquema oficial del tipo de registro seleccionado. Puedes encontrar más información sobre las validaciones en Tipos de registros compatibles.