Share via

Konfigurera kontextvariabler för konfigurationer

  • Artikel

Viktigt!

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Denna artikel listar de sammanhangsvariabler för Azure och Copilot Studio-robotar och hur du konfigurerar dem i Flerkanal för Customer Service. Mer information om hur du skapar sammanhangsvariabler finns i Hantera kontextvariabler.

Sammanhangsvariabler för Azure robot

Följande tabell innehåller listan över kontextvariabler i Flerkanal för Customer Service som du kan använda för konfigurera Azure robot.

Typ av kontextvariabel Namn på kontextvariabel Beskrivning Hur du mappar i Azure
Undersökning före konversation Använd den frågetyp som du skapar i Flerkanal för Customer Service. Med kontextvariabler för svar före konversation lagrar kundsvar för frågor i undersökningen före konversationen. Använd följande information om du vill mappa variabeln för frågetyp i Flerkanal för Customer Service med variabeltypen i Azure:
  • Enkel rad: Sträng
    • Flera rader: Sträng
  • Alternativuppsättning: Sträng
  • Användarmedgivande: boolesk
Anpassad kontext Använd variabelns namn som du skapar Flerkanal för Customer Service eller pass med hjälp av setContextProvider API. Det här är anpassade sammanhangsvariabler som kan skapas och skickas via SDK för livechatt. Mappa användarens svar som en JSON för att använda anpassade sammanhangsvariabler i Flerkanal för Customer Service.
Konversation msdyn_ConversationId Använd den kontextvariabel som innehåller konversations-ID:t för den pågående konversationen och kan hämta och utföra åtgärder för posten i Microsoft Dataverse. Sträng: Sträng
Kontakt msdyn_contact_msdyn_ocliveworkitem_Customer Använd den här kontextvariabeln som innehåller post-ID för kundposten (kontakt) som är länkad till konversationen. Parsa JSON för att extrahera post-ID
Konto msdyn_account_msdyn_ocliveworkitem_Customer Använd den här kontextvariabeln som innehåller post-ID för kontoposten som är länkad till konversationen. Parsa JSON för att extrahera post-ID
Skiftläge msdyn_incident_msdyn_ocliveworkitem Använd den här kontextvariabeln som innehåller post-ID för ärendeposten som är länkad till konversationen. Parsa JSON för att extrahera post-ID

Kommentar

Använd de definierade namnen på kontextvariablerna. Ändra dem inte när du skapar flöden för chattrobotar i Azure eller Copilot Studio. Se till att använda exakt matchning för att skicka värdet till kontextvariabeln eftersom den är ärendekänslig. Om ett matchningsfel inträffar identifieras inte posten automatiskt. Mer information: Identifiera poster automatiskt

Sammanhangsvariabler för Copilot Studio robot

Följande tabell innehåller listan över kontextvariabler i Flerkanal för Customer Service som du kan använda för konfigurera Copilot Studio robot.

Viktigt!

För att kunna använda meddelande- och röstvariabler måste du först installera tilläggslösningarna.

Typ av kontextvariabel Namn på kontextvariabel Beskrivning Hur du mappar i Copilot Studio
Undersökning före konversation Använd den frågetyp som du skapar i Flerkanal för Customer Service. Med kontextvariabler för svar före konversation lagrar kundsvar för frågor i undersökningen före konversationen. Använd följande information om du vill mappa variabeln för frågetyp i Flerkanal för Customer Service med variabeltypen i Copilot Studio:
  • Enkel rad: Användarens hela svar
    • Flera rader: Användarens hela svar
  • Alternativuppsättning: Användarens hela svar
  • Användarmedgivande: boolesk
Anpassad kontext Använd variabelns namn som du skapar Flerkanal för Customer Service eller pass med hjälp av setContextProvider API. Det här är anpassade sammanhangsvariabler som kan skapas och skickas via SDK för livechatt. Använd följande information om du vill mappa den anpassade kontextvariabeln i Flerkanal för Customer Service med variabeltypen i Copilot Studio:
  • Sträng: Användarens hela svar
    • Boolesk: boolesk
  • Nummer, Flyttal: Tal
