View a markdown version of this page

Crear y administrar registros - Amazon Bedrock AgentCore
Cree un registro de registroListar los registros del registroVer los detalles del registroActualizar un registro de registroEnvíe un registro para su aprobaciónEliminar un registro de registroValidación del esquema

Crear y administrar registros

Próxima migración del espacio de nombres

AWS Actualmente, Agent Registry se encuentra en versión preliminar pública en el espacio de nombres bedrock-agentcore. A partir del 6 de agosto de 2026, el servicio pasará al espacio de nombres del registro de agentes. Si utiliza AWS Agent Registry, debe actualizar los puntos finales, las políticas de IAM, los clientes del SDK, los scripts de CLI y los datos de registro. Para obtener más información sobre la migración desde una versión preliminar pública, consulte la guía completa de migración del registro.

Cree un registro de registro

Consola

  1. Abra la página de detalles del registro.

  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 del punto final y credenciales opcionales para invocar el punto final y el registro obtendrá los metadatos de la fuente. Disponible solo para los tipos de registro MCP y Agent. Para actualizar el registro después de que cambie la fuente, 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.

Sincronice desde el punto final

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

    nota

    La sincronización solo es compatible con los tipos de registro MCP y Agent. Los tipos de registro Agent Skills y Custom no admiten la sincronización; en su lugar, utilice el tipo de fuente manual.

  2. Introduzca la URL del punto de conexión. Debe ser una URL HTTPS válida.

  3. En Tipo de credencial, elija la forma en que el registro autoriza con el punto de conexión:

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

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

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

  4. Elija Crear registro.

    El registro se crea con el estado DE CREACIÓN. El registro se conecta al punto final, extrae los metadatos y rellena los descriptores del registro. Una vez completada 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 la fuente, 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 AWS CLI y SDK sobre la creación de registros con sincronización, consulte Sincronizar registros de fuentes externas.

Manual

  1. En Detalles del registro, ingresa:

    1. Nombre: debe empezar 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 inclinada). El nombre puede tener un máximo de 255 caracteres.

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

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

  2. En Tipo de registro, seleccione una de las siguientes opciones: 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 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

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

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

Listar los registros del registro

Consola

  1. Abra la página de detalles del registro.

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

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

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

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

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

AWS CLI

aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

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']}")

Ver los detalles del registro

Consola

  1. En la página de detalles del registro, 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 última actualización, tipo de registro, ID de registro, fecha de creación.

    2. Sección de configuración de 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, ámbitos y parámetros personalizados).

    3. Sección de configuración del protocolo: el contenido del descriptor que 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 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 del estado de actualización: enviar para su aprobación, aprobar, rechazar o desaprobar.

    3. Three-dot menu (◉): editar o eliminar.

AWS CLI

aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

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

  1. En la página de detalles del registro, 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 agente) En Sincronizar desde el punto final, configure la sincronización de forma opcional:

    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 encontrados en la fuente, pero no modifican los campos que la fuente no proporciona. Un administrador o un curador debe revisar y aprobar el nuevo borrador para que aparezca en las búsquedas. Hasta entonces, la revisión aprobada anterior (si la hubiera) seguirá siendo consultable. Para obtener más información sobre el comportamiento de las revisiones dobles, consulte el ciclo de vida de los registros.

    1. Introduzca una URL de punto final para habilitar la sincronización. Los campos de tipo de credenciales aparecen cuando se proporciona un punto final. Si el registro ya tiene la sincronización configurada, 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 Ninguno) 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, pulse el botón de borrado situado junto al campo del punto final. Esto restablece el punto final y todos los campos de credenciales.

  4. En Configuración de registros, actualiza las definiciones del registro en el editor JSON.

    1. Puede configurar el punto final 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 las herramientas y las definiciones del servidor del registro con los valores encontrados en la fuente, lo que tiene prioridad sobre cualquier modificación manual de esos campos. Los campos que no proporciona la fuente no se modifican.

  5. La consola valida el JSON con respecto al 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 aviso de confirmación confirma que: «[Nombre] se ha actualizado y enviado correctamente para su aprobación».

AWS CLI

aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK

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 de estado de actualización

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

    1. También puede utilizar Crear y enviar para su aprobación o Guardar y enviar para su aprobación durante la creación o 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 está establecida en FALSE, el registro pasa al estado «Pendiente de aprobación» y espera a que el curador 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

aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

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

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

  2. Confirme la eliminación escribiendo «eliminar» cuando se le solicite

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

AWS CLI

aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

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 según el esquema oficial del tipo de registro seleccionado. Puedes encontrar más información sobre las validaciones en Tipos de registros compatibles.