Aggiungere un nodo di agente a un flusso di lavoro o un flusso dell'agente

1. In Copilot Studio, vai a Flussi e apri un flusso di lavoro esistente, oppure creane uno nuovo.

   • Nuovo flusso di lavoro: si passa alla finestra di progettazione per configurare un trigger.
   • Flusso di lavoro esistente: apri il flusso di lavoro e vai alla scheda Crea.

2. Seleziona l'icona Agente nel pannello Aggiungi. Si apre il pannello di configurazione per il nodo agente.

1. In Copilot Studio, vai a Flussi e apri un flusso dell'agente esistente o creane uno nuovo.

   • Nuovo flusso: si passa alla pagina Finestra di progettazione per configurare un trigger.
   • Flusso esistente: arrivi alla pagina Panoramica e devi spostarti manualmente alla pagina Finestra di progettazione.

2. Seleziona l'icona Inserisci una nuova azione nel punto del flusso dove vuoi chiamare un agente

3. In Aggiungi un'azione, nella sezione Capacità IA, seleziona Esegui un agente. Nel flusso viene visualizzato un nodo Esegui un agente .

Nell'editor del nodo agente, sotto Agente, seleziona una delle due opzioni:

• Un agente esistente: seleziona un agente pubblicato da un elenco. L'agente viene eseguito con qualsiasi istruzione, strumento e conoscenza con cui è stato già configurato.

• Nuovo agente per questo workflow: crea un agente inline specifico per questo flusso di lavoro. Le istruzioni, gli strumenti, le conoscenze e la struttura dell'output dell'agente sono configurati direttamente nel nodo e viaggiano con il flusso di lavoro. Usa questa opzione quando il lavoro dell'agente è specifico per questa automazione e non devi condividerlo altrove.

La sezione successiva di questo articolo si concentra sulla configurazione di un nuovo agente inline. Se selezioni un agente esistente, vai a Invia un messaggio all'agente.

Nell'editor di esecuzione e agenti, in Agente, puoi selezionare una delle due opzioni:

• Seleziona un agente esistente: seleziona un agente pubblicato dall'elenco. L'agente viene eseguito con qualsiasi istruzione, strumento e conoscenza con cui è stato già configurato.

• Crea un nuovo agente: seleziona Nuovo per creare un nuovo agente. Si apre una nuova scheda del browser con l'ambiente di creazione agenti. Crea e pubblica il tuo agente lì, quindi torna alla finestra di progettazione del flusso per selezionarlo dall'elenco degli agenti esistenti.

La sezione successiva di questo articolo si concentra sulla configurazione di un nuovo agente. Se selezioni un agente esistente, vai a Invia un messaggio all'agente.

Quando scegli Nuovo agente per questo flusso di lavoro, il pannello di configurazione si espande così puoi configurare l'agente sul posto.

Istruzioni

Per un agente inline, il campo Istruzioni serve sia come descrizione del ruolo dell'agente e come prompt per ogni esecuzione. Non è previsto un campo Messaggio separato. Scrivi cosa deve fare l'agente, in modo chiaro, e includi contenuti dinamici dei passaggi precedenti per fornirgli i dati per questa esecuzione.

Sii specifico riguardo all'attività, agli input che l'agente può aspettarsi e al formato della risposta che vuoi ricevere. Istruzioni più chiare portano a esecuzioni più affidabili.

Ad esempio, se il trigger del flusso di lavoro è Quando arriva una nuova e-mail, le tue istruzioni potrebbero essere: Read the email below and decide whether it's a sales lead, a support request, or something else. Reply with a single word. seguite dai token Oggetto e Corpo provenienti dal trigger.

Per scegliere il modello che guida l'agente, usa l'elenco a discesa del modello nell'angolo in alto a destra della casella delle istruzioni. Seleziona un modello più capace quando l'attività prevede ragionamento a più fasi o un'interpretazione attenta. Seleziona un modello più veloce quando l'attività è semplice e deve essere svolta su larga scala.

Work IQ

Attiva Work IQ per consentire all'agente di utilizzare le attività lavorative recenti dell'utente attivo, inclusi posta, Teams, calendario, OneDrive e il contesto di SharePoint, per contestualizzare le sue risposte. Questo è utile quando il flusso di lavoro opera per conto di una persona e il contesto personale (thread recenti, riunioni imminenti, documenti modificati di recente) migliora la risposta.

Strumenti

Gli strumenti danno all'agente la possibilità di eseguire azioni come inviare un messaggio, interrogare un record, eseguire una ricerca o chiamare un'API. Senza strumenti, l'agente può solo leggere e ragionare. Con gli strumenti, può anche agire.

Per allegare uno strumento:

1. Nella sezione Strumenti, seleziona il simbolo più (+).

2. In Aggiungi strumento, sfoglia o cerca lo strumento che desideri.

