Редактор и ноды

Граф агента: как добавлять и настраивать узлы, задавать режим работы.

Что такое граф агента

Агент — это граф из узлов (нод), соединённых стрелками. Данные текут от ноды к ноде: каждая что-то делает и передаёт результат дальше. Минимальный агент состоит из двух нод: Вход и Выход. Шаги выполняются цепочкой: от обычной ноды агент идёт только по одной стрелке, разветвляет путь лишь «Условие» (ветки «да» и «нет»). Если от ноды отходит несколько стрелок, редактор предупредит — выстройте шаги один за другим.

Как добавить ноду

  1. Откройте агента и нажмите «Показать устройство» под карточкой — раскроется редактор с канвасом слева. «Во весь экран» открывает тот же редактор на всю рабочую область.
  2. Нажмите кнопку «Добавить ноду» на канвасе (левый верхний угол).
  3. Выберите тип ноды из появившегося меню.
  4. Нода появится на канвасе. Потяните за неё, чтобы переместить.
  5. Соедините ноды: наведите курсор на кружок-коннектор с правого края ноды-источника, зажмите и тяните к входу ноды-получателя.

Как настроить ноду

  1. Кликните по ноде на канвасе — она выделится.
  2. В правой панели откроется вкладка «Inspector» с параметрами ноды.
  3. Заполните нужные поля. Для большинства полей доступны подсказки под ними.
  4. В текстовых полях можно использовать переменные в формате {{имя_ноды.поле}} — значение подставится из результата соответствующей ноды.
  5. Изменения сохраняются автоматически — специальной кнопки «Сохранить» нет.

Чтобы удалить ноду, выделите её и нажмите кнопку «Удалить ноду» внизу вкладки «Inspector». Для запуска агенту нужны хотя бы ноды Вход и Выход — не удаляйте их.

Режим работы агента (вместо выбора модели)

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

  1. Откройте страницу агента.
  2. Внизу, в «Настройках», раскройте строку «Режим работы».
  3. Выберите режим: «Экономно» — быстрые короткие ответы за минимум кредитов; «Обычно» — рабочий баланс, подходит большинству агентов (стоит по умолчанию); «Максимум» — самое высокое качество и самый большой расход.

Режим — главный рычаг расхода. Все ответы агента оплачиваются кредитами из общего счёта пространства, и «Максимум» выжигает месячный пакет в разы быстрее «Обычно». Ставьте его точечно — тем агентам, где действительно нужен сложный разбор.

Режим зависит от тарифа: «Экономно» доступно всем, «Обычно» — с «Стартер», «Максимум» — с «Плюс». Выбрать более высокий режим можно и на младшем тарифе: агент ответит на мозге, доступном вашему тарифу, запуск не прервётся, а в партитуре прогона будет пометка. Подробно о расходе — в разделе «Кредиты и лимиты».

Вкладки правой панели

  • Inspector — параметры выбранной ноды. Появляется при клике на ноду.
  • Превью — тестовый чат с агентом прямо в редакторе. Вводите сообщения и смотрите как агент отвечает, не публикуя его. Сверху стоит галочка «Тестовый прогон» — она включена по умолчанию: агент отвечает по-настоящему, но сообщения, письма, публикации, заказы и платные генерации наружу не уходят, а в шагах видно, что он собирался сделать. То же касается агентов, которых он вызывает сам: они тоже работают в тестовом режиме. Снимите её, когда захотите боевой прогон. Над чатом раскрываются правила агента: поправка, сказанная в разговоре, действует один разговор, а правило — всегда и во всех каналах. Под своей репликой нажмите «Запомнить как правило» — текст подставится в поле, сохранится только по вашему нажатию. Правила видно списком, лишнее убирается крестиком.
  • Дирижёр — тот же помощник, что на Главной, с памятью разговоров об этом агенте. Он видит агента целиком и выбранную ноду («эта нода» в просьбе — она; клик по ноде выбирает её, не уводя из вкладки). Напишите, что изменить, — правка сразу появится на схеме и сохранится, а кнопка «Вернуть» на карточке откатит её, пока схему после правки не трогали. Правки, которые меняют доступ к боту или право записи в интеграции, он сначала покажет карточкой с кнопкой «Подтвердить».

Типы нод

ВходТочка входа агента. Описывает, какие данные он получает на старте (например, текст сообщения клиента).
ВыходФинальный результат работы агента. Описывает, что агент возвращает в конце.
LLMВызов языковой модели (AI). Задайте системный промпт и запрос; подходящую модель платформа подбирает сама. Это главная «думающая» нода.
УсловиеРазвилка: проверяет выражение и направляет выполнение по одной из двух веток (да / нет). У ноды два выхода — точки «да» и «нет»: тяните стрелку от нужной, ветку определяет точка, а не порядок стрелок. Новая стрелка от точки заменяет прежнюю стрелку этой ветки, вторая ветка остаётся на месте. Понимает ==, !=, «содержит», «не содержит», || (или), && (и) и скобки, например {{classify.output}} == 'price' || {{classify.output}} == 'sale'. Пустое или непонятное условие всегда ведёт по ветке «нет»: после сохранения и обновления страницы агента появится предупреждение, а в журнале прогона — запись «Не понял условие».
HTTPЗапрос к произвольному HTTP API. Поддерживает все методы (GET, POST и т.д.) и авторизацию.
TelegramОтправляет сообщение через Telegram-бота из раздела «Интеграции». Если после отправки в графе нет шага с ответом, клиент получит короткое «Готово, сообщение передано.».
EmailЧтение или отправка почты через IMAP/SMTP-подключение из раздела «Интеграции». Если письмо — последний шаг графа (например, пересылка заявки менеджеру), клиент получит короткое «Готово, сообщение передано.».
КодВ разработке: пока не выполняется. Задумана для запуска произвольного JavaScript-кода с переменной input — безопасное выполнение появится позже.
ИнструментВ разработке: пока не выполняется. Задуманы встроенные инструменты (поиск в интернете, чтение и запись файла) — реальное подключение появится позже.
РасписаниеНастоящий запуск по расписанию задаётся в «Настройках» на странице агента, строка «Расписание» (минимальный интервал — часы). Нода-таймер на канвасе пока только симулируется.
ГенерацияСоздаёт картинки и видео нейросетями. Результат приходит отдельным сообщением; можно сразу отправить на публикацию в канал.
ПубликацияПубликует текст и медиа в подключённый канал — Telegram-канал или сообщество ВКонтакте. Можно включить согласование владельцем перед публикацией.
ИнтеграцияВызывает внешний сервис через подключённый коннектор: Wildberries, amoCRM, Bitrix24, Ozon, Яндекс.Диск.

Переменные между нодами

Каждая нода имеет уникальное имя (например, input_1). Чтобы передать её результат в следующую ноду, используйте шаблон:

{{имя_ноды.поле}}

Например, чтобы передать текст входящего сообщения в LLM-ноду, в поле «Запрос» напишите:

{{input_1.message}}