Competenze negli agenti dichiarativi

Questo articolo illustra le competenze associate a un agente dichiarativo. Per creare una competenza da utilizzare direttamente in Microsoft 365 Copilot Chat senza creare un agente, vedere Creare competenze per Copilot Chat. La matrice di supporto in questo articolo si applica alle competenze con ambito agente, non a tutte le competenze o i pacchetti di plug-in.

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.

Una competenza è una funzionalità modulare che viene aggiunta a un agente dichiarativo per consentirgli di eseguire un'attività specifica in modo più affidabile e ripetibile. Una competenza è una directory di file che contiene un file obbligatorio SKILL.md , oltre a file di risorse e script facoltativi. Il SKILL.md file contiene le istruzioni che indicano al modello di completare l'attività.

Le abilità sono una componente distinta di un agente dichiarativo. Nelle linee guida precedenti, la parola abilità si riferiva a descrizioni di attività scritte in linea all'interno delle istruzioni di un agente. Le competenze sostituiscono questo approccio: invece di scrivere i dettagli dell'attività direttamente nelle istruzioni, li impacchettate come componente separato a cui fa riferimento l'agente. Per indicazioni su come le istruzioni dovrebbero fare riferimento alle competenze, vedere Scrivere istruzioni efficaci per gli agenti dichiarativi.

Puoi aggiungere competenze a un agente dichiarativo usando Generatore di agenti. Per gli scenari pro-code supportati, si consiglia Work IQ Dev Tools . Il suo wiqd agent add skill percorso richiede il flag della agent-skills funzione, che è disattivato per impostazione predefinita. Vedi Scegliere il percorso di implementazione della competenza. La procedura dettagliata basata su Toolkit rimane disponibile per i progetti Toolkit esistenti.

Che cos'è un'abilità

Una competenza è una directory con il seguente contenuto:

  • Un file necessario SKILL.md che contenga:
    • Un nome di competenza e una descrizione nella parte introduttiva di YAML.
    • Istruzioni per le abilità, che devono contenere meno di 20.000 caratteri.
  • File di risorse facoltativi, ad esempio modelli, dati di riferimento o definizioni.
  • Script facoltativi e cartelle di supporto.

Ad esempio, un team finanziario potrebbe creare una competenza di revisione aziendale trimestrale che raggruppa le istruzioni per la produzione della revisione, gli script che trasformano i dati e generano grafici e asset come modelli finanziari, definizioni KPI e modelli di diapositive con marchio. L'agente usa la skill quando un utente chiede quell'attività.

Perché usare le competenze negli agenti dichiarativi

Le competenze consentono di creare flussi di lavoro degli agenti più affidabili e ripetibili:

  • Utilizzo ottimizzato del contesto e maggiore precisione. Le abilità utilizzano la divulgazione progressiva: il modello carica le istruzioni e i contenuti di un'abilità nel contesto solo quando l'attività li richiede. Il contesto dell'agente rimane focalizzato anche se la sua libreria di competenze cresce. Fornire script, anziché basarsi sul codice generato dal modello, offre anche una maggiore ripetibilità dei flussi di lavoro.
  • Ridimensiona le istruzioni senza perdita di qualità. È possibile scomporre istruzioni complesse in competenze modulari e riutilizzabili. Questo approccio consente di fornire indicazioni più lunghe e specifiche senza compromettere la qualità di seguire le istruzioni e senza incorrere nel limite di 8.000 caratteri per le istruzioni dell'agente dichiarativo.
  • Impacchettare le risorse riutilizzabili. È possibile creare pacchetti di istruzioni, risorse e script insieme come competenza e integrare tale funzionalità nell'agente dichiarativo.
  • Pronto per l'azienda. Gli script vengono eseguiti in una sandbox sicura, le etichette di riservatezza sui file delle competenze vengono mantenute e rispettate e la governance dell'amministratore è disponibile.

Matrice di supporto

Alcuni limiti variano a seconda che tu aggiunga la skill con Agent Builder o con Agents Toolkit.

Nella tabella seguente vengono descritti questi due percorsi di creazione, non i limiti di WIQD o la copertura delle funzionalità. Per la route pro-code consigliata, verificare i requisiti correnti nella documentazione di WIQD.

Item Generatore di agenti Toolkit per agenti
Competenze massime per agente 8 8
Pacchetto di competenze Compresso .zip, massimo 50 MB Directory delle competenze; .zip non è supportato
Dimensioni massime del file 25 MB per file Nessun limite di livello di abilità; Il pacchetto completo dell'app è limitato a 10 MB
Numero massimo di file per pacchetto 350 file per tutte le competenze 350 file per tutte le competenze
Creare una competenza da singoli caricamenti Non supportato; Carica il file completo .zip Aggiungere o importare la directory completa delle competenze
Gerarchia di directory La profondità massima della directory è 3 La profondità massima della directory è 3
Riutilizza tra gli agenti Non supportate Non supportato

Tipi di file e script supportati

Una competenza può includere i seguenti tipi di file:

Categoria Tipi di file
Istruzioni e file di risorse .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Script e file binari .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Sandbox per l'esecuzione di script

Gli script delle competenze vengono eseguiti in una sandbox sicura con i seguenti limiti:

Funzionalità Supporto tecnico
Accesso a Internet o alla rete da script Non supportate. La sandbox non ha accesso alla rete in fase di esecuzione.
Installazione del pacchetto Non supportate. Una skill non può installare pacchetti in fase di esecuzione.
Chiamate di rete autenticate da script Non supportate.
Pacchetti preinstallati Una skill può utilizzare pacchetti già presenti nella sandbox. Non dipendere da un pacchetto a meno che la sua disponibilità non sia confermata.
Connettori, plug-in API e server MCP L'agente può usare le funzionalità abilitate tramite l'agente di orchestrazione. Gli script non possono chiamarli tramite la sandbox.

Riservatezza e archiviazione

Item Supporto tecnico
Etichette sulla riservatezza La sandbox conserva le etichette di riservatezza e rispetta i criteri di etichetta. Non supporta le autorizzazioni definite dall'utente o la crittografia a doppia chiave.
Spazio di archiviazione Il sistema archivia i file di competenze caricati in contenitori SharePoint Embedded con ambito tenant.