Pré-requisitos Etapa 1: criar um registro Etapa 2: adicionar um registro de registro Etapa 3: enviar o registro para aprovação Etapa 4: aprovar o registro Etapa 5: descobrir registros aprovados O que você construiu Próximas etapas

Comece com AWS Registro de agentes

A migração já está aberta

AWS O Agent Registry foi lançado com o novo agent-registry namespace. O suporte para o bedrock-agentcore namespace de visualização pública será descontinuado em 17 de setembro de 2026. Para obter instruções de migração, consulte Guia abrangente de migração de registro.

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

Criando um registro com IAM-based autorização

exemplo

AWS Agent Registry namespace

Abra o console do AWS Agent Registry.
No painel de navegação, escolha Registro.
Na seção Registros, escolha Criar registro.
Na seção Detalhes do registro, em Nome, insira um nome para seu registro. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 64 caracteres.
(Opcional) Escolha Detalhes adicionais para expandir a seção e, em Descrição, insira uma descrição para ajudar a identificar esse registro.
Na seção Autorização de descoberta, para o tipo de autenticação, escolha Usar autorização IAM (autorização de entrada).
Na seção Aprovação de registro, ative ou desative Auto-approval:
- Quando Auto-approval ativado, quando você envia um registro para aprovação, o registro passa diretamente para o status Aprovado e fica visível nos resultados da pesquisa logo depois.
- Quando Auto-approval está desativado, quando você envia um registro para aprovação, o registro passa para o status de aprovação pendente e exige que um curador o revise e aprove antes de ser publicado.
(Opcional) Na seção Tags, escolha Adicionar nova tag para anexar uma ou mais tags ao registro. Cada tag tem uma chave e um valor opcional.
Escolha Criar registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

Abra a página AWS Agent Registry no Bedrock-AgentCore console.
No painel de navegação, escolha Registro.
Na seção Registros, escolha Criar registro.
Na seção Detalhes do registro, em Nome, insira um nome para seu registro. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 64 caracteres.
(Opcional) Escolha Detalhes adicionais para expandir a seção e, em Descrição, insira uma descrição para ajudar a identificar esse registro.
Na seção Autorização da API de Pesquisa, para o tipo de autenticação, escolha Usar autorização do IAM (autorização de entrada).
Na seção Aprovação de registro, ative ou desative Auto-approval:
- Quando Auto-approval ativado, quando você envia um registro para aprovação, o registro passa diretamente para o status Aprovado e fica visível nos resultados da pesquisa logo depois.
- Quando Auto-approval está desativado, quando você envia um registro para aprovação, o registro passa para o status de aprovação pendente e exige que um curador o revise e aprove antes de ser publicado.
Escolha Criar registro.

Criando um registro com JWT-based autorização

A autorização do provedor de identidade usa JSON Web Tokens (JWT) para controlar o acesso às APIs do plano de dados detectáveis do registro e ao endpoint MCP. Você pode usar o Amazon Cognito para configurar rapidamente a autorização ou usar seu próprio provedor de identidade para habilitar o OAuth 2.0.

exemplo

AWS Agent Registry namespace

