Giải phẫu harness my-agent-crew

Giải phẫu harness my-agent-crew An architecture diagram generated by Archify. Người dùng · trình duyệt / Telegram · Architecture component Người dùng trình duyệt / Telegram Web UI · SPA React, SSE · Kênh giao tiếp Web UI SPA React, SSE ActivityHub · runs, steps, SSE · Kênh giao tiếp ActivityHub runs, steps, SSE Telegram · bot của master · Kênh giao tiếp Telegram bot của master Scheduler · cron → job run · Runtime (một tiến trình Python) Scheduler cron → job run Inbound · một cổng vào, 1 conv/ngày · Runtime (một tiến trình Python) Inbound một cổng vào, 1 conv/ngày OpenRouter · ProviderChain + fallback · Architecture component OpenRouter ProviderChain + fallback run_turn · model → tool → model · Runtime (một tiến trình Python) · runtime run_turn model → tool → model runtime ToolRegistry · workspace, shell, delegate · Runtime (một tiến trình Python) › Cổng duyệt tool · gate ToolRegistry workspace, shell, delegate gate agent.yaml + persona · AGENTS.md, SOUL.md · Home ~/.my-agent-crew (tệp trên đĩa) agent.yaml + persona AGENTS.md, SOUL.md Skills + kit · skills/*.md, .agents/ · Home ~/.my-agent-crew (tệp trên đĩa) Skills + kit skills/*.md, .agents/ Trí nhớ · MEMORY.md, memory/, users/ · Home ~/.my-agent-crew (tệp trên đĩa) Trí nhớ MEMORY.md, memory/, users/ agent.sqlite3 · conversations, runs, approvals · Home ~/.my-agent-crew (tệp trên đĩa) agent.sqlite3 conversations, runs, approvals Workspace · thư mục làm việc của agent · Home ~/.my-agent-crew (tệp trên đĩa) Workspace thư mục làm việc của agent chat, duyệt tool nhắn bot POST /messages getUpdates → /inbound tracked(run) SSE /activity/stream run_turn() job đến hạn (source=JOB) messages + tool specs tool_calls persona kỹ năng MEMORY.md ghi run đọc/ghi/shell Kênh giao tiếp Runtime (một tiến trình Python) Home ~/.my-agent-crew (tệp trên đĩa) Cổng duyệt tool Legend Frontend Backend Database Cloud Security Message bus External

Runtime

  • • Một tiến trình Python: FastAPI + vòng lặp agent + scheduler + poller Telegram
  • • Web và Telegram vào qua Inbound; job lịch gọi thẳng run_turn — cùng một vòng lặp
  • • Model là dịch vụ ngoài; harness là phần bao quanh nó

Agent = tệp

  • • agent.yaml: model, tool, giới hạn, lịch
  • • AGENTS.md + SOUL.md: vai trò và giọng, nạp mỗi lượt
  • • MEMORY.md + memory/: điều agent tự ghi lại

Kiểm soát

  • • Tool requires_approval dừng lượt chờ người duyệt, trừ khi autonomous
  • • cost_cap_usd và max_steps chặn lượt chạy quá tay
  • • Mọi lượt là một run có steps xem được trên web