Перейти к основному содержимому

Инструменты, коннекторы и знания ИИ

Эти страницы дают агентам ИИ знания и возможности действовать. Все это настройки компании; каждое изменение попадает в аудит. Вводимые вами секреты (токены, секреты клиентов) хранятся в зашифрованном виде и больше не показываются.

СтраницаПуть в менюПраво для просмотраПраво для изменения
Инструменты ИИАдминистрирование > Инструменты ИИ (/admin/ai-tools)settings:readsettings:write
Коннекторы ИИАдминистрирование > Коннекторы ИИ (/admin/ai-connectors)settings:readsettings:write
Каталог товаровАдминистрирование > Каталог товаров (/admin/ai-catalogue)settings:readsettings:write
База знанийАдминистрирование > База знаний (/admin/ai-knowledge)settings:readsettings:write
Доступ MCPАдминистрирование > Доступ MCP (/admin/mcp-access)api_keys:read, api_keys:write или settings:readsettings:write для правил новых клиентов, api_keys:write для отзыва

Инструменты ИИ​

Инструмент — это веб-сервис, который агент может вызвать во время звонка (забронировать столик, открыть заявку). Вы его описываете; писать код не нужно.

  1. Откройте Администрирование > Инструменты ИИ и выберите Добавить инструмент.
  2. Задайте имя (от 3 до 48 строчных букв, цифр или знаков подчёркивания, начинается с буквы) и описание для модели (от 1 до 500 символов: по нему агент решает, когда использовать инструмент).
  3. Задайте URL (адрес https без имени пользователя и пароля), метод, параметры в виде объекта JSON не более чем с 12 свойствами и, при желании, имя заголовка аутентификации, префикс значения и секрет.
  4. Задайте ограничения: вызовов в минуту (от 1 до 600) и тайм-аут (от 500 до 15 000 мс). Укажите аргументы, которые нужно скрывать в аудите.
  5. Оставьте включённым Звонящий должен сказать «да» до вызова инструмента, если инструмент не безобиден. Тогда агент зачитывает действие и ждёт устного «да».
  6. Сохраните. Инструментов может быть до 50.

Чтобы дать агенту инструмент, используйте Инструменты по агентам на той же странице: выберите, какие инструменты может вызывать агент (до 12 на агента). Выключенный инструмент остаётся назначенным, но не предлагается.

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

URL проверяется при сохранении и при каждом вызове: частные и внутренние адреса отклоняются, если их нет в списке частных хостов ниже (или если оператор не разрешил их для установки).

Частные хосты​

Если инструменту нужно обратиться к хосту внутри вашей сети, владелец компании может внести его в Частные хосты: по одному имени или адресу в строке, с необязательным портом, не более 20. Для этого нужно право владельца ai_tools:private_hosts, а список действует, только если оператор включил списки компаний на установке (если нет, страница об этом сообщает). Метаданные облака, адреса multicast и учётные данные в URL остаются заблокированными.

Предложить инструмент клиентам MCP​

По умолчанию инструмент предназначен только для голосового агента. Владелец может отметить Предлагать этот инструмент клиентам MCP (только владелец) (нужно ai_tools:private_hosts). Тогда клиент MCP с правом ai_tools:invoke может увидеть и вызвать этот инструмент. Вызов проходит те же проверки, что и голосовой: проверка аргументов, подтверждение, ограничение частоты, проверка адреса и запись в аудит. Если инструмент требует подтверждения, первый вызов возвращает зачитываемый текст и ничего не отправляет; после согласия пользователя клиент повторяет вызов с confirmed: true.

Коннекторы ИИ​

Администрирование > Коннекторы ИИ состоит из двух частей.

Календарь​

Одно подключение на компанию, Google Calendar или Microsoft 365, чтобы агенты могли находить свободные слоты, записывать, переносить и отменять.

  1. Выберите поставщика и введите идентификатор календаря, часовой пояс, рабочие часы, длительность слота (от 5 до 480 минут), минимальное время заранее и на сколько дней вперёд агенты могут записывать (от 1 до 365).
  2. Введите идентификатор клиента и секрет клиента вашего собственного приложения OAuth (и tenant Microsoft для Microsoft 365), а также refresh token, полученный для учётной записи календаря. Кнопки входа в консоли нет: refresh token вы приносите сами.
  3. Сохраните, затем Проверить подключение. Проверка обновляет токен и читает занятость на ближайшие 24 часа; в календарь ничего не записывается.

Агенты записывают только в рабочие часы и могут менять или отменять только то, что записали сами. Если поставщик отозвал доступ, статус это показывает; сохраните новый refresh token, чтобы вернуть подключение в рабочее состояние. Отключить удаляет подключение и ссылки на записи; события остаются в календаре, но агенты больше не могут их менять и предлагать записи.

Бизнес-инструменты​

Включайте только то, что нужно; пока вы не включите, всё выключено. Каждую группу можно ограничить перечисленными агентами.

ГруппаЧто может делать агент
CRMИскать и создавать лиды и заметки через вашу интеграцию с CRM
Электронная почтаОтправлять письма через вашего поставщика почты; ограничение в день
КаталогИскать по каталогу товаров
ПодтвержденияОтправлять подтверждения по SMS или WhatsApp через сервис SMS с учётом отказов; ограничения в день и на человека в день

Записи, которые делают агенты, требуют зачитывания и подтверждения звонящего и согласия получателя.

Каталог товаров​

Администрирование > Каталог товаров хранит товары, по которым агенты ищут инструментом каталога.

  1. Выберите Импорт и источник: текст CSV или Google Sheet (идентификатор таблицы и диапазон; токен доступа только для этого импорта, нигде не хранится, для открытой таблицы не нужен).
  2. В строке заголовка обязателен столбец name, могут быть price, stock, description и branch.
  3. При желании отметьте Заменить каталог; замена выполняется, только если в файле нет ошибок.
  4. В результате показано, сколько позиций создано, обновлено, пропущено и удалено, а каждая отклонённая строка указана с номером строки и полем.

Поиск проверяет каталог, Очистить каталог удаляет всё.

База знаний​

Администрирование > База знаний хранит документы, из которых агенты цитируют. Источники привязываются к агенту в редакторе агента.

  1. Выберите Добавить источник и вид: файл PDF, файл DOCX, веб-страница, текст или FAQ (по одной паре «вопрос | ответ» в строке, не более 500).
  2. Веб-страница загружается один раз, сейчас, только по https (без частных адресов и перенаправлений). Чтобы обновить её, выберите Переиндексировать.
  3. Проверка поиска показывает лучшие фрагменты со ссылкой на источник (название источника, адрес и номер фрагмента).

Ограничения на компанию: 200 источников, 100 МиБ всего и 5 МиБ на документ. При превышении АТС отвечает ошибкой квоты.

Доступ MCP​

Администрирование > Доступ MCP показывает ИИ-ассистентов (клиентов MCP), которым сотрудники вашей компании разрешили действовать от их имени: клиент, пользователь, доступ, когда разрешено и последнее использование. Отозвать немедленно прекращает работу ассистента для этого пользователя.

В разделе Новые клиенты переключатель Разрешить клиентам MCP регистрироваться самостоятельно управляет саморегистрацией, а Разрешённые хосты перенаправления (по одному имени хоста в строке; пусто означает любой хост) ограничивает, куда они могут перенаправлять. Уже зарегистрированные клиенты продолжают работать.