Abra o console do AWS Agent Registry.
No painel de navegação, escolha Registro.
Na seção Registros, escolha Criar registro.
Na seção Detalhes do registro, em Nome, insira um nome para seu registro. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 64 caracteres.
(Opcional) Escolha Detalhes adicionais para expandir a seção e, em Descrição, insira uma descrição para ajudar a identificar esse registro.
Na seção Autorização de descoberta, para o tipo de autenticação, escolha Usar JSON Web Tokens (JWT) (autorização de entrada).
Para a configuração do esquema JWT, escolha uma das seguintes opções:
1. Criação rápida de configurações com o Cognito (recomendado) — O AWS Agent Registry cria as configurações de autorização em seu nome usando o Amazon Cognito como provedor de identidade. Não é exigida nenhuma configuração adicional.
2. Use as configurações existentes do provedor de identidade — Traga seu próprio provedor de identidade para ativar o OAuth 2.0. Se você escolher essa opção, conclua as seguintes etapas:
  1. Para URL de descoberta, insira a URL de descoberta do seu provedor de identidade. AWS O Agent Registry usa esse URL para buscar automaticamente as configurações de login, token e verificação do seu provedor. Você pode encontrar esse URL no painel ou na documentação do seu provedor de identidade (por exemplo,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).
    
    nota
    O URL de descoberta não pode ser alterado após a criação do registro.
  2. (Opcional) Em Configuração de autorização do JWT, selecione Públicos permitidos para fornecer uma lista dos públicos permitidos que o AWS Agent Registry valida em relação à aud reivindicação no token do JWT. Uma declaração de público (aud) no OAuth 2.0 especifica para qual servidor de recursos (API) o token se destina. Isso garante que o token seja o destinatário correto antes de processar a solicitação, impedindo que um token seja reutilizado em uma API diferente para a qual não foi emitido.
  3. (Opcional) Selecione Clientes permitidos para fornecer uma lista de identificadores de clientes permitidos que o AWS Agent Registry valida com base na client_id declaração no token JWT. client_idA é um identificador público e exclusivo de um aplicativo que está solicitando tokens de acesso para acessar as APIs detectáveis do plano de dados ou o endpoint MCP do registro. Se você habilitar essa opção, insira uma ou mais IDs de cliente no campo Clientes e escolha Adicionar cliente para adicionar mais clientes.
  4. (Opcional) Selecione Escopos permitidos para fornecer uma lista de permissões permitidas, definidas como escopos. Se configurado, pelo menos um valor de escopo no token de entrada deve corresponder a um dos valores configurados. Os escopos funcionam como permissões para limitar o que um aplicativo pode fazer.
  5. (Opcional) Selecione Declarações personalizadas para fornecer um conjunto de regras que correspondam às reivindicações específicas no token de entrada com valores predefinidos. Para cada regra, especifique o nome da declaração, o tipo de valor (STRING ou STRING_ARRAY) e o valor de correspondência necessário.
Na seção Aprovação de registro, ative ou desative Auto-approval:
1. Quando Auto-approval ativado, quando você envia um registro para aprovação, o registro passa diretamente para o status Aprovado e fica imediatamente visível nos resultados da pesquisa.
2. Quando Auto-approval está desativado, quando você envia um registro para aprovação, o registro passa para o status de aprovação pendente e exige que um administrador do registro o revise e aprove antes de ser publicado.
(Opcional) Na seção Tags, escolha Adicionar nova tag para anexar uma ou mais tags ao registro. Cada tag tem uma chave e um valor opcional.
Escolha Criar registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

Abra a página AWS Agent Registry no Bedrock-AgentCore console.
No painel de navegação, escolha Registro.
Na seção Registros, escolha Criar registro.
Na seção Detalhes do registro, em Nome, insira um nome para seu registro. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 64 caracteres.
(Opcional) Escolha Detalhes adicionais para expandir a seção e, em Descrição, insira uma descrição para ajudar a identificar esse registro.
Na seção Autorização da API de Pesquisa, em Tipo de autenticação, escolha Usar JSON Web Tokens (JWT) (autorização de entrada).
Para a configuração do esquema JWT, escolha uma das seguintes opções:
1. Criação rápida de configurações com o Cognito (recomendado) — O AWS Agent Registry cria as configurações de autorização em seu nome usando o Amazon Cognito como provedor de identidade. Não é exigida nenhuma configuração adicional.
2. Use as configurações existentes do provedor de identidade — Traga seu próprio provedor de identidade para ativar o OAuth 2.0. Se você escolher essa opção, conclua as seguintes etapas:
  1. Para URL de descoberta, insira a URL de descoberta do seu provedor de identidade. AWS O Agent Registry usa esse URL para buscar automaticamente as configurações de login, token e verificação do seu provedor. Você pode encontrar esse URL no painel ou na documentação do seu provedor de identidade (por exemplo,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).
    
    nota
    O URL de descoberta não pode ser alterado após a criação do registro.
  2. (Opcional) Em Configuração de autorização do JWT, selecione Públicos permitidos para fornecer uma lista dos públicos permitidos que o AWS Agent Registry valida em relação à aud reivindicação no token do JWT. Uma declaração de público (aud) no OAuth 2.0 especifica para qual servidor de recursos (API) o token se destina. Isso garante que o token seja o destinatário correto antes de processar a solicitação, impedindo que um token seja reutilizado em uma API diferente para a qual não foi emitido.
  3. (Opcional) Selecione Clientes permitidos para fornecer uma lista de identificadores de clientes permitidos que o AWS Agent Registry valida com base na client_id declaração no token JWT. client_idA é um identificador público e exclusivo de um aplicativo que está solicitando tokens de acesso para acessar a API de pesquisa do registro. Se você habilitar essa opção, insira uma ou mais IDs de cliente no campo Clientes e escolha Adicionar cliente para adicionar mais clientes.
  4. (Opcional) Selecione Escopos permitidos para fornecer uma lista de permissões permitidas, definidas como escopos. Se configurado, pelo menos um valor de escopo no token de entrada deve corresponder a um dos valores configurados. Os escopos funcionam como permissões para limitar o que um aplicativo pode fazer.
  5. (Opcional) Selecione Declarações personalizadas para fornecer um conjunto de regras que correspondam às reivindicações específicas no token de entrada com valores predefinidos. Para cada regra, especifique o nome da declaração, o tipo de valor (STRING ou STRING_ARRAY) e o valor de correspondência necessário.
