Все ноды/AI/Agent State
Навыки агента
Набор навыков (skills) для агента: каждый навык — набор инструкций в системном промпте. Агент может активировать/деактивировать навыки динамически. Подключается через link_extension.
Тип в графе: agent_skills
ToolExecStateful
Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.
Как попробовать
Минимальный рабочий воркфлоу
- Исполнение + данные
- Данные
Запускается сразу
Как применять
Навыки нужны, когда один агент должен вести себя по-разному в разных ситуациях, а держать все инструкции в одном системном промпте уже неудобно: правила возврата, тон для жалобы, порядок оформления заказа. Каждый навык — это имя, короткое описание и блок инструкций. В промпт попадают инструкции только включённых навыков, а модель может включать и выключать их по ходу диалога.
Как это работает
В системный промпт добавляется блок <skills>: сначала перечень всех навыков с их состоянием
и описанием, затем полный текст включённых, затем имена выключенных. Модель видит, что у неё
есть в запасе, и переключает инструментами agent_skill_activate и agent_skill_deactivate —
решает она по описанию, поэтому пустое описание практически гарантирует, что навык никогда
не включится.
У каждого навыка есть собственный входной порт Skill N — он появляется по мере того, как вы добавляете навыки. Инструменты, подключённые к порту навыка, объявляются модели только пока этот навык включён. Это и есть главный смысл ноды: не только текст инструкции, но и набор доступных инструментов меняется вместе с режимом работы.
Между ходами сохраняется только флаг «включён/выключен», привязанный к имени навыка. Сами тексты, описания и связи каждый раз берутся из текущей конфигурации, поэтому правка инструкции доезжает до уже идущих диалогов сразу, а состояние переключателей при этом не теряется.
Порт Set active (включается опцией «Задать активные навыки из входа») работает мягче, чем
его аналоги у Памяти агента и Плана агента:
он принимает карту вида {"refunds": true} и меняет только флаги совпавших по имени навыков.
Библиотека не заменяется, незнакомые имена игнорируются.
Частые ошибки
- Ждать, что нужный навык включится сам. Выбор делает модель. Если навык должен работать всегда, оставьте его активным изначально или перенесите текст в системный промпт агента.
- Подключать инструменты прямо к агенту и ждать, что навык их скроет. Скрываются только те, что подключены к порту самого навыка.
- Два навыка с одинаковым именем. Переключение найдёт первый, второй останется недоступным.
- Пустой список навыков при включённых инструментах. Пока библиотека пуста, инструменты управления модели не показываются вовсе — нода в графе есть, а эффекта нет.
- Тянуть выход в порт Memory агента. Нода подключается связью расширения в порт Extensions ИИ-агента.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Set activeskills_in | Исполнение + данныеexecute_data | object | показывается, когда overwrite_from_input = true |
Skill 1skill_0 | Расширениеlink_extension | — |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Agentoutput | Расширениеlink_extension | — | |
Activeskills_out | Данныеdata | object | показывается, когда expose_skills_output = true |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Режим редактированияedit_mode | string | editor | Режим UI для редактирования навыков: json (текстовое поле) или editor (визуальная форма) Варианты: |
Включённые инструментыenabled_tools | array<string> | ["activate","deactivate"] | Какие инструменты управления навыками доступны LLM. Пока список навыков пуст, модели не показывается ни один из них. |
Вывод активныхexpose_skills_output | boolean | false | Показать data-порт вывода, который отдаёт текущую карту {skill: active}. |
Открыть инструменты для LLMexpose_tools | boolean | true | Разрешить LLM вызывать инструменты управления навыками (activate/deactivate) |
Начальные навыкиinitial_skills | array | [] | Навыки для загрузки при старте (у каждого навыка есть name, description, prompt, active) |
Задать активные навыки из входаoverwrite_from_input | boolean | false | Показать входной порт навыков (ED) (карта {skill_name: bool}), срабатывание которого мержит флаги активности совпадающих навыков, плюс exec-выход «History set», срабатывающий после записи. |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.