Aggiungere competenze all'agente dichiarativo in Generatore di agenti

Una competenza è un componente modulare e riutilizzabile che viene aggiunto a un agente dichiarativo per aiutarlo a svolgere una specifica attività pacchettizzata. Una competenza è una directory che contiene un file obbligatorio SKILL.md con le istruzioni, oltre a file di risorse e script facoltativi. Questo articolo descrive come aggiungere una competenza a un agente integrato in Agent Builder, descrivendo la competenza in linguaggio naturale o caricando un pacchetto di competenze.

Per informazioni su cosa sono le competenze, perché utilizzarle e la matrice di supporto completa, i tipi di file supportati, il comportamento sandbox e la governance, vedere Competenze negli agenti dichiarativi.

Per una competenza personale utilizzata direttamente in Copilot Chat senza un agente, vedere Creare competenze per Copilot Chat. I passaggi e i limiti di caricamento in questo articolo si applicano a Generatore agenti, non ai caricamenti di Chat personali.

Importante

Nei tenant che usano Barriere informative Microsoft Purview (IB), gli amministratori possono distribuire agenti dichiarativi con competenze, ma gli utenti finali non possono aggiungere competenze agli agenti dichiarativi che creano.

Prerequisiti

  • Un abbonamento a Microsoft 365 idoneo che fornisce l'accesso a Microsoft 365 Copilot Chat. Non è necessaria una licenza per componente aggiuntivo di Microsoft 365 Copilot. Alcune funzionalità degli agenti richiedono una licenza di Microsoft 365 Copilot o il pagamento in base al consumo. Per informazioni dettagliate, vedere Funzionalità degli agenti e modelli di licenza.

Nota

In Agent Builder puoi aggiungere fino a otto competenze per agente e ogni pacchetto di competenze è un file compresso .zip fino a 50 MB. Per la matrice di supporto completa e i limiti, vedere Competenze negli agenti dichiarativi.

Creare una competenza da una descrizione

Puoi chiedere al generatore di agenti di creare un'abilità riutilizzabile da una descrizione in linguaggio naturale.

  1. Nella chat di Copilot, selezionare Agenti & Competenze, quindi selezionare Nuovo agente.

  2. Selezionare la casella di testo Generatore agente messaggio e chiedere a Generatore agente di creare un flusso di lavoro riutilizzabile.

    Create an agent that helps my team write release notes. Add a reusable skill that always follows the same steps:
    
    1. Takes a list of merged changes (a pasted list or an uploaded  .csv  of PR titles).
    2. Groups them into Features, Fixes, and Other.
    3. Runs a script to format them into a clean Markdown changelog with a version heading and today's date.
    
    Package this as a skill with clear instructions and the formatting script so the output looks the same every time.
    

    Screenshot del prompt di Generatore di agenti per creare un agente

  3. Nella scheda Configura conferma che è stata creata una competenza.

    Screenshot della scheda Configura in Generatore di agenti che mostra una competenza collegata

  4. Seleziona la funzionalità per esaminarne i dettagli.

    Screenshot dei dettagli della nuova competenza aggiunta

Se la competenza non viene aggiunta, è possibile aggiungerla esplicitamente caricando un pacchetto di competenze.

Carica un pacchetto di competenze

Per aggiungere un pacchetto di competenza, crealo prima e caricalo in Generatore agenti.

Crea il tuo pacchetto di competenze

Prima di aggiungere una competenza in Agent Builder, impacchetta la competenza in un .zip file che contiene:

  • File obbligatorio SKILL.md .
  • Un nome di competenza e una descrizione nella SKILL.md parte introduttiva di YAML.
  • File di risorse supportati facoltativi.
  • Script supportati facoltativi e cartelle di supporto.
  • Istruzioni di abilità inferiori a 20.000 caratteri.

Il pacchetto è simile alla seguente struttura di directory:

my-skill.zip
|-- SKILL.md              # required
|-- <resource files>      # optional
`-- <scripts or folders>  # optional

Per i tipi di file e script supportati, vedere Tipi di file e script supportati.

Importante

Caricare il pacchetto completo .zip . Non caricare SKILL.md da solo.

Carica il pacchetto di competenze

  1. Apri o crea un agente dichiarativo in Generatore di agenti.

  2. Nella scheda Configura , espandi Competenze, quindi seleziona Aggiungi.

    Screenshot del pulsante Aggiungi nella sezione Competenze del riquadro Configura di Generatore di agenti

  3. Carica il pacchetto completo .zip di competenze.

  4. Esamina il nome dell'abilità, la descrizione, le istruzioni e i file inclusi.

  5. Nella scheda Prova, prova un prompt che dovrebbe usare la competenza.