Na seção Aprovação de registro, ative ou desative Auto-approval:
1. Quando Auto-approval ativado, quando você envia um registro para aprovação, o registro passa diretamente para o status Aprovado e fica imediatamente visível nos resultados da pesquisa.
2. Quando Auto-approval está desativado, quando você envia um registro para aprovação, o registro passa para o status de aprovação pendente e exige que um administrador do registro o revise e aprove antes de ser publicado.
Escolha Criar registro.

nota

* É necessário pelo menos um campo de configuração de autorização do JWT: públicos permitidos, clientes permitidos, escopos permitidos ou declarações personalizadas. Se você configurar mais de um, o AWS Agent Registry verificará todos eles. * O URL de descoberta não pode ser alterado após a criação do registro. * O tipo de autorização (IAM ou JWT) não pode ser alterado após a criação do registro. * Um registro suporta somente uma forma de tipo de autorização de entrada por vez — IAM SigV4 ou JWT Bearer Token. Você não pode usar os dois simultaneamente. A pesquisa via IAM só é suportada por meio IAM-based do registro; e a pesquisa via Oauth só é suportada por meio do registro baseado em Oauth.

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 seu status for Pronto.

AWS CLI

exemplo

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

AWS SDK

exemplo

Etapa 2: adicionar um registro de registro

Crie um registro para um servidor MCP em seu registro.

Console

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

exemplo

AWS Agent Registry namespace

Abra o console do AWS Agent Registry.
No painel de navegação, escolha Registro e, em seguida, escolha o nome do registro ao qual você deseja adicionar um registro.
Na seção Registros do registro, escolha Criar registro.
Escolha um tipo de fonte:
1. Sincronizar a partir do endpoint — Forneça um URL de endpoint e credenciais opcionais para buscar metadados de um servidor MCP ou endpoint de agente (A2A). Consulte Sincronizar registros de fontes externas para obter detalhes.
2. Manual — Configure manualmente os detalhes do registro e a configuração do protocolo. Continue com as etapas abaixo.
Na seção Detalhes do registro, em Nome, insira um nome exclusivo para o registro. O nome deve ser exclusivo no registro — a combinação de Name e Record version deve ser exclusivo. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 255 caracteres.
(Opcional) Em Nome de exibição, insira uma etiqueta legível para o registro. Isso aparece na tabela de registros do registro e nos resultados da pesquisa ao lado do nome técnico do registro.
(Opcional) Em Descrição, insira uma descrição para o registro. A descrição pode ter de 1 a 4.096 caracteres.
Em Versão do registro, insira um identificador de versão para o registro (por exemplo, 1.0.0 ouv2.1).
Na seção Tipo de registro e descritor:
1. Em Tipo, selecione o tipo semântico do registro. O tipo determina quais chaves do descritor primário são válidas.
  - MCP — Protocolo projetado para ferramentas de IA e comunicações com agentes. Lida com gerenciamento de contexto e formatos de mensagens estruturadas.
  - Agente — Protocolo projetado para interações seguras entre agentes. Permite fluxos de trabalho distribuídos e troca de informações.
  - Habilidades — Registre as habilidades do agente com a documentação de markdown e uma definição estruturada opcional.
  - Personalizado — Implementação de protocolo personalizado para padrões de comunicação especializados. Defina sua própria especificação de interface e requisitos de integração.
