Uso di Power Automate per aggiungere azioni

• 6 minuti

Spesso, quando un agente interagisce con i clienti, potrebbe richiedere informazioni di altre applicazioni per fornire al cliente un'esperienza personalizzata. Ad esempio, se un cliente chiede informazioni meteo sulla località in cui si trova, l'agente potrebbe trasmettere i dettagli sulla località, come la città e l'indirizzo postale del cliente, a un servizio meteo che recupererà le previsioni per quella località. I dettagli sulla previsione possono quindi essere trasmessi all'agente, che li può quindi includere in un messaggio al cliente.

In Microsoft Copilot Studio queste interazioni sono delle azioni. Le azioni chiamano i flussi di Power Automate per supportare l'automatizzazione delle attività, la chiamata ai sistemi operativi o l'interazione con le applicazioni esterne. Ad esempio, nel caso di un'azione che chiama un flusso di Power Automate, il flusso passerebbe le informazioni sulla località acquisite nell'agente a un servizio esterno per poi restituire i dettagli sulla previsione all'agente di Microsoft Copilot Studio.

I flussi di Power Automate vengono chiamati a partire da argomenti usando il nodo Chiama un'azione. È possibile usare un flusso già esistente in un ambiente Power Apps oppure crearne uno nell'area del contenuto di Microsoft Copilot Studio. Per consentire a un flusso di Power Automate di interagire con un agente di Microsoft Copilot Studio, è necessario uno speciale trigger di Microsoft Copilot Studio. Questo trigger acquisisce i dati dall'agente e invia le informazioni di risposta all'agente stesso.

Power Automate fornisce il trigger e l'azione seguenti:

• Microsoft Copilot Studio: trigger che specifica i parametri di input che vengono acquisiti dall'agente di Microsoft Copilot Studio.

• Restituisci valori a Microsoft Copilot Studio: azione che definisce i parametri di output che vengono rimandati all'agente di Microsoft Copilot Studio.

Quando viene creato un nuovo flusso da un agente di Microsoft Copilot Studio, viene caricato un modello iniziale che include il trigger Microsoft Copilot Studio e l'azione Restituisci valori a Microsoft Copilot Studio. Non occorre fare altro che definire i parametri di input e output necessari e completare la struttura del flusso.

Uso di parametri di input e output

Le variabili definite nell'agente possono fornire valori ai parametri di input e usare valori dei parametri di output. Ad esempio, la risposta di un cliente alla domanda "In quale città vivi?" potrebbe essere usata come valore per un parametro di input City.

Parametri di input

I parametri di input rappresentano i valori che vengono acquisiti nell'agente di Microsoft Copilot Studio e usati dai passaggi del flusso di Power Automate. È possibile aggiungere un numero illimitato di parametri di input. Tuttavia, i parametri di input consentiti nei flussi di Power Automate sono solo di tipo numero, stringa e booleano.

Determinare il tipo di dati richiesto quando il parametro di input viene passato attraverso il flusso. Ad esempio, se si intende inviare la città e il codice postale di un cliente al servizio meteorologico di MSN, si potrebbero configurare i parametri di input come mostrato nella figura seguente.

Nome	Tipo di dati
Città	Testo
Zip_Code	Numero

Il parametro City è stato definito come testo poiché MSN Meteo usa i nomi delle città come testo. Il parametro Zip_Code è stato impostato su Numero poiché è usato come numero. Ogni servizio con cui Power Automate può interagire è diverso, quindi è importante assicurarsi di comprenderne il funzionamento.

Quando viene aggiunto un passaggio per ottenere le previsioni meteorologiche del giorno da MSN Meteo, la città e il codice postale vengono passati alla località di modo che MSN Meteo sappia quale previsione ottenere.

Parametri di output

I parametri di output sono valori di un flusso di Power Automate che vengono restituiti all'agente di Microsoft Copilot Studio. Come i parametri di input, i parametri di output possono essere una stringa, un numero o un valore booleano.

Tornando all'esempio sul meteo, dopo che il flusso ha ricevuto i dettagli sulla previsione dal servizio MSN Meteo, si definiscono i parametri di output per memorizzare i dettagli restituiti dal servizio MSN Meteo. I valori di questi parametri saranno usati dall'agente di Microsoft Copilot Studio. Ad esempio, se si desidera che il cliente veda un riepilogo e la percentuale di probabilità di pioggia per il luogo in cui si trova, si potrebbero creare i seguenti parametri di output.

Nome	Tipo di dati
Day_summary	Testo
Località	Testo
Chance_of_rain	Numero

I dettagli effettivi da includere sono estratti dalle informazioni ricevute nelle previsioni di MSN.

Tutti i flussi creati nell'area del contenuto di Microsoft Copilot Studio vengono salvati in una soluzione predefinita in Power Automate e possono essere usati dagli agenti immediatamente.

Chiamata di un flusso di Power Automate come azione da un agente

Dopo che il flusso è stato creato, può essere avviato dall'argomento dell'agente usando il nodo Chiama un'azione. Quando si chiama l'azione, le variabili possono essere passate al flusso come parametri di input. Assicurarsi di aver creato un argomento con frasi trigger appropriate. Ad esempio, è possibile creare un argomento Ottieni meteo che includa frasi trigger come:

• Pioverà?

• Che tempo fa?

• Ottieni meteo

Per passare informazioni sulla località come variabili al flusso di Power Automate, sarà necessario acquisirle. Il modo più semplice di eseguire questa operazione è usare il nodo Fai una domanda. Si usa il campo Identifica sul nodo di domanda per definire il tipo di dati che si desidera acquisire. Si potrebbe ad esempio impostare un elemento del campo Identifica su Città e l'altro su CAP. Le risposte a queste domande vengono memorizzate in variabili.

Dopo aver definito le domande da usare per acquisire i dettagli, aggiungere un nuovo nodo di conversazione Chiama un'azione all'agente selezionando il flusso meteo creato in precedenza.

Nella configurazione del flusso, è necessario eseguire il mapping dei blocchi di input del flusso alle variabili di output dei nodi di domanda. Ad esempio, Città (testo) ottiene il valore da City (city) e CAP (numero) ottiene il valore da Zip (number).

A questo punto, si potranno osservare l'esecuzione del flusso Ottieni previsioni meteo e i parametri di output restituiti dallo stesso.

Sotto il nodo del flusso, aggiungere un nodo Messaggio, quindi immettere un messaggio che usa gli output del flusso.

Ad esempio: Previsioni di oggi per (x)location:{x}day_summary. Probabilità di precipitazioni è {x}probabilità di precipitazioni%.

Per altre informazioni, vedere Uso di flussi Power Automate in Microsoft Copilot Studio.