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.
Durante la compilazione o il riutilizzo, implementare il componente agente dichiarativo selezionato nel piano dei componenti. Questo articolo consente di scegliere la procedura di utilizzo del prodotto e verificare l'idoneità del componente. Concludi con un agente funzionante, le sue dipendenze e le prove di test per l'integrazione del plug-in.
Non hai bisogno di un agente per ogni plugin. Per orchestrazione, modelli, hosting o runtime personalizzati, seguire invece il percorso dell'app .
Controllare un agente esistente prima di crearne uno
Esaminare gli utenti previsti dell'agente esistente, le esperienze supportate, le istruzioni, le conoscenze, le azioni, le autorizzazioni e le limitazioni note con il suo proprietario.
Verifica: Le sue funzionalità documentate corrispondono all'esperienza dell'attività e dell'obiettivo nel piano dei componenti.
Selezionare il percorso di riutilizzo o estensione documentato del prodotto. È possibile iniziare con un modello di agente o copiare un agente Generatore di agenti in Copilot Studio quando il flusso di lavoro è adatto.
Verifica: Il percorso supporta l'origine e la destinazione. Non date per scontato che l'aggiunta di un componente agente a un plugin importi un progetto esistente.
Concordare la proprietà, il controllo delle versioni, il supporto e la gestione delle modifiche, quindi testare le attività rappresentative.
Verifica: Registrare i risultati e i gap non risolti prima di decidere se utilizzare l'agente non modificato, configurarlo o creare un nuovo componente.
Inizia con gli strumenti di sviluppo di Work IQ
Per lo sviluppo professionale, inizia con gli strumenti di sviluppo di Work IQ, scegli un ambiente documentato e aggiungi Agents Toolkit solo quando il tuo componente necessita di controlli di progetto specifici.
| Il tuo punto di partenza | Procedura del prodotto | Risultato previsto |
|---|---|---|
| Un nuovo plugin che necessita di un componente agente | Creare un plug-in con gli strumenti di sviluppo di Work IQ |
wiqd plugin create crea il contenitore; wiqd plugin add agent Impalcatura del componente agente facoltativo. |
| Progetto di origine agente dichiarativo esistente | Ciclo di vita dei componenti dell'agente | Continuare l'authoring e l'iterazione specifici dell'agente con i comandi documentati wiqd agent . |
| Istruzioni dell'agente, conoscenze o azioni da modificare | Agenti dichiarativi in WIQD e riferimento ai comandi | Origine salvata configurata per il componente e l'ambiente selezionati. |
Utilizzare il plug-in WIQD coding-assistente per il lavoro guidato o la CLI diretta per i comandi ripetibili. Installare il plug-in dell'assistente alla codifica e l'interfaccia della riga di comando come prerequisiti separati, quando necessario. GitHub Copilot consente di creare file, istruzioni, configurazioni e test, senza sostituire i requisiti dello strumento di creazione, del runtime o dei componenti.
Per un progetto agente esistente, seleziona esplicitamente la convalida offline:
wiqd agent validate --mode source --env dev
Verifica: Leggere i risultati dell'origine salvata e correggere gli errori segnalati. Un controllo dell'origine superato non stabilisce il comportamento di runtime, la raggiungibilità dell'endpoint, la correttezza dell'autenticazione o l'accettazione del pacchetto finale. La modalità predefinita package utilizza un file ZIP esistente, lo carica per la convalida e può richiedere l'accesso.
Per aggiungere una competenza a un progetto agente WIQD esistente, controllare il flag della funzionalità e i agent-skills requisiti dello schema corrente nella guida di riferimento dei comandi della competenza dell'agente. Un'abilità plug-in di primo livello e un'abilità collegata a un agente dichiarativo sono registrazioni diverse; nessuno dei due stabilisce il supporto in ogni host.
Utilizzare un altro percorso di prodotto quando si adatta al componente
| Requisiti | Procedura del prodotto |
|---|---|
| Creazione gestita in Microsoft 365 Copilot | Panoramica di Generatore di agenti e Agenti di compilazione |
| Logica low-code, ambienti gestiti o connettori Power Platform | Copilot Studio e Connettiti e configura un agente per Teams e Microsoft Copilot |
| Manifesti degli agenti di livello inferiore e integrazioni di sviluppo supportate | Strumenti di sviluppo Work IQ (consigliati per scenari pro-code supportati) |
| Competenze in un agente Toolkit esistente | Aggiungere competenze con Agents Toolkit |
Gli agenti autonomi di Copilot Studio vengono visualizzati nel Registro degli agenti, non nei plug-in. Non date per scontato che la pubblicazione di un agente standalone lo ricomponga come plugin.
Configurare e testare l'agente
Per i passaggi di implementazione dettagliati, seguire le linee guida per l'agente dichiarativo:
| Lavoro da completare | Guida autorevole | Verifica |
|---|---|---|
| Definisci identità, comportamento, limiti delle attività e spunti di conversazione | Agenti di compilazione o Crea con JSON, quindi scrivi istruzioni efficaci | I prompt rappresentativi producono il comportamento previsto e rimangono all'interno dell'attività prevista. |
| Configurare conoscenze e funzionalità | Origini delle conoscenze e Aggiungere funzionalità e azioni personalizzate | I dati obbligatori sono disponibili per l'utente previsto e non disponibili quando le autorizzazioni non lo consentono. |
| Aggiungere le azioni MCP o API supportate | Plug-in MCP e API per agenti dichiarativi | La selezione dello strumento, l'autenticazione, il consenso, le conferme, gli errori e le richieste non supportate si comportano come previsto. |
| Aggiungere una competenza supportata | Competenze negli agenti dichiarativi e nella procedura di authoring selezionata | L'agente di destinazione carica l'abilità e completa l'attività definita entro i limiti di quel prodotto. |
| Gestire la configurazione per la route di creazione | Ambienti e versioni dei toolkit o ambienti WIQD | I valori di identità, le dipendenze e le impostazioni appartengono all'ambiente di test previsto. |
Annotare la versione dell'agente, il proprietario, le esperienze supportate, le dipendenze, le limitazioni note e i risultati dei test. Sono richiesti test specifici per prodotto; Il passaggio della convalida dell'origine o del pacchetto non è la prova che ogni utente possa eseguire l'attività.
Per indicazioni sulla progettazione, vedere Procedure consigliate per gli agenti dichiarativi e Modalità di scelta delle azioni da parte dell'agente di orchestrazione Copilot. Quando il comportamento richiesto funziona, è possibile abilitare facoltativamente il feedback degli utenti e ottimizzare il recupero del contenuto.
Passaggio successivo
Continua i componenti rimanenti in Compila o riutilizza. Quando sono pronti, immettere Package & test con Integrate e testare i componenti.