Kvantora Flow

Автоматизация запускает последовательность шагов после события. Шаг с моделью обращается к API Kvantora: выбирает модель по публичному ID, получает ответ и передаёт его следующему шагу.

Руководства Kvantora Flow

Откройте Kvantora Flow

Откройте «Автоматизации» в кабинете Kvantora (/app/automations) и нажмите «Открыть Flow» — откроется список сценариев. При первом входе в нём уже есть «Пример автоматизации: заявка с сайта → CRM → Telegram»: откройте его, чтобы увидеть готовый сценарий из нескольких шагов (это черновик, он ничего не запускает). Бесплатный тариф и подключение моделей включаются автоматически: отдельный дневной лимит и список моделей настраивать не нужно. Затем создайте сценарий. Там же работают ИИ-сотрудники.

Как подключить модели

1. Подключение «Kvantora — общий бюджет автоматизаций» создаётся автоматически при первом входе владельца или администратора.
2. По умолчанию доступны все модели каталога без отдельного дневного лимита; расходы ограничены общим балансом. При желании сузьте список моделей или задайте дневной бюджет в «Автоматизации → Подключение и история».
3. Откройте редактор и выберите подключение Kvantora в действии с моделью. Секрет не нужно вставлять в текст сценария.
4. Начните с тестового входа без персональных данных. Убедитесь, что ответ и расходы появились в истории, прежде чем подключать внешние действия.

Если вы используете собственный редактор автоматизаций, создайте отдельный ключ Kvantora с нужными правами и бюджетом. Для первого текстового HTTP-шага достаточно text; для чтения каталога добавьте models:read. Сохраните ключ в защищённом подключении вашего редактора.

Первый сценарий в Kvantora Flow

Данные между шагами

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

Для статического теста напишите задание вручную. Когда сценарий работает, замените только входной текст значением триггера. Не вставляйте сырой JSON строковой склейкой: кавычки и переносы в сообщении должны сохраняться.

Действия Kvantora

Действие медиа сначала запрашивает оценку стоимости. Оно не ждёт готового файла: сохраните ID и используйте «Получить результат задания». Транскрипция и редактирование изображения не входят в список готовых действий этой интеграции.

HTTP-шаг в собственном редакторе

Начните с ручного запуска. Добавьте HTTP-шаг с методом POST. Адрес: https://api.kvantora.ai/v1/chat/completions.

Адрес должен быть доступен с сервера автоматизации по HTTPS.

Передайте заголовки:

• Authorization: Bearer <ключ из защищённого подключения>
• Content-Type: application/json
• Idempotency-Key: <сохранённый уникальный ID этого шага>

Замените PUBLIC_API_ID публичным ID из каталога. Это место для вашего ID, а не имя существующей модели.

{
  "model": "PUBLIC_API_ID",
  "messages": [
    { "role": "user", "content": "Составь краткое описание входящего обращения" }
  ],
  "max_tokens": 256
}

Когда статический запрос работает, подставьте входной текст триггера в messages[0].content через поля редактора. Формируйте JSON средствами редактора: кавычки и переносы во входном тексте не должны ломать тело запроса.

При завершённом текстовом ответе следующий шаг получает choices[0].message.content. Сначала проверьте HTTP-статус и поле object, затем читайте текст. Расходы находятся в usage.cost_microrub, состояние расчёта в billing.status.

Ответы, ошибки и повторы

Сохраните ID шага до его отправки. При повторной доставке одного события используйте тот же ключ, endpoint, тело и Idempotency-Key. Не создавайте новый UUID внутри каждой попытки повтора: это отдельный запрос.

• HTTP 202: результат ещё не готов. Не передавайте его следующему шагу как ответ модели.
• Сетевая ошибка: исход может быть неизвестен. Для собственного HTTP-клиента проверяйте исходный запрос с тем же ID, ключом, endpoint и телом по правилам повторов. Во встроенном действии при needs_reconciliation откройте историю Kvantora и остановите цепочку; новый запуск сценария не заменяет проверку прежнего исхода. Не переключайте модель автоматически.
• api_key_daily_budget_exceeded: проверьте дневной лимит, расходы и открытые резервы.
• idempotency_conflict: сравните отправленное тело с исходным.

Медиа обрабатываются через задания. После отправки сохраняйте ID задания, проверяйте GET /v1/jobs/ID и получайте файл только после succeeded. Клиентские уведомления webhook о готовности медиа сейчас не отправляются. Используйте опрос статуса из руководства по заданиям.

Бюджет и данные

Число сценариев и запусков не ограничено. Тариф включает пакет кредитов: 1 кредит — 1 шаг сценария (списывается при запуске по числу шагов) или 1 шаг ИИ-сотрудника. Подробнее — в разделе Тарифы и кредиты. Вызовы моделей оплачиваются отдельно с общего баланса Kvantora; если вы задали дневной бюджет подключения, он ограничивает суммарные расходы ключа с учётом резервов.

Бюджет и расходы отображаются в рублях с двумя знаками после запятой, например 0,99 ₽. Подробнее о резервировании и списаниях — в руководстве по оплате.

Передавайте редактору только ключ Kvantora с нужными ограничениями. Другие пароли и доступ к внутренним сервисам для HTTP-шагов не нужны. Данные из ответа, отправленные следующим шагом во внешний сервис, становятся частью этой интеграции; настройте состав данных перед запуском.

Руководство API · Быстрый старт · Памятка по ошибкам.