27 Registro de IA
O AI Registry é o catálogo central de agentes e servidores MCP para a Oracle AI Data Platform. Ele suporta padrões abertos, incluindo MCP e A2A.
Plataforma de Dados de IA é onde os agentes são criados e implantados. O Oracle Agent Hub é onde os usuários de negócios conversam com eles. O Registro de IA é a camada entre eles. O AI Registry torna um agente ou uma ferramenta detectável e utilizável fora do ambiente em que foi integrado. Agentes e ferramentas devem ser registrados no AI Registry para que possam ser compartilhados no Agent Hub. Consulte Como a IA Empresarial Funciona no Agent Hub em Usando o Oracle Agent Hub.
Você pode registrar os seguintes agentes e ferramentas no AI Data Platform AI Registry:
| Tipo | Descrição |
|---|---|
| Agente da AI Data Platform | Um agente criado e implantado na Plataforma de Dados de IA, em um espaço de trabalho ao qual você tem acesso. Também chamado de agente local no Registro do AI da AI Data Platform. |
| Agente externo | Um agente hospedado fora da AI Data Platform, adicionado pelo URL do cartão do agente A2A. |
| Servidor MCP | Um servidor MCP (Model Context Protocol) que expõe um conjunto de ferramentas que os agentes podem chamar. |
No AI Registry, você pode gerenciar agentes de IA, servidores MCP e credenciais necessárias para usar ambos. Na página do AI Registry, você pode usar as guias Agentes, servidores MCP e Credenciais para exibir uma lista de cada uma. Você pode usar a barra de pesquisa para filtrar as opções visíveis por nome ou descrição. Na guia Agentes, você pode usar o menu drop-down Classificar por para classificar por quanto tempo os agentes foram adicionados ao registro.
Clicar em um cartão de agente exibe os detalhes desse agente, fornecendo o criador, a origem, a versão, um URL para o cartão de agente e a versão do protocolo. Você pode alternar entre a view de detalhes e uma view JSON do cartão usando as opções no canto superior direito do cartão.
Antes de registrar novos agentes externos ou servidores MCP, primeiro você precisa registrar suas credenciais de autenticação na guia Credenciais. Em seguida, você pode registrar novos agentes e servidores MCP clicando em Registrar no canto superior direito e selecionando a opção apropriada. As permissões do AI Registry são gerenciadas na guia Permissões.
Sobre Cartões de Agente
Cartões de Agente são a estrutura de metadados que descreve um agente. O AI Registry os lê durante o registro e os mostra para revisão antes de confirmar.
Para obter mais informações, consulte a Especificação de Protocolo A2A.
- Nome, versão e descrição.
- O URL do cartão do agente, que é onde o próprio cartão é publicado.
- Versão do protocolo.
- Modos de entrada e saída. Por exemplo, texto, texto/sem formatação ou texto/html.
- Recursos, como Streaming.
- Habilidades, cada uma com seu próprio nome e descrição.
Criar Credenciais no AI Registry
Você pode salvar as credenciais necessárias para uso na autenticação de objetos do AI Registry, como agentes e servidores MCP.
- Na Home page, clique em
AI Registry. - Clique na guia Credenciais e, em seguida, clique em Criar credencial.
- Informe um nome e uma descrição para a credencial.
- Selecione o tipo de Credencial no menu suspenso.
- Selecione o tipo de Concessão no menu suspenso.
- Informe o URL de Autorização, o URL do token de acesso, o ID do Cliente, o Segredo do cliente e o URL de Atualização para suas credenciais.
- Informe um Nome e um Valor de Escopo. É necessário pelo menos um nome e valor de Escopo. Adicione nomes e valores de Escopo clicando em Adicionar escopo.
- Copie o URL de Redirecionamento. Você precisa colar o URL de Redirecionamento para o aplicativo confidencial no seu domínio de identidades. O exemplo a seguir demonstra como copiar o URL de Redirecionamento para o Oracle Cloud Infrastructure:
- Faça log-in na console do OCI.
- Clique em Identidade e Segurança, em Domínios e em Aplicativos integrados.
- Selecione o aplicativo cujos URLs de redirecionamento você deseja atualizar.
- Clique na guia OAuth Configuration e, em seguida, clique em Editar configuração OAuth.
- Aplique todos os URLs de redirecionamento necessários e clique em Submeter.
- Clique em Criar.
Registrar um Agente Local no AI Registry
Você pode registrar agentes de IA locais nos espaços de trabalho do Oracle AI Data Platform aos quais tem acesso.
- Na Home page, clique em
AI Registry. - Clique em Registrar e, em seguida, clique em Agente.
- Clique em Agente local.
- No menu drop-down Espaço de Trabalho, selecione o espaço de trabalho no qual o agente local está localizado.
- No menu drop-down Agente, selecione o agente que você deseja registrar.
- Opcional: Passe o mouse sobre o ícone do cartão para ver uma visualização do cartão do agente.
- Clique em Próximo.
- Confirme se os detalhes do agente estão corretos e clique em Registrar.
Registrar um Agente Externo no Registro do AI
Você pode registrar agentes externos do AI de origens suportadas no seu Registro do AI. Esses agentes devem seguir o protocolo A2A.
- Na Home page, clique em
AI Registry. - Clique em Registrar e, em seguida, clique em Agente.
- Clique em Agente externo.
- Informe o URL do cartão do agente.
- Opcional: Se o seu ponto final exigir credenciais seguras, selecione Exigir autenticação e, em seguida, selecione as credenciais no menu drop-down Credenciais.
- Clique em Próximo.
- Opcional: Se você selecionou Exigir autenticação, informe as credenciais de uma conta com direito ao agente na caixa de diálogo exibida.
- Verifique a precisão dos detalhes do agente e clique em Registrar.
Registrar um Servidor MCP no AI Registry
Um servidor MCP expõe um conjunto de ferramentas que os agentes podem descobrir e chamar através de uma interface padrão. O registro de um no AI Registry disponibiliza essas ferramentas na plataforma.
Observação:
Se o servidor MCP exigir autenticação, primeiro crie as credenciais OAuth no AI Registry. Não é possível adicionar credenciais como parte do registro de um servidor MCP.- Na Home page, clique em
AI Registry. - Clique em Registrar e, em seguida, clique em Servidor MCP.
- Informe o URL do ponto final do servidor MCP.
- Digite um nome para Exibição e uma Descrição úteis. Os usuários e agentes usarão essas informações para identificar a finalidade do servidor MCP.
- No menu drop-down, selecione o método Transporte.
- Opcional: Se o servidor MCP exigir credenciais seguras, selecione Exigir autenticação. Selecione as credenciais no menu suspenso Credenciais.
- Clique em Continuar.
- Revise a lista de ferramentas incluídas para o servidor MCP selecionado. Selecione as ferramentas que você deseja incluir individualmente ou clique em Selecionar tudo para incluir todas as ferramentas listadas.
- Clique em Registrar.