Registrare e individuare i plug-in nell'inventario DELLE API

Questo articolo descrive come usare Azure Centro API per registrare i plug-in come parte dell'inventario API. I plug-in sono funzionalità riutilizzabili che gli agenti di intelligenza artificiale possono individuare e usare per estendere le funzionalità.

Nel Centro API registrare un plug-in raggruppando una o più competenze e/o server MCP già registrati nell'inventario API. Registrando un plug-in, si crea un'astrazione di livello superiore che semplifica l'individuazione e l'uso di competenze correlate e server MCP da parte di sviluppatori e sistemi di intelligenza artificiale.

Prerequisiti

Registrare un plug-in nel centro API

Per registrare un plug-in nel centro API:

  1. Accedere al portale di Azure e passare al centro API.

  2. Nel menu della barra laterale, in Inventario, selezionare Asset.

  3. Selezionare + Registra una risorsa>Plugin.

    Screenshot della registrazione di un plug-in nel portale.

  4. Nel modulo Registra un plug-in immettere le informazioni descritte nella tabella seguente:

    Campo Description
    Titolo Immettere un nome descrittivo per il plug-in.
    Identificatore Il Centro API genera automaticamente un identificatore in base al titolo. Se necessario, è possibile modificare questo identificatore.
    Sommario Facoltativamente, immettere un breve riepilogo delle operazioni del plug-in.
    Descrizione Facoltativamente, immettere una descrizione più dettagliata delle funzionalità, dei casi d'uso e del comportamento del plug-in.
    Version Facoltativamente, immettere la versione del plug-in.
    Abilità Per aggiungere competenze al plug-in, selezionare + Aggiungi competenza e scegliere dall'elenco delle competenze registrate nell'inventario API.
    Server MCP Per aggiungere server MCP al plug-in, selezionare + Aggiungi server MCP e scegliere dall'elenco dei server MCP registrati nell'inventario API.

  5. Selezionare Crea per registrare il plug-in nel centro API.

Dopo la registrazione, il plugin compare nel tuo inventario, nella pagina Inventario>Risorse.

Individuare i plug-in nel portale di Centro API

Configurare il portale di Centro API in modo che gli sviluppatori e gli altri stakeholder dell'organizzazione possano individuare i plug-in nell'inventario API. Dal portale di Centro API gli utenti possono:

  • Esplorare e filtrare i plug-in nell'inventario.
  • Visualizzare informazioni dettagliate su ogni plug-in.

Valutare gli asset di intelligenza artificiale

Il Centro API può valutare la qualità degli asset di intelligenza artificiale, ad esempio competenze e agenti registrati nel centro API. API Center comprende criteri di valutazione predefiniti, pronti all'uso, per valutare le risorse in base a dimensioni predefinite. Gli amministratori della piattaforma enterprise possono estendere ulteriormente queste impostazioni predefinite definendo criteri di valutazione personalizzati personalizzati in base agli standard, ai requisiti di conformità e ai criteri di governance specifici dell'organizzazione.

Per abilitare le valutazioni automatizzate degli asset di intelligenza artificiale nell'inventario:

  1. Nel portale di Azure passare al centro API.

  2. Nel menu della barra laterale. Vai a Governance>Valutazione dell’IA.

  3. Selezionare la scheda Competenze per configurare le valutazioni per le competenze oppure selezionare la scheda Agenti per configurare le valutazioni per gli agenti.

  4. In Stato valutazione selezionare Abilitato.

  5. Immettere una descrizione per la valutazione.

  6. In Criteri di valutazione eseguire una delle operazioni seguenti:

    • Accettare i criteri predefiniti forniti dal Centro API. Facoltativamente, rimuovere i criteri predefiniti non pertinenti per l'organizzazione.

    Lo screenshot seguente mostra i criteri predefiniti per le competenze:

    Screenshot della configurazione della valutazione delle competenze di intelligenza artificiale nel portale.

    • Aggiungere uno o più criteri personalizzati.
      1. Selezionare + Aggiungi criteri.
      2. Immettere un nome e un'istruzione di valutazione facoltativa per il criterio.
      3. Immettere Punteggio minimo e Valori di punteggio massimo per il punteggio (ad esempio, 1 e 5).
      4. Immettere un valore soglia pass (ad esempio, 3) che indica il punteggio minimo accettabile per il criterio.
      5. Immettere un valore weight che indica il contributo del criterio alla valutazione totale (ad esempio, un peso di 0,3 multipli il punteggio di 0,3, contribuendo 30% alla valutazione totale).
      6. Ripetere i passaggi precedenti per aggiungere altri criteri in base alle esigenze.

  7. Seleziona Salva.

È quindi possibile visualizzare i risultati della valutazione nel portale del Centro API. Ad esempio, visualizzare i risultati della valutazione per ogni competenza nella pagina dei dettagli della competenza.

Screenshot della valutazione delle competenze nel portale di Centro API.

Configurare l'individuazione dei plug-in e usarla tramite l'endpoint del Marketplace

L'endpoint del marketplace dei plug-in di API Center espone il catalogo dei plug-in registrati tramite l'API dei dati di API Center, consentendone la scoperta e l'uso da parte degli sviluppatori. Gli sviluppatori possono aggiungere il marketplace all'interfaccia della riga di comando di GitHub Copilot o all'ambiente di sviluppo Claude Code per esplorare e installare plug-in dal centro API.

Contenuti correlati

  • Last updated on