Передача агенту переменных контекста с веб-страницы

Когда ваш агент развернут на пользовательском сайте, вы можете передавать контекстные переменные с веб-страницы агенту и использовать их для улучшения пользовательского опыта. Переменные контекста позволяют вашему агенту предоставлять индивидуальные и более содержательные взаимодействия с посетителями вашего веб-сайта.

Когда передавать переменные контекста

Вот примеры ситуаций, когда может быть полезно передать контекст агенту:

  • Передайте идентификатор отслеживания веб-аналитики с веб-страницы агенту для совместного анализа веб-аналитики и аналитики агента.

  • Передайте агенту идентификатор заказа с веб-страницы, чтобы клиенту не пришлось повторно вводить идентификатор заказа. Агент может просто получить идентификатор заказа с веб-страницы.

  • Передайте текущую страницу веб-сайта, чтобы агент мог настроить взаимодействие в соответствии с веб-страницей, которую посещает клиент.

  • Передайте язык веб-страницы, чтобы агент мог адаптировать взаимодействие с пользователем в соответствии с языком страницы.

Передача переменных контекста — это двухэтапная процедура: сначала передайте контекст с вашей веб-страницы агенту, затем сохраните его внутри агента как переменную.

Передача агенту контекста с веб-страницы

В вашем JavaScript-коде при вызове агента добавьте значения, которые будут переданы в качестве контекста. Вы можете передать агенту любую информацию со своего веб-сайта. Например, следующий фрагмент кода отправляет три переменные контекста: Language, currentURL и OrderId.

{
Language: siteLanguage,
currentURL: window.location.href,
OrderId: '12345'
}

Дополнительные сведения см. в разделе Добавление глобальных переменных на пользовательский холст. Для полного примера кода HTML/JavaScript Webchat.js для пользовательского холста см. в разделе Настройка внешнего вида агента.

Сохраните контекст как переменную в агенте

В системной теме Начало разговора добавьте узел Вопрос. Чтобы правильно настроить тему, действуйте следующим образом:

  1. Оставьте вопрос пустым. Узел Вопрос используется только в качестве средства для получения контекста из внешнего источника.

  2. Для функции Идентифицировать замените значение по умолчанию Варианты для выбора значением Полный ответ пользователя или соответствующим типом данных.

  3. Выберите имя переменной по умолчанию и на панели Свойства переменной замените его представительным именем.

  4. Выберите Глобальная (доступна из любой темы).

  5. Выберите Внешние источники могут задавать значения.

    Снимок экрана панели свойств переменной с демонстрацией конфигурации глобальной переменной в Copilot Studio.

  6. Опционально установите желаемое значение таймаута, чтобы переменная могла получить значение от внешнего источника.

Примечание

Хотя в этом примере используется системная тема Начало разговора, вы можете сохранить контекст, полученный с веб-страницы, в любой теме. Рекомендуется выделить отдельную тему, в которой вы настраиваете глобальные переменные для хранения информации, поступающей из внешних источников. Дополнительные сведения см. в Настройка глобальных переменных из внешних источников.

Ваш агент может использовать эти переменные для любых целей — например, чтобы получить детали заказа по номеру заказа или настроить поведение чата в зависимости от языка. Пример использования этой концепции для объединения веб-аналитики и аналитики агентов смотрите в разделе Объединение веб-аналитики и аналитики агентов.

  • Last updated on