Inizia con AWS Registro degli agenti

In questa guida, creerai il tuo primo registro, aggiungerai un record, lo approverai e lo cercherai.

Prerequisiti

Completa i passaggi indicati in Prerequisiti.

Fase 1: Creare un registro

Crea un registro con autorizzazione IAM e approvazione manuale.

Console

Per creare un registro con autenticazione basata su IAM

Per creare un registro con Auth Identity basato su JWT, l'autorizzazione del provider utilizza JSON Web Tokens (JWT) per controllare l'accesso all'API di ricerca del registro. Puoi usare Amazon Cognito per configurare rapidamente l'autorizzazione o utilizzare il tuo provider di identità per abilitare OAuth 2.0.

Dopo aver creato il registro, la console accede alla pagina dei dettagli del registro. Lo stato del registro è inizialmente Creazione. AWS Agent Registry assegna al registro un ARN, che puoi trovare nella sezione dei dettagli del registro. Lo stato del registro passa a Ready dopo il completamento del provisioning. È possibile aggiungere record al registro quando lo stato è Pronto.

AWS CLI

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

Lo stato del registro inizia come CREATING e passa a READY al termine del provisioning.

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

Passaggio 2: Aggiungere un record di registro

Crea un record per un server MCP nel tuo registro.

Console

Un record di registro rappresenta un agente, uno strumento, una competenza o una risorsa personalizzata.

Dopo aver scelto Crea record, AWS Agent Registry inizia a fornire il record. Lo stato del record è inizialmente Creazione. Una volta completato il provisioning, lo stato passa a Bozza. Per rendere il record disponibile affinché altri possano scoprirlo, invialo per l'approvazione. Per ulteriori informazioni, consulta Fase 3: invio del record per l'approvazione.

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

Il record viene creato nello stato CREATING e passa a DRAFT al termine dell'elaborazione. Per altri esempi AWS CLI per la creazione di record di altri tipi, consulta la sezione Crea e gestisci record.

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

Fase 3: Inviare il record per l'approvazione

Console

L'invio di un record per l'approvazione avvia il processo di revisione che rende il record disponibile per l'individuazione. È possibile inviare un record dalla tabella dei record del registro o dalla pagina dei dettagli del record.

Per inviare un record per l'approvazione dalla tabella dei record del registro

Per inviare un record per l'approvazione dalla pagina dei dettagli del record

Dopo aver inviato un record per l'approvazione, lo stato del record cambia in base all'impostazione di approvazione del registro:

AWS CLI

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

Il record viene spostato su PENDING_APPROVAL (o direttamente su APPROVED se l'approvazione automatica è abilitata).

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

Passaggio 4: approvare il record

Console

Per approvare un record dalla tabella dei record del registro

Per approvare un record dalla pagina dei dettagli del record

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

Passaggio 5: Cerca nel registro

Console

È possibile cercare i record approvati in un registro utilizzando la ricerca semantica o per parole chiave per trovare agenti, server MCP, competenze e altre risorse. Puoi filtrare i risultati per nome, protocollo o versione per restringere la ricerca.

Per cercare i record del registro

La ricerca restituisce solo i record con stato Approvato. I record in altri stati, ad esempio Bozza, In attesa di approvazione, Rifiutato o Obsoleto, non vengono visualizzati nei risultati della ricerca.

AWS CLI

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

Il record approvato dovrebbe apparire nei risultati della ricerca.

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

Cosa hai costruito

Fasi successive