Comience con AWS Registro de agentes

En esta guía, creará su primer registro, agregará un registro, lo aprobará y lo buscará.

Requisitos previos

Complete los pasos de los requisitos previos.

Paso 1: Cree un registro

Cree un registro con la autorización de IAM y la aprobación manual.

Consola

Para crear un registro con autenticación basada en IAM

Para crear un registro con una identidad de autenticación basada en JWT, la autorización del proveedor utiliza JSON Web Tokens (JWT) para controlar el acceso a la API de búsqueda del registro. Puede usar Amazon Cognito para configurar rápidamente la autorización o incorporar su propio proveedor de identidad para habilitar OAuth 2.0.

Tras crear el registro, la consola accede a la página de detalles del registro. Inicialmente, el estado del registro es En proceso de creación. AWS El registro del agente asigna al registro un ARN, que puede encontrar en la sección de detalles del registro. El estado del registro cambia a Listo una vez finalizado el aprovisionamiento. Puede añadir registros al registro cuando su estado sea Listo.

AWS CLI

aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

El estado del registro comienza como CREATING y pasa a READY cuando se completa el aprovisionamiento.

AWS SDK

import boto3

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

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

Paso 2: Añadir un registro de registro

Cree un registro para un servidor MCP en su registro.

Consola

Un registro de registro representa un agente, una herramienta, una habilidad o un recurso personalizado.

Tras seleccionar Crear registro, AWS Agent Registry comienza a aprovisionar el registro. El estado del registro es inicialmente Creando. Cuando se completa el aprovisionamiento, el estado cambia a Borrador. Para que el registro esté disponible para que otros lo descubran, envíelo para su aprobación. Para obtener más información, consulte el paso 3: Enviar el registro para su aprobación.

AWS CLI

aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "WeatherServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

El registro se crea con el estado DE CREACIÓN y pasa a BORRADOR cuando se completa el procesamiento. Para obtener más ejemplos de AWS CLI para crear registros de otros tipos, consulte la sección Crear y administrar registros.

AWS SDK

import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Paso 3: Envíe el registro para su aprobación

Consola

Al enviar un registro para su aprobación, se inicia el proceso de revisión que hace que el registro esté disponible para su descubrimiento. Puede enviar un registro desde la tabla de registros o desde la página de detalles del registro.

Para enviar un registro de la tabla de registros del registro para su aprobación

Para enviar un registro para su aprobación desde la página de detalles del registro

Después de enviar un registro para su aprobación, el estado del registro cambia en función de la configuración de aprobación del registro:

AWS CLI

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

El registro pasa a PENDING_APPROVAL (o directamente a APPROVED si la aprobación automática está habilitada).

AWS SDK

import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

Paso 4: Aprobar el registro

Consola

Para aprobar un registro de la tabla de registros

Para aprobar un registro desde la página de detalles del registro

AWS CLI

aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS SDK

import boto3

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

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

Paso 5: busque en el registro

Consola

Puede buscar registros aprobados en un registro mediante una búsqueda semántica o por palabra clave para encontrar agentes, servidores MCP, habilidades y otros recursos. Puede filtrar los resultados por nombre, protocolo o versión para limitar la búsqueda.

Para buscar registros de registro

La búsqueda devuelve solo los registros con el estado Aprobado. Los registros en otros estados, como Borrador, Pendiente de aprobación, Rechazado o Obsoleto, no aparecen en los resultados de la búsqueda.

AWS CLI

aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

El registro aprobado debería aparecer en los resultados de la búsqueda.

AWS SDK

import boto3

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

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

Lo que has creado

Siguientes pasos