Registrar e descobrir plug-ins em seu inventário de API

Este artigo descreve como usar Azure Centro de API para registrar plug-ins como parte de seu inventário de API. Os plug-ins são recursos reutilizáveis que os agentes de IA podem descobrir e consumir para estender suas funcionalidades.

No Centro de API, você registra um plug-in agrupando uma ou mais habilidades e/ou servidores MCP que já estão registrados em seu inventário de API. Ao registrar um plug-in, você cria uma abstração de nível superior que simplifica a descoberta e o uso de habilidades relacionadas e servidores MCP por desenvolvedores e sistemas de IA.

Pré-requisitos

Registrar um plug-in no centro de API

Para registrar um plug-in 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>Plugin.

    Captura de tela do registro de um plug-in no portal.

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

    Campo Description
    Título Insira um nome descritivo para o plug-in.
    Identificador O Centro de API gera automaticamente um identificador com base no título. Você pode editar esse identificador, se necessário.
    Resumo Opcionalmente, insira um breve resumo do que o plug-in faz.
    Description Opcionalmente, insira uma descrição mais detalhada dos recursos, casos de uso e comportamento do plug-in.
    Version Opcionalmente, insira a versão do plug-in.
    Habilidades Para adicionar habilidades ao plug-in, selecione + Adicionar habilidade e escolha na lista de habilidades registradas em seu inventário de API.
    Servidores MCP Para adicionar servidores MCP ao plug-in, selecione + Adicionar servidor MCP e escolha na lista de servidores MCP registrados em seu inventário de API.

  5. Selecione Criar para registrar o plug-in no centro de API.

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

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

  • Navegue e filtre plug-ins no inventário.
  • Exiba informações detalhadas sobre cada plug-in.

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:

    Captura de tela da configuração da avaliação de habilidade de IA no portal.

    • 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. Selecione 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.

Captura de tela da avaliação de habilidades no portal do Centro de API.

Configure a detecção e o uso de plugins por meio do endpoint do Marketplace

O endpoint do marketplace de plug-ins do API Center expõe o catálogo de plug-ins registrados por meio da API de dados do API Center, permitindo que os desenvolvedores os descubram e usem. Os desenvolvedores podem adicionar o marketplace ao GitHub Copilot CLI ou ao ambiente de desenvolvimento do Claude Code para explorar e instalar plugins da sua central de APIs.

Conteúdo relacionado

  • Last updated on