Creare un flusso

  • Articolo

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.

Informazioni su come utilizzare un flusso cloud in Microsoft Copilot Studio dando a un copilota la possibilità di produrre previsioni meteorologiche su richiesta. In questo esempio crei un flusso che recupera le previsioni del tempo. Nell'esempio successivo, chiamerai il flusso come un'azione in modo che il copilota possa rispondere con le previsioni quando un cliente chiede informazioni sul tempo.

Puoi creare un flusso da utilizzare con un copilota o modificare un flusso esistente. Per essere adatto ai copiloti, un flusso Power Automate richiede uno speciale trigger del flusso Microsoft Copilot Studio e un'azione di risposta:

  • Trigger di flusso: Quando Microsoft Copilot Studio chiama un flusso

    Screenshot del trigger del flusso Microsoft Copilot Studio.

  • Azione di risposta: Restituisci valori a Microsoft Copilot Studio

    Screenshot dell'azione di risposta Microsoft Copilot Studio.

Quando crei un flusso dal canvas di creazione Microsoft Copilot Studio, il trigger e l'azione vengono aggiunti automaticamente. Quando modifichi un flusso esistente per utilizzarlo con un copilota, devi aggiungere il trigger Microsoft Copilot Studio e l'azione di risposta.

Importante

Per utilizzare i flussi in Copilot Studio, devono soddisfare i seguenti requisiti:

  • Un flusso può essere chiamato solo da argomento situato nello stesso ambiente Microsoft Dataverse come il tuo copilota.

  • Anche i flussi devono trovarsi in una soluzione Power Automate. Puoi spostare i flussi nelle soluzioni in modo che siano disponibili nell'area del contenuto.

  • I valori di flusso devono essere restituiti in modo sincrono a Copilot Studio.

  • Un flusso cloud chiamato da un copilota Copilot Studio ha un limite di timeout di 100 secondi per essere eseguito e restituito al copilota. Per essere al di sotto del limite di 100 secondi, è necessario ottimizzare la logica del flusso, le query e i dati restituiti. Se parte della logica del flusso cloud può continuare a essere eseguita dopo che un risultato è stato inviato al copilota, inserisci queste azioni dopo il passaggio "Restituisci valori a Microsoft Copilot Studio" nel flusso cloud.

Prerequisiti

Creare un flusso da utilizzare con un copilota

  1. Vai alla pagina Argomenti del tuo copilota.

  2. Apri l'area del contenuto per l'argomento da cui desideri richiamare un flusso.

  3. Seleziona Aggiungi nodo (+) sotto un nodo esistente per aggiungere un nuovo nodo.

  4. Nella finestra di selezione del nodo, seleziona Chiama un'azione, quindi seleziona Crea un flusso.

    Screenshot dell'opzione Crea un flusso nel menu Chiama un'azione.

    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 del copilota e usa le stesse credenziali per l'utente.

    Screenshot del modello di flusso Power Automate chiamato da Microsoft Copilot Studio.

  5. Continua a creare il flusso in Power Automate.

Modifica un flusso esistente da utilizzare con un copilota

Cosa succede se disponi già di un flusso e non desideri crearne uno da zero da utilizzare con il tuo copilota? Aggiungi il trigger di flusso speciale Microsoft Copilot Studio e l'azione di risposta. È possibile aprire un flusso esistente per la modifica in un paio di modi.

Aprire un flusso dal canvas di creazione

  1. In un argomento aperto nel canvas di creazione Microsoft Copilot Studio seleziona Aggiungi nodo (+).

  2. Seleziona Chiama un'azione.

  3. Seleziona Visualizza dettagli flusso sotto il flusso.

    Screenshot del pulsante Modifica un flusso nel selettore azioni.

Aprire un flusso da un nodo Azione

  1. In un argomento aperto nel canvas di creazione Microsoft Copilot Studio seleziona il nodo Azione pertinente.

  2. Seleziona Visualizza dettagli flusso.

    Screenshot del pulsante Modifica un flusso in un nodo Azione.

Aprire un flusso in Power Automate

  1. Andare al portale di Power Automate.

  2. Vai a Soluzioni e seleziona Soluzione predefinita. Se hai spostato il flusso in un'altra soluzione, seleziona quella.

    Screenshot della soluzione predefinita nell'elenco delle soluzioni.

  3. Seleziona il flusso.

    Screenshot del flusso Ottieni previsioni meteo nella soluzione predefinita.

Aggiungere il trigger di flusso Microsoft Copilot Studio e l'azione di risposta