2. Em Descritor, escolha a forma dos dados do descritor do registro. As opções disponíveis dependem do Tipo que você selecionou:
  - MCP → Servidor MCP ou personalizado
  - Agente → Placa de agente A2A, servidor MCP ou personalizada
  - Habiilidades → Definição de habilidades do agente ou personalizadas
  - Personalizado → Personalizado
Um editor específico do descritor aparece com base na sua seleção de descritor:
1. Servidor MCP — Selecione uma versão do esquema no menu suspenso Versão do esquema (por exemplo,2025-12-11) e insira seu servidor de registro Model Context Protocol server.json no site do Model Context Protocol no editor de definições do seu servidor MCP. A definição deve estar de acordo com o esquema oficial do servidor MCP para a versão selecionada. Para ver o esquema oficial como referência, ative Mostrar esquema oficial. (Opcional) Selecione Adicionar definição de ferramenta para adicionar ferramentas disponíveis neste servidor com seus parâmetros de entrada, saídas e exemplos de uso. Selecione uma versão do esquema (por exemplo,2025-11-25) e insira sua definição de ferramenta no editor de definição de Sua ferramenta.
2. Cartão de agente A2A — A versão do esquema é. 0.3 Insira a definição do cartão do agente no editor. Para ver o esquema oficial como referência, ative Mostrar esquema oficial.
3. Definição de habilidades do agente — Para a documentação da habilidade, insira a marcação que descreve essa habilidade. (Opcional) Selecione Incluir definição de habilidade para adicionar uma definição estruturada. Selecione uma versão do esquema e insira a definição como um objeto JSON.
4. Personalizado — insira sua definição personalizada como um objeto JSON.
(Opcional) Na seção Tags, escolha Adicionar nova tag para anexar uma ou mais tags ao registro. Cada tag tem uma chave e um valor opcional.
Escolha Create record (Criar registro).

Amazon Bedrock AgentCore namespace (to be deprecated)

Abra a página AWS Agent Registry no Bedrock-AgentCore console.
No painel de navegação, escolha Registro e, em seguida, escolha o nome do registro ao qual você deseja adicionar um registro.
Na seção Registros do registro, escolha Criar registro.
Escolha um tipo de fonte:
1. Sincronizar a partir do endpoint — Forneça um URL de endpoint e credenciais opcionais para buscar metadados de um servidor MCP ou endpoint de agente (A2A). Consulte Sincronizar registros de fontes externas para obter detalhes.
2. Manual — Configure manualmente os detalhes do registro e a configuração do protocolo. Continue com as etapas abaixo.
Na seção Detalhes do registro, em Nome, insira um nome para o registro. O nome deve começar com um caractere alfanumérico. Os caracteres válidos são a—z, A—Z, 0—9, _ (sublinhado), (hífen), - (ponto final) e . (barra frontal). / O nome pode ter até 255 caracteres.
(Opcional) Em Descrição, insira uma descrição para o registro. A descrição pode ter de 1 a 4.096 caracteres.
Em Versão do registro, insira um identificador de versão para o registro (por exemplo, 1.0.0 ouv2.1).
Na seção Tipo de registro, escolha o tipo que corresponde ao seu recurso:
1. MCP — Protocolo projetado para ferramentas de IA e comunicações com agentes. Lida com gerenciamento de contexto e formatos de mensagens estruturadas. Se você escolher esse tipo, conclua as seguintes etapas:
  1. Na seção Definição do servidor MCP, selecione uma versão do esquema no menu suspenso Versão do esquema (por exemplo,2025-12-11) e insira Model Context Protocol registry server.json no site Model Context Protocol no editor de definição do seu servidor MCP. A definição deve estar de acordo com o esquema oficial do servidor MCP para a versão selecionada. Para ver o esquema oficial como referência, ative Mostrar esquema oficial.
  2. (Opcional) Selecione Adicionar definição de ferramenta para adicionar ferramentas específicas disponíveis neste servidor com seus parâmetros de entrada, saídas e exemplos de uso para melhorar a visibilidade. Se você selecionar essa opção, selecione uma versão do esquema no menu suspenso Versão do esquema (por exemplo,2025-11-25) e insira a definição da ferramenta no editor de definição da Sua ferramenta. Para ver o esquema oficial da ferramenta como referência, ative Mostrar esquema oficial.
