

# Capacidades gerais
<a name="registry-key-capabilities"></a>

**Próxima migração de namespace**  
 AWS O Agent Registry está atualmente em versão prévia pública no namespace bedrock-agentcore. A partir de 6 de agosto de 2026, o serviço passa para o namespace agent-registry. Se você usa o AWS Agent Registry, deve atualizar seus endpoints, políticas do IAM, clientes SDK, scripts de CLI e dados de registro. Para obter mais informações sobre a migração da versão prévia pública, consulte o [guia abrangente de migração do registro](registry-faq.md).

## Tipos de recursos flexíveis
<a name="registry-flexible-resource-types"></a>

Adicione registros de qualquer tipo com uma estrutura flexível e metadados personalizados. AWS O Agent Registry oferece suporte direto a servidores, agentes e habilidades MCP. Para registros do MCP Server e do Agent, o AWS Agent Registry valida suas definições em relação aos esquemas dos protocolos MCP e A2A, respectivamente, garantindo a exatidão antes que os registros sejam publicados. Você também pode registrar qualquer tipo de recurso personalizado, como agentes em conformidade com protocolos diferentes de A2A, APIs, funções Lambda, bases de conhecimento ou bancos de dados, definindo seu próprio esquema de metadados. Isso significa que o AWS Agent Registry pode servir como um catálogo unificado para todos os recursos detectáveis em sua organização, independentemente da tecnologia subjacente.

## Pesquisa híbrida
<a name="registry-hybrid-search"></a>

 AWS O Agent Registry combina pesquisa semântica com correspondência de palavras-chave para fornecer resultados relevantes para qualquer tipo de consulta. Quando você pesquisa usando linguagem natural, como “encontrar uma ferramenta que possa reservar voos”, a pesquisa semântica entende a intenção e encontra registros conceitualmente relevantes, mesmo que essas palavras exatas não apareçam nos metadados do registro. Quando você pesquisa usando termos exatos, como “weather-api-v2", a pesquisa por palavra-chave corresponde ao texto exato. Ambas as modalidades de pesquisa são executadas simultaneamente em todas as consultas, com resultados classificados por uma combinação ponderada de pontuações de relevância. Você pode restringir ainda mais os resultados usando filtros de metadados em campos como nome do registro, tipos de registro e versão.

## Governança e curadoria
<a name="registry-governance-curation"></a>

 AWS O Agent Registry dá aos administradores controle sobre o que os criadores de sua organização podem descobrir e usar. Os administradores podem garantir que somente registros que atendam aos critérios definidos internamente para segurança, riqueza de metadados, conformidade, segurança e quaisquer outros padrões organizacionais sejam aprovados e tornados visíveis nos resultados da pesquisa. Quando um curador precisa remover um recurso da descoberta — seja devido a um problema recém-descoberto, uma suspensão de uso ou uma mudança de política — ele pode descontinuar os registros aprovados existentes, garantindo que esses recursos não possam mais ser encontrados pelos criadores. Para ambientes de desenvolvimento em que a revisão manual não é necessária, os administradores podem ativar a aprovação automática para que os registros enviados possam ser descobertos imediatamente.

## EventBridge Notificações da Amazon
<a name="registry-eventbridge-notifications"></a>

 AWS O Agent Registry envia eventos para a Amazon EventBridge quando um registro é enviado para aprovação. Você pode usar esses eventos para acionar fluxos de trabalho de revisão automatizados, enviar alertas aos curadores por e-mail ou mensagem ou integrar-se a sistemas de emissão de bilhetes e canais de aprovação. Os eventos são entregues no EventBridge barramento padrão da Amazon em sua conta e região e podem ser roteados para qualquer EventBridge-supported destino da Amazon, incluindo AWS Lambda, Amazon Simple Notification Service, Amazon Simple Queue Service e AWS Step Functions.

## Integre-se aos fluxos de trabalho de aprovação existentes
<a name="registry-integrate-approval-workflows"></a>

Muitas organizações já estabeleceram mecanismos para revisar e aprovar recursos — processos que incluem análises de segurança, verificações de conformidade, avaliações de segurança e outras avaliações. AWS O Agent Registry pode ser integrado a esses fluxos de trabalho existentes por meio da Amazon EventBridge e da UpdateRegistryRecordStatus API. Quando um editor envia um registro para aprovação, o AWS Agent Registry envia uma EventBridge notificação à Amazon que pode acionar seu pipeline de revisão existente. Depois que seu pipeline conclui as verificações, ele chama a UpdateRegistryRecordStatus API para aprovar ou rejeitar o registro. Ao integrar o AWS Agent Registry ao seu pipeline de revisão existente, você pode organizar o registro diretamente do seu processo de aprovação existente sem alterar a forma como sua organização analisa os recursos.

## Descobrindo recursos usando o servidor MCP do Registro
<a name="registry-mcp-endpoint"></a>

Cada registro expõe um MCP-compatible endpoint ao qual os clientes MCP podem se conectar diretamente usando o Model Context Protocol. Isso permite que agentes e ferramentas criados no MCP descubram e interajam com recursos registrados usando a comunicação padrão do protocolo MCP, sem precisar usar o AWS SDK ou integrar-se a APIs específicas. AWS Qualquer MCP-compatible cliente válido pode se conectar ao endpoint MCP do registro e pesquisar os recursos disponíveis no registro. Isso permite que os desenvolvedores que usam IDEs de IA descubram facilmente os agentes e ferramentas existentes na organização e os aproveitem à medida que criam novos fluxos de trabalho agentes.

## Autorização flexível
<a name="registry-flexible-authorization"></a>

 AWS O Agent Registry suporta dois métodos de autorização para as operações de busca e invocação de MCP, para que você possa escolher a abordagem adequada à sua organização:
+  ** AWS IAM** — Use suas credenciais existentes do IAM para autorização. Essa é a opção mais simples para equipes que já trabalham nela AWS, sem necessidade de configuração adicional.
+  **JSON Web Tokens (JWT)** — Integre o registro ao provedor de identidade existente da sua organização, como Amazon Cognito, Okta, Microsoft Azure AD ou qualquer provedor compatível com OAuth 2.0. Seus desenvolvedores e agentes podem pesquisar o registro e invocar o endpoint MCP usando suas credenciais corporativas existentes, sem precisar de acesso individual ao IAM.

As operações do plano de controle (criação, atualização e gerenciamento de registros e registros) sempre usam a autorização do IAM, independentemente da configuração de autorização de pesquisa do registro.

## Sincronização de registros
<a name="registry-record-synchronization"></a>

 AWS O Agent Registry pode sincronizar metadados de registros de fontes externas, mantendo seu registro atualizado. Quando você configura um registro com uma URL apontando para um servidor MCP externo, o Registro do AWS Agente busca o servidor mais recente (detalhes como nome, descrição) e os metadados da ferramenta (nomes de ferramentas, descrições de ferramentas) desse URL e atualiza o registro. A sincronização pode ser usada tanto para criar o registro pela primeira vez, extraindo os metadados da URL fornecida, quanto para atualizar um registro existente com novos metadados devido a alterações no recurso subjacente. Quando a sincronização é usada para um registro existente, uma nova revisão para o registro existente é criada. A sincronização é compatível com provedores de credenciais OAuth e IAM para autorização.

## CloudTrail integração
<a name="registry-capability-cloudtrail"></a>

 AWS As chamadas da API do plano de controle do Agent Registry são registradas AWS CloudTrail, fornecendo uma trilha de auditoria completa de quem fez o quê e quando. As operações do plano de controle são registradas como eventos de gerenciamento por padrão.