106 lines
7.5 KiB
Markdown
106 lines
7.5 KiB
Markdown
---
|
||
id: synthesis-Agent-Architecture
|
||
pageType: synthesis
|
||
updatedAt: 2026-11-05T02:12:00+03:00
|
||
claims:
|
||
- text: "Обязательное правило контекст-экономики для саб-агентов (AGENTS.md,
|
||
секция после §19, добавлена 2026-08-24): для задач с файлами >500 строк
|
||
или большим объёмом вывода — (1) жёсткий лимит чтения с самого начала, (2)
|
||
точечные выжимки вместо полного чтения, (3) один большой прогон вместо
|
||
десятка команд, (4) разбиение на подзадачи, если задача не помещается.
|
||
Основание: три инцидента контекст-переполнения (аудит шага 2, первая
|
||
попытка кодера 2A, два саб-агента 2A)."
|
||
status: supported
|
||
evidence:
|
||
- kind: source-file
|
||
sourceId: source.agents
|
||
path: AGENTS.md
|
||
lines: "439-448"
|
||
note: "canonical: AGENTS.md (редакция 2026-11-04), секция «Обязательное правило для саб-агентов» (строки 439–448: правило контекст-экономики + основание: три инцидента контекст-переполнения); snapshot sources/agents.md refreshed 2026-11-04T23:00:40.524Z"
|
||
confidence: 0.95
|
||
updatedAt: 2026-11-05T02:12:00+03:00
|
||
- text: "Subagent workspace isolation (final state 2026-10-25, MEMORY.md §3, строка 33): все 4 субагента (coder-agent, evaluator-agent, humanizer-agent, setup-agent) имеют раздельные workspace (~/.openclaw/workspace-<agentId>) с role-specific AGENTS.md; main-агент в ~/.openclaw/workspace. openclaw.json tools: sessions.visibility=tree + agentToAgent.enabled=false; sessions_spawn работает через subagents.allowAgents; tools.fs.workspaceOnly не включён. Основание: [INFRA] 2026-10-25 21:10 MSK в CHANGELOG.md."
|
||
status: supported
|
||
evidence:
|
||
- kind: source-file
|
||
sourceId: source.memory
|
||
path: sources/memory.md
|
||
lines: MEMORY.md (workspace), §3, буллет 'Subagent workspace isolation (final state 2026-10-25)', строка 33
|
||
note: 'ingest sources/memory.md 2026-10-27T23:00:45.758Z'
|
||
confidence: 0.95
|
||
updatedAt: 2026-10-28T02:05:00+03:00
|
||
- text: "Полная ревизия AGENTS.md (last documentation review 2026-11-04; файл переписан: 37353 → 46720 bytes, «shared operating model» для пяти-агентной среды): §1.1 main = user-facing coordinator (+ research, task decomposition, integration, reporting); §5.5 main допустим read-only диагностика, исследование и МАЛЫЕ прямые действия по явному запросу пользователя (old blanket ban «main не реализует задачи напрямую» уточнён); §6 новая Delegation Policy — old blanket prohibition на sessions_spawn вне wiki-ingest ЗАМЕНЁН (§6: spawn для легитимных user-requested задач; §6.1 task sizing/batching ~10 tool calls / ~50 items warning threshold; §6.2 делегирование не даёт больше прав, чем дал main); §7/§10 — evaluator review НЕ автоматический для каждой операции: только при risk/complexity/persistence/requirement; §11 — роли агентов = функциональные границы, не иерархия команд; user = final decision-maker; finding evaluator'а не заменяет решение пользователя."
|
||
status: supported
|
||
confidence: 0.95
|
||
evidence:
|
||
- kind: source-file
|
||
sourceId: source.agents
|
||
path: sources/agents.md
|
||
lines: "AGENTS.md (редакция 2026-11-04): §1.1 (строки 15–21), §5.5 (строки 154–163), §6 (строки 173–214), §7 (строки 216–226), §10 (строки 260–271), §11 (строки 273–285)"
|
||
note: "ingest sources/agents.md 2026-11-04T23:00:40.524Z (event evt_wiki-ingest_1793823006888562342_7333fc016ffe3e46ada08571); git diff HEAD sources/agents.md: полная переработка текста (227 insertions / 310 deletions)"
|
||
confidence: 0.95
|
||
updatedAt: 2026-11-05T02:12:00+03:00
|
||
sourceIds:
|
||
- sources/agents.md
|
||
- sources/memory.md
|
||
---
|
||
|
||
# Synthesis: Agent Architecture
|
||
|
||
## Summary
|
||
Архитектура многоагентной системы OpenClaw: main-agent orchestrates, делегирует, собирает результаты. С 2026-08-16 основной моделью по AGENTS.md §2 является `ollama-local/qwen3.8-27b-q5xl`.
|
||
|
||
## Description
|
||
Система построена на принципе разделения ответственности:
|
||
1. Main-agent — маршрутизация и координация (не исполняет задачи)
|
||
2. Специализированные агенты (setup, coder, evaluator, humanizer) — исполнение
|
||
3. Evaluator — верификация результатов (обязательная)
|
||
4. Wiki — структурированная память через Obsidian bridge
|
||
|
||
Primary model (AGENTS.md §2, actualized 2026-08-16):
|
||
- main: `ollama-local/qwen3.8-27b-q5xl`
|
||
- Полную историю смены моделей (qwen3.6-35b-192k → qwen3-coder:30b и др.) хранит MEMORY.md «AI Models».
|
||
|
||
Правила (AGENTS.md §5.5, §7, §8, §10, §11):
|
||
- Никто не может self-certify changes; only evaluator verdict is authoritative
|
||
- Успех делегированной задачи = approval evaluator-agent
|
||
- Максимум 3 repair-цикла (execute → evaluate → repair → re-evaluate)
|
||
- Cron jobs = immutable infrastructure → setup-agent only
|
||
- Wiki ingest event-driven: при изменении источников → automatic setup-agent subagent (§16)
|
||
|
||
## Claims
|
||
- Разделение ролей обеспечивает предсказуемость и воспроизводимость
|
||
- Mandatory evaluator review для infra/code changes
|
||
- Wiki используется как вторичная память, bridge — default
|
||
- Primary model по AGENTS.md §2: `ollama-local/qwen3.8-27b-q5xl` (actualized 2026-08-16)
|
||
|
||
## Tags
|
||
- agent-architecture
|
||
- routing
|
||
- orchestration
|
||
- multi-agent
|
||
|
||
## Sources
|
||
- [[AGENTS.md]]
|
||
- [[MEMORY.md]]
|
||
- Synthesis: Agent Architecture
|
||
- Entity: OpenClaw
|
||
- Entity: Ollama
|
||
|
||
## Related
|
||
<!-- openclaw:wiki:related:start -->
|
||
### Related Pages
|
||
|
||
- [Concept: Bridge Mode](../concepts/Bridge-Mode.md)
|
||
- [Concept: Change Logging & Wiki Ingestion (AGENTS.md §14–§16)](../concepts/Change-Logging.md)
|
||
- [Concept: Mail Pipeline (arno@eurostela.ru)](../concepts/Mail-Pipeline.md)
|
||
- [Concept: Nextcloud Sync Folder (arno.nextcloud)](../concepts/Nextcloud-Sync-Folder.md)
|
||
- [Concept: Routing](../concepts/Routing.md)
|
||
- [Concept: Search Tool Priority](../concepts/Search-Tool-Priority.md)
|
||
- [Concept: VRAM Management](../concepts/VRAM-Management.md)
|
||
- [Entity: Beget (хостинг / IMAP)](../entities/Beget.md)
|
||
- [Entity: Dream Diary (DREAMS.md)](../entities/Dream-Diary.md)
|
||
- [Entity: Ollama](../entities/Ollama.md)
|
||
- [Entity: OpenClaw](../entities/OpenClaw.md)
|
||
- [Hermes Restructure (2026-09-07): Source of Truth → INFRASTRUCTURE.md](hermes-restructure-2026-09-07-source-of-truth-infrastructure-md.md)
|
||
<!-- openclaw:wiki:related:end -->
|