Comece com AWS Registro de agentes

Neste guia, você criará seu primeiro registro, adicionará um registro, aprovará e pesquisará por ele.

Pré-requisitos

Conclua as etapas em Pré-requisitos.

Etapa 1: criar um registro

Crie um registro com autorização do IAM e aprovação manual.

Console

Para criar um registro com autenticação baseada em IAM

Para criar um registro com base no JWT, a autorização do provedor de identidade de autenticação usa JSON Web Tokens (JWT) para controlar o acesso à API de pesquisa do registro. Você pode usar o Amazon Cognito para configurar rapidamente a autorização ou trazer seu próprio provedor de identidade para habilitar o OAuth 2.0.

Depois de criar o registro, o console navega até a página de detalhes do registro. O status do registro é inicialmente Criando. AWS O Agent Registry atribui ao registro um ARN, que você pode encontrar na seção Detalhes do registro. O status do registro muda para Pronto após a conclusão do provisionamento. Você pode adicionar registros ao registro quando o status estiver Pronto.

AWS CLI

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

O status do registro começa como CREATING e muda para PRONTO quando o provisionamento é concluído.

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

Etapa 2: Adicionar um registro de registro

Crie um registro para um servidor MCP em seu registro.

Console

Um registro de registro representa um agente, ferramenta, habilidade ou recurso personalizado.

Depois de escolher Criar registro, o Registro do AWS Agente começa a provisionar o registro. O status do registro é inicialmente Criando. Quando o provisionamento é concluído, o status muda para Rascunho. Para disponibilizar o registro para que outras pessoas o descubram, envie-o para aprovação. Para obter mais informações, consulte Etapa 3: Enviar o registro para aprovação.

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

O registro é criado no status CREATING e passa para DRAFT quando o processamento é concluído. Para obter mais exemplos de AWS CLI para criar registros de outros tipos, consulte a seção Criar e gerenciar 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

Etapa 3: enviar o registro para aprovação

Console

O envio de um registro para aprovação inicia o processo de revisão que disponibiliza o registro para descoberta. Você pode enviar um registro da tabela de registros do registro ou da página de detalhes do registro.

Para enviar um registro para aprovação a partir da tabela de registros do registro

Para enviar um registro para aprovação na página de detalhes do registro

Depois de enviar um registro para aprovação, o status do registro muda com base na configuração de aprovação do registro:

AWS CLI

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

O registro é movido para PENDING_APPROVAL (ou diretamente para APPROVED se a aprovação automática estiver ativada).

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

Etapa 4: aprovar o registro

Console

Para aprovar um registro da tabela de registros do registro

Para aprovar um registro na página de detalhes do 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']}")

Etapa 5: pesquisar o registro

Console

Você pode pesquisar registros aprovados em um registro usando a pesquisa semântica ou por palavra-chave para encontrar agentes, servidores MCP, habilidades e outros recursos. Você pode filtrar os resultados por nome, protocolo ou versão para restringir sua pesquisa.

Para pesquisar registros de registro

A pesquisa retorna somente registros com status Aprovado. Registros em outros estados, como status Rascunho, Aprovação pendente, Rejeitado ou Obsoleto, não aparecem nos resultados da pesquisa.

AWS CLI

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

Seu registro aprovado deve aparecer nos resultados da pesquisa.

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

O que você construiu

Próximas etapas