Инструменты

Webhook-инструменты, системные инструменты и правила переключения в Voxagent

Инструменты позволяют агентам Voxagent вызывать внешние API во время разговора — получать данные, выполнять действия и взаимодействовать с вашими системами.

Создание webhook-инструмента

Перейдите в раздел Tools в https://console.voxagent.ru
Нажмите Create Tool
Заполните параметры инструмента:

Основные параметры

Поле	Описание
Name	Человекочитаемое название инструмента
Code	Уникальный идентификатор (латиница, подчёркивания). LLM использует его для вызова инструмента
Description	Описание для LLM — когда и зачем использовать инструмент. Чем точнее описание, тем корректнее агент будет вызывать инструмент

HTTP-запрос

Поле	Описание
Method	HTTP-метод: GET, POST, PUT, DELETE
URL	Адрес эндпоинта. Поддерживает подстановку переменных

Заголовки

Кастомные HTTP-заголовки определяются через OpenAPI-схему. Это позволяет задать заголовки, значения которых LLM сформирует динамически.

Пример схемы заголовков:

{
  "type": "object",
  "properties": {
    "X-Api-Key": {
      "type": "string",
      "description": "API ключ для аутентификации"
    }
  }
}

Тело запроса

Тело HTTP-запроса также определяется через OpenAPI-схему. Схема описывает структуру JSON, который LLM должен сформировать на основе контекста разговора.

Пример схемы тела:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Номер заказа клиента"
    },
    "question": {
      "type": "string",
      "description": "Вопрос клиента о заказе"
    }
  },
  "required": ["order_id"]
}

Описания в схеме

Добавляйте подробные description к каждому полю схемы. LLM ориентируется на них, чтобы корректно заполнить параметры.

Pre-tool speech

Перед вызовом инструмента агент может произнести фразу, чтобы пользователь не ждал в тишине.

В настройках инструмента найдите поле Pre-tool speech
Введите текст, который агент скажет перед вызовом

Примеры:

«Сейчас проверю информацию по вашему заказу...»
«Одну секунду, загружаю данные...»
«Подождите, пожалуйста, я уточняю информацию...»

Привязка инструмента к агенту

После создания инструмента его необходимо привязать к агенту:

Откройте страницу агента
Перейдите на вкладку Tools
Нажмите Add Tool и выберите инструмент из списка
Инструмент станет доступен агенту во время разговоров

Один инструмент — несколько агентов

Один инструмент можно привязать к нескольким агентам. Это удобно для общих интеграций, например проверки статуса заказа.

Помимо пользовательских webhook-инструментов, платформа предоставляет встроенные системные инструменты. Создавать их не нужно — достаточно включить нужные переключателем в секции Инструменты агента:

Инструмент	Что делает
Завершить звонок	Агент сам кладёт трубку, когда разговор закончен
Перевод на оператора	Агент дозванивается на телефон живого оператора и передаёт ему звонок
Перевод на другого агента	Агент передаёт диалог другому AI-агенту
Определение языка	Агент переходит на язык собеседника
Пропустить ход	Агент молчит, если собеседник попросил паузу
Запросить уточнение	Агент фиксирует, какой информации ему не хватило

У включённого инструмента рядом с переключателем появляется шестерёнка — она открывает настройки: описание для LLM, отключение прерываний и правила трансфера у двух инструментов перевода.

Зачем нужен каждый инструмент, как его настроить и как перевод на оператора выглядит на живом звонке — в разделе Системные инструменты.

Правила переключения

Правила переключения задаются внутри двух системных инструментов перевода — откройте у агента «Перевод на другого агента» или «Перевод на оператора» и добавьте правила там.

Правило связывает условие, описанное обычным языком, с направлением перевода: другой агент или номер телефона оператора.

Поле	Описание
Агент / Номер телефона	Куда переводить: целевой AI-агент или телефон оператора
Условие срабатывания	Когда применять это правило

Пример сценария:

Основной агент обрабатывает общие вопросы. Когда пользователь спрашивает о техническом сбое, срабатывает правило переключения и разговор передаётся специализированному агенту технической поддержки. Если же клиент настаивает на живом человеке — срабатывает правило перевода на оператора, и платформа звонит на номер техподдержки.

Мультиагентные сценарии

Правила переключения позволяют создавать сложные сценарии с несколькими специализированными агентами. Например: агент-маршрутизатор определяет тему обращения и передаёт разговор профильному агенту. Перевод на другого агента идёт внутри той же сессии, а перевод на оператора — это реальный исходящий звонок, см. Системные инструменты.

Как это работает

LLM анализирует контекст разговора и решает, что нужен вызов инструмента
Агент произносит pre-tool speech (если настроен)
Платформа формирует HTTP-запрос по OpenAPI-схеме
Запрос отправляется на указанный URL
Ответ передаётся обратно в LLM
LLM включает полученные данные в свой следующий ответ

Инструменты

Содержание