Konfigurieren von Kontextvariablen für Bots

Dieser Artikel führt Kontextvariablen hinzu und zeigt, wie Sie diese für Azure und Copilot Studio Bots in Omnichannel for Customer Service konfigurieren können. Informationen zum Erstellen von Kontextvariablen finden Sie unter Kontextvariablen verwalten.

Kontextvariablen für Azure Bots festlegen

Die folgende Tabelle enthält die Liste der Kontextvariablen in Omnichannel for Customer Service, die Sie für die Konfiguration von Azure Bots verwenden können.

Kontextvariablen für Copilot Studio Bots festlegen

Die folgende Tabelle enthält die Liste der Kontextvariablen in Omnichannel for Customer Service, die Sie für die Konfiguration von Copilot Studio Bots verwenden können.

Konfigurieren von Kontextvariablen für Copilot Studio Bot

Um Ihre Copilot Studio Bot Kontextvariablen aus Omnichannel zu lesen, führen Sie die folgenden Schritte aus:

1. Wählen Sie auf der Seite Themen Neues Thema hinzufügen und ohne Vorlage aus.

2. Geben Sie einen Namen für Ihr Thema ein (z. B. „Kontextvariablen festlegen“) und speichern Sie es.

3. Wählen Sie einen neunen Knoten für das Thema und wählen Sie Vairablenverwaltung > Einen Variablenwert festlegen

4. In Ihrem neuen Knoten unter Variablen hinzufügen wählen Sie Neue Variable erstellen.

5. Öffnet den Bereich Variableneigenschaften durch Klicken auf den neuen Variablennamen. Legen Sie im Fenster den Variablennamen fest, um genau mit dem Namen der Omnichannel-Kontextvariablen übereinzustimmen (Groß-/Kleinschreibung wird beachtet).

6. Wählen Sie im Abschnitt Referenz die Auslassungspunkte (...) aus und wählen Sie Wert von diesem Knoten abrufen, wenn leer. Der Copilot Studio Bot ruft den Variablenwert zur Laufzeit von diesem Knoten ab.

7. Im Abschnitt Nutzung wählen Sie Global (jedes Thema kann darauf zugreifen) und Externe Quelle kann Werte festlegen. Copilot Studio akzeptiert Daten von Omnichannel. Den Bereich Variableneigenschaften schließen.

8. Geben Sie in Ihrem Knoten im Feld Bis-Wert einen Wert ein, der dem Datentyp entspricht, den Ihr Bot erwartet. Wenn Ihr Bot beispielsweise eine Zeichenfolge erwartet, legen Sie Text("") fest. Copilot Studio fällt auf den Wert zurück, den Sie hier festlegen, wenn die Daten nicht in der Unterhaltung ankommen.

   

9. Speichern und veröffentlichen Sie die Änderungen.

Während einer Unterhaltung werden die Daten aus der Omnichannel-Kontextvariable in die Copilot Studio Variablen gesetzt und können in der Logik des Bots verwendet werden.

Der Bot kann während einer Unterhaltung auch Omnichannel-Kontextvariablen festlegen. Um eine Omnichannel-Variable aus Ihrer Copilot Studio Logik festzulegen, stellen Sie sicher, dass Ihr Bot den richtigen Variablennamen verwendet, und legen Sie den Wert in der Eigenschaft „Bis-Wert“ in Ihrem Variablenverwaltungsknoten fest. Copilot Studio übergibt die Variable während der Übertragung an den Agenten an Omnichannel. Dies wird häufig verwendet, um die Unterhaltung mit einem Fall zu verknüpfen, wenn der Bot die Unterhaltung an einen Agenten eskaliert. Weitere Informationen zum Verknüpfen von Datensätzen in Omnichannel aus diesen Daten: Kunde und Fall mit einer Unterhaltung verknüpfen

Die globalen Variablen, die in Copilot Studio erstellt wurden, können an den Omnichannel for Customer Service übergeben werden, wenn eine Konversation eskaliert. Die vollständige Liste finden Sie unter Kontextvariablen bei Übergabe verfügbar.

Analysieren Sie das JSON-Objekt, um die Datensatz-ID zu extrahieren

Stellen Sie sicher, dass Sie die folgenden Details haben:

• Die Omnichannel for Customer Service Kontextvariable, z. B. msdyn_contact_msdyn_ocliveworkitem_Customer.
• Die Schemadetails

Eine Kopie der Beispielschemadetails lautet wie folgt:

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

PrimaryDisplayValue enthält den Wert aus dem Attribut in den Dataverse Entitäten. Die Zuordnung für die Entitätsattribute lautet wie folgt:

• Anfragen: Anfragetitel
• Kontakte: Vollständiger Name
• Firmen: Name

Hier ist eine Beispiel-Kontextdatensatz.

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

Siehe auch

Integrieren Sie einen Copilot Studio-Bot
Integrieren Sie einen Azure Bot
Einen Bot konfigurierien, um Unterhaltungen zu eskalieren und zu beenden
Livechat SDK Referenz