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

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

Набор навыков (skills) для агента: каждый навык — набор инструкций в системном промпте. Агент может активировать/деактивировать навыки динамически. Подключается ко входу «Расширения агента» ИИ-агента выходом «Расширение агента».

Навыки агентаT▶S
Задать активные навыкиРасширение агента
Навык 1Активные навыки

Тип в графе: agent_skills

ToolExecStateful

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Входы

ПортПроводДанныеПримечания
Задать активные навыкиskills_inИсполнение + данныеexecute_dataobject

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

Навык 1skill_0Расширениеlink_extension—

Выходы

ПортПроводДанныеПримечания
Расширение агентаoutputРасширениеlink_extension—
Активные навыкиskills_outДанныеdataobject

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

Настройки

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

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

Варианты: json — Текстом, editor — Формой

Разрешённые инструментыenabled_toolsarray<string>["activate","deactivate"]

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

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

Показать выход, который отдаёт следующему шагу, какие навыки сейчас включены.

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

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

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

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

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

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

Общие поля

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

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