Во время диалога агенту Robovoice нужна информация из внешних источников. В этом разделе настраиваются источники, к которым он может обращаться: внешние информационные системы, документы, таблицы, базы знаний и базы данных.
Каждое подключение после создания получает статус: Загрузка, Готов или Ошибка. В сценарии можно использовать только подключения со статусом Готов.
Сразу после создания Robovoice автоматически проверит подключение и покажет один из статусов:
Во время диалога с абонентом сценарию может понадобиться обратиться к внешней системе (CRM, учётной системе, сервису записи и так далее) для получения или внесения информации. Вместо того чтобы писать специальную интеграцию и разрабатывать отдельные сервисы, достаточно передать Robovoice описание методов API: по нему платформа сама поймёт, как работать с этим API.
Для работы REST API to MCP нужно предоставить описание методов REST API в одном из форматов: OpenAPI, Swagger или коллекция Postman. Каждый доступный метод становится инструментом LLM модели. Для этого:
Кнопка Добавить из cURL есть только у подключения, созданного из файла или cURL. Если источник — адрес спецификации, методы берутся из неё при перечитывании.
Кнопка Сменить ключ MCP выпускает новый X-API-Key. Прежний ключ сразу перестаёт работать. Новый ключ тоже нужно сохранить сразу.
В качестве источника данных, к которому Robovoice может обращаться во время диалога, может выступать обычная таблица: файл Excel, документ CSV или таблица Google Sheets в облаке.
Данные из таблицы доступны только для чтения: Robovoice не изменяет содержимое таблицы, а использует её только как источник информации. Например, в таблицу можно загрузить актуальное расписание специалистов, остатки товара на складе или любые другие справочные данные, к которым сценарий будет обращаться во время диалога и использовать их для формирования ответов абонентам.
Чтобы подставить другие строки, откройте карточку и нажмите Заменить файл. Новый файл заменяет текущие данные.
Если поиск не находит строку, в этой таблице нет подходящей записи. В промпте узла LLM попросите при пустом результате обратиться к другому подключённому источнику.
Внешним источником данных может служить и обычная СУБД: база данных информационной системы или база, отдельно подготовленная для диалоговых сценариев. Сценарий может обращаться к вашей базе данных напрямую, получать из неё актуальные данные во время диалога и использовать их для формирования ответов абонентам.
Поддерживаемые СУБД:
Модель видит только те таблицы и колонки, которые вы оставили ей доступными.
После сохранения строка подключения скрыта. Пустое поле при редактировании оставляет прежнее значение. Новый текст заменяет строку целиком.
Чтобы Robovoice правильно работал с данными, ему нужно описание структуры базы: какие таблицы есть, что в них хранится и когда их использовать.
Кнопка Создать название и описания полей заполняет пустое название таблицы и колонки без описания. Уже написанный текст она не меняет. Для этого в настройках помощника заранее выберите подключение к LLM для авторазметки.
Встроенные операции: просмотр списка сущностей, описание сущности, выборка, добавление, изменение и удаление. Добавление, изменение и удаление работают только у таблиц с режимом Чтение и запись. Изменение и удаление требуют фильтра.
Именованный инструмент — отдельная команда, которую модель вызывает по имени. Откройте Именованные инструменты.
Во время диалога Robovoice может использовать информацию из ваших корпоративных документов, инструкций, регламентов, статей и так далее. Для этого документы загружаются в базу знаний.
Поддерживаемые форматы: TXT, MD, HTML, PDF, DOC, DOCX, FB2, EPUB. Документ должен содержать текстовый слой.
Загруженные документы будут обработаны большой языковой моделью, поэтому перед созданием базы знаний подготовьте подключение к LLM для эмбеддингов.
Повторно проиндексировать все заново обрабатывает уже загруженные файлы, например, после смены профиля эмбеддинга. Новые файлы эта кнопка не добавляет: их загружают отдельно.
Если по какой-то причине вкладки Документы у вас нет, то использование базы знаний на этом стенде недоступно. Для получения консультации обратитесь к ответственному менеджеру или в техническую поддержку.
Найди заказ по номеру {~Номер заказа~}.
Используй инструмент только для чтения.
Если заказ не найден, сообщи об этом без догадок.Если каталог недоступен, в свойствах узла появится сообщение «MCP-серверы недоступны», и добавить подключение нельзя. Если каталог пуст — «В каталоге нет MCP-серверов».
| Симптом | Что проверить |
|---|---|
| Подключений нет | Нажмите Добавить и создайте подключение нужного типа. |
| Статус Ошибка или Загрузка | Проверьте адрес, файл, ключ, спецификацию или строку подключения. Если ошибка не уходит, создайте подключение заново. |
| Инструмент нельзя выбрать | Обновите каталог, убедитесь, что статус Готов, и заново откройте сценарий. |
| «MCP-серверы недоступны» | Каталог сейчас не открывается. Добавить подключение в узел можно будет после его загрузки. |
| Инструмент не вызывается | Проверьте подключение в поле LLM узлов, выбранный инструмент, промпт и публикацию сценария. |
| Ключ REST API потерян | X-API-Key показывается один раз. Нажмите Сменить ключ MCP и сохраните новый ключ. |
| Метод API не виден модели | На карточке REST API включите доступность метода и нужных аргументов, затем сохраните. |
| Поиск по таблице пустой | В таблице нет подходящей строки. Проверьте файл или доступ к Google Sheets и при необходимости подключите другой источник. |
| Строка подключения к БД не видна | После сохранения она скрыта. Пустое поле её не меняет. Чтобы заменить доступ, вставьте новую строку целиком. |
| Модель не видит таблицу базы | В редакторе структуры включите Доступен модели и выберите нужный режим доступа. |
| Документы выбраны, но не ищутся | Нажмите Загрузить и проиндексировать и дождитесь статуса Готов. Повторная индексация новые файлы не добавляет. |
| Нет вкладки Документы | Использование базы знаний на этом стенде недоступно. Обратитесь к ответственному менеджеру или в техническую поддержку. |
| Робот молчит | В промпте попросите озвучить результат инструмента. Сохраните и опубликуйте сценарий. |