Konfigurowanie zmiennych kontekstowych dla botów
Ważne
Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.
Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.
Ten artykuł wymienia zmienne kontekstowe dla Azure i botów Copilot Studio, i sposób ich konfigurowania w aplikacji Obsługa wielokanałowa dla Customer Service. Aby dowiedzieć się, jak tworzyć zmienne kontekstowe, zobacz temat Zarządzanie zmienne kontekstowe.
Zmienne kontekstowe dla botów Azure
Poniższa tabela zawiera listę zmiennych kontekstowych w aplikacji Obsługa wielokanałowa dla Customer Service, których można użyć do konfigurowania botów Azure.
| Typ zmiennej kontekstowej | Nazwa zmiennej kontekstu | Popis | Jak mapować w Azure |
|---|---|---|---|
| Ankieta przed konwersacją | Użyj typu pytania utworzonego w aplikacji Obsługa wielokanałowa dla Customer Service. | Zmienne kontekstowe odpowiedzi przed konwersacją przechowują odpowiedzi klientów na pytania w ankiecie przed konwersacją. | Użyj poniższych informacji, aby zamapować zmienną typu pytania w aplikacji Obsługa wielokanałowa dla Customer Service z typem zmiennej w Azure:
|
| Kontekst niestandardowy | Użyj nazwy zmiennej tworzonej w aplikacji Obsługa wielokanałowa dla Customer Service lub przekaż przy użyciu interfejsu API setContextProvider. | Są to niestandardowe zmienne kontekstowe, które można tworzyć i przekazywać za pośrednictwem SDK czatu na żywo. | Mapuj odpowiedź użytkownika jako JSON, aby użyć niestandardowej zmiennej kontekstowej w aplikacji Obsługa wielokanałowa dla Customer Service. |
| Konwersacja | msdyn_ConversationId | Użyj zmiennej kontekstowej, która zawiera identyfikator konwersacji dla trwającej konwersacji i może pobierać i wykonywać operacje na rekordzie w Microsoft Dataverse. | Ciąg: Ciąg |
| Kontakt biznesowy | msdyn_contact_msdyn_ocliveworkitem_Customer | Użyj tej zmiennej kontekstowej, która zawiera identyfikator rekordu dla rekordu klienta (kontaktu), który jest połączony z konwersacją. | Analizuj JSON, aby wyodrębnić identyfikator rekordu |
| Konto | msdyn_account_msdyn_ocliveworkitem_Customer | Użyj tej zmiennej kontekstowej, która zawiera identyfikator rekordu dla rekordu konta, który jest połączony z konwersacją. | Analizuj JSON, aby wyodrębnić identyfikator rekordu |
| Przypadek | msdyn_incident_msdyn_ocliveworkitem | Użyj tej zmiennej kontekstowej, która zawiera identyfikator rekordu dla rekordu sprawy, który jest połączony z konwersacją. | Analizuj JSON, aby wyodrębnić identyfikator rekordu |
Uwaga
Używaj zdefiniowanych nazw zmiennych kontekstowych i nie zmieniaj ich, gdy tworzysz przepływy w Azure lub boty Copilot Studio. Pamiętaj też, aby użyć dokładnego dopasowania do przekazania wartości do zmiennej kontekstowej, ponieważ rozróżniana jest wielkość liter. Jeśli istnieje niezgodność, rekord nie zostanie automatycznie zidentyfikowany. Więcej informacji: Automatyczne identyfikowanie rekordów
Zmienne kontekstowe dla botów Copilot Studio
Poniższa tabela zawiera listę zmiennych kontekstowych dostępnych w aplikacji Obsługa wielokanałowa dla Customer Service, których można użyć do konfigurowania botów Copilot Studio.
Ważne
Aby być w stanie używać zmiennych wiadomości i komunikatów głosowych, upewnij się, że najpierw zainstalujesz rozwiązania rozszerzeń.
| Typ zmiennej kontekstowej | Nazwa zmiennej kontekstu | Popis | Jak mapować w Copilot Studio |
|---|---|---|---|
| Ankieta przed konwersacją | Użyj typu pytania utworzonego w aplikacji Obsługa wielokanałowa dla Customer Service. | Zmienne kontekstowe odpowiedzi przed konwersacją przechowują odpowiedzi klientów na pytania w ankiecie przed konwersacją. | Użyj poniższych informacji, aby zamapować zmienną typu pytania w aplikacji Obsługa wielokanałowa dla Customer Service z typem zmiennej w Copilot Studio:
|
| Kontekst niestandardowy | Użyj nazwy zmiennej tworzonej w aplikacji Obsługa wielokanałowa dla Customer Service lub przekaż przy użyciu setContextProvider API. | Są to niestandardowe zmienne kontekstowe, które można tworzyć i przekazywać za pośrednictwem SDK czatu na żywo. | Użyj poniższych informacji, aby zamapować zmienną kontekstu niestandardowego w aplikacji Obsługa wielokanałowa dla Customer Service z typem zmiennej w Copilot Studio:
|
| Konwersacja | msdyn_ConversationId | Użyj zmiennej kontekstowej, która zawiera identyfikator konwersacji dla trwającej konwersacji i może pobierać i wykonywać operacje na rekordzie w Microsoft Dataverse. | Ciąg: Cała odpowiedź użytkownika. |
| Zmienne wiadomości i komunikatów głosowych | msdyn_CustomerType | Użyj tej zmiennej kontekstowej zawierającej typ klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. |
| msdyn_CustomerName | Użyj tej zmiennej kontekstowej zawierającej nazwę klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. | |
| msdyn_CustomerId | Użyj tej zmiennej kontekstowej zawierającej identyfikator klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. | |
| msdyn_CaseId | Użyj tej zmiennej kontekstowej zawierającej identyfikator rekordu sprawy, który jest połączony z rozmową. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. | |
| msdyn_CaseTitle | Użyj tej zmiennej kontekstowej zawierającej tytuł rekordu sprawy, który jest połączony z rozmową. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. | |
| Zmienne Tylko głos | CustomerPhoneNumber | Użyj tej zmiennej kontekstowej dla numeru telefonu klienta podanego w działaniu Telefonia. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. |
| OrganizationPhoneNumber | Użyj tej zmiennej kontekstowej dla numeru telefonu organizacji podanego w działaniu Telefonia. | Wybierz zmienną rozwiązania rozszerzenia aplikacji Obsługa wielokanałowa dla Customer Service. | |
| Nazwa metody rozszerzenia | va_SurveyConsent | Ten dialog pozwala określić, czy klient zgadza się wziąć udział w ankietach podczas rozmowy. | Ta metoda służy do eskalowania szczegółów rozmowy do aplikacji Obsługa wielokanałowa dla Customer Service. |
| va_CustomerLocale | Ten dialog jest używany do przenoszenia użytkownika aktualnie rozmawiającego z botem do innego bota, który może używać innego języka. | Ustaw kod, wybierając zmienną wejściową i używając poprawnego kodu ustawienia regionalnego. | |
Konfigurowanie zmiennych kontekstowych dla botów Copilot Studio
W Copilot Studio wykonaj następujące działania:
Na stronie Tematy wybierz Nowy temat.
Na karcie Ustawienia wprowadź nazwę i opis, i zapisz temat.
Wybierz opcję Przejdź do kanwy tworzenia.
Wybierz Dodaj węzeł, wybierz akcję Zadaj pytanie.
Edytuj pole Identyfikowanie, a następnie w oknie dialogowym Wybieranie informacji do zidentyfikowania wybierz opcję, która będzie zgodna z typem danych zmiennej kontekstowej. Aby uzyskać informacje na temat mapowania typu danych, zobacz informacje w powyższej tabeli.
Edytuj Zapisz odpowiedź jako, a w oknie dialogowym Właściwości zmiennej zaktualizuj wartość dla Nazwa przy użyciu wymaganej zmiennej kontekstowej aplikacji Obsługa wielokanałowa dla Customer Service. Upewnij się, że Bot (każdy temat może uzyskać dostęp) i Źródła zewnętrzne mogą ustawić wartości zostały zaznaczone. Opcja Źródła zewnętrzne mogą ustawiać wartości jest dostępna tylko do uzyskiwania zmiennej kontekstowej.
Zapisz i opublikuj zmiany.
W czasie wykonywania wymagane informacje są przechwytywane w zmiennej kontekstowej, która może być następnie używana do dalszych akcji na podstawie skonfigurowanego przepływu pracy. Bot może ustawić informacje dla zmiennych kontekstowych tak, aby połączyć rozmowę i sprawę, gdy bot eskaluje rozmowę do agenta. Więcej informacji: Łączenie klienta i sprawy z konwersacją
Można również skonfigurować węzeł Transfer do agenta w temacie Copilot Studio, aby wysłać wiadomość prywatną z odpowiednimi zmiennymi kontekstowymi do agenta, który jest człowiekiem, podczas eskalacji.
Zmienne globalne, które zostały utworzone w Copilot Studio mogą być przekazywane do Obsługa wielokanałowa dla Customer Service w momencie eskalowania rozmowy. Aby uzyskać pełną listę, zobacz Zmienne kontekstowe dostępne w chwili przekazywania.
Analizuj obiekt JSON w celu wyodrębnienia identyfikatora rekordu
Upewnij się że posiadasz poniższe informacje szczegółowe:
- Zmienna kontekstowa aplikacji Obsługa wielokanałowa dla Customer Service, taka jak msdyn_contact_msdyn_ocliveworkitem_Customer.
- Szczegóły schematu
Kopia szczegółów schematu przykładu jest następująca:
Schema:
{
"type": "array",
"items": {
"type": "object",
"properties": {
"RecordId": {
"type": "string"
},
"PrimaryDisplayValue": {
"type": "string"
}
},
"required": [
"RecordId",
"PrimaryDisplayValue"
]
}
}
PrimaryDisplayValue będzie zawierać wartość z atrybutu w encjach Dataverse. Mapowanie atrybutów encji jest następujące:
- Sprawy: Tytuł sprawy
- Kontakty: Pełna nazwa
- Konta: Nazwa
Oto przykładowy rekord kontekstu.
{
"msdyn_contact_msdyn_ocliveworkitem_Customer": [
{
"RecordId": "<GUID>",
"PrimaryDisplayValue": "<FullName>"
}
],
"msdyn_liveworkitemid": "<GUID>"
}
Zobacz też
Integruj bota Copilot Studio
Integruj bota Azure
Konfigurowanie botów w celu eskalowania i kończenia konwersacji
Odwołanie SDK czatu na żywo