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.
Usa gli strumenti di sviluppo di Work IQ con l'origine locale per un agente dichiarativo esistente per convalidarlo, eseguirne il provisioning, creare pacchetti e condividerlo come plug-in. Questa guida introduttiva parte da un progetto di origine esistente, non da un nuovo scaffolding agente.
Questa procedura dettagliata non crea un nuovo agente né ricostruisce l'origine da un agente installato. Se invece stai avviando un nuovo plug-in, segui Crea un plug-in con gli strumenti di sviluppo di Work IQ.
Suggerimento
Guarda Work IQ Dev Tools creare un plug-in Copilot da una richiesta e pubblicarlo nell'Archivio agenti nella demo interattiva.
Prerequisiti
- Interfaccia della riga di comando di GitHub Copilot con un abbonamento Copilot attivo
- Plug-in dell'assistente codifica WIQD per l'interfaccia della riga di comando di GitHub Copilot (vedere i comandi di installazione in questa sezione)
- Node.js 24.15 o versione successiva e npm, disponibile sulla
PATHtua , per l'interfaccia della riga di comando WIQD e lo script di installazione - PowerShell 7 o versione successiva (solo Windows)
- Un account Microsoft 365 con accesso a Copilot
- Caricamento di app personalizzate abilitato nel tenant
- Progetto di origine agente dichiarativo supportato
Dopo aver installato l'interfaccia della riga di comando di GitHub Copilot, installa il plug-in dell'assistente alla codifica WIQD:
copilot plugin install wiqd@awesome-copilot
In alternativa, aggiungi il marketplace WIQD e installa il plug-in da qui:
copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd
Installare l'interfaccia della riga di comando di WIQD usando lo script di installazione.
Avviare una nuova sessione dell'interfaccia della riga di comando di GitHub Copilot dopo l'installazione.
Il plug-in coding-assistente fornisce indicazioni per la creazione; non installa l'interfaccia wiqd della riga di comando. Installare l'interfaccia della riga di comando separatamente prima di eseguire i comandi di convalida e ciclo di vita. Confermare l'installazione CLI e wiqd --version verificarne i prerequisiti con wiqd doctor.
Verificare di avere un progetto iniziale supportato
Iniziare dalla cartella radice di un progetto di origine agente dichiarativo locale. La cartella deve contenere almeno:
contoso-support-agent/
|-- appPackage/
| |-- manifest.json
| |-- declarativeAgent.json
| `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>
Il file del ciclo di vita può essere m365agents.yml, m365agents.local.yml, teamsapp.ymlo teamsapp.local.yml. Il progetto può contenere altre cartelle e file di ambiente.
Questa guida introduttiva non si applica quando:
- Hai solo un agente pubblicato o un pacchetto installato e nessun progetto di origine locale. Gli strumenti di sviluppo di Work IQ non supportano la ricostruzione del progetto di origine da un titolo distribuito. Ripristinare il repository di origine originale o usare lo strumento di creazione originale.
- L'agente esiste solo in un'esperienza di creazione gestita, ad esempio Agent Builder o Copilot Studio. Usa la procedura di pubblicazione e condivisione di questo strumento.
- Si dispone di un agente motore personalizzato. Questo percorso Work IQ Dev Tools supporta gli agenti dichiarativi.
- Hai solo un pacchetto
.zipagente . I comandi del ciclo di vita richiedono il progetto di origine e il relativo file del ciclo di vita.
Se non si ha un progetto esistente, iniziare con la guida introduttiva di WIQD per creare un plug-in e aggiungere un agente dichiarativo. WIQD è il punto di partenza pro-code consigliato per gli scenari supportati.
Nota
wiqd plugin importimporta i formati di plug-in Open Plugin, Claude o Cursor plug-in supportati. Non importa un progetto o un pacchetto di agente dichiarativo di Microsoft 365 esistente. Per altre informazioni, vedere Importazione/esportazione (interoperabilità).
Creare il plug-in
Se non l'hai già fatto, installa gli strumenti di sviluppo di Work IQ.
Aprire l'interfaccia della riga di comando nella directory in cui si vuole creare il plug-in e accedere usando il comando seguente:
wiqd auth login --interactiveNell'interfaccia della riga di comando, avviare GitHub Copilot usando il
copilotcomando.Chiedi a GitHub Copilot di creare un plug-in con il tuo agente dichiarativo, la tua competenza o il tuo server MCP esistente. Ad esempio:
Create a plugin named My Plugin by using the agent in "..\My Agent"
Convalidare il progetto del plug-in
Seleziona esplicitamente la convalida dell'origine offline prima di effettuare il provisioning o creare un pacchetto del plug-in. Nell'interfaccia della riga di comando di GitHub Copilot, chiedi:
Validate the plugin source offline in the dev environment
Effettuare il provisioning del plug-in
Importante
Questo esempio usa l'ambiente condiviso dev standard. Controlla la configurazione effettiva del ciclo di vita e il file di ambiente selezionato in environmentFolderPath (impostazione predefinita env) per AGENT_SCOPE=shared prima del provisioning per la condivisione. Un ambiente denominato dev da solo non stabilisce un ambito condiviso. Mantenere lo stesso ambiente per il provisioning, la creazione di pacchetti, la convalida e la condivisione.
Chiedi a GitHub Copilot di eseguire il provisioning del plug-in.
Provision the plugin using the dev environment
Attendere il completamento del provisioning. Il provisioning non stabilisce che tutte le funzionalità del plug-in siano disponibili in Copilot Chat; il supporto dipende dal componente e dall'esperienza di destinazione di Microsoft 365.
Creare un pacchetto del plug-in
Chiedi a GitHub Copilot di creare il pacchetto del plug-in.
Package the plugin using the dev environment
Importante
È necessario eseguire il provisioning del plug-in prima di creare il pacchetto. Se si esegue il pacchetto prima del provisioning, il pacchetto risultante non è valido.
Convalidare il pacchetto
Dopo la creazione del pacchetto, individuare lo ZIP generato e verificare che il file esista. Nell'interfaccia della riga di comando di GitHub Copilot, fornisci il percorso effettivo e chiedi:
Validate this existing plugin ZIP in package mode using the dev environment
La convalida del --mode package pacchetto utilizza e uno ZIP esistente fornito tramite --package-file, non una compilazione automatica. Esamina il verdetto restituito e i risultati. Codice di uscita 0 indica che i controlli selezionati sono stati superati; gli avvisi possono comunque essere segnalati. Il blocco dei risultati o dei risultati incompleti non è un passaggio e la convalida del pacchetto non dimostra il comportamento di runtime.
Le modalità di convalida correnti sono source, package, e marketplace.
source è il controllo offline esplicito. L'impostazione predefinita, package, richiede un file ZIP esistente, carica una copia acquisita nel servizio di convalida di Microsoft 365 e potrebbe richiedere l'autenticazione.
marketplace aggiunge controlli delle politiche e delle prove; Non è l'approvazione ufficiale del negozio. La convalida non crea automaticamente uno zip o non esegue automaticamente l'accesso o il provisioning del plug-in. Per informazioni dettagliate, vedere Convalida e MVL.
Condividere il plug-in
Ora puoi chiedere a GitHub Copilot di condividere la distribuzione del plug-in con utenti specifici all'interno dell'organizzazione o con l'intera organizzazione. Confermare AGENT_SCOPE=shared nell'ambiente selezionato prima di condividere. Il gruppo di destinatari condiviso (--scope users o --scope tenant) non modifica l'ambito della distribuzione.
Share the plugin with AmberR@contoso.com using the dev environment
Oppure:
Share the plugin with my organization using the dev environment
Importante
La condivisione di plug-in personalizzati dipende dalle impostazioni dell'organizzazione per consentire o bloccare la condivisione di plug-in. Se si verificano errori durante questo passaggio, contatta gli amministratori. Per ulteriori informazioni, vedere Impostazioni di condivisione e pubblicazione degli agenti.
Pubblicare il plug-in nel registro dei plug-in dell'organizzazione
Invece di condividere il plug-in, è possibile richiedere di pubblicarlo nel registro dei plug-in dell'organizzazione. Gli amministratori dell'organizzazione possono esaminare il plug-in e approvare o rifiutare la richiesta.
Submit my plugin to the organization catalog for admin approval using the dev environment
La condivisione garantisce l'accesso diretto; L'invio del catalogo è un'operazione separata e non è l'approvazione dell'amministratore o l'installazione utente completata.
Eliminare il pacchetto (facoltativo)
Se questo plug-in è solo un plug-in di test, chiedi a GitHub Copilot di rimuovere il plug-in. Questa azione elimina tutte le risorse cloud di cui è stato effettuato il supplizio.
Delete the plugin using the dev environment