Konversation msdyn_ConversationId Använd den kontextvariabel som innehåller konversations-ID:t för den pågående konversationen och kan hämta och utföra åtgärder för posten i Microsoft Dataverse. Sträng: Användarens hela svar.
Meddelande- och röstvariabler msdyn_CustomerType Använd den här sammanhangsvariabeln som innehåller kundtypen för posten konto eller kontakt som är länkad till konversationen. Välj en Flerkanal för Customer Service-lösningsvariabel.
msdyn_CustomerName Använd den här sammanhangsvariabeln som innehåller kundnamnet för posten konto eller kontakt som är länkad till konversationen. Välj en Flerkanal för Customer Service-lösningsvariabel.
msdyn_CustomerId Använd den här sammanhangsvariabeln som innehåller kund-ID för posten konto eller kontakt som är länkad till konversationen. Välj en Flerkanal för Customer Service-lösningsvariabel.
msdyn_CaseId Använd den här sammanhangsvariabeln som innehåller ID för ärendepost posten som är länkad till konversationen. Välj en Flerkanal för Customer Service-lösningsvariabel.
msdyn_CaseTitle Använd den här sammanhangsvariabeln som innehåller rubrik för ärendepost posten som är länkad till konversationen. Välj en Flerkanal för Customer Service-lösningsvariabel.
Enbart röstvariabler CustomerPhoneNumber Använd den här sammanhangsvariabeln för kundens telefonnummer som finns i telefonaktiviteten. Välj en Flerkanal för Customer Service-lösningsvariabel.
OrganizationPhoneNumber Använd den här sammanhangsvariabeln för organisationens telefonnummer som finns i telefonaktiviteten. Välj en Flerkanal för Customer Service-lösningsvariabel.
Namn på tilläggsmetod va_SurveyConsent Använd den här dialogen för att avgöra om en kund har accepterat att delta i enkäter under samtalet. Använd den här metoden om du vill eskalera konversationsinformation till Flerkanal för Customer Service.
va_CustomerLocale Använd den här dialogrutan för att överföra användaren som pratar med roboten till en annan robot som kanske talar på ett annat språk. Ange koden genom att välja indatavariabeln och använda rätt språkkod.

Konfigurera kontextvariabler för Copilot Studio-robot

I Copilot Studio, gör följande:

  1. På sidan Ämnen väljer du Nytt ämne.

  2. På fliken Inställning, ange ett namn och en beskrivning och spara ämnet.

  3. Välj gå till arbetsytan för författande.

  4. Välj Lägg till nod, välj åtgärden Ställ en fråga.

  5. Redigera fältet Identifiera och i dialogrutan Välj information att identifiera välj ett alternativ som matchar datatyp för kontextvariabel. Information om mappningen av datatyper finns i informationen i föregående tabell.

  6. Redigera Spara svar som och i dialogrutan Variabelegenskaper uppdatera värdet för Namn med önskad kontextvariabel för kundtjänst. Se till att Robot (vilket ämne som helst kan komma åt) och Externa källor kan ställa in värden har valts. Alternativet Externa källor kan ställa in värden är endast tillämpligt för att få kontextvariabeln.

    Konfigurera kontextvariabel i ett ämne.

  7. Spara och publicera ändringarna.

Vid körningen tas den information som krävs in i kontextvariabeln som sedan kan användas för ytterligare åtgärder baserat på det arbetsflöde du konfigurerar. Roboten kan ange att informationen för sammanhangsvariablerna ska länka konversationen och ärendet när robot eskalerar konversationen till en handläggare. Mer information: Länka kund och ärende till en konversation

Du kan också konfigurera noden Överför till handläggare i ämnet Copilot Studio för att skicka ett privat meddelande med relevanta kontextvariabler till live-handläggare under eskaleringen.

De globala variablerna som skapas i Copilot Studio kan skickas till be Flerkanal för Customer Service när en konversation eskaleras. En fullständig lista finns i Sammanhangsberoende variabler som är tillgängliga vid överlämning.

Parsa JSON-objekt för att extrahera post-ID

Kontrollera att du har följande information:

  • Sammanhangsvariabeln Flerkanal för Customer Service, till exempel msdyn_contact_msdyn_ocliveworkitem_Customer.
  • Schemainformationen

En kopia av exempel schemainformationen är som följer:

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

PrimaryDisplayValue innehåller värdet från attributet i Dataverse entiteterna. Mappningen för entitetsattributen är som följer:

  • Ärende: ärenderubrik
  • Kontakter: fullständigt namn
  • Konton: Namn

Här är ett exempel på kontextpost:

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

Se även

Integrera en Copilot Studio-robot
Integrera Azure-robot
Konfigurera robotar för att eskalera och avsluta konversationer
SDK-referens för livechatt