Udostępnij za pośrednictwem


Przekazywanie zmiennych kontekstowych ze strony internetowej do pomocnika

Gdy pomocnik jest wdrażany w niestandardowej witrynie sieci Web, można przekazać zmienne kontekstowe ze strony internetowej do pomocnika. Można skutecznie przekazać zmienne kontekstowe ze strony internetowej do pomocnika i używać tych zmiennych w celu zwiększenia możliwości użytkownika. Zmienne kontekstowe umożliwiają użytkownikom dostęp do dostosowanych do potrzeb i bardziej znaczących interakcji z odwiedzającymi witrynę.

Kiedy należy przekazać zmienne kontekstowe

  • Przekaż identyfikator śledzenia usługi Web Analytics ze strony internetowej pomocnika w celu wspólnej analizy sieci i pomocnika.

  • Przekaż identyfikator zamówienia ze strony internetowej do pomocnika, aby użytkownik nie musiał ponownie wpisywać identyfikatora zamówienia dla pomocnika. Pomocnik może tylko zabrać informacje o identyfikatorze zamówienia ze strony internetowej.

  • Należy przekazać bieżącą stronę witryny sieci Web, aby pomocnik mógł dostosować środowisko do strony sieci Web odwiedzanej przez użytkownika.

  • Należy przekazać język strony internetowej do pomocnika, aby pomocnik mógł dostosować środowisko do języka strony sieci Web.

Przekazywanie zmiennych kontekstowych jest dwuetapową procedurą: najpierw należy przekazać kontekst ze strony internetowej do pomocnika, a następnie zapisać kontekst w zmiennej w pomocniku.

Przekazywanie kontekstu ze strony internetowej do pomocnika

W kodzie JavaScript, w którym można wywołać pomocnika, należy uwzględnić wartości, które mają być wysyłane jako kontekst. Wszelkie informacje, takie jak OrderId, można przekazać ze swojej witryny internetowej do pomocnika. Na przykład w następującym fragmencie kodu wysyłane są trzy zmienne kontekstowe:

  • Język
  • currentURL
  • OrderId

Zrzut ekranu przedstawiający kod JSON wyróżniający trzy wysyłane zmienne kontekstowe.

Uwaga

Aby uzyskać więcej informacji, zobacz Ponowne używanie zmiennych w różnych tematach. Ponadto, aby uzyskać pełny blok kodu Webchat.js HTML/JavaScript niestandardowej kanwy, zobacz Dostosowywanie wyglądu i działania pomocnika.

Zapisywanie kontekstu jako zmiennej w pomocniku

W temacie systemowym Uruchamianie konwersacji dodaj węzeł „Zadawanie pytań”. Aby prawidłowo skonfigurować temat, należy wykonać następujące czynności:

Zrzut ekranu okna dialogowego właściwości zmiennych przedstawiających integrację zmiennych w Copilot Studio.

Uwaga

W tym przykładzie jest używany temat systemowy Rozpoczynanie konwersacji, ale można zapisać kontekst odbierany ze strony sieci Web w dowolnym temacie.

Zmienna w pomocniku umożliwia użycie go w dowolnym celu, na przykład uzyskania szczegółowych informacji o zamówieniu, identyfikatora zamówienia, dostosowywania zachowania rozmowy dla języka itp. Przykład używania tego pojęcia do łączenia analiz w sieci Web i pomocniku zobacz Łączenie analizy internetowej i dotyczącej pomocnika.