Все ноды/AI/Agents

План агента

Todo-список для агента: планирование и отметка задач через инструменты. Стрим в панель Extra — «Stream to Extra panel»; порт stream по умолчанию скрыт, включите «Explicit Extra stream port» для ребра к Extra Section.

План агентаT▶S

Расширения агентаРасширение агента

Задать задачиПоток

Задачи

Тип в графе: agent_plan

ToolExecStateful

Можно включить выход ошибки и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий сценарий

Вход

План агентаT▶S

Выход▶

Исполнение + данные
Данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

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

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

Список подставляется в системный промпт строками вида [ ] Проверить оплату, где [✓] — выполнено, [✗] — ошибка. Управляет им модель инструментами agent_todo_new, agent_todo_delete и agent_todo_set_status; каждый принимает сразу массив задач, поэтому весь план создаётся одним вызовом. Статусы ровно три: planned, completed, error.

Показ в чате включён по умолчанию: после каждого изменения списка снимок уходит в панель Extra — без ребра в графе. «Показывать план в начале хода» добавляет ещё один снимок в начале хода, до того как модель что-то сделала.

Если снимок нужно направить в конкретную Секцию Extra, включите «Явный порт стрима в Extra»: появится порт Поток. Учтите обратную сторону — встроенный показ при этом отключается, и работает только нарисованное ребро.

«Область» та же, что у памяти: thread (по умолчанию) — план переживает сообщения чата, session — живёт один запуск, call — начинается пустым каждый ход. Начальные задачи дописываются к сохранённому списку и сверяются по идентификатору, а если он не задан — по заголовку, поэтому одно и то же семя не дублируется от хода к ходу.

Частые ошибки

Рисуют ребро в Секцию Extra, не включив «Явный порт стрима в Extra». Порт скрыт, ребро провести не от чего.
Включают порт и забывают ребро. Тогда выключены оба канала сразу, и плана не видно нигде.
Оставляют thread в долгом чате. Задачи вчерашнего вопроса остаются в промпте, и модель пытается их закрывать. Для одноразового плана берите call.
Ищут вызовы agent_todo_* в потоке перехвата инструментов. По умолчанию они скрыты («Скрывать вызовы плана в Catch»), потому что их и так видно снимком плана.
Ждут план в выводе сценария. Чтобы отдать список задач в граф, включите «Вывод задач» и тяните ребро от порта Задачи.

Входы

Порт	Провод	Данные	Примечания
Расширения агента`tools`	Расширение`link_extension`	—	несколько связей
Задать задачи`tasks_in`	Исполнение + данные`execute_data`	`array`	показывается, когда overwrite_from_input = true

Выходы

Порт	Провод	Данные	Примечания
Расширение агента`output`	Расширение`link_extension`	—
Поток`stream`	Стрим`streaming`	—
Задачи`tasks_out`	Данные`data`	`array`	показывается, когда expose_tasks_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Разрешённые инструменты`enabled_tools`	`array<string>`	`["new","delete","set_status"]`	Какие инструменты плана может вызывать модель.
Явный порт стрима в Extra`expose_extra_stream_port`	`boolean`	`false`	Когда выключено (по умолчанию): стрим в панель Extra без ребра в сценарии; порт стрима скрыт. Когда включено: порт стрима показан — подключите его к Extra Section (или другому разрешённому приёмнику). Встроенный само-стрим отключён; вывод отправляет только явное ребро стрима.
Вывод задач`expose_tasks_output`	`boolean`	`false`	Показать выход, который отдаёт текущий список задач следующему шагу.
Открыть инструменты для LLM`expose_tools`	`boolean`	`true`	Разрешить модели самой управлять планом (new, delete, set status).
Начальные задачи`initial_todos`	`array<object>`	`[]`	Опциональные начальные задачи (id, title, status)
Задать задачи из входа`overwrite_from_input`	`boolean`	`false`	Показать вход, который одновременно запускает шаг и приносит значение: пришедшее полностью заменяет сохранённый список задач. Появляется и его выход «Успех», который срабатывает после записи.
Область`scope`	`string`	`thread`	thread: сохраняется между сообщениями чата · session: живёт одно выполнение · call: заново каждый раз Варианты: `thread` — Тред, `call` — Вызов, `session` — Сессия
Показывать план в начале хода`stream_initial`	`boolean`	`false`	Отправлять один снимок перед первым запросом к LLM в ходе (если stream_to_extra включён), даже когда stream_on_change выключен.
Показывать план при изменении`stream_on_change`	`boolean`	`true`	Отправлять снимок после каждого изменения списка todo-инструментом (если stream_to_extra включён).
Стрим в панель Extra`stream_to_extra`	`boolean`	`true`	Когда включено, снимки todo отправляются в панель Extra чата (через встроенный стрим, если не включён «Explicit Extra stream port» — тогда только через подключённое ребро).
Скрывать вызовы плана в Catch`suppress_in_catch`	`boolean`	`true`	Когда включено, сырые вызовы agent_todo_* не дублируются в потоке Catch Tool Call (снимок плана всё равно обновляет Extra, если настроено).

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Показывает выход, который срабатывает, если не удалась запись задач.