Tài liệu gốc 03 4 phútTiếng Việt + English

docs/en/s00f-code-reading-order.mdXem bản gốc

Ngôn ngữ bài đọc

Bản dịch tiếng Việt

Bản dịch đầy đủ theo đúng cấu trúc tài liệu; code, liên kết và định danh kỹ thuật được giữ nguyên.

s00f: Thứ tự đọc mã

Trang này trả lời một câu hỏi: bạn nên mở thư theo thứ tự nào? .py tập tin dưới agents/?

Nó không dạy về cơ chế (đó là mục đích của các chương chính). Nó chỉ cho bạn biết "mở cái này trước, sau đó mở cái kia", vì vậy bạn có thể xem qua nguồn trong khi đọc tài liệu.

Đơn hàng được đề xuất

Mỗi agents/sNN_*.py ánh xạ tới một chương chính. Đọc tài liệu chương trước, sau đó mở tệp nguồn phù hợp.

Việc triển khai tham chiếu có thể chạy được sẽ xây dựng trực giác nhanh hơn bất kỳ lời giải thích trừu tượng nào.

Giai đoạn 1: Lõi agent đơn (bắt buộc)

Đặt hàng	Tệp nguồn	Chương	Tập trung vào điều gì
1	`s01_agent_loop.py`	`s01-the-agent-loop.md`	cái `messages` danh sách, `run_conversation()` vòng lặp
2	`s02_tool_system.py`	`s02-tool-system.md`	`ToolRegistry`, `@tool` người trang trí
3	`s03_session_store.py`	`s03-session-store.md`	`SessionDB`, Lược đồ SQLite, FTS5
4	`s04_prompt_builder.py`	`s04-prompt-builder.md`	lắp ráp phần trong `build_context_files_prompt()`
5	`s05_context_compression.py`	`s05-context-compression.md`	ngưỡng nén và lời nhắc tóm tắt
6	`s06_error_recovery.py`	`s06-error-recovery.md`	`classify_api_error()`, thử lại, chuyển đổi dự phòng

Sau sáu tệp này, bạn có một agent duy nhất có khả năng nén, ổn định và có khả năng chịu lỗi.

Giai đoạn 2: Lớp thông minh

Đặt hàng	Tệp nguồn	Chương
7	`s07_memory_system.py`	`s07-memory-system.md`
8	`s08_skill_system.py`	`s08-skill-system.md`
9	`s09_permission_system.py`	`s09-permission-system.md`
10	`s10_subagent_delegation.py`	`s10-subagent-delegation.md`
11	`s11_configuration_system.py`	`s11-configuration-system.md`

Giai đoạn 3: Đa nền tảng

Đặt hàng	Tệp nguồn	Chương
12	`s12_gateway_architecture.py`	`s12-gateway-architecture.md`
13	`s13_platform_adapters.py`	`s13-platform-adapters.md`
14	`s14_terminal_backends.py`	`s14-terminal-backends.md`
15	`s15_scheduled_tasks.py`	`s15-scheduled-tasks.md`

Giai đoạn 4: Khả năng nâng cao

Đặt hàng	Tệp nguồn	Chương
16	`s16_mcp.py`	`s16-mcp.md`
17	`s17_browser_automation.py`	`s17-browser-automation.md`
18	`s18_voice_vision.py`	`s18-voice-vision.md`
19	`s19_cli_and_web_interface.py`	`s19-cli-and-web-interface.md`
20	`s20_background_review.py`	`s20-background-review.md`

Giai đoạn 5: Tự tiến hóa

Đặt hàng	Tệp nguồn	Chương
21	`s21_skill_creation_loop.py`	`s21-skill-creation-loop.md`
22	`s22_hook_system.py`	`s22-hook-system.md`
23	`s23_trajectory_and_rl.py`	`s23-trajectory-and-rl.md`
—	(chỉ tài liệu)	`s24-plugin-architecture.md`
24	`s25_skill_evolution.py`	`s25-skill-evolution.md`
25	`s26_evaluation_system.py`	`s26-evaluation-system.md`
26	`s27_optimization_and_deploy.py`	`s27-optimization-and-deploy.md`

Lưu ý: s24 hiện chỉ gửi kèm theo tài liệu. Tài liệu này độc lập và có thể đọc được.

Nhịp điệu cho mỗi tập tin

Khi bạn mở một sNN_*.py, đi qua nó như thế này:

Đọc chuỗi tài liệu trên cùng và if __name__ == "__main__": — biết nó làm gì và chạy nó như thế nào.
Nối nó với phần "triển khai tối thiểu" trong tài liệu chương — tìm các đoạn trích từ tài liệu trong nguồn thực tế.
Thực sự chạy nó — python agents/sNN_*.py và quan sát đầu ra.
Thay đổi điều gì đó nhỏ — thêm công cụ của riêng bạn, điều chỉnh lời nhắc, thay đổi ngưỡng và xem những thay đổi nào.

Điều quan trọng hơn là "đọc tất cả nguồn trong một lần": mỗi chương để lại cho bạn một phiên bản tối thiểu do chính bạn chạy và tự mình chỉnh sửa.

Khi nào bạn có thể bỏ qua phía trước

Nếu bạn đã xây dựng các hệ thống tương tự trước đây thì các đường dẫn bỏ qua này sẽ an toàn:

Chỉ có ba điều cốt lõi: s01 → s02 → s03
Chỉ là "đa nền tảng hoạt động như thế nào": sau s01, nhảy tới s12 → s13
Chỉ là "agent tự tiến hóa như thế nào": sau s01 → s08, nhảy tới s21 → s27

Nếu không, hãy đọc theo thứ tự. Sự phụ thuộc giữa các chương là có thật - các chương sau sử dụng cấu trúc dữ liệu mà các chương trước xác định.