View a markdown version of this page

Crear y administrar registros - Amazon Bedrock AgentCore
Cree un registroListar registrosVea los detalles del registroActualizar un registroEliminar un registro

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

Consola

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, en Discover, elija Registry.

  3. En la sección Registros, elija Crear registro.

  4. En Nombre, introduce un nombre para tu registro. El nombre debe empezar por 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 hasta 64 caracteres.

  5. (Opcional) Expanda los detalles adicionales e introduzca una descripción (de 1 a 4096 caracteres).

  6. (Opcional) Amplíe la autorización de la API de búsqueda para configurar la forma en que los consumidores autorizan las búsquedas en el registro (autorización entrante). Elija AWS IAM para usar AWS credenciales estándar o JSON Web Tokens (JWT) para usar las credenciales de su proveedor de identidad corporativa. Si eliges JWT, puedes crear rápidamente con Cognito o traer tu propio IdP proporcionando la URL de descubrimiento, la audiencia, el alcance, las afirmaciones personalizadas y los clientes.

  7. En Aprobación de registros, elija si desea habilitarlo. Auto-approval Cuando la aprobación automática está desactivada, un curador debe revisar y aprobar cada registro antes de que se pueda buscar en él.

  8. Selecciona Crear registro.

El estado del registro comienza como En proceso de creación y pasa a Listo cuando se completa el aprovisionamiento.

nota

Para los registros habilitados para JWT, se requiere al menos un campo de configuración de autorización de JWT: audiencias permitidas, clientes permitidos, ámbitos permitidos o notificaciones personalizadas. Si configura más de uno, AWS Agent Registry los verifica todos.

AWS CLI

IAM-based registro: 

aws bedrock-agentcore-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1

JWT-based registro: 

aws bedrock-agentcore-control create-registry \
  --name "MyOAuthRegistry" \
  --authorizer-type CUSTOM_JWT \
  --authorizer-configuration '{"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}' \
  --region us-east-1

AWS SDK

IAM-based registro: 

import boto3

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

response = client.create_registry(
    name='MyRegistry',
    description='Production registry'
)
print(response['registryArn'])

JWT-based registro: 

import boto3

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

response = client.create_registry(
    name='MyOAuthRegistry',
    authorizerType='CUSTOM_JWT',
    authorizerConfiguration={
        'customJWTAuthorizer': {
            'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration',
            'allowedClients': ['<appClientId>']
        }
    }
)
print(response['registryArn'])

Listar registros

Consola

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, en Discover, elija Registry.

  3. La tabla Registros muestra todos los registros de su cuenta con las siguientes columnas:

    1. Nombre: el nombre del registro (vinculado a la página de detalles).

    2. Descripción: la descripción del registro, si se ha proporcionado.

    3. Tipo de autorización: el método de autorización entrante (AWS_IAM o CUSTOM_JWT).

    4. Estado: el estado actual (estado de creación, listo, actualización, eliminación o error).

    5. ARN: el nombre del recurso de Amazon del registro.

    6. Creado: marca de tiempo de creación.

    7. Última actualización: la marca de tiempo de la última modificación.

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

  5. Utilice los controles de paginación para navegar por los resultados.

AWS CLI

aws bedrock-agentcore-control list-registries \
  --region us-east-1

AWS SDK

import boto3

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

response = client.list_registries()
for registry in response['registries']:
    print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")

Vea los detalles del registro

Consola

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, en Discover, elija Registry.

  3. Elija el nombre del registro en la tabla Registros.

  4. La página de detalles del registro tiene dos pestañas:

    1. Administrar registros: vea y administre los registros del registro.

    2. Buscar registros: busque registros aprobados en el registro.

  5. La sección de detalles del registro muestra: nombre, estado, descripción Auto-approval (activado o desactivado), ARN del registro, fecha de última actualización y fecha de creación.

  6. La sección de registros del registro muestra los contadores de resumen de estado (total enviado, pendiente de aprobación, aprobado, obsoleto, rechazado) y una tabla de registros.

  7. La sección Autorización de la API de búsqueda (autorización entrante) muestra el tipo de autorización actual.

AWS CLI

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

AWS SDK

import boto3

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

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")

Actualizar un registro

Consola

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, en Discover, elija Registry.

  3. Seleccione el botón de opción situado junto al registro que desee editar y, a continuación, seleccione Editar. Como alternativa, elija el nombre del registro y, a continuación, elija Editar.

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

    1. Nombre: cambie el nombre del registro (las mismas reglas de nomenclatura que en la creación).

    2. Descripción: en Detalles adicionales, actualice o añada una descripción.

    3. Aprobación de registros: activa Auto-approvalo desactiva. Los cambios solo afectan a los registros enviados después de la actualización.

  5. Seleccione Save changes (Guardar cambios).

nota

La actualización de la configuración de aprobación automática de OFF a ON solo afecta a los registros enviados después del cambio. Los registros existentes que ya están «pendientes de aprobación» no se ven afectados y, aun así, deben aprobarse o rechazarse llamando a la API. UpdateRegistryRecordStatus Cambiar la configuración de ON a OFF solo afecta a los registros que se publican como «Pendiente de aprobación» una vez realizado el cambio.

nota

La URL de descubrimiento (para un registro autorizado por JWT) no se puede cambiar una vez creado el registro. El tipo de autorización entrante (IAM o JWT) no se puede cambiar una vez creado el registro.

AWS CLI

aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

import boto3

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

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

Eliminar un registro

Consola

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, en Discover, elija Registry.

  3. Seleccione el botón de opción situado junto al registro que desee eliminar y, a continuación, seleccione Eliminar.

  4. En el cuadro de diálogo de confirmación, revise la advertencia: primero debe eliminar todos los registros del registro antes de eliminar el registro.

  5. Escriba delete en el campo de confirmación.

  6. Elija Eliminar.

El estado del registro cambia a Eliminando. Un aviso de éxito confirma que se ha completado la eliminación.

AWS CLI

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

AWS SDK

import boto3

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

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING