Registrar e descobrir habilidades em seu inventário de API

Este artigo descreve como usar o Centro de API do Azure para registrar habilidades de agente como parte de seu inventário de API. As habilidades são funcionalidades reutilizáveis que os agentes de IA podem descobrir e consumir para estender suas funcionalidades.

Ao registrar habilidades em seu centro de API, você cria um registro centralizado que ajuda sua organização:

• Descobrir as habilidades disponíveis e suas funcionalidades
• Acessar o código-fonte e a documentação das habilidades

Pré-requisitos

• Um centro de API. Se você ainda não tiver um centro de API, confira o início rápido para criar um centro de API.
• Uma ou mais habilidades que você deseja registrar, normalmente hospedadas em um repositório de código-fonte, como o GitHub.

Registrar uma habilidade

Para registrar uma habilidade no centro de API:

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

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

3. Selecione + Registrar um ativo>Habilidade.

   

4. No formulário Registrar uma habilidade , forneça as informações na tabela a seguir:

   Campo	Descrição
   Título	Insira um nome descritivo para a habilidade (por exemplo, Habilidade de Revisão de Código).
   Identificação	O Centro de API gera automaticamente um identificador com base no título (por exemplo, code-review-skill). Você pode editar isso se necessário.
   Resumo	Forneça uma breve descrição de uma linha do que a habilidade faz (por exemplo, executa revisões de código automatizadas usando a análise estática).
   Descrição	Insira uma descrição mais detalhada dos recursos, casos de uso e comportamento da habilidade.
   Estágio do ciclo de vida	Selecione o estágio atual do ciclo de vida da habilidade no menu suspenso.
   Fonte
   URL de origem	Insira a URL do repositório Git para o código-fonte da habilidade (por exemplo, https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
   Compatibilidade	Descreva os requisitos, dependências e pré-requisitos para usar a habilidade (por exemplo, software ou ferramentas necessárias, como git, docker, linguagens de programação; requisitos do sistema; requisitos de acesso à rede; Chaves de API ou requisitos de autenticação).
   Ferramentas permitidas	Selecione + Adicionar ferramenta para especificar as APIs ou servidores MCP do inventário de API que essa habilidade pode acessar. Essa abordagem ajuda a garantir a governança e a segurança adequadas definindo explicitamente quais recursos a habilidade pode consumir.
   Licença	Selecione + Adicionar para fornecer informações de licenciamento. Insira o nome da licença (por exemplo, MIT, Apache 2.0 ou Proprietário), opcionalmente forneça uma URL de licença e adicione uma descrição, se necessário, para esclarecer os termos ou restrições de licenciamento.
   Informações do contato	Selecione + Adicionar para adicionar pontos de contato para suporte ou consultas. Insira um nome ou função de contato (por exemplo, Equipe de API ou John Smith), forneça detalhes de contato, como endereço de email, e, opcionalmente, adicione uma descrição para esclarecer quando e por que contatar essa pessoa ou equipe.

5. Selecione Criar para registrar a habilidade no centro de API.

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

Atualizar uma habilidade registrada

Você pode atualizar informações de habilidade a qualquer momento:

1. No Centro de APIs, vá para Inventário>Ativos.
2. Localize e selecione a habilidade que você deseja atualizar.
3. Selecione Editar para modificar as propriedades da habilidade.
4. Faça as suas alterações e selecione Guardar.

Sincronizar habilidades de um repositório Git

Para automatizar o registro de habilidades e manter seu inventário atualizado, você pode integrar um repositório Git ao centro de API. Para obter mais informações, consulte Sincronizar ativos de API de um repositório Git.

Descobrir habilidades 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 habilidades em seu inventário de API. No portal do Centro de API, os usuários podem:

• Procure e filtre habilidades no inventário.
• Exiba informações detalhadas sobre cada habilidade.

Avaliar ativos de IA

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. Acesse Governança>Avaliação de IA.

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
• Registre e descubra servidores MCP e plug-ins em seu inventário de API.
• Configurar o portal do Centro de API
• Principais conceitos no Centro de API do Azure