Nakonfigurujte kontextové proměnné pro roboty

Článek
12/08/2023

Důležité

Schopnosti a funkce Power Virtual Agents jsou nyní součástí Microsoft Copilot Studio po významných investicích do generativní umělé inteligence a vylepšených integracích napříč Microsoft Copilot.

Některé články a snímky obrazovky mohou odkazovat na Power Virtual Agents, zatímco aktualizujeme dokumentaci a obsah školení.

Tento článek obsahuje seznam kontextových proměnných pro roboty Azure a Copilot Studio s informacemi, jak je můžete použít k jejich konfiguraci v aplikaci Omnikanál pro Customer Service. Chcete-li pochopit, jak vytvořit kontextové proměnné, viz Správa kontextových proměnných.

Kontextové proměnné pro roboty Azure

Následující tabulka obsahuje seznam kontextových proměnných v Omnikanálu pro Customer Service, které můžete použít ke konfiguraci robotů Azure.

Typ kontextové proměnné	Název kontextové proměnné	Description	Jak mapovat v Azure
Průzkum před konverzací	Použijte typ otázky, který vytvoříte v Omnikanálu pro Customer Service.	Kontextové proměnné pro odpovědi před konverzací ukládají odpovědi zákazníků na otázky v průzkumu před konverzací.	Pomocí následujících informací můžete namapovat proměnnou typu otázky v Omnikanálu pro Customer Service s typem proměnné v Azure: Jeden řádek: Řetězec Více řádků: Řetězec Sada možností: Řetězec Souhlas uživatele: Logická hodnota
Vlastní kontext	Použijte název proměnné, který vytvoříte v Omnikanálu pro Customer Service nebo předáte pomocí rozhraní API setContextProvider.	Toto jsou vlastní kontextové proměnné, které lze vytvořit a předat prostřednictvím sady SDK pro živý chat.	Mapujte odezvu uživatele jako JSON, abyste mohli použít vlastní kontextové proměnné v Omnikanálu pro Customer Service.
Konverzace	msdyn_ConversationId	Použijte kontextovou proměnnou, která obsahuje ID konverzace pro probíhající konverzaci a můžete načíst a provádět operace se záznamem v Microsoft Dataverse.	Řetězec: Řetězec
Kontakt	msdyn_contact_msdyn_ocliveworkitem_Customer	Použijte tuto kontextovou proměnnou, která obsahuje ID záznamu pro záznam zákazníka (kontaktu), který je propojen s konverzací.	Analýza JSON pro extrakci ID záznamu
Účet	msdyn_account_msdyn_ocliveworkitem_Customer	Použijte tuto kontextovou proměnnou, která obsahuje ID záznamu pro záznam obchodního vztahu, který je propojen s konverzací.	Analýza JSON pro extrakci ID záznamu
Případ	msdyn_incident_msdyn_ocliveworkitem	Použijte tuto kontextovou proměnnou, která obsahuje ID záznamu pro záznam případu, který je propojen s konverzací.	Analýza JSON pro extrakci ID záznamu

Poznámka:

Při vytváření toků v robotech Azure nebo Copilot Studio používejte definované názvy kontextových proměnných a neměňte je. K předání hodnoty kontextové proměnné také nezapomeňte použít přesnou shodu, protože se v ní rozlišují velká a malá písmena. Pokud dojde k neshodě, záznam nebude automaticky identifikován. Více informací: Automatická identifikace záznamů

Kontextové proměnné pro roboty Copilot Studio

Následující tabulka obsahuje seznam kontextových proměnných dostupných v Omnikanálu pro Customer Service, které můžete použít ke konfiguraci robotů Copilot Studio.

Důležité

Abyste mohli používat proměnné zpráv a hlasu, ujistěte se, že jste nejprve instalovali řešení rozšíření.

