Все ноды/AI/Agent State

Навыки агента

Набор навыков (skills) для агента: каждый навык — набор инструкций в системном промпте. Агент может активировать/деактивировать навыки динамически. Подключается через link_extension.

Навыки агентаTS
Set activeAgent
Skill 1Active

Тип в графе: agent_skills

ToolExecStateful

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

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

Минимальный рабочий воркфлоу

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

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

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

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

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

В системный промпт добавляется блок <skills>: сначала перечень всех навыков с их состоянием и описанием, затем полный текст включённых, затем имена выключенных. Модель видит, что у неё есть в запасе, и переключает инструментами agent_skill_activate и agent_skill_deactivate — решает она по описанию, поэтому пустое описание практически гарантирует, что навык никогда не включится.

У каждого навыка есть собственный входной порт Skill N — он появляется по мере того, как вы добавляете навыки. Инструменты, подключённые к порту навыка, объявляются модели только пока этот навык включён. Это и есть главный смысл ноды: не только текст инструкции, но и набор доступных инструментов меняется вместе с режимом работы.

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

Порт Set active (включается опцией «Задать активные навыки из входа») работает мягче, чем его аналоги у Памяти агента и Плана агента: он принимает карту вида {"refunds": true} и меняет только флаги совпавших по имени навыков. Библиотека не заменяется, незнакомые имена игнорируются.

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

  • Ждать, что нужный навык включится сам. Выбор делает модель. Если навык должен работать всегда, оставьте его активным изначально или перенесите текст в системный промпт агента.
  • Подключать инструменты прямо к агенту и ждать, что навык их скроет. Скрываются только те, что подключены к порту самого навыка.
  • Два навыка с одинаковым именем. Переключение найдёт первый, второй останется недоступным.
  • Пустой список навыков при включённых инструментах. Пока библиотека пуста, инструменты управления модели не показываются вовсе — нода в графе есть, а эффекта нет.
  • Тянуть выход в порт Memory агента. Нода подключается связью расширения в порт Extensions ИИ-агента.

Входы

ПортПроводДанныеПримечания
Set activeskills_inИсполнение + данныеexecute_dataobject

показывается, когда overwrite_from_input = true

Skill 1skill_0Расширениеlink_extension

Выходы

ПортПроводДанныеПримечания
AgentoutputРасширениеlink_extension
Activeskills_outДанныеdataobject

показывается, когда expose_skills_output = true

Настройки

ПолеТипПо умолчаниюОписание
Режим редактированияedit_modestringeditor

Режим UI для редактирования навыков: json (текстовое поле) или editor (визуальная форма)

Варианты: json, editor

Включённые инструментыenabled_toolsarray<string>["activate","deactivate"]

Какие инструменты управления навыками доступны LLM. Пока список навыков пуст, модели не показывается ни один из них.

Вывод активныхexpose_skills_outputbooleanfalse

Показать data-порт вывода, который отдаёт текущую карту {skill: active}.

Открыть инструменты для LLMexpose_toolsbooleantrue

Разрешить LLM вызывать инструменты управления навыками (activate/deactivate)

Начальные навыкиinitial_skillsarray[]

Навыки для загрузки при старте (у каждого навыка есть name, description, prompt, active)

Задать активные навыки из входаoverwrite_from_inputbooleanfalse

Показать входной порт навыков (ED) (карта {skill_name: bool}), срабатывание которого мержит флаги активности совпадающих навыков, плюс exec-выход «History set», срабатывающий после записи.

Общие поля

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

  • expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.