2. Agente — Protocolo projetado para interações seguras entre agentes. Permite fluxos de trabalho distribuídos e troca de informações. Se você escolher esse tipo, a versão do esquema será0.3. Insira a definição do cartão do agente no editor. Para ver o esquema oficial como referência, ative Mostrar esquema oficial.
3. Habilidades do agente — Registre as habilidades do agente com a documentação de markdown e uma definição estruturada opcional. Se você escolher esse tipo, conclua as seguintes etapas:
  1. Para a documentação da habilidade, insira a documentação do markdown que descreve essa habilidade.
  2. (Opcional) Selecione Incluir definição de habilidade para adicionar uma definição estruturada. Se você selecionar essa opção, selecione uma versão do esquema no menu suspenso Versão do esquema e, em seguida, insira a definição da habilidade como um objeto JSON no editor.
4. Personalizado — Implementação de protocolo personalizado para padrões de comunicação especializados. Defina sua própria especificação de interface e requisitos de integração. Se você escolher esse tipo, insira sua definição personalizada como um objeto JSON no editor.
Escolha Create record (Criar registro).

nota

Para adicionar um servidor ou agente ao registro que não esteja em conformidade com os esquemas de protocolo MCP ou A2A padrão, use o tipo de registro personalizado.

Depois de escolher Criar registro, o AWS Agent Registry 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

exemplo

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

exemplo

AWS Agent Registry namespace


import boto3
import json

client = boto3.client('agent-registry-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',
    displayName='My MCP Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11',
            'additionalData': {
                'tools': {
                    'data': tools_content,
                    'dataSchemaVersion': '2024-11-05'
                }
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Amazon Bedrock AgentCore namespace (to be deprecated)


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
            }
        }
    },
    recordVersion='1.0'
)
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

exemplo

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

exemplo

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

Se o registro estiver Auto-approval ativado, o status do registro mudará diretamente para Aprovado e ficará visível nos resultados da pesquisa logo depois.
Se o registro estiver Auto-approval desativado, o status do registro mudará para Aprovação pendente e exigirá que um administrador do registro o revise e aprove antes de ser publicado.

AWS CLI

exemplo

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

AWS SDK

exemplo

Etapa 4: aprovar o registro

Console

Para aprovar um registro da tabela de registros do registro

exemplo

Para aprovar um registro na página de detalhes do registro

exemplo

AWS Agent Registry namespace

Abra o console do AWS Agent Registry.
No painel de navegação, escolha Registro e, em seguida, escolha o nome do registro.
Na seção Registros do registro, escolha o nome do registro que você deseja aprovar.
Na página de detalhes do registro, escolha Atualizar status e, em seguida, escolha Aprovar.
Na caixa de diálogo de confirmação, insira um motivo para a alteração do status.
Escolha Confirmar.

Amazon Bedrock AgentCore namespace (to be deprecated)

Abra a página AWS Agent Registry no Bedrock-AgentCore console.
No painel de navegação, escolha Registro e, em seguida, escolha o nome do registro.
Na seção Registros do registro, escolha o nome do registro que você deseja aprovar.
Na página de detalhes do registro, escolha Atualizar status e, em seguida, escolha Aprovar.
Na caixa de diálogo de confirmação, insira um motivo para a alteração do status.
Escolha Confirmar.

AWS CLI

exemplo

AWS SDK

exemplo

Etapa 5: descobrir registros aprovados

O diretório de registros é a página do console para navegar e pesquisar registros aprovados em um registro. Quando você seleciona um registro na página Diretório de registros, o console lista automaticamente seus registros aprovados. A partir daí, você pode folhear a lista ou usar a caixa de pesquisa para executar uma consulta em linguagem natural. Programaticamente, use ListDiscoverableRegistryRecords para navegar, SearchDiscoverableRegistryRecords pesquisar e BatchGetDiscoverableRegistryRecord obter detalhes completos de vários registros em uma chamada.

