Chiamata di un'azione per estrarre i dati di Dataverse for Teams
Con il nodo Chiama un'azione, i copiloti possono interagire con i flussi Power Automate. È possibile usare questi flussi per attivare processi automatizzati o connettersi con i dati di Dataverse for Teams, Elenchi Microsoft o altre origini dati.
Ad esempio, il copilota Event Contacts potrebbe fornire i membri del Sales Project Team a partire da una tabella di Dataverse for Teams. Invece di modificare il copilota quando vengono apportate modifiche a questo team, è possibile aggiornare la tabella.
Passaggio 1 - Creazione di una tabella di Dataverse for Teams
Per creare una tabella di Dataverse for Teams, effettuare i seguenti passaggi:
Creare una nuova tabella di Dataverse for Teams nello stesso team del copilota. Ricordare che è necessario crearla usando Power Apps per Teams. In Power Apps per Teams selezionare la scheda Crea, quindi selezionare il proprio team.
Selezionare Visualizza tutto sotto Elementi creati per [nome del team] per visualizzare l'elenco delle soluzioni del team. Questo elenco include tutte le app, i copiloti, i flussi cloud, le tabelle e così via che sono stati creati in Dataverse for Teams per il team selezionato. Se si è selezionato lo stesso team in cui si è creato il copilota Event Contacts, questo apparirà nell'elenco di soluzioni.
Nella barra multifunzione della soluzione del team in alto selezionare Nuovo>Tabella.
Assegnare alla nuova tabella il nome Sales Project Team e selezionare Salva. Le colonne e i tipi di dati da usare sono i seguenti:
| Colonna | Tipo di dati |
|---|---|
| Nome | Testo |
| Indirizzo e-mail |
Sarà necessario aggiungere la colonna Indirizzo e-mail alla tabella prima di continuare con il passaggio successivo.
Aggiungere nuove righe per ciascuno dei quattro contatti.
Nome Indirizzo e-mail Joseph Price JosephP@contoso.com Nathan Rigby NathanR@contoso.com Amber Rodriguez AmberR@contoso.com Monica Thomson MonicaT@contoso.com Al termine, tornare a Microsoft Copilot Studio per Teams.
Passaggio 2 - Creazione di un argomento per il copilota con un passaggio di azione
Per aggiungere un'azione, effettuare i seguenti passaggi:
In Microsoft Copilot Studio per Teams selezionare la scheda Copiloti dalla barra multifunzione, quindi trovare/selezionare il copilota Event Contacts per aprirlo.
Andare all'elenco di Argomenti.
Creare un nuovo argomento selezionando Nuovo argomento>Da vuoto nella barra multifunzione Argomenti. Per assegnare un nome all'argomento selezionare Dettagli nella barra multifunzione. Immettere "Sales Project Team" nel campo Nome.
Selezionare Frasi trigger e immettere ciascuna delle seguenti voci, scegliendo + dopo ogni immissione:
sales project teamsales project infosales team infosales project memberssales project infoNell'area del contenuto all'interno del nodo Messaggio immettere:
Let me look up the Sales Project Team!
A questo punto selezionare il pulsante Salva nella barra multifunzione per salvare l'argomento. Eventuali modifiche non salvate finora potrebbero andare perse quando si passa a Power Automate per creare il flusso.
Aggiungere un nuovo nodo dopo il nodo Messaggio, quindi selezionare Chiama un'azione > Crea un flusso. Copilot Studio potrebbe visualizzare una casella di opzione per ricordare di salvare l'argomento prima di uscire. Se si è già provveduto al salvataggio, selezionare Esci. Questa azione apre lo studio di Power Automate all'interno di Copilot Studio.
Sono disponibili alcuni modelli comuni tra cui scegliere immediatamente. Ogni modello consente di passare informazioni al flusso quando viene attivato. Al termine, il flusso può restituire informazioni al copilota. Per esaminare altri modelli, è possibile selezionare Visualizza altri modelli. Tra le opzioni disponibili figurano:
Modello di flusso di Power Virtual Agents: questo modello include solo i passaggi per ricevere e inviare informazioni al copilota.
Invia un messaggio a un canale di Teams: attiva un messaggio Teams dal copilota.
Invia una scheda adattiva a un canale Teams: attiva una scheda adattiva per fornire informazioni in un canale di Teams.
Selezionare quello denominato Modello di flusso Power Virtual Agents. Mentre si esegue l'operazione, il trigger sarà Power Virtual Agents e sotto è presente un passaggio denominato Restituisci valori a Power Virtual Agents.
Rinominare il flusso in Get Sales Team Members.
Creare una variabile per contenere le informazioni da restituire al copilota. Tra il trigger e il passaggio di restituzione dei valori, spostare il cursore sulla freccia e selezionare l'icona Inserisci nuovo passaggio che appare al passaggio del mouse su tale spazio e selezionare Aggiungi un'azione.
Nella casella di ricerca immettere "variabile" e poi, sotto Azioni, selezionare Inizializza variabile.
Immettere "varContactInfo" per il Nome, quindi selezionare Stringa per il tipo. Lasciare il campo Valore vuoto.
Ora occorre un passaggio per accedere ai dati di Dataverse da Teams. Nel nuovo passaggio Inizializza variabile selezionare l'icona Inserisci nuovo passaggio, quindi Aggiungi un'azione. Cercare il connettore Microsoft Dataverse, quindi selezionare Elenca righe come trigger.
Per Nome tabella selezionare Sales Project Team dall'elenco a discesa. (è possibile specificare "sales" nel campo di input per filtrare rapidamente l'elenco).
L'azione Elenca righe estrae tutte le righe della tabella in una matrice. Una matrice è una tabella. Per aggiungere dati alla variabile stringa, è necessario esaminare ogni riga della tabella e aggiungere ogni riga di dati alla propria variabile varContactInfo. Questo è il modo con cui i dati vengono restituiti a Power Virtual Agents.
Selezionare l'icona Inserisci nuovo passaggio dopo Elenca righe. Selezionare Aggiungi un'azione.
Nella casella di ricerca immettere Controllo e in Azioni selezionare Applica a ogni.
Nel campo Selezionare un output dai passaggi precedenti selezionarlo per l'aggiunta di contenuto dinamico. Quindi, selezionare value sotto l'azione Elenca righe Dataverse.
Selezionare Aggiungi un'azione nel passaggio Applica a ogni per continuare.
Nella casella di ricerca Scegliere un'operazione immettere variabile, quindi, in Azioni, selezionare Aggiungi a variabile stringa.
Nel passaggio Aggiungi a variabile matrice selezionare varContactInfo per il Nome.
Per il Valore verrà creato un elenco puntato a più righe (come dati stringa) con il nome e l'indirizzo e-mail di ogni persona. Power Automate usa la sintassi di Markdown per la formattazione del testo. Per indicare un elenco puntato in Markdown, si usa il carattere asterisco (*) all'inizio della riga (per altre informazioni su Markdown, consultare la sezione Riepilogo alla fine di questo modulo).
Nella casella di testo Valore:
Inserire un asterisco * e aggiungere uno spazio.
Sotto il contenuto dinamico Elenca righe, selezionare Name e aggiungere uno spazio.
Nel contenuto dinamico Elenca righe selezionare Email Address.
Premere INVIO per iniziare una nuova riga.
Questo passaggio è completo.
Selezionare il passaggio Restituisci i valori a Microsoft Copilot Studio alla fine del flusso, quindi selezionare + Aggiungi un output.
Selezionare Testo come tipo di output.
Nella casella di testo Immetti titolo inserire ContactData.
Per il campo Inserisci valore per rispondere selezionare il campo di input, quindi varContactInfo nella sezione Variabili.
Ora il flusso dovrebbe avere l'aspetto seguente:
Selezionare Salva dalla barra multifunzione di Power Automate per completare la modifica del flusso. Power Automate esegue automaticamente la Verifica flusso per individuare i problemi. Potrebbe essere visualizzato un avviso relativo a "...query di filtro OData..." che si può ignorare. È possibile utilizzare i filtri OData per limitare i dati recuperati dal passaggio Elenca righe, ma l'origine dati include solo poche righe, quindi il filtro non è necessario. Selezionare Chiudi per uscire da Power Automate e tornare all'editor del copilota.
Tornare all'editor di Copilot e osservare il passaggio Azione. Dovrebbe essere visibile il flusso che si è appena creato: Get Sales Team Members come azione e la variabile stringa ContactData creata elencata come output.
Aggiungere un passaggio Mostra un messaggio dopo il nodo Azione.
Fare clic nella casella di testo per visualizzare il menu. Selezionare ContactData sotto Inserisci variabile {X}.
Selezionare Salva dalla barra multifunzione di modifica dell'argomento e attendere il salvataggio dell'argomento. Se il riquadro Test del bot non è visibile, selezionare l'opzione del menu Test del chatbot.
Nella parte superiore del pannello Testa chatbot, verificare che l'opzione Monitoraggio tra argomenti sia attivata.
Immettere una delle frasi trigger per testare il copilota del Sales Project Team. Il copilota di test fornisce un elenco puntato con i quattro nomi e indirizzi e-mail del Sales Project Team.
L'esercizio è terminato. A questo punto si è creato un modo per consentire al copilota di ottenere informazioni dalle tabelle di dati tramite un flusso Power Automate integrato.