Registrare e individuare le competenze nell'inventario DELLE API

Questo articolo descrive come usare il Centro API di Azure per registrare le competenze dell'agente come parte dell'inventario API. Le competenze sono funzionalità riutilizzabili che gli agenti di intelligenza artificiale possono individuare e usare per estendere le funzionalità.

Registrando le competenze nel centro API, si crea un registro centralizzato che consente all'organizzazione di:

  • Scoprire le competenze disponibili e le relative funzionalità
  • Accedere al codice sorgente e alla documentazione per le competenze

Prerequisiti

  • Un centro API. Se non si ha ancora un centro API, vedere la guida introduttiva per Creare un centro API.
  • Una o più competenze da registrare, in genere ospitate in un repository di codice sorgente, ad esempio GitHub.

Registrare una competenza

Per registrare una competenza 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. Seleziona + Registra un asset>competenza.

    Screenshot della registrazione di una competenza sul portale.

  4. Nel modulo Registra una competenza specificare le informazioni nella tabella seguente:

    Campo Descrizione
    Titolo Immettere un nome descrittivo per la competenza( ad esempio, Competenza di revisione codice).
    Identificazione Il Centro API genera automaticamente un identificatore in base al titolo (ad esempio, code-review-skill). Se necessario, è possibile modificarlo.
    Sommario Specificare una breve descrizione delle operazioni eseguite dalla competenza, ad esempio Esegue revisioni automatiche del codice usando l'analisi statica.
    Descrizione Immettere una descrizione più dettagliata delle funzionalità, dei casi d'uso e del comportamento della competenza.
    Fase del ciclo di vita Selezionare la fase corrente del ciclo di vita della competenza dal menu a discesa.
    Fonte
    URL di origine Immettere l'URL del repository Git per il codice sorgente dell'abilità, ad esempio https://github.com/<org>/<repo>/tree/main/skills/<skill-name>.
    Compatibilità Descrivere i requisiti, le dipendenze e i prerequisiti per l'uso della competenza (ad esempio, software o strumenti necessari, ad esempio git, docker, linguaggi di programmazione; requisiti di sistema; requisiti di accesso alla rete; Chiavi API o requisiti di autenticazione.
    Strumenti consentiti Selezionare + Aggiungi strumento per specificare le API o i server MCP dall'inventario API a cui può accedere questa competenza. Questo approccio consente di garantire la governance e la sicurezza appropriate definendo in modo esplicito le risorse che possono essere usate dalla competenza.
    Licenza Selezionare + Aggiungi per fornire informazioni sulle licenze. Immettere il nome della licenza( ad esempio MIT, Apache 2.0 o Proprietario), specificare facoltativamente un URL di licenza e aggiungere una descrizione, se necessario, per chiarire le condizioni di licenza o le restrizioni.
    Informazioni contatto Selezionare + Aggiungi per aggiungere punti di contatto per assistenza o richieste. Immettere un nome o un ruolo di contatto (ad esempio, team API o John Smith), specificare i dettagli di contatto, ad esempio l'indirizzo di posta elettronica e, facoltativamente, aggiungere una descrizione per chiarire quando e perché contattare questa persona o team.

  5. Selezionare Crea per registrare la competenza nel centro API.

Dopo la registrazione, la competenza viene visualizzata nell'inventario alla pagina Inventario>Asset.

Aggiornare una competenza registrata

È possibile aggiornare le informazioni sulle competenze in qualsiasi momento:

  1. Nel tuo centro API, vai su Inventario>Asset.
  2. Trovare e selezionare la competenza da aggiornare.
  3. Selezionare Modifica per modificare le proprietà della competenza.
  4. Apportare le modifiche e selezionare Salva.

Sincronizzare le competenze da un repository Git

Per automatizzare la registrazione delle competenze e mantenere aggiornato l'inventario, è possibile integrare un repository Git con il centro API. Per altre informazioni, vedere Sincronizzare gli asset dell'API da un repository Git.

Individuare le competenze nel portale di Centro API

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

  • Esplorare e filtrare le competenze nell'inventario.
  • Visualizzare informazioni dettagliate su ogni competenza.

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.

Contenuti correlati

  • Last updated on