Creare un flusso

Scopri come utilizzare un flusso cloud in Copilot Studio dando a un agente la possibilità di produrre una previsione meteorologica su richiesta. In questo primo esempio, crei un flusso che recupera una previsione meteorologica. Nell'esempio seguente, configuri un argomento per chiamare il flusso come un'azione di un argomento in modo che l'agente possa rispondere con la previsione quando un cliente chiede informazioni sul meteo.

Per funzionare con gli agenti, un flusso Power Automate richiede il trigger di flusso seguente e un'azione di risposta specifici:

• Trigger di flusso: Esegui un flusso da Copilot
• Azione di risposta: Rispondi a Copilot

Quando crei un flusso da Copilot Studio, vengono aggiunti automaticamente il trigger di flusso e l'azione di risposta obbligatori. Puoi modificare un flusso esistente per l'uso con gli agenti aggiornandolo per l'uso con queste azioni e questi trigger.

Prerequisiti

• Accesso a Copilot Studio con una licenza che include l'uso dei flussi in Copilot Studio.

Creare un flusso da usare con un agente

1. Vai alla pagina Argomenti dell'agente.

2. Apri l'argomento da cui desideri richiamare un flusso.

3. Seleziona l'icona Aggiungi nodo sotto qualsiasi nodo e seleziona Aggiungi un'azione.

4. Nella scheda Azioni di base seleziona Nuovo flusso Power Automate.

   Il portale Power Automate si apre in una nuova scheda, con un modello di flusso iniziale aperto per la modifica. Il portale si apre automaticamente nello stesso ambiente dell'agente e usa le stesse credenziali per l'utente.

   Ora aggiungi le azioni al flusso. In questo esempio aggiungi un'azione che recupera la previsione corrente da MSN Meteo.

5. Seleziona il nome del flusso e sostituiscilo con "Ottieni previsioni meteo".

6. Seleziona il flusso del trigger Esegui un flusso da Copilot e aggiungi i parametri di input seguenti:

   • Città (Testo)
   • Codice postale (numero)

   

7. Seleziona l'icona Aggiungi sotto il trigger Esegui un flusso da Copilot.

8. In Aggiungi un'azione, cerca "MSN Meteo" e seleziona l'azione Recupera previsione per oggi.

9. Nel riquadro Recupera previsione per oggi, nella casella Posizione, inserisci una barra (/), seleziona Inserisci contenuto dinamico, quindi seleziona il parametro di input Città.

10. Procedi allo stesso modo per aggiungere il parametro di input del codice postale.

11. Nell'azione Rispondi a Copilot, aggiungi i seguenti parametri e variabili di output:

    Parametro di output	Type	Variabile
    day_summary	Testo	Riepilogo giorno
    location	Testo	Ubicazione
    chance_of_rain	Numero	Probabilità pioggia giorno

    

12. Salva e pubblica il flusso.

13. Torna al tuo argomento in Copilot Studio e segui le istruzioni in Chiamare un flusso da un argomento.

Gestisci quali connessioni vengono utilizzate dal flusso

In un agente autenticato supportato, i flussi cloud possono essere configurati per l'uso delle credenziali utente quando vengono eseguiti come parte di un piano di orchestrazione generativa o chiamati da un argomento. L'uso del flusso in un canale supportato non richiede alcuna configurazione speciale nell'agente. I clienti sono in grado di gestire le proprie connessioni durante l'utilizzo dell'agente.

I flussi cloud in ambienti che usano chiavi gestite dal cliente (CMK) non possono ancora essere eseguiti con le credenziali del cliente come parte dei piani di orchestrazione generativa o dagli argomenti. Assicurati che le impostazioni di sola esecuzione per i flussi cloud negli ambienti con chiavi gestite dal cliente siano impostate su connessioni specifiche anziché su Fornito dall'utente di sola esecuzione.

Modifica di un flusso esistente da usare con un agente

Se hai un flusso con un trigger diverso che desideri usare con il tuo agente, puoi modificare il flusso in modo che usi il trigger Esegui un flusso da Copilot e l'azione di risposta Rispondi a Copilot e assicurarti che si trovi in una soluzione nello stesso ambiente dell'agente personalizzato.

1. Vai al portale Power Automate e utilizza il selettore degli ambienti in alto a destra per scegliere l'ambiente in cui è archiviato il flusso.

2. Seleziona Flussi personali nel riquadro di spostamento a sinistra e cerca il flusso che vuoi modificare.

3. Seleziona il flusso e seleziona Modifica.

   

Aggiungi il trigger di Copilot e l'azione di risposta

Se il flusso non include già il trigger e l'azione di risposta obbligatori, devi aggiungerli prima di poter usare il flusso con l'agente.

1. Seleziona Nuovo passaggio.

2. Cerca Copilot e seleziona Esegui un flusso da Copilot.

3. Seleziona Nuovo passaggio.

4. Cerca il connettore Copilot e seleziona Rispondi a Copilot. L'azione di risposta può essere utilizzata in più rami del flusso, ma deve avere gli stessi output a ogni utilizzo.

5. Salva e pubblica il flusso.

Assicurati che l'azione di risposta sia impostata per essere restituita in tempo reale

I flussi che vuoi usare in un agente devono restituire valori in tempo reale o in modo sincrono. I flussi eseguiti in background o in modo asincrono potrebbero causare un errore quando l'agente tenta di eseguirli. Invece di eseguire il flusso, l'agente dice "Si è verificato un evento imprevisto. Stiamo indagando. Codice di errore: 3000."

Quando crei un flusso da Copilot Studio, le risposte asincrone sono disattivate per impostazione predefinita. Se hai modificato un flusso esistente in cui le risposte asincrone sono attivate, segui questi passaggi per controllare l'impostazione e assicurarti che sia disattivata:

1. Apri il flusso e trova le azioni Rispondi a Copilot.

2. Seleziona la scheda Impostazioni.

3. Imposta Risposta asincrona su Disattivato, quindi seleziona Salva.

   

Aggiungere il flusso a una soluzione

Per essere disponibili per gli agenti, i flussi devono essere archiviati in una soluzione nello stesso ambiente di Power Platform. Se un flusso si trova in una soluzione, nella pagina dei dettagli del flusso è visibile un riquadro Soluzioni in cui sono elencate le soluzioni in cui si trova il flusso. I flussi possono essere aggiunti alla Soluzione predefinita per l'utilizzo con gli agenti o spostati in una soluzione diversa utilizzando i passaggi seguenti:

1. Andare a Power Automate.

2. Vai a Soluzioni e seleziona una soluzione esistente o crea una soluzione per il flusso.

3. Se desideri creare una nuova soluzione:

   1. Selezionare Nuova soluzione.

   2. Dai un nome alla tua nuova soluzione, seleziona Autore predefinito di CDS nel campo Editore e inserisci un numero di Versione.

      

   3. Seleziona Crea.

4. Se desideri aggiungere il flusso a una soluzione esistente, seleziona la soluzione desiderata, quindi Modifica.

5. Seleziona Aggiungi esistente>Automazione>Flusso cloud.

   

   Viene visualizzato il riquadro Aggiungi flussi esistenti.

6. Seleziona il flusso, quindi Aggiungi.

   

Contenuto correlato

• Chiamare un flusso come un'azione
• Usare le variabili di input e output per passare informazioni
• Aggiungi l'autenticazione utente agli argomenti