Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Le competenze in Microsoft 365 Copilot Chat sono disponibili a livello generale. Una competenza include istruzioni specifiche per attività, criteri di qualità e file o script di supporto facoltativi in modo che gli utenti non debbano ripetere lo stesso flusso di lavoro in ogni conversazione.
È possibile creare una competenza da usare direttamente in Copilot Chat senza creare un agente dichiarativo. Gli utenti possono selezionare una competenza installata in modo esplicito o lasciare che Copilot la selezioni automaticamente quando è rilevante. Gli utenti controllano la chiamata automatica per ogni competenza.
Importante
Nei tenant che usano Barriere informative Microsoft Purview (IB), le competenze non sono supportate in Copilot Chat. Questa restrizione si applica alle competenze personali e alle competenze distribuite come parte di un plug-in.
Scegli l'ambito della competenza
| Destinazione | Percorso di creazione e distribuzione |
|---|---|
| Una competenza personale usata direttamente in Copilot Chat | Creare un file autonomo SKILL.md o uno zip di competenza. Gli utenti possono anche creare e modificare competenze personali con Copilot Chat. |
| Una competenza distribuita come parte di un plug-in | Usa gli strumenti di sviluppo di Work IQ per creare un pacchetto di app Microsoft 365, quindi usa un metodo di condivisione o pubblicazione supportato. |
Crea una competenza personale
Suggerimento
Se hai intenzione di creare un pacchetto della tua competenza come plug-in, segui invece i passaggi descritti in Creare un pacchetto di una competenza in un plug-in . Gli strumenti di sviluppo di Work IQ automatizzano la maggior parte dei passaggi di questa sezione.
Ogni abilità richiede un file chiamato SKILL.md. Aggiungere risorse facoltative e script solo quando l'attività li richiede.
release-notes/
|-- SKILL.md
|-- references/
| `-- release-note-format.md
`-- scripts/
`-- format_release_notes.py
Iniziare SKILL.md con la parte introduttiva YAML contenente un nome e una descrizione. Per le competenze del plug-in WIQD, il nome deve corrispondere esattamente alla cartella contenitore. Usare caratteri alfanumerici minuscoli e trattini da 1 a 64, senza trattini iniziali, finali o consecutivi. La descrizione può contenere da 1 a 1.024 caratteri e dovrebbe identificare le richieste che attivano la competenza.
Ad esempio:
---
name: release-notes
description: Draft release notes or a changelog from a supplied list of changes, grouped into Features, Fixes, and Other.
---
# Release notes
Use this skill when the user asks for release notes or a changelog.
1. Use the change list supplied by the user. If it is missing, ask for it.
2. Group the changes into Features, Fixes, and Other.
3. Use references/release-note-format.md for the output structure.
4. Preserve issue and pull request links from the supplied input.
5. Don't invent changes, links, version numbers, or release dates.
6. Return the draft and identify any missing information.
Includi ogni file le istruzioni di riferimento. Ad esempio, se aggiungi uno script di formattazione, spiega quando eseguirlo, quali input accetta e come gestire gli errori. Mantieni credenziali, token e segreti fuori dalla competenza.
Linee guida per la progettazione
Mantieni focalizzato sulla competenza
- Assegna all'abilità un lavoro definito, con input, output e limiti chiari.
- Includi frasi nella descrizione che gli utenti potrebbero usare per quel lavoro.
- Mantieni
SKILL.mdmeno di 20.000 caratteri come suggerimento per la creazione. Sposta il materiale di riferimento dettagliato nei file di supporto e spiega quando leggerli. - Mantieni la directory poco profonda e includi solo i file necessari per l'attività. Conferma il numero di file, la profondità delle directory e i limiti di dimensione del pacchetto per ogni host di destinazione.
Aggiungere le risorse e gli script supportati
Usa i tipi di file supportati dal runtime delle competenze di Chat:
| Categoria | Tipi di file |
|---|---|
| Istruzioni e file di risorse |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .txt, .rtf, .md, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| Lettere in corsivo |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
Le competenze di chat e quelle collegate all'agente hanno percorsi di caricamento distinti. Non applicare i limiti di Generatore di agenti e Toolkit agenti al caricamento di una competenza di chat personale.
Rispettare il limite di runtime degli script
Script delle competenze:
- Non è possibile accedere a Internet o alla rete in fase di esecuzione.
- Impossibile installare i pacchetti in fase di esecuzione.
- Può usare solo i pacchetti già disponibili nel runtime.
- Non è possibile effettuare chiamate di rete autenticate.
Quando un'attività richiede dati o azioni esterne, fare in modo che Copilot richiami un connettore abilitato o un'altra funzionalità esterna supportata. Non inserire le chiamate di rete in uno script di competenza come sostituto.
Per un plug-in che include un connettore MCP remoto, usa la configurazione del manifesto dell'app agentConnectors . Nelle istruzioni sulle competenze spiegare quando e perché Copilot deve usare il connettore. La configurazione della connessione e le autorizzazioni utente rimangono separate dalle istruzioni dell'abilità.
Account per la protezione dei dati
I file di competenze chat caricati vengono archiviati in contenitori SharePoint Embedded con ambito tenant. Le etichette di riservatezza vengono mantenute e i criteri di etichetta vengono rispettati. Le autorizzazioni definite dall'utente e la crittografia a doppia chiave non sono supportate.
Esaminare le istruzioni, le risorse, gli script, l'accesso ai dati e gli output rispetto ai requisiti dell'organizzazione. Usa i dati del piano, la privacy e la sicurezza per la soluzione più ampia.
Carica la competenza
Per un caricamento diretto delle competenze, fornisci SKILL.md da solo o un file ZIP con SKILL.md alla radice e tutti i file di supporto sottostanti. Non includere una directory di inclusione aggiuntiva nel SKILL.md file ZIP.
In Copilot Chat, selezionare Agenti>Altri agenti. Seleziona l'elenco a discesa accanto ad Aggiungi e seleziona Carica competenza.
Aggiungere il file SKILL.md o ZIP e selezionare Carica.
Creare un pacchetto di una competenza in un plug-in
Work IQ Dev Tools fornisce un flusso di lavoro pro-codice per la creazione, la convalida, il provisioning, la creazione di pacchetti e la condivisione di un plug-in basato sulle competenze.
Seguire i prerequisiti di installazione e autenticazione di WIQD in Creare un plug-in.
Crea un progetto di plug-in e aggiungi una competenza:
wiqd plugin create --name release-notes-plugin Set-Location release-notes-plugin wiqd plugin add skill --name "Release Notes"Modificate le risorse o gli script generati e aggiungete le risorse o gli script a
appPackage/skills/release-notes/SKILL.mdcui si fa riferimento, seguendo le indicazioni riportate nelle linee guida per la progettazione.Seguire il flusso di lavoro di WIQD per eseguire il provisioning dell'ambiente previsto, creare il pacchetto del plug-in e convalidare lo ZIP effettivamente compilato. La sola convalida dell'origine non ispeziona il contenuto delle competenze o dimostra il comportamento di runtime.
Pubblicare o condividere il plug-in e renderlo disponibile agli utenti previsti.
Nota
Il manifesto dell'app Microsoft 365 registra le competenze a livello di plug-in tramite agentSkills. Un agente dichiarativo fa riferimento alle sue competenze nell'ambito dell'agente attraverso agent_skills il manifesto dell'agente dichiarativo. Non scambiare queste proprietà e non dare per scontato che la dichiarazione di un'abilità su una superficie la registri anche sull'altra.
Per le regole di formato, i dettagli del manifesto e i vincoli specifici dell'host, vedere la guida di riferimento per la creazione di plug-in WIQD. Una competenza destinata sia alla chat che al cowork deve soddisfare i requisiti di entrambi gli host.
Individuazione e chiamata di test
Testare la competenza installata in ogni esperienza di Microsoft 365 che si intende supportare:
- Conferma che un utente previsto può trovare e selezionare la competenza.
- Seleziona esplicitamente la competenza, fornisci un input rappresentativo e controlla l'output e i file di supporto.
- Abilita la chiamata automatica e usa una richiesta che corrisponda alla descrizione della competenza. Conferma che Copilot selezioni la competenza desiderata.
- Disattiva la chiamata automatica e verifica che l'abilità non venga selezionata automaticamente. La selezione esplicita è un caso d'uso separato.
- Verificare la mancanza di input, le richieste ambigue, gli strumenti non disponibili e gli errori di script. Assicurarsi che la risposta identifichi il problema anziché restituire silenziosamente un risultato incompleto.
- Se il plug-in include altre funzionalità, testarle insieme. Verificare che il connettore o lo strumento MCP previsto sia effettivamente richiamato.
- Se si supportano sia la chat che Cowork, verificare l'individuazione, l'installazione e l'esecuzione in entrambe. Non dedurre la disponibilità o il supporto per la modifica in un prodotto da un test riuscito nell'altro.
Pubblicazione, distribuzione, condivisione e installazione sono passaggi distinti. Verificare l'esperienza installata per il gruppo di destinatari previsto anziché considerare il caricamento di un pacchetto completato come prova che l'abilità è individuabile.