Typ kontextové proměnné	Název kontextové proměnné	Description	Jak mapovat v Copilot Studio
Průzkum před konverzací	Použijte typ otázky, který vytvoříte v Omnikanálu pro Customer Service.	Kontextové proměnné pro odpovědi před konverzací ukládají odpovědi zákazníků na otázky v průzkumu před konverzací.	Pomocí následujících informací můžete namapovat proměnnou typu otázky v Omnikanálu pro Customer Service s typem proměnné v Copilot Studio: Jeden řádek: Celá odpověď uživatele Více řádků: Celá odpověď uživatele Sada možností: Celá odpověď uživatele Souhlas uživatele: Logická hodnota
Vlastní kontext	Použijte název proměnné, kterou vytvoříte v aplikaci Omnikanál pro Customer Service, nebo předejte pomocí rozhraní API setContextProvider.	Toto jsou vlastní kontextové proměnné, které lze vytvořit a předat prostřednictvím sady SDK pro živý chat.	Pomocí následujících informací můžete namapovat proměnnou vlastního kontextu v Omnikanálu pro Customer Service s typem proměnné v Copilot Studio: Řetězec: Celá odpověď uživatele Logická hodnota: Logická hodnota Číslo, Číslo s plovoucí desetinnou čárkou: Číslo
Konverzace	msdyn_ConversationId	Použijte kontextovou proměnnou, která obsahuje ID konverzace pro probíhající konverzaci a můžete načíst a provádět operace se záznamem v Microsoft Dataverse.	Řetězec: Celá odpověď uživatele.
Proměnné zpráv a hlasu	msdyn_CustomerType	Použijte tuto kontextovou proměnnou, která obsahuje typ zákazníka pro záznam obchodního vztahu nebo kontaktu, který je propojen s konverzací.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
	msdyn_CustomerName	Použijte tuto kontextovou proměnnou, která obsahuje jméno zákazníka pro záznam obchodního vztahu nebo kontaktu, který je propojen s konverzací.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
	msdyn_CustomerId	Použijte tuto kontextovou proměnnou, která obsahuje ID zákazníka pro záznam obchodního vztahu nebo kontaktu, který je propojen s konverzací.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
	msdyn_CaseId	Použijte tuto kontextovou proměnnou, která obsahuje ID záznamu případu, který je propojen s konverzací.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
	msdyn_CaseTitle	Použijte tuto kontextovou proměnnou, která obsahuje název záznamu případu, který je propojen s konverzací.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
Jen hlasové proměnné	CustomerPhoneNumber	Tuto kontextovou proměnnou použijte pro telefonní číslo zákazníka, které je uvedeno v aktivitě Telefonování.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
	OrganizationPhoneNumber	Tuto kontextovou proměnnou použijte pro telefonní číslo organizace, které je uvedeno v aktivitě Telefonování.	Vyberte proměnnou řešení rozšíření Omnikanálu pro Customer Service.
Název metody rozšíření	va_SurveyConsent	Pomocí tohoto dialogového okna můžete zjistit, zda zákazník během konverzace souhlasil s účastí v průzkumech.	Tuto metodu použijte k eskalaci údajů konverzace na Omnikanál pro Customer Service.
	va_CustomerLocale	Pomocí tohoto dialogu můžete uživatele, který aktuálně mluví s robotem, převést na jiného robota, který mluví jiným jazykem.	Nastavte kód výběrem vstupní proměnné a použitím správného kódu národního prostředí.

Konfigurace kontextových proměnných pro robota Copilot Studio

V Copilot Studio postupujte takto:

Na stránce Témata vyberte Nové téma.
Na kartě Nastavení zadejte název a popis a uložte téma.
Vyberte Přejít na autorské plátno.
Vyberte Přidat uzel a pak akci Položit otázku.
Upravte pole Identifikovat a v poli dialogového okna Vybrat informace, které chcete identifikovat vyberte možnost, která bude odpovídat datovému typu kontextové proměnné. Informace o mapování datových typů najdete v předchozí tabulce.
Upravte Uložit odpověď jako a v dialogovém okně Vlastnosti proměnných aktualizujte hodnotu Název s požadovanou kontextovou proměnnou Omnikanálu pro Customer Service. Ujistěte se, že jsou vybrány možnosti Robot (má přístup ke každému tématu) a Externí zdroje mohou nastavovat hodnoty. Možnost Externí zdroje mohou nastavovat hodnoty je použitelná pouze pro získání kontextové proměnné.
Uložte a publikujte změnu.

Za běhu jsou požadované informace zachyceny v kontextové proměnné, kterou lze poté použít pro další akce na základě pracovního postupu, který nakonfigurujete. Robot může nastavit informace pro kontextové proměnné tak, aby propojily konverzaci a případ, kdy robot eskaluje konverzaci na agenta. Další informace: Propojení zákazníka a případu s konverzací

Můžete také nakonfigurovat uzel Předat agentovi v tématu Copilot Studio k odeslání soukromé zprávy s relevantními kontextovými proměnnými živému agentovi během eskalace.

Globální proměnné, které jsou vytvořeny v Copilot Studio, lze předat do Omnikanálu pro Customer Service, když je konverzace eskalována. Úplný seznam najdete v části Kontextové proměnné dostupné po předání.

Analyzování objektů JSON pro extrahování ID záznamu

Ujistěte se, že máte následující podrobnosti:

Kontextová proměnná Omnikanálu pro Customer Service, jako je msdyn_contact_msdyn_ocliveworkitem_Customer.
Podrobnosti schématu

Kopie podrobností ukázkového schématu je následující:

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

PrimaryDisplayValue bude obsahovat hodnotu z atributu v entitách Dataverse. Mapování atributů entity je následující:

Případy: Název případu
Kontakty: Celé jméno
Obchodní vztahy: Název

Zde je ukázka záznamu kontextu.

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

Viz také

Integrace robota Copilot Studio
Integrace robota Azure
Konfigurace eskalace a ukončení konverzací roboty
Informace o sadě SDK pro živý chat

Sdílet prostřednictvím