Console

nota

Console-based a descoberta está disponível somente para registros que usam Use IAM como o tipo de autorização. Se seu registro usa JSON Web Tokens (JWT), chame as APIs detectáveis do plano de dados diretamente usando um cliente HTTP, como curl ou Postman, com um JWT Bearer Token válido no cabeçalho da solicitação. A AWS CLI e AWS os SDKs usam a assinatura IAM SigV4 e não podem ser usados com registros. JWT-authorized Para obter mais detalhes, consulte Pesquisar registros do registro.

exemplo

AWS Agent Registry namespace

Para navegar ou pesquisar registros aprovados

Abra o console do AWS Agent Registry.
No painel de navegação, escolha Diretório de registros.
Em Registro, selecione o registro cujos registros aprovados você deseja explorar. A página lista automaticamente todos os registros aprovados nesse registro.
(Opcional) Alterne entre a visualização de cartão e tabela no canto superior direito da página.
(Opcional) Em Pesquisar registros aprovados, insira uma consulta de idioma natural ou um nome para restringir os resultados e escolha Pesquisar.
Escolha um cartão ou linha para abrir todos os detalhes do registro.

O diretório de registros exibe os registros somente no status Aprovado. Os registros nos status Rascunho, Aprovação pendente, Rejeitado ou Obsoleto não aparecem.

Amazon Bedrock AgentCore namespace (to be deprecated)

Para pesquisar registros de registro

Abra a página AWS Agent Registry no Bedrock-AgentCore console.
No painel de navegação, escolha Registro e, em seguida, escolha o nome do registro.
Escolha a guia Pesquisar registros.
No campo Pesquisar registros aprovados, insira sua consulta de pesquisa.
(Opcional) Para filtrar os resultados por uma propriedade específica, escolha o campo de pesquisa para expandir o menu Propriedades e escolha um filtro: Nome , Tipo de descritor ou Versão.
Selecione a opção Pesquisar.

A pesquisa retorna somente registros com status Aprovado. Registros em outros estados, como status de rascunho, aprovação pendente, rejeitado ou obsoleto, não aparecem nos resultados da pesquisa.

AWS CLI

Procure registros aprovados — liste os registros aprovados em um registro:


aws agent-registry list-discoverable-registry-records \
  --registry-id "<registry-id>" \
  --region us-east-1

Pesquise registros aprovados — execute uma pesquisa híbrida semântica e por palavra-chave:

exemplo

Recupere todos os detalhes de vários registros de uma só vez:


aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registry-id>", "recordIds": ["<recordId-1>", "<recordId-2>"]}]' \
  --region us-east-1

nota

ListDiscoverableRegistryRecordse só BatchGetDiscoverableRegistryRecord estão disponíveis no agent-registry namespace. Eles não estão disponíveis no bedrock-agentcore namespace.

AWS SDK

Procure registros aprovados:


import boto3

client = boto3.client('agent-registry')

list_response = client.list_discoverable_registry_records(
    registryId='<registry-id>',
    maxResults=20
)
for record in list_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")

Pesquisar registros aprovados:

exemplo

Recupere todos os detalhes de vários registros de uma só vez:


batch_response = client.batch_get_discoverable_registry_record(
    entries=[{'registryId': '<registry-id>', 'recordIds': ['<recordId-1>', '<recordId-2>']}]
)
for record in batch_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
for err in batch_response['errors']:
    print(f"Error for {err['recordId']}: {err['errorCode']}")

O que você construiu

Um registro com autorização do IAM e aprovação manual
Um registro de registro descrevendo um servidor MCP
Um registro aprovado, navegável e pesquisável por meio do diretório de registros

Próximas etapas

Crie experiências de descoberta no estilo de catálogo com base em e ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord
Configure as EventBridge notificações da Amazon para automatizar seu fluxo de trabalho de aprovação
Adicione mais registros para seus agentes, servidores, habilidades e recursos personalizados

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Casos de uso de exemplo

Criação e gerenciamento de registros