3. Seleziona lo strumento per aggiungerlo. Puoi aggiungere più strumenti in un unico agente.

Puoi collegare due tipi di strumenti:

• Server Model Context Protocol (MCP): server precostruiti che offrono un insieme curato di funzionalità.
• Connettori: qualsiasi azione di connettore della Power Platform.

L'agente decide in fase di esecuzione quale degli strumenti ad esso associati chiamare, in quale ordine e con quali argomenti. Non devi collegare gli strumenti insieme. Questo è ciò che rende il nodo agente diverso dal collegamento di azioni individuali del flusso di lavoro.

Knowledge Base

La conoscenza dà all'agente qualcosa da leggere. Quando fai una domanda all'agente, può basare la sua risposta sulle fonti che colleghi invece di affidarsi solo a ciò che il modello già sa.

Per allegare una fonte delle informazioni:

1. Nella sezione Conoscenza, seleziona il simbolo più (+).

2. In Aggiungi conoscenza, scegli il tipo di sorgente:

   • Siti Web pubblici: indicizza uno o più URL pubblici, così l'agente può citare contenuti da quei siti.
   • SharePoint: connettiti a un sito, una libreria o un documento specifico di SharePoint, così che l'agente possa rispondere da contenuti interni (criteri, playbook, documentazione di prodotto, contratti).

3. Inserisci l'URL, quindi salva.

Allega conoscenza ogni volta che la risposta corretta dipende da contenuti non inclusi nei training del modello, come criteri interni, specifiche di prodotto, accordi con i clienti o l'ultima pagina dei prezzi sul tuo sito Web.

Output

Usa l'elenco a discesa Output per definire la struttura di ciò che l'agente restituisce. La forma determina il modo in cui i passaggi del flusso di lavoro downstream utilizzano il risultato.

Quando scegli un output strutturato, ogni campo diventa un proprio token di contenuto dinamico a cui le azioni a valle possono fare riferimento direttamente.

Quando selezioni Nuovo, crei l'agente nell'esperienza di creazione degli agenti che si apre in una nuova scheda del browser. Nell'esperienza di creazione degli agenti, configuri le istruzioni, le conoscenze e le funzionalità dell'agente.

Una volta terminata la creazione dell'agente, pubblicalo, torna alla progettazione flusso e selezionalo dall'elenco degli agenti esistenti.

Attiva Richiedi assistenza umana quando non si è certi per consentire all'agente di eseguire l'escalation quando non è sufficientemente sicuro di agire da solo. L'agente invia un'e-mail al proprietario della connessione per richiedere un riscontro e attende una risposta prima di proseguire.

Attiva questa opzione per decisioni critiche in cui l'errore è più costoso rispetto al procedere con lentezza, come nella gestione delle eccezioni sulle transazioni finanziarie, le approvazioni dei casi limite o le decisioni importanti sulle escalation dei clienti.

Attiva Richiedi assistenza umana quando non si è certi per consentire all'agente di eseguire l'escalation a un umano quando non è sufficientemente sicuro di agire da solo. Quando si verifica un'escalation, l'agente invia una richiesta di input tramite posta elettronica al proprietario della connessione.

Questa opzione è utile quando l'attività dell'agente potrebbe richiedere un'interpretazione che va oltre le sue istruzioni o le conoscenze disponibili. Ad esempio, se un agente sta esaminando i report delle spese e trova un addebito insolito che non corrisponde a nessuna policy, può segnalare il report affinché sia una persona a decidere, invece di approvare erroneamente.

1. Seleziona l'azione successiva in cui vuoi usare il risultato (ad esempio, Invia un'e-mail o Aggiorna una riga).

2. Apri il selettore di contenuto dinamico sul campo che desideri compilare.

3. Scegli l'output dal passaggio Agente:

   • Risposta di testo: output → un singolo token di risposta dell'agente.
   • Output strutturato o personalizzato: output → un token per campo definito dall'utente.

Modelli comuni:

• Inserisci una risposta di testo nel corpo di un'e-mail, in un messaggio Teams o in un documento.
• Ramifica il flusso di lavoro in base a un campo strutturato (ad esempio, priority == "high").
• Scrivi campi strutturati su Dataverse, Excel o un elenco di SharePoint.

1. Seleziona l'azione in cui desideri utilizzare la risposta (ad esempio, un'azione Invia una e-mail o Aggiorna una riga).

2. Nel campo in cui vuoi inserire la risposta, apri il selettore dinamico di contenuti.

3. Cerca l'output del passaggio Esegui un agente e seleziona la risposta dell'agente.

Modalità comuni di utilizzo della risposta dell'agente:

• Inserisci la risposta nel corpo di un'e-mail o di un messaggio.
• Definisci una condizione per suddividere il flusso di lavoro in base alla risposta dell'agente.
• Memorizza la risposta in una variabile o origine dati per utilizzi futuri.