ClassyGitShadowzzh

README.md

README.md

Hiểu sâu về AI Agent: Nguyên lý thiết kế và thực hành kỹ thuật

Stars License PDF Languages

中文 · 中文繁體 · English · Tiếng Việt ← hiện tại · தமிழ்

Agent = LLM + Context + Tools — Cuốn sách xây dựng trên công thức cốt lõi này qua 10 chương, đưa AI Agent từ nguyên lý đến thực hành kỹ thuật. Toàn bộ nội dung, hình minh họa và 88 thí nghiệm đi kèm đều là mã nguồn mở. Hoan nghênh bạn tự chạy các thí nghiệm.

📚 10 chương nội dung, từ nền tảng đến sản xuất 📂 88 dự án đi kèm (70+ chạy độc lập) 🌐 5 ngôn ngữ: Trung / 中文繁體 / Anh / Tamil / Việt

📖 Sách điện tử

📥 Tải xuống PDF / EPUB (toàn bộ nội dung, mã nguồn mở miễn phí). Các liên kết này luôn trỏ tới bản dựng mới nhất của nhánh main; bản cố định xem tại Releases:

Mã nguồn tiếng Trung nằm trong book/; các bản Trung phồn thể (Đài Loan)/Anh/Tamil/Việt là đóng góp cộng đồng (có thể chậm hơn bản gốc), nằm trong book-zhtw/, book-en/, book-ta/, book-vi/.

Trình dựng chung tạo sách EPUB 3 cho tiếng Trung giản thể, tiếng Trung phồn thể (Đài Loan), tiếng Anh, tiếng Tamil và tiếng Việt. Xem hướng dẫn dựng EPUB.

