Registe-se e descubra plugins no seu inventário de API

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

No API Center, registas um plugin agrupando uma ou mais skills e/ou servidores MCP que já estão registados no teu inventário de API. Ao registar um plugin, cria uma abstração de nível superior que simplifica a descoberta e utilização de competências relacionadas e servidores MCP por parte de programadores e sistemas de IA.

Pré-requisitos

Registe um plugin no teu centro API

Para registar um plugin no seu centro de 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. Selecione + Registar um ativo>Plugin.

    Captura de ecrã do registo de um plugin no portal.

  4. No formulário Registar um plugin , introduza a informação descrita na tabela seguinte:

    Campo Description
    Título Introduza um nome descritivo para o plugin.
    Identificador O API Center gera automaticamente um identificador com base no título. Pode editar este identificador se necessário.
    Resumo Opcionalmente, introduza um breve resumo do que o plugin faz.
    Description Opcionalmente, introduza uma descrição mais detalhada das capacidades, casos de uso e comportamento do plugin.
    Version Opcionalmente, introduza a versão do plugin.
    Competências Para adicionar competências ao plugin, selecione + Adicionar competência e escolha da lista de competências registadas no seu inventário de API.
    Servidores MCP Para adicionar servidores MCP ao plugin, selecione + Adicionar servidor MCP e escolha da lista de servidores MCP registados no seu inventário de API.

  5. Selecione Criar para registar o plugin no seu centro de API.

Após o registo, o plugin aparece no seu inventáriona página>.

Descubra suplementos no portal do API Center

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

  • Navegue e filtre os plugins no inventário.
  • Veja informações detalhadas sobre cada plugin.

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.

Configurar a descoberta e utilização de plugins através do endpoint do marketplace

O endpoint do marketplace de plugins do API Center expõe o catálogo de plugins registados utilizando a API Center Data API, permitindo a descoberta e utilização pelos programadores. Os programadores podem adicionar o marketplace ao seu GitHub Copilot CLI ou ao ambiente de desenvolvimento Claude Code para navegar e instalar plugins a partir do seu centro de API.

Conteúdo relacionado

  • Last updated on