Настройки проекта¶

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

Содержание инструкции:

Информация о проекте
Учетные данные
Конечные точки
Внешний вид
Виджет чата
Домен по умолчанию

Информация о проекте¶

Раздел Информация о проекте содержит общие настройки проекта:

Название проекта: Название проекта, отображаемое в иснтерфейсе системы.
Язык проекта: Основной язык, на котором работает проект в целом.
Язык по умолчанию: Это основной язык, который используется ботом для обработки запросов и генерации ответов.
Порог NLU: Минимальный уровень уверенности, при котором намерение считается распознанным.
Смещение часового пояса относительно UTC±00:00: Временная зона, необходимая для корректного отображения времени в логах и аналитике.

Учетные данные¶

В разделе Учетные данные задаются параметры для подключения проекта к каналам взаимодействия.

Пример:

rasa_addons.core.channels.webchat.WebchatInput:
  session_persistence: true
  base_url: `https://your.wisebot.host` 
  socket_path: '/socket.io/'

session_persistence: true: Включает сохранение сессии пользователя. Это означает, что состояние диалога сохраняется даже после перезагрузки страницы. Если установлено false, сессия будет сбрасываться при каждой перезагрузке.
base_url: https://your.wisebot.host: Базовый URL, по которому доступен бот. Это может быть домен вашего сервера или облачного сервиса.
socket_path: '/socket.io/': Путь для подключения через WebSocket.

Конечные точки¶

В разделе Конечные точки задаются настройки взаимодействия бота с внешними сервисами для выполнения различных задач, таких как генерация ответов (NLG), выполнение пользовательских действий (action server), хранение данных диалогов (tracker store) и загрузка моделей.

Пример:

nlg:
  url: 'https://<bot-api-host>/project/bf/nlg'
action_endpoint:
  url: 'https://<actions-server-host>/webhook'
tracker_store:
  store_type: rasa_addons.core.tracker_stores.AnalyticsTrackerStore
  url: 'https://<bot-api-host>'
  project_id: 'bf'
models:
  url: 'https:/server.com/models/default'
  wait_time_between_pulls: 60

NLG (Natural Language Generator): отвечает за генерацию текстовых ответов бота на основе шаблонов или динамических данных. URL указывает адрес сервера, который предоставляет данные для генерации ответов.
Action Endpoint: используется для выполнения пользовательских действий (custom actions), таких как вызов внешних API, работа с базами данных или сложная бизнес-логика. URL указывает адрес сервера действий.
Tracker Store: отвечает за хранение данных о диалогах (например, история сообщений, слоты, контекст). URL указывает адрес сервера, который управляет хранением данных.
Models: Определяет, откуда бот загружает модели (NLU и диалоговые модели).
- URL указывает адрес сервера, где хранятся модели. Здесь используются переменные:
- wait_time_between_pulls: 60: Указывает, как часто (в секундах) бот проверяет наличие новых моделей. В данном случае проверка происходит каждые 60 секунд.

Внешний вид¶

Раздел Учетные данные предназначен для настройки логотипов проекта:

Логотип для отображения в верхней части развернутой боковой панели,
Логотип для отображения в верхней части свернутой боковой панели.

Виджет чата¶

Раздел Виджет чата предназначен для настройки вида виджета.

Настройки виджета¶

Заголовок виджета: Текст, который отображается в верхней части окна.
Подзаголовок виджета: Текст, который отображается под заголовком.
Начальная полезная нагрузка: Сообщение от помощника, которое будет отображаться при открытии окна.
Язык: Язык, который используется ботом.
Переключатель Включить кнопку перезапуска виджета

Пример внешнего вида виджета:

Цвета виджета¶

Доступны следующие настройки:

Основной цвет веб-чата
Цвет фона диалога
Цвет текста сообщений пользователя
Цвет фона сообщений пользователя
Цвет текста сообщений ассистента
Цвет фона сообщений ассистента

Чтобы изменить цвет:

Нажмите на установленный вариант цвета.
Откроется окно с настройкой цвета.
Укажите цвет одним из способов:
- Выберите в ручную на палитре,
- Задайте код цвета в формате HLS, RGB или HEX.

Дополнительные настройки виджета¶

Настройки поведения:

Подсказка для пользовательского ввода: Текст плейсхолдера, который будет отображаться в поле ввода пользователя.
Отображать количество непрочитанных сообщений: Рядом со значком чата будет отображать индикатор с количеством непрочитанных сообщений.
Скрывать виджет при отсутствии подключения: Если не удалось подключить к Wisebot, виджет будет скрыт.
Отключить всплывающие подсказки: При закрытом виджете сообщения не будут отображаться в виде всплывающих сообщений.
Автоматически очищать кеш: При повторном подключении пользователя спустя 30 минут начнется новая сессия.
Отображать временную метку сообщения: Рядом с сообщением будет отображаться время отправки.

Иконки и аватарки:

Иконка для открытия виджета: иконка, которая будет размещена на кнопке вызова виджета.
Иконка для закрытия виджета: иконка, которая будет размещена на кнопке закрытия виджета.
Путь к аватарке: аватарка помощника.

Дизайн:

Название класса подсветки по умолчанию: Класс, который применяется для подсветки элементов виджета по умолчанию. Этот класс можно использовать для стилизации элементов виджета, таких как кнопки, текстовые поля или другие интерактивные элементы.
Подсветка CSS по умолчанию: Стили CSS, которые применяются для подсветки элементов виджета по умолчанию. Эти стили включают анимацию и настройки контура.
```
animation: 0.5s linear infinite alternate default-botfront-blinker-animation;
outline-style: solid;
```
Параметры:
- animation: Задает анимацию подсветки с длительностью 0.5 секунд, линейным изменением и бесконечным повторением.
- outline-style: Устанавливает стиль контура элемента (в данном случае — сплошная линия).
CSS-анимация подсветки по умолчанию: Анимация, которая определяет изменение цвета контура элемента при подсветке.
```
@keyframes default-botfront-blinker-animation {
    0% {
      outline-color: red;
    }
    49% {
  outline-color: red;
    }
    50% {
      outline-color: red;
    }
    100% {
      outline-color: red;
    }
  }
         }
       }
```
Параметры:
- outline-color: Цвет контура элемента. В данном случае используется красный цвет (red).
- keyframes: Определяет ключевые кадры анимации. В этом примере цвет контура остается красным на протяжении всей анимации.

Домен по умолчанию¶

В разделе Домен по умолчанию можно задать action-скрипты и слоты, которые не могут быть автоматически выведены из диалоговых сценариев или слотов.

Пример настройки домена по умолчанию:

slots:
  disambiguation_message:
    type: unfeaturized
actions:
  - action_botfront_disambiguation
  - action_botfront_disambiguation_followup
  - action_botfront_fallback
  - action_botfront_mapping

Слот disambiguation_message - это слот, который используется для хранения сообщения, помогающего уточнить намерение пользователя (например, "Вы имели в виду X или Y?"). Тип type: unfeaturized указывает, что этот слот не влияет на предсказание следующего действия. Он используется только для хранения данных.
Действие action_botfront_disambiguation - это действие для уточнения намерения пользователя, если бот не уверен в его запросе. Например, бот может спросить: "Вы имели в виду X или Y?"
Действие action_botfront_disambiguation_followup - это действие для обработки ответа пользователя после уточнения намерения.
Действие action_botfront_fallback - действие, которое выполняется, если бот не может распознать намерение пользователя. Например, бот может сказать: "Извините, я не понял ваш запрос."
Действие action_botfront_mapping - действие для сопоставления данных (например, преобразование введенного пользователем адреса в координаты).