Перейти к содержимому
PentAGI
Концепции

Agents

Специализированные agents, обеспечивающие выполнение flow, и механизмы защиты, удерживающие их на правильном пути.

Flow выполняется командой agents. У каждого agent type свои промпт, настройки модели и tools, что позволяет назначать более мощные или более дешёвые модели для каждой роли.

Agent types

AgentРоль
primary_agentОсновной рассуждающий agent, управляющий flow
assistantРежим интерактивного assistant
generatorРазбивает каждый task на subtasks
refinerУточняет план по мере поступления результатов
adviserЭкспертные консультации; наставник при контроле выполнения и планировщик при постановке task
reflectorКорректирует agents, переставших выполнять tool calls
searcherСбор информации и поиск в интернете
enricherСобирает дополнительный контекст из memory и sandbox перед тем, как adviser даст ответ
coderПишет и анализирует код
installerУстанавливает и настраивает tools в sandbox
pentesterPentest и оценка безопасности
simple, simple_jsonПростые и JSON-структурированные завершения

Ещё два agents работают за кулисами: memorist отвечает на вопросы других agents о прошлой работе, обращаясь к долгосрочной memory, а reporter оформляет результат каждой task.

Как делегируется работа

How a task is split into subtasks and the primary agent delegates each step to specialist agents through shared memoryVector storeSpecialistsMemoristPrimary agentGeneratorVector storeSpecialistsMemoristPrimary agentGeneratorSubtasks of the taskPast work, when the context lacks itSearch memoryDelegate a step to the searcher, pentester, coder or installerStore tool resultsResult

Механизмы контроля

  • Лимиты tool call (всегда включены) — MAX_GENERAL_AGENT_TOOL_CALLS (по умолчанию 100) ограничивает количество ходов модели в цепочках primary_agent, assistant, pentester, coder и installer, а MAX_LIMITED_AGENT_TOOL_CALLS (по умолчанию 20) ограничивает их для остальных agents. За один ход можно вызвать несколько tools. Значения от 1 до 5 повышаются до 6, а 0 или меньше означает использование значения по умолчанию.
  • Обнаружение повторов (всегда включено) — начиная с третьего подряд вызова одного и того же tool с теми же аргументами, tool не выполняется повторно: agent получает предыдущий ответ с просьбой изменить курс. Седьмой такой вызов завершает цепочку.
  • Reflector (всегда включён) — вмешивается, если модель впервые отвечает без tool call, и направляет agent обратно к выполнению tool call; после трёх неудачных раундов цепочка останавливается.
  • Контроль выполнения (бета, EXECUTION_MONITOR_ENABLED) — для primary_agent, pentester, coder, installer и assistant при работе с agents adviser выступает в роли наставника, когда agent вызывает один и тот же tool EXECUTION_MONITOR_SAME_TOOL_LIMIT раз подряд (по умолчанию 5) или совершает EXECUTION_MONITOR_TOTAL_TOOL_LIMIT tool calls с момента последней рекомендации (по умолчанию 10). Триггер подсчитывает вызовы, а не обнаруживает зависание; затем adviser анализирует прогресс agent и рекомендует продолжить, изменить подход или остановиться.
  • Интеллектуальное планирование task (бета, AGENT_PLANNING_STEP_ENABLED) — agent adviser составляет 3–7 конкретных шагов до того, как специалисты приступят к subtask.

Контроль выполнения и планирование task примерно вдвое повышают качество результатов для моделей с объёмом менее 32B параметров, но расходуют в 2–3 раза больше токенов и времени. По умолчанию они отключены.

В Enterprise planner всегда выполняется, а мониторинг выполнения включён по умолчанию с лимитами 20 и 40 — см. Agent profiles.

Последнее обновление: