Udostępnij za pośrednictwem


Przekazywanie zmiennych kontekstowych ze strony internetowej do agent

Gdy agent zostanie wdrożony w niestandardowej witrynie internetowej, możesz chcieć przekazać zmienne kontekstowe ze swojej strony internetowej do agent. Możesz skutecznie przekazywać zmienne kontekstowe ze strony internetowej do swojego agent i używać tych zmiennych do ulepszania doświadczenia użytkownika. Zmienne kontekstowe pozwalają Twojemu agent zapewnić dostosowane i bardziej znaczące interakcje z odwiedzającymi Twoją witrynę.

Kiedy należy przekazać zmienne kontekstowe

  • Przekaż identyfikator śledzenia analityki internetowej ze strony internetowej do agent, aby analizować jednocześnie analitykę internetową i agent.

  • Przekaż identyfikator zamówienia ze strony internetowej do agent, aby użytkownik nie musiał ponownie wpisywać identyfikatora zamówienia dla agent. Agent może po prostu pobrać informacje o identyfikatorze zamówienia ze strony internetowej.

  • Przejdź przez bieżącą stronę witryny, aby agent mógł dostosować swoje wrażenia do odwiedzanej strony internetowej.

  • Przekaż język strony internetowej do agent, aby agent mógł dostosować swoje wrażenia zgodnie z językiem strony internetowej.

Przekazywanie zmiennych kontekstowych to procedura dwuetapowa: najpierw przekaż kontekst ze swojej strony internetowej do agent, a następnie zapisz kontekst w agent jako zmienną.

Przekaż kontekst ze swojej strony internetowej do agent

W kodzie JavaScript, w którym wywołujesz metodę agent, uwzględnij wartości, które mają być wysyłane jako kontekst. Możesz przekazać dowolne informacje, takie jak OrderId, ze swojej witryny do agent. 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ć kompletną niestandardową kanwę Webchat.js bloku kodu HTML/JavaScript, zobacz Dostosowywanie wyglądu i działania agent.

Zapisz kontekst jako zmienną w agent

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.

Mając tę zmienną w swoim agent, możesz jej używać w dowolnym celu, takim jak uzyskanie szczegółów zamówienia dla identyfikatora zamówienia, dostosowanie zachowania czatu do języka i tak dalej. Aby zapoznać się z przykładem użycia tej koncepcji do połączenia analiz internetowych i agent, zobacz Łączenie analiz internetowych i agent.