Живые источники данных (меню, прайс-лист, остатки)

Источник данных: это принадлежащий вам URL (меню, прайс-лист, остатки, свободные слоты), который платформа загружает по расписанию, превращает в простой текст и кладёт перед агентом в начале звонка. Во время звонка ничего не ищется: агент отвечает на «какой блинчик самый дешёвый?» по всему списку, с первого слова.

Когда это подходит#

• База знаний нужна для документов, которые меняются редко и по которым ищут. Каталог, который меняется ежедневно и должен читаться целиком (цены, что во что входит), лучше подходит источнику данных.
• Инструмент получает один ответ, пока звонящий ждёт. Используйте инструмент для запросов по конкретному клиенту (заказ, бронирование), а источник данных для списка, о котором спрашивают все.

Подключение источника#

1. Откройте агента и перейдите на вкладку Data sources.
2. Нажмите Add data source и ответьте на Where does the data come from?, выбрав своего поставщика. iotSoft POS стоит первым в списке; если вашего поставщика нет, используйте Catalogue JSON API или Text or CSV page.
3. Введите URL и, если поставщик требует, Access token. Токен сохраняется как секрет проекта и больше никогда не показывается.
4. Задайте Refresh every (minutes) (минимум 5, по умолчанию 60) и при необходимости Max characters (по умолчанию 15000).
5. Нажмите Connect and fetch. Первая загрузка выполняется сразу, и вы тут же видите, работают ли адрес и токен.
6. Attach источник к агенту, затем Save и Deploy.

Preview what the agent sees показывает точный текст, который получает агент.

Как данные остаются свежими#

Каждый источник загружается в фоне по собственному расписанию, ровно одним сервером за раз; звонок никогда не ждёт загрузку. Загрузка, которая не находит ничего нового, не трогает сохранённые данные и лишь отмечает, когда источник проверялся: в списке видно и последнюю проверку, и последнее изменение. Неудачная загрузка оставляет в работе последний удачный снимок и помечает источник как error с причиной; посреди звонка ничего не меняется. Refresh now загружает вне расписания.

Описание собственного JSON#

Для Catalogue JSON API поле Mapping (JSON) указывает платформе, где что лежит в вашей ленте, в точечной нотации: список категорий (list_path), название категории, позиции, название и цена каждой позиции, её состав и группы опций. Бесплатные группы становятся составом позиции или выбором клиента; платные группы становятся дополнениями. Подбирайте mapping, пока предпросмотр не читается так, как это услышал бы клиент.

Полезно знать#

• До 8 источников на агента.
• Лента больше лимита обрезается на границе категории, и текст сообщает, что список продолжается, поэтому агент никогда не заявит, что позиции нет.
• Адреса в частных сетях отклоняются.
• Удаление источника удаляет и сохранённый токен.