Creare o riutilizzare le competenze

Se disponi di un'attività ripetibile e di un'esperienza Microsoft di destinazione, usa questo articolo per decidere se creare una competenza o adattare il contenuto di una competenza esistente. Quindi, scegliere i passaggi di creazione del prodotto. Sei in Crea o riutilizza. Il risultato è un'implementazione delle competenze con le relative dipendenze e prove di test, pronta per l'integrazione prima del & test del pacchetto.

Riutilizza o estendi una competenza

Per gli agenti dichiarativi, Generatore di agenti e Toolkit agenti non supportano il riutilizzo tra gli agenti. Segui la matrice di supporto in Competenze negli agenti dichiarativi; Non dare per scontato che una competenza collegata a un agente possa essere condivisa con un altro.

Prima di creare una competenza:

  1. Esaminare le competenze approvate che eseguono già il lavoro richiesto.
  2. Verificare che l'agente di destinazione o l'esperienza Microsoft supporti il formato dell'abilità e le funzionalità.
  3. Esamina le istruzioni, le risorse, gli script, gli strumenti e l'accesso ai dati.
  4. Controlla i limiti di riutilizzo documentati dell'esperienza di destinazione prima di adattare il contenuto dell'abilità esistente.
  5. Conferma la proprietà, il controllo delle versioni, la condivisione, il supporto e le aspettative di aggiornamento.
  6. Testa l'abilità con input rappresentativi e output previsti.

Crea una nuova competenza quando nessuna competenza approvata esistente soddisfa il requisito o l'esperienza di destinazione non supporta il riutilizzo.

Scegliere il percorso di implementazione

Inizia con gli strumenti di sviluppo di Work IQ per lo sviluppo professionale. Scegli il percorso per l'esperienza di destinazione e il tipo di progetto; Un formato condiviso SKILL.md non stabilisce l'idoneità al riutilizzo o alla pubblicazione tra agenti.

Approccio allo sviluppo Artefatto e ambito dell'abilità Inizia con
Strumenti di sviluppo di Work IQ Una cartella di competenze di primo livello in un plug-in autonomo o una competenza aggiunta a un progetto agente dichiarativo esistente. Si tratta di percorsi di creazione separati. Crea un plug-in con gli strumenti di sviluppo di Work IQ e i dettagli del percorso di seguito
Creazione di competenze e distribuzione di plug-in in Copilot Chat Segui le indicazioni per la creazione e la distribuzione specifiche del prodotto. Crea competenze per Copilot Chat
Generatore di agenti Una competenza ZIP completa caricata in un agente dichiarativo o una competenza creata da una descrizione in Agent Builder. Aggiungi competenze con Generatore di agenti
Toolkit per agenti di Microsoft 365 Una directory di competenze aggiunta a un progetto di agente dichiarativo esistente, non un file ZIP di competenza autonomo. Aggiungere competenze con Agents Toolkit
Copilot Cowork Cartelle delle competenze registrate in un pacchetto dell'app Microsoft 365. Usare i requisiti e i limiti del pacchetto Cowork. Creare plug-in per Copilot Cowork

Abbinare l'artefatto alla relativa route di pubblicazione

Segui le indicazioni per la pubblicazione del tuo artefatto:

Il supporto per un artefatto non stabilisce l'idoneità alla pubblicazione per ogni pacchetto di plug-in. La pubblicazione non completa l'accesso dell'utente, il consenso o la configurazione della connessione.

GitHub Copilot può fornire assistenza con istruzioni sulle competenze, script di supporto, risorse, test e modifiche al repository. L'esperienza di destinazione e lo strumento di creazione determinano il formato delle competenze e il runtime supportati.

Strumenti di sviluppo di Work IQ

WIQD offre due diversi percorsi di creazione di competenze.

  • wiqd plugin add skill Aggiunge una competenza di alto livello a un progetto di plug-in autonomo. Il plug-in può essere di sola competenza o combinare la competenza con agenti supportati o connettori MCP remoti. Verifica separatamente il supporto del prodotto di destinazione.
  • wiqd agent add skill Aggiunge una competenza a un progetto agente dichiarativo esistente. Questa route utilizza il flag della agent-skills funzione, che è disattivato per impostazione predefinita.

Entrambe le route creano una SKILL.mdfunzionalità basata su , ma funzionano su tipi di progetto diversi. Nel formato del plug-in WIQD, il nome dell'abilità deve corrispondere al nome della cartella e la sua descrizione deve includere le frasi che la attivano. Consulta Cos'è un plug-in? e la documentazione di riferimento per la creazione di plug-in.

La convalida della fonte WIQD (wiqd plugin validate --mode source) non controlla il contenuto delle competenze. Dopo l'imballaggio, eseguire wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" con il percorso ZIP effettivo. La convalida del pacchetto carica una copia acquisita di tale file ZIP nel servizio di convalida Microsoft 365 e potrebbe richiedere l'autenticazione. Esaminare i risultati restituiti; Un passaggio non stabilisce il comportamento di runtime. Vedere Convalida e MVL.

Implementa la competenza

Completare il lavoro applicabile:

  1. Definisci il processo, gli input, gli output previsti, i limiti e i criteri di successo.
  2. Crea o importa le istruzioni per la competenza.
  3. Aggiungere le risorse di supporto e gli script necessari.
  4. Configurare qualsiasi strumento richiesto, server MCP remoto, API, identità, autorizzazione o dipendenza dei dati.
  5. Verificare i tipi di file supportati, i tipi di script, il comportamento della sandbox, l'archiviazione e i requisiti di riservatezza.
  6. Testare scenari previsti, ambigui, non supportati e di errore.
  7. Registra la versione della competenza, il proprietario, le dipendenze, le limitazioni note e il processo di supporto.

Per le competenze usate direttamente in Copilot Chat, vedere Creare competenze per Copilot Chat. Per i vincoli di supporto e runtime correnti negli agenti dichiarativi, vedere Competenze negli agenti dichiarativi. Per Copilot Cowork, vedere Limiti dei file complementari. Applica i requisiti di ogni host di destinazione quando distribuisci una competenza a più di un'esperienza.

Conferma che l'abilità funzioni

La competenza è pronta per l'integrazione quando:

  • L'agente o l'esperienza di destinazione può caricarlo e usarlo.
  • Le sue istruzioni eseguono il lavoro definito in modo coerente.
  • Sono disponibili le risorse, gli script, gli strumenti e i dati necessari.
  • Le autorizzazioni e le dipendenze esterne funzionano nell'ambiente di sviluppo o di test.
  • Le operazioni non supportate o non riuscite producono un comportamento comprensibile.
  • Proprietà, controllo delle versioni, limitazioni e prove di test vengono registrati.

Continua con qualsiasi altro componente del piano. Quando sono completi, integra e testa i tuoi componenti, quindi passa a Pacchetto & test per creare il pacchetto del plug-in.