Configurare variabili di contesto per bot

Questo articolo elenca le variabili di contesto per i bot di Azure e Copilot Studio e come puoi configurarli in Multicanale per Customer Service. Per capire come creare variabili di contesto, vedi Gestire le variabili di contesto.

Variabili di contesto per bot Azure

La seguente tabella contiene l'elenco di variabili di contesto in Multicanale per Customer Service che puoi usare per configurare i bot diconfigurazione bot di Azure.

Variabili di contesto per bot Copilot Studio

La seguente tabella contiene l'elenco di variabili di contesto disponibili in Multicanale per Customer Service che puoi usare per configurare i bot di Copilot Studio.

Configurare le variabili di contesto per bot Copilot Studio

Per fare in modo che il bot di Copilot Studio legga le variabili di contesto da Multicanale, procedi come segue:

1. Nella pagina Argomenti seleziona Aggiungi un argomento e Da vuoto.

2. Immetti un nome per il tuo argomento (ad esempio, "Imposta variabili di contesto") e salvalo.

3. Aggiungi un nuovo nodo all'argomento e seleziona Gestione variabili > Imposta un valore variabile

4. Nel nodo, sotto Imposta variabile, seleziona Crea una nuova variabile.

5. Apri il riquadro Proprietà variabile facendo clic sul nome della nuova variabile. Nel riquadro, imposta il Nome della variabile in modo che corrisponda esattamente al nome della variabile di contesto Multicanale (fa distinzione tra maiuscole e minuscole).

6. Nella sezione Riferimento, seleziona i puntini di sospensione (...) e quindi Recupera valore da questo nodo, se vuoto. Il bot di Copilot Studio recupera il valore della variabile da questo nodo in fase di esecuzione.

7. Nella sezione Utilizzo seleziona Globale (qualsiasi argomento può accedere) e Le origini esterne possono impostare valori. Copilot Studio accetta dati da Multicanale. Chiudi il riquadro Proprietà variabili.

8. Nel tuo nodo, immetti un valore in A valore che corrisponda al tipo di dati previsto dal tuo bot. Ad esempio, se il tuo bot prevede una stringa, imposta Text(""). Copilot Studio ritorna al valore impostato qui se i dati non arrivano nella conversazione.

   

9. Salvare e pubblicare le modifiche.

Durante una conversazione, i dati della variabile di contesto Multicanale vengono impostati nelle variabili di Copilot Studio e possono essere utilizzati nella logica del bot.

Il bot può anche impostare variabili di contesto multicanale durante una conversazione. Per impostare una variabile Multicanale dalla logica di Copilot Studio, assicurati che il tuo bot utilizzi il nome di variabile corretto e imposti il valore nella proprietà "A valore" nel nodo di gestione delle variabili. Copilot Studio trasferisce la variabile a Multicanale durante il trasferimento all'agente. Ciò viene spesso utilizzato per collegare la conversazione a un caso quando il bot riassegna la conversazione a un agente. Ulteriori informazioni su come collegare record in Multicanale da questi dati: Collegare cliente e caso a una conversazione

Le variabili globali che vengono create in Copilot Studio possono essere passate a Multicanale per Customer Service quando una conversazione viene riassegnata. Per l'elenco completo, vedi Variabili contestuali disponibili al momento della consegna.

Analizza l'oggetto JSON per estrarre l'ID record

Verifica di avere i seguenti dettagli:

• La variabile di contesto di Multicanale per Customer Service, ad esempio msdyn_contact_msdyn_ocliveworkitem_Customer.
• I dettagli dello schema

Una copia dei dettagli dello schema di esempio è come segue:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue contiene il valore dell'attributo nelle entità Dataverse. Il mapping per gli attributi dell'entità è la seguente:

• Casi: titolo del caso
• Contatti: nome completo
• Account: nome

Di seguito è riportato un esempio di record di contesto.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

Vedi anche

Integrare un bot Copilot Studio
Integrare un bot Azure
Configurare i bot per eseguire la riassegnazione e terminare le conversazioni
Riferimento SDK Live Chat