Chiamare un flusso agente

Informazioni su come usare un flusso agente in Copilot Studio offrendo a un agente la possibilità di produrre una previsione meteo su richiesta.

Prerequisiti

Questo esempio dipende da un esempio precedente in cui è stato creato un flusso agente che recupera una previsione meteo.

Se non hai già creato il flusso delle previsioni del tempo, fallo ora.

Chiamare un flusso agente da un agente

Di seguito viene illustrato come aggiungere il flusso delle previsioni meteo come strumento a un agente. Questo metodo consente all'agente di orchestrazione di chiamare il flusso quando deve fornire una previsione meteo.

1. Nel riquadro di spostamento a sinistra in Copilot Studio selezionare Agenti e selezionare l'agente a cui si vuole aggiungere il flusso.

2. Passare alla pagina Strumenti e selezionare Aggiungi uno strumento.

3. Selezionare Flow per visualizzare l'elenco dei flussi pubblicati disponibili.

4. Selezionare il flusso Get weather forecast creato in precedenza.

5. Selezionare Aggiungi e configura.

   Il flusso viene aggiunto all'agente e viene visualizzato nell'elenco degli strumenti per l'agente. Verrà aperto il riquadro di configurazione per lo strumento usato dall'agente. È possibile usare questo riquadro per configurare lo strumento per l'agente.

6. In Nome e Descrizione immettere un nome visualizzato per lo strumento e una descrizione chiara che consente all'agente di orchestrazione di comprendere quando usare il flusso. Ad esempio, "Ottenere le previsioni meteo di oggi in corrispondenza del nome della città o del codice postale specificato".

7. In Input selezionare la modalità di riempimento del valore della variabile da parte dell'agente.

8. In Completamento selezionare l'operazione che l'agente deve eseguire al termine dell'uso dello strumento.

9. Al termine della configurazione, selezionare Salva.

Chiamare un flusso agente da un argomento

Di seguito viene illustrato come usare un nodo Azione in un argomento per chiamare il flusso quando un cliente chiede informazioni sul meteo.

1. In Copilot Studio, vai alla pagina Argomenti per il tuo agente.

2. Crea un nuovo argomento e chiamalo Visualizza meteo.

3. Aggiungi le seguenti frasi trigger:

   • pioverà
   • previsioni odierne
   • ottieni previsioni
   • com'è il tempo

   

4. Seleziona l'icona Aggiungi nodo sotto il nodo Trigger, quindi seleziona Invia un messaggio.

5. Nel nodo Messaggio, immetti Posso aiutarti in questo. nella casella di testo.

6. Seleziona l'icona Aggiungi nodo sotto il nodo Messaggio e seleziona Fai una domanda per aggiungere un nodo Domanda per la prima informazione del flusso, la città.

7. Nel nodo Domanda:

   1. Inserisci la domanda "Qual è la tua città?" nella casella di testo.
   2. In Identificazione seleziona Intera risposta dell'utente.
   3. Prendi nota del nome della variabile associata alla risposta Var1. Puoi lasciare il nome così com'è o sostituirlo con un nome più significativo, ad esempio "Città" (vedi Rinominare una variabile, se necessario).

8. Procedi allo stesso modo per aggiungere un altro nodo Domanda per l'altra informazione per il flusso, ovvero il CAP:

   1. Inserisci la domanda "Qual è il tuo CAP?" nella casella di testo.
   2. In Identifica, seleziona Numero.
   3. Prendi nota del nome della variabile associata alla risposta Var2. Puoi lasciare il nome così com'è o sostituirlo con un nome più significativo (ad esempio "ZIPcode").

9. Selezionare l'icona Aggiungi nodo sotto il nodo Domanda per il codice postale, selezionare Aggiungi uno strumento e quindi selezionare il flusso creato in precedenza, Ottieni previsioni meteo.

10. Imposta gli input del flusso alle variabili di output dai nodi della domanda. Città (stringa) ottiene il suo valore da Var1 (o City se l'hai rinominata) e il codice postale (numero) ottiene il suo valore da Var2 (o ZIPcode se l'hai rinominata).

    

11. Sotto il nodo Azione, aggiungi un nodo Messaggio e quindi immetti un messaggio che utilizza le informazioni di output dal flusso. Ad esempio:

    "Previsioni odierne per location: day_summary"
    "La probabilità di pioggia è chance_of_rain%"
    Dove location,day_summary e chance_of_rain sono i parametri di output del flusso.

    

12. Seleziona Salva.

Gestire un flusso di agenti usato in un argomento

Una volta ottenuto un nodo Azione che chiama un flusso, puoi usare le seguenti opzioni dal menu del nodo per gestire il flusso:

• Elimina definitivamente il nodo e rimuove il flusso dall'argomento.

• Aggiorna ricarica il flusso per ottenere le modifiche apportate in Power Automate e le convalida nell'argomento. Prima di poter salvare l'argomento, devi risolvere eventuali problemi relativi al flusso.

Se vuoi selezionare o creare un flusso diverso, usa l'icona Modifica flusso che appare quando passi il puntatore del mouse sul flusso nel nodo Azione.

Testa il tuo flusso e l'argomento

È buona norma testare il flusso e l'argomento che lo chiama.

Nel riquadro Testa il tuo agente, digita una delle frasi trigger dell'argomento per avviare una conversazione con l'agente. Inserisci la tua città e il tuo codice postale quando l'agente li richiede. Verifica che l'agente restituisca le previsioni meteo odierne per la tua città e che il messaggio abbia l'aspetto previsto.

Risoluzione dei problemi dell'agente

Testa l'agente sempre quando apporti modifiche ai tuoi argomenti e flussi, per assicurarti che tutto funzioni come previsto. Se l'agente rileva un problema durante una conversazione, risponde con un messaggio di errore.

Trova la maggior parte dei problemi relativi al flusso nella scheda Progettazione flusso. Usa Verifica argomento per identificare i problemi dell'area del contenuto.