Registe-se e descubra competências no seu inventário de APIs

Este artigo descreve como usar o Azure API Center para registar competências de agente como parte do seu inventário de API. As competências são capacidades reutilizáveis que os agentes de IA podem descobrir e consumir para expandir a sua funcionalidade.

Ao registar competências no seu centro API, cria um registo centralizado que ajuda a sua organização a:

  • Descubra as competências disponíveis e as suas capacidades
  • Aceda ao código-fonte e à documentação das competências

Pré-requisitos

  • Um centro de API. Se ainda não tem um centro de APIs, consulte o início rápido para Criar um centro de APIs.
  • Uma ou mais competências que queres registar, normalmente alojadas num repositório de código-fonte como o GitHub.

Registe uma competência

Para registar uma competência no seu centro API:

  1. Inicia sessão no portal Azure e vai ao teu centro de API.

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

  3. Selecionar + Registar um ativo>Habilidade.

    Captura de ecrã do registo de uma competência no portal.

  4. No formulário Registar uma competência, forneça as informações conforme a tabela seguinte:

    Campo Descrição
    Título Introduza um nome descritivo para a competência (por exemplo, Perícia de Revisão de Código).
    Identificação O API Center gera automaticamente um identificador com base no título (por exemplo, code-review-skill). Podes editar isto se for necessário.
    Resumo Forneça uma breve descrição de uma linha do que a competência faz (por exemplo, realiza revisões automáticas de código usando análise estática).
    Descrição Introduza uma descrição mais detalhada das capacidades, casos de uso e comportamento da competência.
    Fase do ciclo de vida Selecione a fase atual do ciclo de vida da habilidade no menu suspenso.
    Source
    URL de origem Introduza a URL do repositório Git para o código-fonte da skill (por exemplo, https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
    Compatibilidade Descreva os requisitos, dependências e pré-requisitos para a utilização da competência (por exemplo, software ou ferramentas necessárias como git, docker, linguagens de programação; requisitos do sistema; requisitos de acesso à rede; Chaves API ou requisitos de autenticação).
    Ferramentas permitidas Selecione + Adicionar ferramenta para especificar as APIs ou servidores MCP do seu inventário de APIs a que esta competência pode aceder. Esta abordagem ajuda a garantir uma governação e segurança adequadas ao definir explicitamente que recursos a competência pode consumir.
    Licença Selecionar + Adicionar para fornecer informações sobre licenciamento. Insira o nome da licença (por exemplo, MIT, Apache 2.0 ou Proprietário), forneça opcionalmente um URL da licença e adicione uma descrição se necessário para clarificar termos ou restrições da licenciamento.
    Informação de Contacto Selecionar + Adicionar para adicionar pontos de contacto para apoio ou consultas. Insira um nome ou função de contacto (por exemplo, API Team ou John Smith), forneça dados de contacto como endereço de email e, opcionalmente, adicione uma descrição para esclarecer quando e porquê contactar essa pessoa ou equipa.

  5. Selecione Criar para registar a competência no seu centro de API.

Após o registo, a habilidade aparece no seu inventário na página de Ativos de Inventário>.

Atualize uma competência registada

Pode atualizar a informação das competências a qualquer momento:

  1. No teu centro de API, vai a Inventário>Ativos.
  2. Encontra e seleciona a competência que queres atualizar.
  3. Selecione Editar para modificar as propriedades da habilidade.
  4. Faz as tuas alterações e seleciona Guardar.

Sincronizar competências a partir de um repositório Git

Para automatizar o registo de competências e manter o seu inventário atualizado, pode integrar um repositório Git com o seu centro de API. Para mais informações, consulte Sincronizar ativos de API a partir de um repositório Git.

Descubra competências no portal API Center

Configure o seu portal do API Center para que os programadores e outros intervenientes da sua organização possam descobrir competências no seu inventário de APIs. A partir do portal API Center, os utilizadores podem:

  • Navegue e filtre as competências no inventário.
  • Consulte informações detalhadas sobre cada competência.

Avaliar ativos de IA

O API Center pode avaliar a qualidade dos ativos de IA, como competências e agentes registados no seu API Center. O API Center vem com critérios de avaliação padrão logo de fábrica, avaliando ativos em dimensões predefinidas. Os administradores de plataformas empresariais podem expandir ainda mais estes padrões definindo critérios personalizados de avaliação adaptados às normas específicas, requisitos de conformidade e políticas de governação da sua organização.

Para permitir avaliações automáticas dos ativos de IA no seu inventário:

  1. No portal Azure, vai ao teu centro de API.

  2. Na barra lateral. Aceda a Governação>Avaliação de IA.

  3. Selecione o separador Competências para configurar avaliações para competências, ou selecione o separador Agentes para configurar avaliações para agentes.

  4. No estado da Avaliação, selecione Ativado.

  5. Introduza uma Descrição para a avaliação.

  6. Nos critérios de avaliação, faça um dos seguintes:

    • Aceite os critérios padrão fornecidos pelo API Center. Opcionalmente, remova critérios padrão que não sejam relevantes para a sua organização.

    A captura de ecrã seguinte mostra critérios padrão para as competências:

    Captura de ecrã da configuração da avaliação de competências de IA no portal.

    • Adicione um ou mais critérios personalizados.
      1. Selecionar + Adicionar critérios.
      2. Introduza um Nome e uma instrução opcional de Avaliação para o critério.
      3. Insira os valores de pontuação mínima e máxima para a pontuação (por exemplo, 1 e 5).
      4. Introduza um valor limiar de Aprovação (por exemplo, 3) que indica a pontuação mínima aceitável para o critério.
      5. Introduza um valor de Peso que indica 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 os passos anteriores para adicionar mais critérios conforme necessário.

  7. Selecione Guardar.

Pode então consultar os resultados das avaliações no portal do API Center. Por exemplo, veja os resultados das avaliações de cada competência na página de detalhes da competência.

Captura de ecrã da avaliação de competências no portal do API Center.

Conteúdo relacionado

  • Last updated on