Документация

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

Начало

• Что такое Iterna — Модель продукта за пять минут — сценарий, ноды, провода и каналы доставки.
• Быстрый старт — Что понадобится, что произойдёт в первые пять минут и где начинается лестница уроков.
• Готовые шаблоны — Десять готовых сценариев: что каждый делает, из чего собран и что обязательно донастроить после импорта.
• Глоссарий — Короткие определения терминов, которые встречаются в интерфейсе и в документации.

Уроки

• Урок 1. Первый чат-бот — Агент с моделью и памятью: собрать, проверить и выложить по ссылке за один заход.
• Урок 2. Бот на вашем сайте — Тот же бот, что и в уроке 1, — кнопкой в углу вашей страницы или блоком внутри вёрстки. Один тег script.
• Урок 3. Бот отвечает по вашим документам — База знаний, поиск по смыслу и агент, который отвечает только по найденному, а не по общим знаниям.
• Урок 4. Логика без модели — Ветвление и шаблоны: граф, который сортирует обращения и отвечает по-разному, не обращаясь к модели ни разу.
• Что делать, если… — Диагностика по симптому: правка не применилась, кнопка публикации серая, нода пропущена, ответ пустой, бот молчит. Что видно, почему так и куда идти дальше.

Интерфейс

• Обзор интерфейса — Как устроено приложение Iterna — боковая панель, разделы, рабочие пространства, язык и аккаунт.
• Сценарии — Список сценариев пространства: поиск, вкладки статуса, метрики карточки, создание из шаблона и удаление.
• Холст редактора — Палитра нод, соединение портов, выделение, автолейаут и вход внутрь композитных нод.
• Окно конфигурации ноды — Вкладки «Параметры», «Входы» и «Выходы», секция «Дополнительно», перекрытие поля портом и разделение портов.
• Проверка, сохранение и версии — Панель проблем, разница между ошибкой и предупреждением, история версий и откат.
• ИИ-ассистент в редакторе — Как ставить задачу ассистенту, читать предпросмотр изменений и применять их.
• Вкладка «Тест» — Запуск сценария из чата, статусы нод на канвасе, лог исполнения и инспектор ноды.
• Вкладка «Публикация» — Чем черновик отличается от опубликованной версии и что настраивается в каждом из шести каналов.
• Запуски — Список запусков, фильтры и страница одного запуска: ноды, граф, таймлайн, логи, токены и кварки.
• Чат — Разговор с развёрнутым сценарием — сессии, отправка и остановка ответа, вложения, очистка истории.
• Расход — Куда ушли кварки — остаток, разбивка по дням, сценариям и каналам, выгрузка списаний.
• Диалоги — Просмотр сессий конечных пользователей сценария и полной переписки по каждой из них.
• Документы — Создание базы знаний, загрузка документов и ссылок, метаданные, статусы обработки и удаление.
• Таблицы — Коллекции JSON-документов рабочего пространства — вставка, правка, запросы и квоты.
• Файлы — Файловое дерево рабочего пространства — загрузка, папки, предпросмотр, квота и удаление.
• Настройки — Десять разделов настроек — от профиля и рабочего пространства до виджета, white-label и оплаты.

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

• Основные концепции — Из чего состоит сценарий: граф, ноды, порты, провода и порядок исполнения.
• Модель графа — Ноды, рёбра, порты, вход и выход — и почему движок активирует ноды событиями, а не порядком в списке.
• Провода — Десять типов рёбер Iterna — что каждое несёт, когда появляется и почему конфигурационные связи не влияют на порядок.
• Типы портов — Тринадцать семантических типов данных порта, правила совместимости и то, как значение приводится к нужной форме.
• Как исполняется граф — Ноду запускает входящее ребро, а не порядок на холсте: ветвления, OR-join, барьеры и чистые data-ноги.
• Агент и инструменты — Чем ai_agent отличается от одного вызова модели: раунды, инструменты через link_extension, состояние агента и бюджет вызовов.
• Вход и выход сценария — Почему entry ровно один, когда допустимо несколько exit и что такое гонка за результат.
• Циклы и итерации — Почему ребро назад — это ошибка, а повтор выражается нодами-оболочками: while_loop, for_each, map и filter.
• Композиты и суб-сценарии — Свернуть кусок графа в одну ноду: интерфейсные порты, изоляция имён, вложенность и WF tool как инструмент агента.
• Статусы запуска и причины пропуска — Точный смысл completed, partial и failed, статусы нод и шесть значений skip_reason.
• Ошибки нод — Ветка on_error, что в неё приходит, коды ошибок, повторы и чем ошибка интеграции отличается от ошибки валидации.
• Шаблоны — Подстановки {{ }} в полях нод — пространства имён, правила рендера и однократность.
• Переменные и память — Где сценарий хранит состояние — var, области видимости, память диалога и память агента.
• Таймауты и бюджеты — Что останавливает застрявший запуск: потолки времени, токенов, итераций и глубины вложенности.
• Коды проверки графа — Полный список кодов, которые показывает панель проблем: что означает каждый и когда он блокирует запуск.

