Инструменты, MCP, передачи и схема диалога

Промпт задаёт, как агент разговаривает. Инструменты, передачи и схема диалога определяют, что он может сделать: узнать данные в вашей системе, перевести звонок, назначить перезвон и собрать ответы в структурированном виде. Все вкладки, описанные здесь, доступны после первого сохранения агента.

Встроенные инструменты

Вкладка «Инструменты», блок «Встроенные инструменты» (для разговорных режимов). Включите нужные и при необходимости добавьте «Дополнительные указания» — когда модели стоит использовать инструмент.

Перевод на человека работает только в настоящем телефонном звонке — в тесте из браузера переводить некуда.

HTTP-инструменты

Свои инструменты позволяют агенту обращаться к вашему API во время разговора: проверить статус заказа, найти свободное время, создать заявку.

1. На вкладке «Инструменты» откройте форму «Добавить инструмент».
2. Заполните поля:
   • «Название (slug, строчные + подчёркивания)», например get_order_status;
   • «Описание» — что делает инструмент. Это текст для модели: опишите, когда его вызывать;
   • «Метод» (GET, POST, PUT, DELETE, PATCH) и «URL»;
   • «Параметры (JSON Schema)» — какие аргументы модель должна передать;
   • «Заголовки (JSON-объект)» — например, токен авторизации вашего API.
3. Нажмите «Добавить инструмент».
4. Кнопкой «Проверить» можно вызвать инструмент с тестовыми «Аргументы (JSON)» и посмотреть ответ.

Пример схемы параметров:

{
  "type": "object",
  "properties": {
    "order_id": { "type": "string", "description": "Номер заказа" }
  },
  "required": ["order_id"]
}

Вызов до начала разговора

Флажок «Вызывать до начала разговора» превращает инструмент в источник данных о собеседнике. Платформа один раз вызовет его на старте звонка, передав номер собеседника и направление, и добавит поля из ответа (плоский JSON-объект) в параметры звонка. Их можно подставлять в промпт и приветствие и предзаполнять ими поля схемы диалога. Если инструмент не ответил за 2 секунды, звонок продолжается без этих данных.

MCP-подключения

Если ваши системы уже доступны как MCP-сервер, подключите его целиком вместо отдельных HTTP-инструментов.

1. Вкладка «MCP» → «Добавить MCP-подключение».
2. Укажите «Название», «URL сервера» и «Транспорт» (http или sse).
3. Выберите «Тип авторизации»: без авторизации, API-ключ, Bearer-токен или OAuth-токен — и введите «Учётные данные».
4. В поле «Разрешённые инструменты» перечислите через запятую инструменты, которые агенту можно вызывать. Пусто — разрешены все.
5. Нажмите «Добавить MCP».

Вызовы MCP и их результаты видны на вкладке «Активность» в карточке звонка.

Передачи между агентами

Вкладка «Передачи» позволяет собрать из нескольких агентов единую линию: например, агент-администратор распределяет звонящих между агентом бронирования и агентом поддержки.

1. Нажмите «Добавить маршрут».
2. В поле «Передавать агенту» выберите целевого агента.
3. В поле «Когда передавать» опишите ситуацию звонящего, а не команду: «звонящий хочет забронировать столик». Этот текст дословно становится описанием инструмента передачи для модели.
4. «Реплика в момент передачи» — необязательно, например «Секунду, соединяю вас с бронированием». Оставьте пустым для молчаливой передачи.
5. Нажмите «Добавить».

Разговор продолжается в том же звонке, и новый агент видит историю. Передача работает только на активного агента: если у целевого агента выключен «Агент активен», маршрут помечается как «выключен» и модель его не видит. У агента может быть только один маршрут к агенту-слушателю.

Схема диалога

Вкладка «Схема диалога» превращает разговор в анкету: агент выясняет нужные поля, проверяет ответы и сохраняет их в результаты звонка (в вебхуке это collectedFields).

1. Включите «Собирать структурированные данные».
2. Выберите шаблон в «Начать с шаблона» или нажмите «Добавить поле».
3. Для каждого поля задайте:
   • «Имя» — ключ ответа латиницей в snake_case (payment_date);
   • «Тип» — string, integer, number, date (ГГГГ-ММ-ДД), boolean, enum или phone. Неподходящий ответ отклоняется, и агент переспрашивает;
   • «Вопрос» — что нужно узнать. Агент формулирует вопрос своими словами, поэтому сюда можно писать и указания;
   • «Обязательное» — пока обязательные поля не заполнены, разговор не считается завершённым;
   • для enum — «Допустимые значения (через запятую)», для чисел — «Мин» и «Макс»;
   • «Подставить из» — заполнить поле заранее из параметра звонка (формат call_parameters.<имя>), тогда агент не будет спрашивать;
   • «Пропустить если» — условие по уже собранным ответам, например rooms > 2.
4. В блоке «По завершению» задайте «Закрывающую фразу» и при необходимости «Завершать звонок автоматически».

Если ни одно поле не отмечено как обязательное, разговор считается завершённым после первого же ответа. Отметьте поля, без которых звонок нельзя закончить.

По итогам звонка анкета получает статус полноты: все поля собраны, частично, брошен или без анкеты. Эти статусы можно использовать в условиях действий в CRM на вкладке «CRM».

Дальше: SIP-транки и номера.