Creare un agente dichiarativo

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

  1. 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.

  2. 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.

  3. 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.