Интеграция с Tuner

Обзор

Узел интеграции Tuner экспортирует данные завершенного звонка (транскрипт, метаданные, задержки и названия моделей, исход звонка, ссылку на запись) после окончания каждого звонка. Агентика использует собственный приемник Tuner — сервис tuner-compat из этого же репозитория, который поставляется в docker-compose.yaml как образ agentika-tuner-compat. Регистрироваться в стороннем сервисе не нужно: экспорт остается внутри вашего развертывания и хранится в собственной схеме tuner в Postgres.

tuner-compat — это приемник, а не продукт. Он принимает экспорт завершенного звонка, аутентифицирует его, дедуплицирует и сохраняет. У него нет панели управления, симуляции и UI для оценок — анализируйте сохраненные звонки своим SQL или BI-инструментом.

Предварительные требования

Работающее развертывание Агентики, включающее сервис tuner-compat (он входит в стандартный docker-compose.yaml)
Воркфлоу голосового агента Агентики

Как подключен приемник

Бэкенд отправляет каждый завершенный звонок на TUNER_BASE_URL:

Настройка	Значение по умолчанию	Назначение
`TUNER_BASE_URL` (бэкенд)	`http://tuner-compat:9201` в Docker Compose; `https://tuner.agentika.ai`, если не задано	Куда отправляются завершенные звонки
`TUNER_ALLOWED_TOKENS` (приемник)	пусто	Список API-ключей `tuner_live_…` через запятую, сравниваемых за постоянное время. Если пусто, принимается любой корректно сформированный токен `tuner_live_…` — задайте список до того, как открывать сервис наружу
`TUNER_DB_SCHEMA` (приемник)	`tuner`	Схема Postgres, которой владеет приемник

Приемник предоставляет ровно два эндпоинта:

GET  /api/v1/health
POST /api/v1/public/call?workspace_id=<int>&agent_remote_identifier=<str>

Настройка

1. Выберите учетные данные

Приемник ваш, поэтому консоли, откуда копировать значения, нет — вы задаете их сами:

Поле	Что использовать
Tuner Agent ID	Любой идентификатор, под которым будут храниться звонки, например `sales-bot-prod`. Сохраняется как `agent_remote_identifier`
Tuner Workspace ID	Любое положительное целое число, группирующее ваших агентов, например `1`
Tuner API Key	Токен, начинающийся с `tuner_live_` и перечисленный в `TUNER_ALLOWED_TOKENS` приемника

Сгенерируйте API-ключ и добавьте его в окружение приемника:

# сгенерировать токен
python -c "import secrets; print('tuner_live_' + secrets.token_urlsafe(24))"

# затем в .env вашего развертывания
TUNER_ALLOWED_TOKENS=tuner_live_xxxxxxxxxxxxxxxxxxxxxxxx

Перезапустите сервис tuner-compat, чтобы он подхватил список разрешенных токенов.

2. Добавьте узел Tuner в воркфлоу

В редакторе воркфлоу Агентики нажмите Добавить узел и прокрутите до раздела Интеграции. Выберите Tuner. Прокрутите до Интеграции и выберите Tuner: Узел появится на холсте с бейджем Не настроено:

3. Настройте узел

Нажмите на узел Tuner и заполните поля:

Tuner Agent ID — выбранный вами идентификатор (любая непустая строка)
Tuner Workspace ID — номер вашего рабочего пространства (положительное целое число)
Tuner API Key — токен tuner_live_… из списка разрешенных на приемнике
Включен — включите, чтобы активировать экспорт

Нажмите Сохранить, затем Опубликовать для вашего воркфлоу. В одном воркфлоу может быть не более одного узла Tuner, и он стоит особняком: у него нет ни входящих, ни исходящих рёбер, потому что он выполняется после звонка, а не внутри диалога.

4. Проверьте подключение

Сделайте тестовый звонок через своего агента. Когда звонок завершится, бэкенд отправит его в приемник, а тот сохранит запись в таблице tuner.calls:

SELECT call_id, workspace_id, agent_remote_identifier, call_type, created_at
FROM tuner.calls
ORDER BY created_at DESC
LIMIT 5;

Результат также записывается в аннотации запуска воркфлоу под ключом tuner_<id узла>: delivered при успехе, duplicate, если такой звонок уже сохранен (приемник дедуплицирует по call_id + workspace_id + agent_remote_identifier), либо текст ошибки, если отправка не удалась.

Отключение интеграции

Чтобы прекратить экспорт звонков, откройте настройки узла Tuner и выключите Включен. Значения сохранятся — включите переключатель обратно, когда понадобится возобновить экспорт.

Устранение неполадок

Проблема	Решение
Звонки не сохраняются	Проверьте логи `tuner-compat` и убедитесь, что `TUNER_BASE_URL` на бэкенде указывает на работающий приемник (`GET /api/v1/health` должен вернуть `{"status":"ok"}`)
В результате экспорта `401`	API-ключ ноды отсутствует в `TUNER_ALLOWED_TOKENS` приемника или не начинается с `tuner_live_`
В результате экспорта `duplicate`	Это не ошибка: звонок уже сохранен для этого агента и рабочего пространства
Узел показывает «Не настроено»	Откройте узел и заполните Agent ID, Workspace ID и API Key. Все три поля обязательны, пока включен Включен
Воркфлоу не отправляет данные	Убедитесь, что воркфлоу опубликован, а не только сохранен как черновик

Дополнительно

Обзор интеграций — как узлы интеграций встраиваются в воркфлоу
Исходный код приемника и его контракт находятся в директории tuner-compat/ репозитория

Начало работы

Основные понятия

Конфигурации

Конструктор голосовых агентов

Телефония

Интеграции

Интеграция с Tuner

Обзор

Предварительные требования

Как подключен приемник

Настройка

1. Выберите учетные данные

2. Добавьте узел Tuner в воркфлоу

3. Настройте узел

4. Проверьте подключение

Отключение интеграции

Устранение неполадок

Дополнительно

​Обзор

​Предварительные требования

​Как подключен приемник

​Настройка

​1. Выберите учетные данные

​2. Добавьте узел Tuner в воркфлоу

​3. Настройте узел

​4. Проверьте подключение

​Отключение интеграции

​Устранение неполадок

​Дополнительно

Обзор

Предварительные требования

Как подключен приемник

Настройка

1. Выберите учетные данные

2. Добавьте узел Tuner в воркфлоу

3. Настройте узел

4. Проверьте подключение

Отключение интеграции

Устранение неполадок

Дополнительно