Инструменты, коннекторы и знания ИИ
Эти страницы дают агентам ИИ знания и возможности действовать. Все это настройки компании; каждое изменение попадает в аудит. Вводимые вами секреты (токены, секреты клиентов) хранятся в зашифрованном виде и больше не показываются.
| Страница | Путь в меню | Право для просмотра | Право для изменения |
|---|---|---|---|
| Инструменты ИИ | Администрирование > Инструменты ИИ (/admin/ai-tools) | settings:read | settings:write |
| Коннекторы ИИ | Администрирование > Коннекторы ИИ (/admin/ai-connectors) | settings:read | settings:write |
| Каталог товаров | Администрирование > Каталог товаров (/admin/ai-catalogue) | settings:read | settings:write |
| База знаний | Администрирование > База знаний (/admin/ai-knowledge) | settings:read | settings:write |
| Доступ MCP | Администрирование > Доступ MCP (/admin/mcp-access) | api_keys:read, api_keys:write или settings:read | settings:write для правил новых клиентов, api_keys:write для отзыва |
Инструменты ИИ
Инструмент — это веб-сервис, который агент может вызвать во время звонка (забронировать столик, открыть заявку). Вы его описываете; писать код не нужно.
- Откройте Администрирование > Инструменты ИИ и выберите Добавить инструмент.
- Задайте имя (от 3 до 48 строчных букв, цифр или знаков подчёркивания, начинается с буквы) и описание для модели (от 1 до 500 символов: по нему агент решает, когда использовать инструмент).
- Задайте URL (адрес
httpsбез имени пользователя и пароля), метод, параметры в виде объекта JSON не более чем с 12 свойствами и, при желании, имя заголовка аутентификации, префикс значения и секрет. - Задайте ограничения: вызовов в минуту (от 1 до 600) и тайм-аут (от 500 до 15 000 мс). Укажите аргументы, которые нужно скрывать в аудите.
- Оставьте включённым Звонящий должен сказать «да» до вызова инструмента, если инструмент не безобиден. Тогда агент зачитывает действие и ждёт устного «да».
- Сохраните. Инструментов может быть до 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, чтобы агенты могли находить свободные слоты, записывать, переносить и отменять.
- Выберите поставщика и введите идентификатор календаря, часовой пояс, рабочие часы, длительность слота (от 5 до 480 минут), минимальное время заранее и на сколько дней вперёд агенты могут записывать (от 1 до 365).
- Введите идентификатор клиента и секрет клиента вашего собственного приложения OAuth (и tenant Microsoft для Microsoft 365), а также refresh token, полученный для учётной записи календаря. Кнопки входа в консоли нет: refresh token вы приносите сами.
- Сохраните, затем Проверить подключение. Проверка обновляет токен и читает занятость на ближайшие 24 часа; в календарь ничего не записывается.
Агенты записывают только в рабочие часы и могут менять или отменять только то, что записали сами. Если поставщик отозвал доступ, статус это показывает; сохраните новый refresh token, чтобы вернуть подключение в рабочее состояние. Отключить удаляет подключение и ссылки на записи; события остаются в календаре, но агенты больше не могут их менять и предлагать записи.
Бизнес-инструменты
Включайте только то, что нужно; пока вы не включите, всё выключено. Каждую группу можно ограничить перечисленными агентами.
| Группа | Что может делать агент |
|---|---|
| CRM | Искать и создавать лиды и заметки через вашу интеграцию с CRM |
| Электронная почта | Отправлять письма через вашего поставщика почты; ограничение в день |
| Каталог | Искать по каталогу товаров |
| Подтверждения | Отправлять подтверждения по SMS или WhatsApp через сервис SMS с учётом отказов; ограничения в день и на человека в день |
Записи, которые делают агенты, требуют зачитывания и подтверждения звонящего и согласия получателя.
Каталог товаров
Администрирование > Каталог товаров хранит товары, по которым агенты ищут инструментом каталога.
- Выберите Импорт и источник: текст CSV или Google Sheet (идентификатор таблицы и диапазон; токен доступа только для этого импорта, нигде не хранится, для открытой таблицы не нужен).
- В строке заголовка обязателен столбец
name, могут бытьprice,stock,descriptionиbranch. - При желании отметьте Заменить каталог; замена выполняется, только если в файле нет ошибок.
- В результате показано, сколько позиций создано, обновлено, пропущено и удалено, а каждая отклонённая строка указана с номером строки и полем.
Поиск проверяет каталог, Очистить каталог удаляет всё.
База знаний
Администрирование > База знаний хранит документы, из которых агенты цитируют. Источники привязываются к агенту в редакторе агента.
- Выберите Добавить источник и вид: файл PDF, файл DOCX, веб-страница, текст или FAQ (по одной паре «вопрос | ответ» в строке, не более 500).
- Веб-страница загружается один раз, сейчас, только по
https(без частных адресов и перенаправлений). Чтобы обновить её, выберите Переиндексировать. - Проверка поиска показывает лучшие фрагменты со ссылкой на источник (название источника, адрес и номер фрагмента).
Ограничения на компанию: 200 источников, 100 МиБ всего и 5 МиБ на документ. При превышении АТС отвечает ошибкой квоты.
Доступ MCP
Администрирование > Доступ MCP показывает ИИ-ассистентов (клиентов MCP), которым сотрудники вашей компании разрешили действовать от их имени: клиент, пользователь, доступ, когда разрешено и последнее использование. Отозвать немедленно прекращает работу ассистента для этого пользователя.
В разделе Новые клиенты переключатель Разрешить клиентам MCP регистрироваться самостоятельно управляет саморегистрацией, а Разрешённые хосты перенаправления (по одному имени хоста в строке; пусто означает любой хост) ограничивает, куда они могут перенаправлять. Уже зарегистрированные клиенты продолжают работать.