Phiên bản: 0.20.0 · Cập nhật: 2026-10-14
my-agent-crew là một agent harness nhỏ chạy trên máy cá nhân: nhiều agent, mỗi agent là một thư mục tệp, một vòng lặp chung có cổng duyệt tool, trí nhớ trên đĩa, web UI và Telegram. Bộ tài liệu này viết cho người chưa từng xây harness, minh hoạ bằng một bộ cài thật.
| # | Tài liệu | Đọc khi |
|---|---|---|
| 1 | Kiến trúc hệ thống | muốn hiểu harness gồm gì, mỗi phần làm gì, khớp nhau ra sao (5 sơ đồ động) |
| 2 | Tổng quan sản phẩm | muốn biết vì sao nó tồn tại và nó cam kết gì |
| 3 | Cài đặt và vận hành | muốn cài, chạy thường trực, thêm agent, publish doc |
| 4 | Bản đồ mã nguồn | sắp mở code, cần định hướng theo gói và bảng API (không phải bản đồ từng tệp) |
| 5 | Chuẩn viết code | sắp commit |
| — | Thiết kế · Agent · Tool · Trí nhớ · Kênh · Canvas · Kiểm thử | tham chiếu sâu từng mảng |
| — | Nhật ký thay đổi | muốn biết bản này khác bản trước ở đâu |
Sơ đồ chạy ngay trong trang — bấm tên view trên thanh để xem từng lớp:
Bốn sơ đồ còn lại nằm trong Kiến trúc hệ thống, cũng nhúng động:
| Sơ đồ | Câu hỏi nó trả lời | Xem riêng |
|---|---|---|
| Giải phẫu harness | có những khối nào, ở đâu | HTML · SVG |
| Một lượt qua Telegram | tin nhắn đi qua đâu, theo thứ tự nào | HTML · SVG |
| Master giao việc | ai làm gì, cô lập ở đâu | HTML · SVG |
| Vòng đời duyệt tool | khi nào dừng, ai quyết, hết hạn thì sao | HTML · SVG |
| Ngữ cảnh và trí nhớ | model biết gì, nhớ bằng gì | HTML · SVG |
Gallery: diagrams/index.html. Spec và cách tái tạo: Sơ đồ harness.
uv sync
MY_AGENT_ROUTES=fake:echo uv run python -m my_agent_crew # thử không tốn tiền
# rồi với model thật:
export OPENROUTER_API_KEY=… && uv run python -m my_agent_crew
Bộ tài liệu này đã publish tại https://docs.phucnt.org/my-agent-crew/ (GitHub Pages, nguồn main / /docs) — sơ đồ chạy ngay trong trang. Trên GitHub hoặc trình đọc markdown, iframe không hiện; dùng link “SVG” trong bảng trên.
Bản .html của sơ đồ là trang tự chứa; chỉ cần phục vụ docs/ như site tĩnh. Nhanh nhất là GitHub Pages với nguồn /docs, hoặc python3 -m http.server 8080 --directory docs trên máy. Chi tiết và các cách khác ở deployment-guide.md §9.
docs/ và chuỗi hiển thị cho người dùng — xem code-standards.md §1.docs/ cố ý chỉ có tiếng Việt (viết cho đội maintain người Việt); chưa quyết có bản tiếng Anh cho người ngoài không.