Справочник нод

• Как читать страницу ноды — Карточка, порты, бейджи, таблица полей и пример: что где искать в справочнике нод.

Модели

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

Каналы

• Публичный чат — Страница с чатом по ссылке — самый быстрый способ отдать сценарий людям.
• Telegram-бот — Подключение бота, триггеры в группах, режим приватности и диагностика.
• Бот ВКонтакте — Подключение сообщества, Callback API, уровни доступа в беседе и диагностика.
• Вебхук — Запуск сценария из чужой системы — HTTP-запросом с ключом.
• Встраиваемый виджет — Добавьте чат-виджет Iterna на сайт, идентифицируйте пользователей и вызывайте браузерный JS.
• Запуск по расписанию — Cron-триггер: дайджесты, выгрузки и проверки без человека в чате.
• Assistant MCP — Внешний ИИ-агент управляет платформой по протоколу MCP: читает графы, правит, запускает.

Интеграции

• Интеграции: обзор — Как устроены подключения к внешним сервисам: учётные данные живут в воркспейсе, нода на них ссылается.
• CRM: amoCRM и Битрикс24 — Тонкие обёртки над REST этих CRM: вы называете метод и тело запроса, платформа берёт на себя адрес, авторизацию и разбор ответа.
• Календарь (CalDAV) — Одиннадцать нод к CalDAV: читать занятость, создавать и править события, отдать календарь агенту.
• Почта — Одно подключение на отправку и чтение: SMTP, IMAP или POP3, четыре ноды и почтовый инструмент агента.
• HTTP и веб — Универсальный запрос к любому API, чтение веб-страниц агентом и поиск в интернете, который возвращает источники.
• Подключение MCP-сервера — Нода mcp_tool берёт инструменты чужого MCP-сервера: коннект, два режима, подключение к агенту и что бывает, когда сервер недоступен.
• Свой код на JavaScript — Нода code_javascript: когда код оправдан, что приходит на вход и в какой песочнице он исполняется.

Данные

• Базы знаний и RAG — Как устроен поиск по документам: фрагменты, эмбеддинги, метаданные, фильтры и реранкер.
• Коллекции документов — Хранилище JSON-документов рабочего пространства: когда оно нужно, как читать и писать нодами db_*.
• Файлы воркспейса — Хранилище файлов: ноды чтения и записи, ссылки filestore:// и вложения в чате.
• Таблицы — Четырнадцать нод для CSV и Excel: как таблица ходит по графу, конвейер «прочитать → отфильтровать → сгруппировать → записать» и чем таблица отличается от коллекции.

Администрирование

• Команда и роли — Рабочее пространство как граница данных, три роли и матрица прав, владелец как отдельная сущность, архивация и бюджет пространства.
• Данные и безопасность — Где лежат данные, как устроены секреты и ключи каналов, что уходит наружу, сколько живёт история — и чего в платформе честно нет.
• Доступ по API — Три разных ключа — вход в интерфейс, запуск сценария по HTTP и внешний ИИ-агент по MCP. Единого токена «ко всему API» нет.

Тарифы

• Кварки и стоимость — Из чего складывается цена запуска: запуск, ноды, токены, медиа и поиск — и что не тарифицируется.
• Лимиты тарифов — Полная таблица ограничений всех тарифов: кварки, квоты хранилищ, каналы публикации и сроки хранения истории.