Registrar e gerenciar agentes no Centro de API do Azure

Este artigo mostra como registrar agentes de IA, incluindo agentes A2A, no Centro de API, torná-los detectáveis para os usuários e atualizá-los e gerenciá-los.

Pré-requisitos

• Uma instância do Centro de API do Azure
• Um agente descrito por um cartão de agente no formato JSON ou uma definição de agente no formato Markdown
• Permissões apropriadas para editar APIs no Centro de API

Registrar agente

1. Entre no Azure portal e vá para o centro de API.

2. No menu da barra lateral, em Inventário, selecione Ativos.

3. Selecione + Registrar um ativo>Agente.

   

4. No formulário Registrar um agente , insira as informações descritas na tabela a seguir:

   Campo	Description
   Título	Insira um nome descritivo para o agente, como o Help Desk Agent.
   Identificação	O Centro de API gera automaticamente um identificador com base no título, como o help-desk-agent. Você pode editar esse identificador, se necessário.
   Resumo curto	Insira uma descrição breve, de uma linha, do que o agente faz, que aparecerá no portal da Central de APIs e em outros locais.
   Description	Opcionalmente, insira uma descrição mais detalhada dos recursos, casos de uso e comportamento da habilidade.
   Version
   Título da versão	Insira um título para a versão de sua escolha, como v1.
   Identificação da versão	O Centro de API gera automaticamente um identificador com base no título da versão. Você pode editar esse identificador, se necessário.
   Ciclo de vida da versão	Selecione o estágio atual do ciclo de vida da versão do agente no menu suspenso. Saiba mais sobre versões no Hub de API.
   Detalhes do agente
   Definição do agente	Insira uma URL ou selecione um arquivo para carregar uma definição de agente. A definição do agente deve estar no formato Markdown e incluir detalhes sobre os recursos, as habilidades e outras informações relevantes do agente.
   Protocolo	Se aplicável, selecione o protocolo A2A se o agente seguir esse protocolo.
   Cartão do agente	Opcionalmente, insira uma URL ou selecione um arquivo para carregar um cartão de agente A2A no formato JSON.

   

5. Selecione Criar para adicionar o agente.

Após o registro, o agente aparece em seu inventário na páginaAtivos de >.

Atualizar um agente registrado

Você pode atualizar as informações do agente a qualquer momento.

1. No portal do Azure, vá para o centro de API.
2. No menu da barra lateral, em Inventário, selecione Ativos.
3. Na tabela, selecione o nome do agente na coluna Título .
4. Selecione o botão Editar para abrir a página Editar no painel de trabalho.
5. Faça as suas alterações e selecione Guardar.

Sincronizar agentes de fontes de API

Para automatizar o registro do agente e manter seu inventário atualizado, você pode integrar as seguintes fontes upstream ao centro de API:

• Gerenciamento de API do Azure: se você gerenciar agentes A2A no Gerenciamento de API do Azure, poderá habilitar a sincronização automática para manter o centro de API atualizado. Para saber mais, confira Sincronizar APIs da instância de Gerenciamento de API do Azure.

• Repositório Git: para agentes A2A e outros ativos de IA armazenados em um repositório Git, você pode habilitar a sincronização automática para manter o centro de API atualizado. Para obter mais informações, consulte Sincronizar ativos de API de um repositório Git.

Descobrir agentes no portal do Centro de API

Configure o portal do Centro de API para que os desenvolvedores e outros stakeholders em sua organização possam descobrir agentes em seu inventário de API. No portal do Centro de API, os usuários podem:

• Navegue e filtre agentes no inventário.
• Exiba informações detalhadas sobre cada agente.

Avaliar ativos de IA (versão prévia)

O Centro de API pode avaliar a qualidade dos ativos de IA, como habilidades e agentes registrados em seu centro de API. O Centro de API vem com critérios de avaliação padrão prontos para uso, avaliando ativos em dimensões predefinidas. Os administradores da plataforma empresarial podem estender ainda mais esses padrões definindo critérios de avaliação personalizados adaptados aos padrões, requisitos de conformidade e políticas de governança específicos de sua organização.

Para habilitar avaliações automatizadas de ativos de IA em seu inventário:

1. No portal do Azure, vá para o centro de API.

2. No menu da barra lateral. vá para Governança>Avaliação de IA (versão prévia).

3. Selecione a guia Habilidades para configurar avaliações para habilidades ou selecione a guia Agentes para configurar avaliações para agentes.

4. No status de Avaliação, selecione Habilitado.

5. Insira uma descrição para a avaliação.

6. Nos critérios de avaliação, siga um destes procedimentos:

   • Aceite os critérios padrão fornecidos pelo Centro de API. Opcionalmente, remova critérios padrão que não são relevantes para sua organização.

   A captura de tela a seguir mostra critérios padrão para habilidades:

   

   • Adicione um ou mais critérios personalizados.
     1. Selecione + Adicionar critérios.
     2. Insira um nome e uma instrução de avaliação opcional para o critério.
     3. Insira a pontuação mínima e os valores de pontuação máxima para a pontuação (por exemplo, 1 e 5).
     4. Insira um valor de limite pass (por exemplo, 3) que indica a pontuação mínima aceitável para o critério.
     5. Insira um valor de peso que indique a contribuição do critério para a avaliação total (por exemplo, um peso de 0,3 multiplica a pontuação por 0,3, contribuindo com 30% para a avaliação total).
     6. Repita as etapas anteriores para adicionar mais critérios conforme necessário.

7. Clique em Salvar.

Em seguida, você pode exibir os resultados da avaliação no portal do Centro de API. Por exemplo, exiba os resultados da avaliação para cada habilidade na página de detalhes da habilidade.

Conteúdo relacionado

• Sincronizar ativos de API de um repositório Git
• Registrar e descobrir servidores MCP em seu inventário de API
• Configurar o portal do Centro de API
• Principais conceitos no Centro de API do Azure