🔧 Tự build PDF? (cần pandoc / xelatex / ElegantBook)
  • Mã nguồn: book/introduction.md (mở đầu), book/chapter1.md ~ book/chapter10.md (Chương 1–10), book/afterword.md (bạt từ)

  • Build: Cài pandoc, xelatex, ElegantBook và font cần thiết, rồi chạy

    cd book && bash build_pdf.sh

    Hình vẽ do book/gen_*_figs.py tạo, lưu trong book/images/; chi tiết typography xem book/preamble.tex và book/*.lua.

📑 Tổng quan nội dung (Chương 1–10)

Sách xoay quanh công thức cốt lõi Agent = LLM + Context + Tools, mười chương tuần tự nâng dần:

Ch Chủ đề Tóm tắt một câu Văn bản Mã
1 🚀 Kiến thức nền tảng về Agent Mô hình "Model as Agent" + Agent = LLM + Context + Tools; kỹ thuật Harness mới là lợi thế cạnh tranh thực sự Đọc 4
2 🎯 Kỹ thuật ngữ cảnh Ngữ cảnh quyết định trần năng lực: KV Cache, prompt engineering, Agent Skills, nén ngữ cảnh Đọc 9
3 📚 Bộ nhớ người dùng và kho tri thức Ghi nhớ người dùng qua phiên + tri thức ngoài: bộ nhớ người dùng, RAG, chỉ mục cấu trúc, đồ thị tri thức Đọc 13
4 🛠️ Công cụ Công cụ là đôi tay Agent: giao thức MCP, cảm nhận/thực thi/cộng tác, Agent bất đồng bộ hướng sự kiện, khám phá công cụ tích cực Đọc 7
5 💻 Coding Agent và sinh mã Mã là "công cụ tạo ra công cụ mới"; Coding Agent cấp sản xuất đầy đủ Đọc 12
6 🎯 Đánh giá Agent Biến biểu hiện thành tín hiệu so sánh được: môi trường, chỉ số, ý nghĩa thống kê, chọn mô hình dựa trên đánh giá Đọc 10
7 🧠 Hậu huấn luyện mô hình Tiền huấn luyện/SFT/RL ba giai đoạn: khi nào SFT, khi nào RL, nội tại hóa gọi công cụ, hiệu quả mẫu Đọc 14
8 🔄 Tự tiến hóa của Agent Trưởng thành không cần sửa trọng số: học từ kinh nghiệm, từ người dùng thành người tạo Đọc 6
9 🎙️ Đa phương thức và tương tác thời gian thực Mở rộng từ văn bản sang giọng nói, GUI, thế giới vật lý: ba mô thức giọng nói, Computer Use, robot Đọc 7
10 🤝 Cộng tác đa Agent Trí tuệ tập thể cao hơn cá thể: khung cộng tác, chia sẻ/cô lập ngữ cảnh, "xã hội Agent" nổi lên Đọc 6

💡 Đọc = đọc nội dung chương trên GitHub (markdown); N = số dự án đi kèm, nhấp để xem code. Phân loại (✅ Chạy độc lập / 📖 Tái hiện / 🚧 Thiết kế) xem README từng chương.

📚 Cách đọc sách hiệu quả? Xem Gợi ý học tập (ý tưởng cốt lõi, lộ trình, phân cấp độ khó, mẹo thực hành).

🔑 API Key

Nên đăng ký API key từ vài nền tảng để thuận tiện học tập. Tham khảo hướng dẫn này để chọn mô hình.

Nền tảng Link Đặc điểm
Kimi (Moonshot) https://platform.moonshot.cn/ Kimi series, ngữ cảnh dài và khả năng Agent mạnh
Zhipu GLM https://open.bigmodel.cn/ GLM-4.6, tiếng Trung mạnh, hiệu năng/ch giá tốt
Siliconflow https://siliconflow.cn/ Các mô hình mở (DeepSeek, Qwen, v.v.)
Volcano Engine https://www.volcengine.com/product/ark ByteDance Doubao (closed-source), độ trễ thấp trong nước
OpenRouter https://openrouter.ai/ Truy cập Gemini / Claude / GPT-5 v.v. (API chính thức cần IP/phương thức thanh toán ngoài; OpenAI còn cần xác thực danh tính ngoài)

📦 Phụ lục · Lấy kho ngoài

20 kho ngoài cho benchmark, framework huấn luyện, nền tảng robot ở Chương 6, 7, 9, 10 không được đóng gói (do kích thước và bản quyền), cần tự clone vào thư mục tương ứng.

Script clone một lần

🔧 Mở rộng lệnh clone (20 kho ngoài)
# Chương 6 · Benchmark đánh giá
git clone https://github.com/google-research/android_world.git         chapter6/android_world
git clone https://huggingface.co/datasets/gaia-benchmark/GAIA          chapter6/GAIA
git clone https://github.com/xlang-ai/OSWorld.git                      chapter6/OSWorld
git clone https://github.com/SWE-bench/SWE-bench.git                   chapter6/SWE-bench
git clone https://github.com/sierra-research/tau2-bench.git            chapter6/tau2-bench
git clone https://github.com/laude-institute/terminal-bench.git        chapter6/terminal-bench

# Chương 7 · Framework huấn luyện (bojieli/* là fork phù hợp với sách)
git clone https://github.com/bojieli/minimind.git                      chapter7/MiniMind-pretrain/minimind      # Exp 7-3 train LLM from scratch
git clone https://github.com/bojieli/minimind-v.git                    chapter7/MiniMind-pretrain/minimind-v    # Exp 7-4 train VLM (projection layer)
git clone https://github.com/bojieli/AdaptThink.git                    chapter7/AdaptThink-original
git clone https://github.com/bojieli/AWorld.git                        chapter7/AWorld
git clone https://github.com/bojieli/SFTvsRL.git                       chapter7/SFTvsRL
git clone https://github.com/bojieli/verl.git                          chapter7/verl
git clone https://github.com/thinking-machines-lab/tinker-cookbook.git chapter7/tinker-cookbook
git clone https://github.com/bojieli/lighteval.git                     chapter7/Intuitor/lighteval
git clone https://github.com/19PINE-AI/rlvp.git                        chapter7/RLVP/rlvp                       # Exp 7-14 RLVP paper code
git clone https://github.com/PRIME-RL/SimpleVLA-RL.git                 chapter7/SimpleVLA-RL/SimpleVLA-RL       # Exp 7-13 vision-language-action RL

# Chương 9 · Tự động hóa trình duyệt & ví dụ Claude
git clone https://github.com/browser-use/browser-use.git               chapter9/browser-use
git clone https://github.com/anthropics/claude-quickstarts.git         chapter9/claude-quickstarts

# Chương 10 · Kiến trúc đa Agent (đã độc lập thành TalkAct) + Stanford AI Town
git clone https://github.com/19PINE-AI/TalkAct.git                     chapter10/use-computer-while-calling
git clone https://github.com/joonspk-research/generative_agents.git    chapter10/generative_agents             # Exp 10-7 Stanford AI Town

Nếu README dự án chỉ định commit cụ thể, hãy git checkout phiên bản đó để đảm bảo tái hiện. Chương 10 use-computer-while-calling đã phát triển thành 19PINE-AI/TalkAct độc lập; kho này chỉ giữ tài liệu trỏ tới.

Các đường dẫn tái hiện khác

Các thí nghiệm dưới đây không có lệnh clone riêng nhưng có phương thức tái hiện cụ thể:

Thí nghiệm Loại Mô tả
6-2 / 6-3 / 6-4 / 6-9 📝 Bài tập bạn đọc Human benchmark, đánh giá bộ nhớ, JSON Cards vs RAG, chọn bộ nhớ — cải tạo từ user-memory / user-memory-evaluation / contextual-retrieval chương 3
5-12 📝 Bài tập bạn đọc Agent tạo Agent — bootstrap từ chapter5/coding-agent
7-8 📝 Bài tập bạn đọc Prompt distillation — xem chapter8/prompt-distillation (dùng lại xuyên chương)
7-9 📝 Bài tập bạn đọc CoT distillation [Mở rộng] — thiết kế và tiêu chí trong sách, không có code riêng
6-11 🤖 Đánh giá mô phỏng OpenVLA + RoboTwin2 — xem README chapter7/SimpleVLA-RL về VLA training/env
9-8 / 9-9 🔧 Phần cứng thật XLeRobot teleoperation và LLM Agent control — cần tay máy SO-100, Teleop · LLM Agent
9-10 🔧 Phần cứng thật RGB zero-shot Sim2Real grasping — StoneT2000/lerobot-sim2real (mô phỏng chạy pure GPU; triển khai cần SO-100)

🤝 Đóng góp

Sách và mã đi kèm hoàn toàn mã nguồn mở. Rất hoan nghênh Pull Request:

Loại Mô tả
📝 Cải tiến nội dung sách Hiệu đính, bổ sung, diễn đạt rõ hơn, hoặc tiến triển mới (nội dung trong book/chapter*.md)
🐛 Cải tiến code & sửa bug Dự án đi kèm mạnh mẽ hơn, dễ dùng hơn, gần sản xuất hơn
🧪 Dự án thực hành mới Bổ sung/thay thế cài đặt tốt hơn cho thí nghiệm, hoặc đóng góp ví dụ mới
🎨 Cải tiến hình vẽ Biểu đồ trong book/images/ rõ và đẹp hơn (do book/gen_*_figs.py tạo)
🌐 Bản dịch ngôn ngữ mới Hoan nghênh dịch sang nhiều ngôn ngữ; xem Trung phồn thể/Đài Loan (book-zhtw/), tiếng Anh (book-en/), Tamil (book-ta/), Việt (book-vi/)

Trước khi gửi, hãy chạy thí nghiệm liên quan để xác nhận tái hiện; có thể mở issue thảo luận trước.

📄 Giấy phép

Dự án sử dụng Apache License 2.0. Xem tệp LICENSE. Một số dự án con có thể có thông tin giấy phép riêng; xem dự án con để biết chi tiết.

⭐ Lịch sử Star

Star History Chart

Được tạo bởi scripts/gen_star_history.py, cập nhật hàng ngày bởi GitHub Actions · Nhấp vào hình để xem dữ liệu trực tiếp