Condividi tramite

Usare le variabili di input e output per passare informazioni

Usare le variabili come parametri di input e output per passare informazioni tra i flussi dell'agente e gli agenti di Copilot Studio.

Importante

Un agente può solo ricevere fino a 1 MB di dati da un flusso a un'azione singola. Tuttavia, non c'è limite al numero di variabili o alla quantità di dati che un agente può inviare.

In questo esempio crei un flusso con un parametro di input e lo restituisci a un agente come parametro di output.

Prerequisiti

  • Informazioni su come creare un flusso dall'area del contenuto di Copilot Studio

Tipi di parametro supportati

Gli agenti di Copilot Studio supportano i tipi seguenti di parametri di input e output per i flussi dell'agente:

  • Numero
  • String
  • Boolean

I seguenti tipi di dati non sono attualmente supportati:

  • Object
  • Date
  • Timestamp:
  • Elenco [String]
  • Elenco [Number]
  • Elenco [Boolean]
  • Elenco [Object]
  • Elenco [Date]
  • Elenco [Timestamp]

Creare un argomento e un flusso

  1. Vai alla pagina Argomenti dell'agente.

  2. Crea un nuovo argomento chiamato Messaggio di eco.

  3. Aggiungi la frase trigger eco.

  4. Aggiungi un nodo Domanda e immetti il messaggio "Dimmi cosa devo dirti".

  5. Per Identifica, scegli Intera risposta dell'utente.

  6. Per Salva risposta utente con nome, rinomina la variabile in userResponse.

    Screenshot di un nodo Domanda che raccoglie la risposta dell'utente.

  7. Selezionare l'icona Aggiungi nodo sotto il nodo Domanda e selezionare Aggiungi uno strumento.

  8. Nella scheda Azioni di base selezionare Nuovo flusso agente. Viene visualizzata la scheda Progettazione flussi agente con un modello iniziale per un flusso agente chiamato da un agente. Il flusso include due azioni: quando un agente chiama il flusso e Rispondi all'agente.

  9. Seleziona Salva bozza.

  10. Nella scheda Panoramica del flusso modificare i dettagli per il flusso, sostituendo il nome con il parametro Echo. Selezionare Salva.

  11. Tornare alla scheda Progettazione .

Aggiunta di un parametro di input per il flusso

  1. Selezionare il trigger Quando un agente chiama il trigger del flusso di flusso e selezionare Aggiungi un input.

  2. Seleziona Testo e inserisci il nome Stringa_Input.

    Screenshot del parametro di input per il trigger del flusso.

Aggiunta di un parametro di output per il flusso

  1. Selezionare l'azione Rispondi alla risposta dell'agente e selezionare Aggiungi un output.

  2. Seleziona Testo e inserisci il nome Stringa_Output.

    Screenshot del parametro di output dell'azione di risposta.

  3. Per il valore, immetti una barra rovesciata (/) nella casella, seleziona Inserisci contenuto dinamico, quindi seleziona la variabile String_Input.

  4. Selezionare Salva bozza e Pubblica. Copilot Studio informa l'utente quando viene pubblicato il flusso dell'agente.

  5. Selezionare Torna all'agente per tornare all'editor degli argomenti dell'agente. Il nuovo flusso di azione viene aggiunto all'argomento.

Chiamare il flusso dall'argomento

  1. Selezionare il nuovo nodo azione.

  2. Imposta il parametro di input del flusso sulla variabile di output dal nodo Domanda: String_Input (stringa) ottiene il valore dalla variabile di userResponse.

    Screenshot del nodo Azione che chiama il flusso

  3. Aggiungi un nodo messaggio.

  4. Seleziona Inserisci variabile, quindi seleziona Stringa_Output.

    Screenshot del nodo del messaggio che restituisce l'input dell'utente.

  5. Selezionare Salva.

  6. Testa l'agente.

    Screenshot della conversazione dell'agente.

Contenuto correlato

  • Last updated on