Se il tuo flusso non include già il trigger del flusso speciale Microsoft Copilot Studio e l'azione di risposta, devi aggiungerli prima di poter utilizzare il flusso con il tuo copilota.

  1. Seleziona Nuovo passaggio.

  2. Cerca il connettore Microsoft Copilot Studio e quindi seleziona Quando Microsoft Copilot Studio chiama un flusso.

  3. Seleziona Nuovo passaggio.

  4. Cerca il connettore Microsoft Copilot Studio e quindi seleziona Restituisci valori a Microsoft Copilot Studio.

  5. Seleziona Salva.

Creare il flusso nel portale Power Automate

Ora aggiungi le azioni al flusso. Nell'esempio corrente, l'azione che aggiungerai recupera la previsione corrente da MSN Meteo.

  1. Seleziona il nome del flusso e rinominalo in Ottieni previsioni meteo.

    Screenshot del nome del flusso selezionato.

  2. Aggiungi i seguenti parametri di input al trigger di flusso Microsoft Copilot Studio:

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

    Screenshot dei parametri di input per il flusso Power Automate.

  3. Seleziona Aggiungi un'azione per creare una nuova azione sotto il trigger di flusso Microsoft Copilot Studio.

    Screenshot del pulsante Aggiungi azione flusso.

  4. Cerca MSN meteo, quindi seleziona l'azione Recupera previsione per oggi.

    Screenshot dell'azione Ottieni previsioni per oggi sotto il connettore MSN meteo.

  5. Nell'azione Ottieni previsioni per oggi nella casella Posizione seleziona Aggiungi contenuto dinamico, quindi seleziona Città e Cap.

    Screenshot delle variabili aggiunte all'azione Recupera previsione per oggi

  6. Nell'azione Restituisci i valori a Microsoft Copilot Studio aggiungi i seguenti parametri e variabili di output:

    Nome parametro di output Type Variabile
    day_summary String Riepilogo giorno
    location String Location
    chance_of_rain Numero Probabilità pioggia giorno

    Screenshot delle variabili di output dinamiche aggiunte all'azione di risposta del flusso.

  7. Seleziona Salva.

Il prossimo passaggio è disattivare le risposte asincrone nel flusso.

Facoltativamente, spostare il flusso in un'altra soluzione

Per essere disponibili per i tuoi copiloti nel tuo ambiente, i flussi devono essere archiviati in una soluzione in Power Automate. Se non vuoi usare la Soluzione predefinita puoi spostare i tuoi flussi in un'altra soluzione.

  1. Andare al portale di Power Automate.

  2. Vai a Soluzioni e seleziona una soluzione esistente o crea una soluzione per i tuoi flussi.

    Per creare una soluzione, seleziona Nuova soluzione.

    Screenshot del pulsante Nuova soluzione.

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

    Screenshot delle proprietà della soluzione.

  3. Nella scheda Soluzioni, vai alla soluzione che desideri utilizzare. Seleziona Aggiungi esistente per aggiungere un flusso.

    Screenshot del pulsante Aggiungi esistente.

  4. Nela pagina Aggiungi flusso esistente, seleziona la scheda Dalle soluzioni, quindi seleziona il flusso e Aggiungi.

    Screenshot dell'elenco dei flussi esistenti nelle soluzioni.

    Per spostare un flusso dalla scheda I miei flussi a una soluzione, seleziona Soluzioni esterne, quindi seleziona Aggiungi per aggiungere il tuo flusso alla soluzione.

    Screenshot dell'elenco dei flussi esistenti all'esterno delle soluzioni.

Disattivare le risposte asincrone nel flusso

I flussi che desideri utilizzare in un copilota devono restituire valori in tempo reale o in modo sincrono. I flussi eseguiti in background o in modo asincrono possono causare un errore quando il copilota tenta di eseguirli. Invece di eseguire il flusso, il copilota dirà "Si è verificato un evento imprevisto. Stiamo indagando. Codice di errore: 3000."

Quando crei un flusso da Microsoft Copilot Studio, le risposte asincrone sono disattivate per impostazione predefinita. Se hai modificato un flusso esistente in cui sono attivate le risposte asincrone, dovrai modificare l'impostazione.

  1. Apri il tuo flusso e trova il passaggio Restituisci i valori a Microsoft Copilot Studio.

  2. Seleziona l'icona Menu (...) e quindi seleziona Impostazioni.

    Schermata del menu impostazioni dell'azione.

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

    Screenshot dell'opzione Risposta asincrona.

Chiamare un flusso come un'azione.

Ulteriori informazioni sulle variabili di input e output.