Перейти к содержанию

Агенты и промпты

🚧 Draft. Скелет по стандарту index.md §4 / _meta/_TEMPLATE.ru.md.

Агенты в Axon — это workflow-функции (config shape = agent_config). Этот мануал: agent definitions, executor profiles, какие tools агенту видны (AgentSpec exposure rule), prompt scope, управление промптами.

1. Что это и зачем

TODO — AI — скальпель, не кувалда; агент = workflow с agent_config; Pydantic AI / Instructor → LiteLLM proxy (не прямые SDK провайдеров); model_call идёт через LiteLLM, не через MCP.

2. Роли и доступ

TODO — agent_definition:manage (owner/admin/system; manager НЕ имеет); prompt:manage (owner/admin/system); engineer пишет agent/prompt definitions в коде, публикует — owner/admin (или system для built-in).

3. Где это в Console

TODO — раздел Agents (список agent definitions, executor profiles, allowed_tools); раздел Prompts (управление промптами, prompt scope, версии).

4. Концепции (mental model)

TODO — executor profile (allowed_tools ∩ project enabled_tools ∩ AgentSpec exposure rule); AgentToolResolver отдаёт агенту только side_effect_class="none" tools; internal/external_low/external_high connector/MCP actions — это workflow steps (tool_call/external_write) с policy gate, не direct agent tools; prompt scope (что видит prompt, какие переменные).

5. Флоу: пошаговые сценарии

TODO — «создать agent definition» (engineer→admin); «настроить executor profile»; «опубликовать prompt»; «дать агенту доступ к новому direct tool».

6. Справочник опций

TODO — поля agent definition; executor profile; prompt scope config; модели и routing (cross-ref Model-Routing-And-Budgets).

7. Жизненный цикл и обслуживание

TODO — версии prompt/agent definitions; built-in (origin='system'/'code') vs project-level; Langfuse traces.

8. Траблшутинг

TODO — «агент не видит tool» → не side_effect_class="none" / нет в allowlist / нет в project enabled_tools; «нужен audited read-tool» → требует отдельного public contract, не вводится implicit-правилом.

9. Ограничения и инварианты

TODO — direct agent tools только side_effect_class="none"; AI не обязателен ни для одного уровня; все AI side effects подчиняются тем же policy/budget/audit; объяснимость до уровня features/circuits/attribution graphs (инвариант 9).

10. Связанные мануалы и каноны