Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy tylko: Dynamics 365 Contact Center autonomiczne i Dynamics 365 Customer Service
Notatka
Nazwa bota Copilot Studio zostanie zmieniona na agent funkcji Copilot (agent lub agent AI). Nazwa człowieka agent została zmieniona na przedstawiciela działu obsługi klienta (przedstawiciela działu obsługi klienta lub przedstawiciela). Możesz natknąć się na odwołania do starych i nowych terminów podczas aktualizowania interfejsu użytkownika, dokumentacji i zawartości szkoleniowej produktu.
W tym artykule wymieniono zmienne kontekstowe dla agentów platformy Azure i Copilot oraz sposób ich konfigurowania w centrum kontaktów usługi Dynamics 365. Aby dowiedzieć się, jak tworzyć zmienne kontekstowe, zobacz temat Zarządzanie zmienne kontekstowe.
Zmienne kontekstowe dla agentów funkcji Copilot
Poniższa tabela zawiera listę zmiennych kontekstowych dostępnych w centrum kontaktów usługi Dynamics 365, których można użyć do konfigurowania agentów Copilot.
Ważne
- Niektóre zmienne są łatwiej dostępne w przypadku instalowania rozwiązań rozszerzeń.
- Program Copilot Studio może odbierać zmienne asynchronicznie podczas konwersacji. Dzięki temu agent AI może powitać użytkowników z małymi opóźnieniami, używając niestandardowych danych dostarczonych przez Contact Center podczas konwersacji. Podczas projektowania agenta należy wziąć pod uwagę zarówno źródła danych, jak i czas pobierania, ponieważ w informacjach ze środowisk Dataverse mogą wystąpić opóźnienia. Skonfiguruj ustawienia limitu czasu w definicji zmiennej, aby prawidłowo zarządzać danymi przychodzącymi z opóźnieniem. Dowiedz się więcej w temacie Ustawianie zmiennych globalnych ze źródeł zewnętrznych.
| Typ zmiennej kontekstowej | Nazwa zmiennej kontekstu | Podpis | Jak mapować w Copilot Studio |
|---|---|---|---|
| Ankieta przed konwersacją | Użyj nazwy pytania ankiety wstępnej konwersacji utworzonej w Centrum kontaktów usługi Dynamics 365. | W systemie odpowiedzi z ankiety przed rozmową są przechowywane jako zmienne kontekstowe. | Użyj poniższych informacji, aby mapować nazwę pytania w aplikacji Dynamics 365 Contact Center z typem zmiennej w Copilot Studio:
|
| Kontekst niestandardowy dla czatu | Użyj nazwy zmiennej, którą tworzysz w aplikacji Dynamics 365 Contact Center lub przekaż przy użyciu interfejsu API setContextProvider. | Niestandardowe zmienne kontekstowe, które tworzysz, można przekazywać za pośrednictwem SDK czatu na żywo. | Użyj poniższych informacji, aby mapować zmienną kontekstu niestandardowego w aplikacji Dynamics 365 Contact Center z typem zmiennej w Copilot Studio:
|
| Kontekst niestandardowy dla Direct Line | Użyj nazwy zmiennej utworzonej w Centrum kontaktów usługi Dynamics 365. | Niestandardowe zmienne kontekstowe, które można utworzyć, mogą być przekazywane jako pary klucz-wartość w pliku Activity.ChannelData.ConversationContext, gdy klient DirectLine rozpoczyna konwersację. | Użyj poniższych informacji, aby mapować zmienną kontekstu niestandardowego w aplikacji Dynamics 365 Contact Center z typem zmiennej w Copilot Studio:
|
| Zmienne ustawiane według reguł klasyfikacji pracy | Użyj nazwy zmiennej utworzonej w centrum administracyjnym Contact Center. | Zmienne niestandardowe generowane w ramach reguł klasyfikacji pracy wymagają dodatkowego czasu przetwarzania w celu wygenerowania kontekstu. Ustaw limit czasu dla kontekstu klasyfikacji pracy w agencie AI. Dowiedz się więcej w temacie Ustawianie zmiennych globalnych ze źródeł zewnętrznych. | Użyj poniższych informacji, aby mapować zmienną kontekstu niestandardowego w aplikacji Dynamics 365 Contact Center 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 tylko do obsługi wiadomości | msdyn_CustomerType 1 | Użyj tej zmiennej kontekstowej zawierającej typ klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną dla rozwiązania rozszerzenia wielokanałowego. |
| msdyn_CustomerName 1 | Użyj tej zmiennej kontekstowej zawierającej nazwę klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną rozwiązania rozszerzenia wielokanałowego. | |
| msdyn_CustomerId 1 | Użyj tej zmiennej kontekstowej zawierającej identyfikator klienta dla rekordu konto lub kontakt połączonego z rozmową. | Wybierz zmienną rozwiązania rozszerzenia wielokanałowego. | |
| msdyn_CaseId 1 | Użyj tej zmiennej kontekstowej zawierającej identyfikator rekordu sprawy, który jest połączony z rozmową. Dane są pobierane ze środowiska Dataverse w ramach automatycznej identyfikacji klienta. W związku z tym agent AI może mieć opóźnienie w odbieraniu danych. | Wybierz zmienną rozwiązania rozszerzenia wielokanałowego. | |
| msdyn_CaseTitle 1 | Użyj tej zmiennej kontekstowej zawierającej tytuł rekordu sprawy, który jest połączony z rozmową. | Wybierz zmienną rozwiązania rozszerzenia omnichannel. | |
| msdyn_ChannelInstanceId | Unikatowy identyfikator rekordu wystąpienia kanału Dataverse, na przykład unikatowy identyfikator skonfigurowanego widgetu czatu lub strony serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_WorkstreamId | Unikatowy identyfikator strumienia pracy usługi Dataverse skojarzony z wystąpieniem kanału. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_Locale | Skonfigurowany kod ustawień regionalnych w wystąpieniu kanału, na przykład widget czatu lub strona serwisu Facebook. Może to być używane w scenariuszach, takich jak wielojęzyczni agenci Copilot Studio. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_SocialProfileId | Unikatowy identyfikator rekordu Dataverse dla profilu społecznościowego skojarzonego z konwersacją. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_LineCustomerName | Nazwa klienta z interfejsu API LINE. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_TeamsCustomerName | Nazwa klienta z usługi Microsoft Teams. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_TeamsCustomerEmail | Adres e-mail (UPN) z usługi Microsoft Teams. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_CapabilityList | Wartości listy możliwości usługi Apple Messages for Businesses są ciągiem rozdzielanym. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_AppleMessagesForBusinessGroupId | Identyfikator grupy Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_AppleMessagesForBusinessIntentId | Identyfikator intencji Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_AppleMessagesForBusinessLocale | Ustawienia regionalne udostępniane przez interfejs API Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_AppleBusinessId | Identyfikator firmy z konta Apple Messages for Business. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_FacebookCustomerName | Nazwa klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_FacebookLocale | Ustawienia regionalne użytkownika końcowego klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_FacebookTimezone | Strefa czasowa klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_FacebookUserPageScopedId | Identyfikator użytkownika specyficzny dla strony klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_FacebookPageId | Identyfikator PageID ze strony serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_CustomerPhoneNumber | Numer telefonu, w jaki klient wysyła wiadomości tekstowe pochodzi z kanałów WhatsApp i SMS. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_OrganizationPhoneNumber | Numer telefonu odbierający wiadomości od klienta (numer organizacji). Należy pamiętać, że nie jest on przekazywany w aplikacji WhatsApp za pośrednictwem usług Azure Communication Services. | Ciąg: Cała odpowiedź użytkownika. | |
| msdyn_WhatsAppCustomerFirstMessage | Jeśli używasz wstępnie wypełnionej wiadomości w uniwersalnym linku WhatsApp, te informacje zostaną przekazane w tej zmiennej. | Ciąg: Cała odpowiedź użytkownika. | |
| Zmienne Tylko głos 2 | Activity.From.Name | Użyj tej zmiennej kontekstowej dla numeru telefonu klienta podanego w działaniu Telefonia. Przypisz tę zmienną do zmiennej globalnej w temacie Rozpoczęcie konwersacji. Dowiedz się więcej w temacie Konfigurowanie zmiennych kontekstowych dla agenta Copilot Studio. | Wybierz zmienną systemową z programu Microsoft Copilot Studio. |
| Activity.Recipient.Name | Użyj tej zmiennej kontekstowej dla numeru telefonu organizacji podanego w działaniu Telefonia. Przypisz tę zmienną do zmiennej globalnej w temacie Rozpoczęcie konwersacji. Dowiedz się więcej w temacie Konfigurowanie zmiennych kontekstowych dla agenta Copilot Studio. | Wybierz zmienną systemową z programu Microsoft Copilot Studio. | |
| Nazwa metody rozszerzenia | va_SurveyConsent | Ten dialog pozwala określić, czy klient zgadza się wziąć udział w ankietach podczas rozmowy. | Użyj tej metody, aby eskalować szczegóły konwersacji do Centrum kontaktów usługi Dynamics 365. |
| va_CustomerLocale | Ten dialog jest używany do przenoszenia użytkownika aktualnie rozmawiającego z agentem do innego agenta, który może używać innego języka. | Ustaw kod, wybierając zmienną wejściową i używając poprawnego kodu ustawienia regionalnego. |
1 Aby użyć innych zmiennych kontekstowych dla głosu, możesz je uzyskać z Copilot Studio. Więcej informacji: Praca z artykułami merytorycznymi.
Konfigurowanie zmiennych kontekstowych dla agenta funkcji Copilot
Aby Twój agent Copilot mógł odczytać zmienne kontekstowe z Centrum Kontaktów Dynamics 365, wykonaj następujące czynności:
Na stronie Tematy wybierz pozycję Dodaj temat>z pustego. Użyj tematu, który nie jest wywoływany lub już istnieje, ponieważ w przeciwnym razie zmienna kontekstowa nie będzie działać.
Wprowadź nazwę tematu, na przykład Ustaw zmienne kontekstowe, i zapisz go.
Dodaj nowy węzeł do tematu, a następnie wybierz Zarządzanie zmiennymi > Ustaw wartość zmiennej.
W nowym węźle w obszarze Ustaw zmienną wybierz Utwórz nową zmienną.
Otwórz okienko Właściwości zmiennej, wybierając nową nazwę zmiennej. W okienku Ustaw nazwę zmiennej tak, aby była dokładnie zgodna z nazwą zmiennej kontekstowej Obsługi wielokanałowej (uwzględniana jest wielkość liter).
W sekcji Odwołanie wybierz wielokropek pionowy, a następnie wybierz pozycję Pobierz wartość z tego węzła, jeśli jest pusty. Agent Copilot Studio pobiera wartość zmiennej z tego węzła w czasie wykonywania.
W sekcji Użycie wybierz pozycję Globalne (dowolny temat może uzyskiwać dostęp) i Źródła zewnętrzne mogą ustawiać wartości, aby agent Copilot Studio akceptował dane z Obsługi wielokanałowej, a ta zmienna mogła być używana w dowolnym temacie.
Jeśli używasz danych z reguł klasyfikacji pracy w zmiennej, upewnij się, że w definicji zmiennej ustawiono limit czasu. Dowiedz się więcej w temacie Ustawianie zmiennych globalnych ze źródeł zewnętrznych.
Zamknij okienko Właściwości zmiennej.
W węźle wprowadź wartość w polu Wartość, która odpowiada typowi danych oczekiwanemu przez agenta.
Zapisz i opublikuj zmiany.
Notatka
Dostęp do zmiennej Activity.From.Name można uzyskać tylko z tematu Rozpoczynanie konwersacji. Zalecamy utworzenie zmiennej globalnej w temacie Rozpoczynanie konwersacji, ustawienie wartości zmiennej na Activity.From.Name, a następnie użycie zmiennej globalnej w innych tematach. Dzięki temu możesz uzyskać dostęp do numeru telefonu klienta w dowolnym temacie agenta Copilot Studio.
Podczas konwersacji dane ze zmiennej kontekstowej centrum kontaktów są ustawiane w zmiennych programu Copilot Studio i mogą być używane w logice agenta.
Agent może również ustawić zmienne kontekstowe obsługi wielokanałowej podczas konwersacji. Aby ustawić zmienną Obsługi wielokanałowej z poziomu logiki Copilot Studio, upewnij się, że agent używa prawidłowej nazwy zmiennej i ustaw wartość we właściwości „Wartość docelowa” w węźle zarządzania zmiennymi. Copilot Studio przekazuje zmienną do aplikacji Obsługa wielokanałowa podczas przenoszenia do przedstawiciela działu obsługi klienta. Jest to często używane do łączenia konwersacji z przypadkiem, gdy agent eskaluje konwersację do przedstawiciel działu obsługi. Więcej informacji o łączeniu rekordów w Obsłudze wielokanałowej z tych danych: Łączenie klienta i sprawy z rozmową
Zmienne globalne utworzone w programie Copilot Studio można przekazać do Centrum kontaktów usługi Dynamics 365 po eskalacji konwersacji. 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 Centrum kontaktów Dynamics 365, 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:
- Przypadki: tytuł przypadku
- Kontakty: imię i nazwisko
- Konta: nazwa
Oto przykładowy rekord kontekstu.
{
"msdyn_contact_msdyn_ocliveworkitem_Customer": [
{
"RecordId": "<GUID>",
"PrimaryDisplayValue": "<FullName>"
}
],
"msdyn_liveworkitemid": "<GUID>"
}
Zmienne kontekstowe dla agentów Azure
Poniższa tabela zawiera listę zmiennych kontekstowych w centrum kontaktów usługi Dynamics 365, których można użyć do konfigurowania agentów platformy Azure.
| Typ zmiennej kontekstowej | Nazwa zmiennej kontekstu | Podpis | Jak mapować w Azure |
|---|---|---|---|
| Ankieta przed konwersacją | Użyj nazwy pytania ankiety wstępnej konwersacji utworzonej w Centrum kontaktów usługi Dynamics 365. | W systemie odpowiedzi z ankiety przed rozmową są przechowywane jako zmienne kontekstowe. | Użyj poniższych informacji, aby mapować nazwę pytania w aplikacji Dynamics 365 Contact Center z typem zmiennej w Azure:
|
| Kontekst niestandardowy | Użyj nazwy zmiennej, którą utworzysz w Centrum Kontaktowym Dynamics 365 lub przekaż ją przy użyciu interfejsu API setContextProvider. | Niestandardowe zmienne kontekstowe, które tworzysz, można przekazywać za pośrednictwem SDK czatu na żywo. | Zamapuj odpowiedź użytkownika jako kod JSON , aby użyć niestandardowej zmiennej kontekstowej w centrum kontaktów usługi Dynamics 365. |
| Kontekst niestandardowy dla Direct Line | Użyj nazwy zmiennej utworzonej w Centrum kontaktów usługi Dynamics 365 | Niestandardowe zmienne kontekstowe, które można utworzyć, mogą być przekazywane jako pary klucz-wartość w pliku Activity.ChannelData.ConversationContext, gdy klient DirectLine rozpoczyna konwersację. | Użyj poniższych informacji, aby mapować zmienną kontekstu niestandardowego w aplikacji Dynamics 365 Contact Center 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: ciąg |
| Kontakt | 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 |
| Wystąpienie kanału | msdyn_ChannelInstanceId | Unikatowy identyfikator rekordu wystąpienia kanału Dataverse — na przykład unikatowy identyfikator skonfigurowanego widgetu czatu lub strony serwisu Facebook | Ciąg: Cała odpowiedź użytkownika. |
| Strumień pracy | msdyn_WorkstreamId | Unikatowy identyfikator strumienia pracy usługi Dataverse skojarzony z wystąpieniem kanału. | Ciąg: Cała odpowiedź użytkownika. |
| Ustawienia regionalne kanału | msdyn_Locale | Skonfigurowany kod ustawień regionalnych w wystąpieniu kanału. Na przykład widget czatu lub strona serwisu Facebook. Może to być używane w scenariuszach, takich jak wielojęzyczni agenci Copilot Studio. | Ciąg: Cała odpowiedź użytkownika. |
| Profil społecznościowy | msdyn_SocialProfileId | Unikatowy identyfikator rekordu Dataverse dla profilu społecznościowego skojarzonego z konwersacją. | Ciąg: Cała odpowiedź użytkownika. |
| Nazwa klienta interfejsu Line | msdyn_LineCustomerName | Nazwa klienta z interfejsu API LINE. | Ciąg: Cała odpowiedź użytkownika. |
| Nazwa klienta aplikacji Teams | msdyn_TeamsCustomerName | Nazwa klienta z usługi Microsoft Teams. | Ciąg: Cała odpowiedź użytkownika. |
| Adres e-mail klienta aplikacji Teams | msdyn_TeamsCustomerEmail | Adres e-mail (UPN) z usługi Microsoft Teams. | Ciąg: Cała odpowiedź użytkownika. |
| Lista możliwości Apple | msdyn_CapabilityList | Wartości listy możliwości usługi Apple Messages for Businesses są ciągiem rozdzielanym. | Ciąg: Cała odpowiedź użytkownika. |
| Identyfikator grupy Apple | msdyn_AppleMessagesForBusinessGroupId | Identyfikator grupy Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. |
| Identyfikator intencji Apple | msdyn_AppleMessagesForBusinessIntentId | Identyfikator intencji Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. |
| Ustawienia regionalne Apple | msdyn_AppleMessagesForBusinessLocale | Ustawienia regionalne udostępniane przez interfejs API Apple Messages for Businesses. | Ciąg: Cała odpowiedź użytkownika. |
| Identyfikator biznesowy Apple | msdyn_AppleBusinessId | Identyfikator firmy z konta Apple Messages for Business. | Ciąg: Cała odpowiedź użytkownika. |
| Nazwa klienta w serwisie Facebook | msdyn_FacebookCustomerName | Nazwa klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. |
| Ustawienia regionalne klienta serwisu Facebook | msdyn_FacebookLocale | Ustawienia regionalne użytkownika końcowego klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. |
| Strefa czasowa klienta serwisu Facebook | msdyn_FacebookTimezone | Strefa czasowa klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. |
| Identyfikator o określonym zakresie strony klienta w serwisie Facebook | msdyn_FacebookUserPageScopedId | Identyfikator użytkownika specyficzny dla strony klienta z serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. |
| Identyfikator strony serwisu Facebook | msdyn_FacebookPageId | Identyfikator PageID ze strony serwisu Facebook. | Ciąg: Cała odpowiedź użytkownika. |
| Numer telefonu klienta | msdyn_CustomerPhoneNumber | Numer telefonu, w jaki klient wysyła wiadomości tekstowe pochodzi z kanałów WhatsApp i SMS. | Ciąg: Cała odpowiedź użytkownika. |
| Numer telefonu organizacji | msdyn_OrganizationPhoneNumber | Numer telefonu odbierający wiadomości od klienta (numer organizacji). Należy pamiętać, że nie jest on przekazywany w aplikacji WhatsApp za pośrednictwem usług Azure Communication Services | Ciąg: Cała odpowiedź użytkownika. |
| Wiadomość dla linku uniwersalnego WhatsApp | msdyn_WhatsAppCustomerFirstMessage | Jeśli używasz wstępnie wypełnionej wiadomości w uniwersalnym linku WhatsApp, te informacje są przekazywane w tej zmiennej. | Ciąg: Cała odpowiedź użytkownika. |
Notatka
Używaj zdefiniowanych nazw zmiennych kontekstowych i nie zmieniaj ich, gdy tworzysz przepływy w agentach Azure lub Copilot Studio. Należy również pamiętać o użyciu dokładnego dopasowania w celu przekazania wartości do zmiennej kontekstowej, ponieważ uwzględniana jest wielkość liter. Jeśli występuje niezgodność, rekord nie zostanie automatycznie zidentyfikowany. Więcej informacji: Automatyczne identyfikowanie rekordów
Informacje pokrewne
Integrowanie agenta programu Copilot Studio
Integracja agenta Azure
Konfigurowanie agentów w celu eskalowania i kończenia konwersacji
Odwołanie SDK czatu na żywo