n8n + TokenTool: от тестовой AI-ноды к управляемой автоматизации
Публичная инструкция TokenTool показывает подключение n8n через OpenAI credential и базовый URL. В рабочей архитектуре workflow получает отдельный проект или ключ, настраиваемый лимит и техническую наблюдаемость; результат модели валидируется, повторы ограничиваются, а внешние действия остаются идемпотентными.
Короткий ответ
Как подключить TokenTool к n8n?
Используйте credential типа OpenAI API с Base URL TokenTool и отдельным ключом для workflow; публичная инструкция показывает текущую последовательность настройки.
- Кому
- Разработчики автоматизаций и интеграторы n8n.
- Что решает
- Подключает текстовый AI-шаг, сохраняя в workflow проверку ответа, повторы и внешние действия.
- Подтверждено
- Публичная инструкция n8n фиксирует тип credential, Base URL https://api.tokentool.ru/api/v1 и настройку ключа.
- Граница
- Интерфейс и ноды n8n меняются; конкретный режим требует теста, а валидация, bounded retry и идемпотентность остаются задачей workflow.
Проверено
Открыть инструкцию n8nИнфраструктурный слой
После подключения API начинается управление
Отдельный контур
Для workflow можно отделить ключ и проект от других интеграций команды.
Проверить поверхностьБюджет процесса
Суточный и общий лимиты помогают контролировать текстовые запросы; внешнее действие защищается отдельно.
Проверить поверхностьРазбор выполнения
Статистика и логи помогают сопоставлять модель, ключ, проект и стоимость без публикации содержимого.
Проверить поверхностьРабочий инструмент
Контрольная карта workflow
У каждого узла одна ответственность и измеримый выход.
| Узел | Вход | Проверка перед выходом |
|---|---|---|
| Trigger | Событие с ID | Источник разрешён, ID не пуст |
| Normalize | Сырой объект | Лишние и секретные поля удалены |
| AI | Узкая задача | Есть текстовый ответ и технический статус |
| Validate | Ответ модели | Типы, длина и enum прошли |
| Action | Проверенные поля | Idempotency key и allowlist готовы |
| Review/Error | Конечная ошибка | Есть владелец и причина |
Контур из пяти узлов
Начните с явного триггера: webhook, расписание или новое событие в системе. Следующий узел нормализует вход и удаляет поля, которые модели не нужны. AI-узел выполняет одну вероятностную задачу — классификацию, извлечение или черновик. После него обычный Code/IF-узел проверяет схему, а отдельный action-узел выполняет разрешённое действие.
Такое разделение делает сбой наблюдаемым. Модель не должна сама определять получателя платежа, выполнять SQL или выбирать произвольный URL. Если ответ не прошёл проверку, workflow уходит в конечную ветку review/error, а не пытается бесконечно исправить себя.
Credential и секреты
Текущая публичная инструкция описывает OpenAI API credential с базовым URL TokenTool. Названия полей и расположение настроек зависят от версии n8n, поэтому проверяйте руководство и интерфейс в день внедрения. Ключ сохраняйте в credential store, а не в Set-узле, JSON workflow, заметке или query string webhook.
Экспорт workflow перед публикацией просматривайте как обычный код. В нём не должно быть ключа, пользовательских документов, реальных email и тестовых ответов. Для разработки и production используйте разные credentials и отдельные ключи с собственными лимитами.
Повторы и внешние действия
HTTP timeout не доказывает, что предыдущая операция не выполнилась. Перед отправкой письма, созданием задачи или изменением записи сформируйте idempotency key из стабильного ID события и версии операции. Повтор должен находить уже завершённое действие, а не создавать копию.
Задайте максимальное число попыток, задержку и перечень повторяемых ошибок. Невалидный JSON и ошибка бизнес-правила требуют review, а временная сетевая ошибка может получить ограниченный retry. Все ветки должны завершаться видимым статусом.
Стоимость одного результата
Считайте не только цену AI-вызова. Один исходный event может пройти несколько AI-шагов, повториться и попасть на ручную проверку. Зафиксируйте число входных и выходных токенов каждого узла, частоту повторов и долю результатов, дошедших до нужного действия.
Сначала оцените текстовую нагрузку в калькуляторе, затем сравните её с фактическими списаниями. Model ID и тариф сверяйте по каталогу перед выпуском. Страница не обещает поддержку каждой n8n-ноды: конкретную версию credential и операцию нужно пройти в тестовом workflow.
Порядок внедрения
- 01Создать отдельный credential по актуальной инструкции.
- 02Собрать trigger и нормализацию входа.
- 03Оставить AI-узлу одну ограниченную задачу.
- 04Добавить схему, review-ветку и bounded retry.
- 05Посчитать стоимость успешного действия на тестовой выборке.
Перед запуском
- Ключ хранится только в credential
- Экспорт workflow очищен
- Ответ модели валидируется
- Внешнее действие идемпотентно
- Retry имеет предел
- Есть конечная ветка review/error
Границы решения
- Интерфейс credential и набор нод меняются между версиями n8n.
- Поддержка конкретного режима модели подтверждается отдельным тестом.
Начните с небольшого измеримого теста
Проверьте один сценарий, зафиксируйте результат и расходы, затем расширяйте нагрузку.