Condividi tramite


Aggiungere variabili di input e output

Importante

Le capacità e funzionalità di Power Virtual Agents ora fanno parte di Microsoft Copilot Studio a seguito di investimenti significativi nell'intelligenza artificiale generativa e integrazioni migliorate in Microsoft Copilot.

Alcuni articoli e schermate potrebbero fare riferimento a Power Virtual Agents durante l'aggiornamento della documentazione e dei contenuti per il training.

Utilizza le variabili come parametri di input e output per trasferire informazioni tra flussi Power Automate e copiloti Copilot Studio.

Importante

Un copilota può ricevere solo fino a 1 MB di dati da un flusso in una singola azione. Tuttavia, non esiste alcun limite alla quantità di dati che un copilota può inviare o al numero di variabili che può passare.

In questo esempio creerai un flusso con un parametro di input e lo restituirai a un copilota come parametro di output.

Prerequisiti

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

Tipi di parametro supportati

I copiloti possono utilizzare i seguenti tipi di input e output con i flussi Power Automate:

  • Numero
  • String
  • Boolean

I seguenti tipi non sono 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 del tuo copilota

  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 come, seleziona l'icona a forma di matita e rinomina la variabile in userResponse.

    Screenshot di un nodo Domanda.

  7. Nel canvas di creazione seleziona Aggiungi nodo (+). Seleziona Chiama un'azione e quindi seleziona Crea un flusso.

  8. Nel portale Power Automate denomina il flusso Parametro eco.

Aggiungere i parametri di input al flusso

  1. Nel trigger di flusso Microsoft Copilot Studio seleziona Aggiungi un input.

    Screenshot di un trigger di flusso Microsoft Copilot Studio, con Aggiungi un input evidenziato.

  2. Seleziona Testo e inserisci il nome Stringa_Input.

    Screenshot dell'input del trigger di flusso.

Aggiungere i parametri di output al flusso

  1. Nell'azione di risposta Restituisci i valori a Microsoft Copilot Studio, seleziona Aggiungi un output.

    Screenshot dell'azione di risposta del flusso, con Aggiungi un output evidenziato.

  2. Seleziona Testo e inserisci il nome Stringa_Output.

    Screenshot dell'output dell'azione di risposta.

  3. Per il valore di Stringa_Output, seleziona la variabile Stringa_Input.

    Screenshot di un parametro di input selezionato come valore di un parametro di output.

  4. Seleziona Salva.

Seleziona variabili nell'argomento del copilota

  1. Sul canvas di creazione Microsoft Copilot Studio seleziona Aggiungi nodo (+), quindi seleziona Chiama un'azione.

  2. Seleziona il flusso che hai creato in precedenza, Parametro eco.

  3. Per Stringa_Input(text) ottiene il valore da, seleziona userResponse.

  4. Aggiungi un nodo messaggio. Seleziona Inserisci variabile, quindi seleziona Stringa_Output.

    Screenshot di un nodo Azione per il flusso di parametri eco.

  5. Metti alla prova il tuo argomento nel riquadro Prova copilota.

    Screenshot di una conversazione con copilota.

Facoltativamente, utilizza i valori letterali per i parametri di input

In alternativa, invece di utilizzare una variabile come parametro di input di un'azione, puoi digitare il valore direttamente nella casella "recupera valore da".

Screenshot di un valore letterale passato come parametro di input.

Usare le variabili