Conceitos e terminologia
Próxima migração de namespace
AWS O Agent Registry está atualmente em versão prévia pública sob o namespace bedrock-agentcore. A partir de 6 de agosto de 2026, o serviço passa para o namespace de registro do agente. 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.
Registro
Um registro é um catálogo centralizado que você cria em sua AWS conta para organizar e gerenciar recursos. Cada registro tem um nome, uma descrição, uma configuração de autorização que controla como os consumidores acessam as APIs de pesquisa e MCP e uma configuração de aprovação que determina se os registros precisam de revisão manual antes de se tornarem detectáveis.
A forma como você organiza seus registros depende de suas necessidades — por exemplo, registros dedicados para diferentes tipos de recursos (um registro de agente, um registro de servidor MCP, um registro de habilidades), registros para diferentes estágios de desenvolvimento (produção, controle de qualidade, desenvolvimento), registros independentes para diferentes equipes ou unidades de negócios ou um único registro para toda a organização.
Registro de registro
Um registro de registro representa os metadados de um recurso individual publicado em um registro. Cada registro captura os principais metadados que descrevem o recurso subjacente, fornecendo informações sobre o que é, o que faz e como pode ser encontrado. Os registros têm um nome, descrição opcional, versão, tipo e metadados específicos do tipo de recurso.
Resource types
Servidores MCP — Os servidores Model Context Protocol (MCP) fornecem ferramentas que os agentes de IA podem descobrir e invocar. Um registro de servidor MCP contém uma definição de servidor que descreve a configuração do servidor e as definições de ferramentas para todas as ferramentas que o servidor fornece, incluindo seus parâmetros de entrada e formatos de saída. AWS O Agent Registry valida os registros do servidor MCP em relação ao esquema do protocolo MCP
Agentes — Agentes são programas autônomos que podem raciocinar, planejar e realizar ações para realizar tarefas. Um registro do agente contém um cartão do agente que descreve os recursos, as habilidades e a interface de comunicação do agente de acordo com a especificação do protocolo A2A (Agent-to-Agent)
Habilidades — As habilidades são recursos reutilizáveis que podem ser compartilhados entre os agentes. Um registro de habilidade contém metadados básicos do descritor, como Nome, Descrição, informações de acesso opcionais, como detalhes do Package ou do Repository, e documentação opcional de markdown que descreve o que a habilidade faz e como usá-la.
Recursos personalizados — Para recursos que não se encaixam nos tipos padrão acima, você pode definir seu próprio esquema de metadados usando qualquer estrutura JSON válida.
Provedor de credencial
Quando você configura um registro de registro para sincronizar metadados de uma fonte externa (autorização de saída), o Registro do AWS Agente precisa de credenciais para acessar essa fonte. Um provedor de credenciais armazena os detalhes da autorização — credenciais do OAuth ou uma função do IAM — que o AWS Agent Registry usa para invocar o endpoint do recurso externo durante a sincronização. Você faz referência a um provedor de credenciais pelo ARN ao configurar a sincronização em um registro. Para obter mais informações, consulte Gerenciar provedores de credenciais.
A autorização de registro é de 2 tipos -
-
Autorização de entrada: essa configuração permite que os administradores do registro controlem como os consumidores podem pesquisar o registro (via AWS CLI, AWS SDK ou invocando o endpoint MCP). O registro oferece suporte à autorização de entrada baseada em IAM e JWT. Os administradores do registro especificam isso como parte do fluxo de trabalho para criar um registro.
-
Autorização de saída: como parte da sincronização de registros MCP e A2A com seus endpoints remotos (para registros em que a sincronização está configurada), o registro exige credenciais de saída para invocar o recurso remoto no endpoint especificado e recuperar metadados. Os editores fornecem essas credenciais como parte da configuração do trabalho de sincronização para um registro de registro específico.
Personas principais
As pessoas que usam o Registro podem variar de organização para organização. No entanto, vimos as seguintes personalidades gerais que interagem com o Registro, comumente encontradas em organizações.
- Administrador
-
O administrador é o proprietário da infraestrutura de registro. Eles são responsáveis por criar e configurar registros na AWS conta, decidir como cada registro é organizado (por equipe, ambiente ou tipo de recurso) e escolher o método de autorização (IAM ou JWT) que determina como os consumidores acessam o registro. Os administradores configuram o fluxo de trabalho de aprovação — decidindo se os registros exigem revisão manual ou são aprovados automaticamente — e configuram EventBridge as integrações da Amazon para conectar o registro aos sistemas existentes de notificação e revisão da organização. Eles gerenciam as permissões do IAM para controlar quais editores, curadores e consumidores podem acessar cada registro. Por serem administradores, eles também têm acesso total para criar, atualizar e excluir registros e podem aprovar, rejeitar ou descontinuar registros quando necessário.
- Editora
-
O editor é um construtor dentro da organização que criou um recurso — um servidor MCP, um agente, uma habilidade ou alguma outra ferramenta — e deseja torná-lo detectável para outras pessoas. Os editores criam registros de registro que descrevem seus recursos, fornecendo metadados, definições e informações de versão que ajudarão outras pessoas a encontrar e entender o que o recurso faz. Eles repetem os registros no status Rascunho, refinando as descrições e os esquemas até que o registro esteja pronto e, em seguida, o enviam para aprovação. Se um registro for rejeitado, o editor revisará o feedback do curador, fará as alterações necessárias e o reenviará. Os editores também podem configurar a URL-based sincronização para que seus registros permaneçam sincronizados com os servidores MCP ativos sem atualizações manuais.
- Curador/Aprovador
-
O curador é o guardião da qualidade do registro e, muitas vezes, também pode ser o administrador do registro. Eles são responsáveis por revisar os registros que os editores enviaram para aprovação, avaliando cada registro de acordo com os padrões da organização quanto à segurança, conformidade, integridade dos metadados e quaisquer outros critérios definidos pela organização. Os curadores aprovam registros que atendem a esses padrões, tornando-os visíveis nos resultados da pesquisa e por meio do endpoint do MCP, e rejeitam registros que não atendem, fornecendo um feedback claro sobre o que precisa ser corrigido. Quando um recurso é desativado, tem problemas conhecidos ou é substituído por uma versão mais recente, o curador desaprova o registro para removê-lo da descoberta. Os curadores garantem que o registro continue sendo um catálogo confiável e de alta qualidade no qual os criadores de toda a organização possam confiar.
- Consumidor
-
O consumidor é qualquer pessoa — humana ou agente — que precisa encontrar e usar recursos. Os consumidores pesquisam o registro usando consultas em linguagem natural ou pesquisas por palavras-chave para descobrir servidores, agentes, habilidades e outros recursos do MCP que foram aprovados e publicados. Eles também podem se conectar ao endpoint MCP do registro usando qualquer MCP-compatible cliente para descobrir as ferramentas disponíveis programaticamente. Os consumidores só veem os registros aprovados, então podem confiar que tudo o que encontram no registro foi revisado e atende aos padrões de qualidade da organização. Os consumidores podem autorizar por meio de credenciais do IAM ou tokens JWT de um provedor de identidade corporativa, dependendo de como o registro está configurado.
