ai-agent-book 精选快照（<2MB 代码与文档，来自 github.com/bojieli/ai-agent-book）

docs/vi/LEARNING.md

@@ -0,0 +1,53 @@
+# Gợi ý học tập
+
+← [Về README chính](README.md)
+
+### Tư tưởng cốt lõi: Agent = mô hình + context + tools
+
+Khung cốt lõi của sách là **Agent = mô hình + context + tools**. Ba thành phần này phối hợp với nhau để hiện thực hành vi thông minh của Agent:
+
+- **Mô hình (Model)**: bộ não của Agent, cung cấp năng lực hiểu, suy luận và ra quyết định
+- **Ngữ cảnh (Context)**: hệ điều hành của Agent, bao gồm chỉ dẫn hệ thống, lịch sử hội thoại, quá trình suy luận, bản ghi tương tác công cụ, v.v.
+- **Công cụ (Tools)**: đôi tay của Agent, giúp Agent cảm nhận môi trường, thực thi thao tác và tương tác với thế giới bên ngoài
+
+### Lộ trình học
+
+Lộ trình học tương ứng một-một với các chương của sách, triển khai từng lớp quanh ba trụ cột lớn:
+
+- **Chương 1 · Phần nền tảng**: xây dựng khung nhận thức hoàn chỉnh về hệ thống Agent — hiểu định nghĩa Agent trong RL, so sánh khác biệt về hiệu quả mẫu giữa RL truyền thống và mô thức LLM+RL, hiểu mô hình mới “model as Agent”, nắm vững khung cốt lõi **Agent = mô hình + context + tools**. **Insight then chốt**: tầm quan trọng của tri thức tiên nghiệm vượt qua thuật toán và môi trường.
+
+- **Chương 2–3 · Phần ngữ cảnh**: ngữ cảnh là hệ điều hành của Agent. Chương 2 bao phủ system prompt, thiết kế thân thiện KV Cache, nén ngữ cảnh và ablation prompt engineering; chương 3 bao phủ bộ nhớ người dùng, truy xuất dày đặc/thưa/lai, Agentic RAG, truy xuất nhận biết ngữ cảnh và trích xuất tri thức có cấu trúc. **Insight then chốt**: ngữ cảnh hoàn chỉnh bao gồm chỉ dẫn hệ thống, lịch sử hội thoại, quá trình suy luận, bản ghi tương tác công cụ, bộ nhớ người dùng và tri thức bên ngoài.
+
+- **Chương 4–5 · Phần công cụ**: công cụ là cây cầu để Agent tương tác với thế giới. Chương 4 bao phủ ba loại công cụ MCP cảm nhận/thực thi/cộng tác, kích hoạt sự kiện và kiến trúc bất đồng bộ; chương 5 đi sâu vào triển khai đầy đủ Coding Agent cấp sản xuất. **Insight then chốt**: thiết kế công cụ nên tổng quát hóa (code interpreter tốt hơn calculator); mã là siêu năng lực có thể tạo ra công cụ mới.
+
+- **Chương 6–7 · Phần mô hình**: cách đo lường và phóng đại trí tuệ. Chương 6 bao phủ các benchmark đánh giá như Terminal-Bench, SWE-bench, GAIA, OSWorld, Tau2-Bench; chương 7 bao phủ các kỹ thuật hậu huấn luyện như SFT, RL, RLHF và hiệu quả mẫu. **Insight then chốt**: tín hiệu xác minh độc lập đáng tin cậy hơn “để mô hình nghĩ lại một lần”; “model as Agent” dùng RL để nội hóa gọi công cụ thành năng lực nguyên sinh.
+
+- **Chương 8 · Phần tự tiến hóa**: giúp Agent trưởng thành từ kinh nghiệm mà không cần đổi trọng số — học từ kinh nghiệm, ngoại hóa workflow thành công cụ, chưng cất prompt và quan sát vào tham số. **Insight then chốt**: học từ kinh nghiệm là chìa khóa để Agent đi từ “thông minh” tới “thành thạo”.
+
+- **Chương 9–10 · Phần mở rộng và cộng tác**: chương 9 mở rộng cảm nhận và hành động từ văn bản sang giọng nói, GUI và thế giới vật lý; chương 10 xử lý nhiệm vụ phức tạp thông qua phân công cộng tác đa Agent. **Insight then chốt**: mọi quyết định thiết kế trong hệ thống đa Agent đều có thể tìm thấy đối ứng trong ba yếu tố của đơn Agent.
+
+## Phân công giữa văn bản và thí nghiệm
+
+Cuốn sách không phải hướng dẫn từng bước cho một SDK cụ thể. Pseudocode và skeleton chỉ ra luồng trạng thái, điểm dừng và ranh giới kiểm chứng; thí nghiệm cung cấp triển khai, adapter, test, log và bằng chứng.
+
+| Tầng | Đọc trước | Tạm bỏ qua | Câu hỏi mà nó trả lời |
+| :--: | --- | --- | --- |
+| **Starter** | README dự án: mục tiêu, lệnh tối thiểu và điều kiện nghiệm thu; skeleton tương ứng trong sách | thông tin xác thực, UI, adapter provider và log thô dài | Thí nghiệm này nhằm chứng minh cơ chế nào? |
+| **Builder** | điểm vào, vòng lặp lõi, schema state/message, tool và verifier | các lớp tương thích/triển khai không liên quan đến cơ chế | Biến nào đã làm thay đổi hành vi? |
+| **Maintainer** | test, xử lý lỗi, định dạng bằng chứng, manifest/hash và đường rollback | chi tiết bên thứ ba chỉ cần khi sửa thí nghiệm | Kết quả có tái lập được không và lỗi có được ghi nhận trung thực không? |
+
+### Phân cấp độ khó
+
+- **Nhập môn** (Chương 1–2): phù hợp với người mới bắt đầu, hiểu khái niệm cơ bản
+- **Nâng cao** (Chương 3–4): cần nền tảng lập trình nhất định, liên quan đến tích hợp hệ thống
+- **Cao cấp** (Chương 5–6): cần năng lực lập trình mạnh hơn, liên quan đến thiết kế hệ thống phức tạp
+- **Chuyên gia** (Chương 7–8): cần kinh nghiệm học sâu và huấn luyện/tự tiến hóa
+- **Ứng dụng** (Chương 9–10): tổng hợp kiến thức đã học để xây dựng ứng dụng thực tế
+
+### Gợi ý thực hành
+
+1. **Tự tay thực hành**: mỗi dự án đều được thiết kế để có thể chạy độc lập; khuyến nghị tự chạy và sửa mã
+2. **Kết hợp với sách**: đọc cùng các chương tương ứng trong bản thảo tại [`book/`](../../book/) để hiểu sự kết hợp giữa lý thuyết và thực hành
+3. **So sánh thí nghiệm**: nhiều dự án chứa nghiên cứu ablation và thí nghiệm đối chứng; hãy dùng so sánh để hiểu sâu hơn
+4. **Học tăng dần**: bắt đầu từ dự án đơn giản rồi dần đi sâu vào hệ thống phức tạp
+5. **Chú ý giao thức**: các dự án MCP server ở chương 4 minh họa giao thức công cụ chuẩn hóa, đây là chìa khóa để xây dựng Agent có thể mở rộng

docs/vi/README.md

@@ -0,0 +1,196 @@
+# Hiểu sâu về AI Agent: Nguyên lý thiết kế và thực hành kỹ thuật
+
+[![PDF](https://img.shields.io/badge/PDF-tải%20về-success.svg)](#-sách-điện-tử) [![Đọc trực tuyến](https://img.shields.io/badge/🌐_Đọc_trực_tuyến-bojieli.github.io-success?style=flat-square)](https://bojieli.github.io/ai-agent-book/) [![Stars](https://img.shields.io/github/stars/bojieli/ai-agent-book?style=social)](https://github.com/bojieli/ai-agent-book) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](../../LICENSE) [![Languages](https://img.shields.io/badge/dịch-14%20ngôn%20ngữ-informational.svg)](#-sách-điện-tử)
+[![Trending GitHub Project of the Day](https://img.shields.io/badge/GitHub%20Trending-Project%20of%20the%20Day-orange?logo=github)](https://github.com/trending)
+
+**[中文](../../README.md) · [English](../en/README.md) · [Español](../es/README.md) · [Bahasa Indonesia](../id/README.md) · [العربية](../ar/README.md) · [繁體中文（台灣）](../zh-TW/README.md) · [Русский](../ru/README.md) · Tiếng Việt ← hiện tại · [தமிழ்](../ta/README.md) · [日本語](../ja/README.md) · [Türkçe](../tr/README.md) · [한국어](../ko/README.md) · [Magyar](../hu/README.md) · [עברית](../../README.he.md)**
+
+> 📥 **[Tải PDF / EPUB](#-sách-điện-tử)** (khuyên dùng) — nên đọc sách qua bản PDF / EPUB để có trải nghiệm tốt nhất; bạn cũng có thể [đọc trực tuyến](https://bojieli.github.io/ai-agent-book/) (chuyển đổi ngôn ngữ, mục lục đóng/mở được, tìm kiếm toàn văn; tự động xây dựng lại sau mỗi lần đẩy lên main).
+
+**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à **93 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.
+
+> 📢 **Những thay đổi trong bản 2.0 (so với 1.4):** Bản 2.0 hợp nhất phần “tương tác bất đồng bộ” của Chương 4 cũ với nội dung về “Agent đa phương thức” của Chương 9 cũ, rồi tái cấu trúc thành Chương 6 mới, “Tương tác: mở rộng không gian quan sát và không gian hành động”. Các Chương 6 (“Đánh giá Agent”), 7 (“Post-training mô hình”) và 8 (“Sự tiến hóa liên tục của Agent”) trước đây đều lùi lại một chương, nay lần lượt là Chương 7, 8 và 9.
+>
+> Nếu bạn đang đọc một bản PDF cũ, chúng tôi khuyên bạn [tải PDF mới nhất](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-vi.pdf). Ấn bản mới còn có nhiều nội dung được sửa chữa và điều chỉnh; vui lòng sử dụng phiên bản mới nhất.
+
+| 📚 **10 chương** nội dung, từ nền tảng đến sản xuất | 📂 **93** dự án đi kèm (70+ chạy độc lập) | 🌐 **14 ngôn ngữ**: Trung / Anh / Tây Ban Nha / Indonesia / Ả Rập / 繁體中文（台灣） / Nga / Tamil / Việt / Nhật / Thổ Nhĩ Kỳ / Hàn / Hungary / Do Thái |
+| :---: | :---: | :---: |
+
+## 📖 Sách điện tử
+
+> 📥 **Tải xuống PDF / EPUB** (khuyên dùng; 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](https://github.com/bojieli/ai-agent-book/releases):
+> - **Bản gốc tiếng Trung**：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-CN.epub)
+> - **Tiếng Anh**（dịch cộng đồng, by [@nsdevaraj](https://github.com/nsdevaraj)、[@whanyu1212](https://github.com/whanyu1212)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-en.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-en.epub)
+> - **Tiếng Tây Ban Nha**（dịch cộng đồng, by [@santhreal](https://github.com/santhreal)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-es.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-es.epub)
+> - **Tiếng Ả Rập**（dịch cộng đồng, by [@TheSyBuilder](https://github.com/TheSyBuilder)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ar.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ar.epub)
+> - **Trung phồn thể (Đài Loan)**（dịch cộng đồng, by [@tigercosmos](https://github.com/tigercosmos)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-TW.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-zh-TW.epub)
+> - **Tiếng Nga**（dịch cộng đồng, by [@ui99ru](https://github.com/ui99ru)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ru.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ru.epub)
+> - **Tiếng Tamil**（dịch cộng đồng, by [@nsdevaraj](https://github.com/nsdevaraj)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ta.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ta.epub)
+> - **Tiếng Việt**（dịch cộng đồng, by [@toanalien](https://github.com/toanalien)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-vi.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-vi.epub)
+> - **Tiếng Nhật**（dịch cộng đồng, by [@eltociear](https://github.com/eltociear)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ja.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ja.epub)
+> - **Tiếng Thổ Nhĩ Kỳ**（dịch cộng đồng, by [@memisemre](https://github.com/memisemre)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-tr.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-tr.epub)
+> - **Tiếng Hàn**（dịch cộng đồng, by [@JeongJaeSoon](https://github.com/JeongJaeSoon)）：[PDF](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ko.pdf) · [EPUB](https://github.com/bojieli/ai-agent-book/releases/download/latest/AI-Agents-in-Depth-ko.epub)
+>
+> 🌐 Bạn cũng có thể [đọc trực tuyến](https://bojieli.github.io/ai-agent-book/) — chuyển đổi ngôn ngữ, mục lục đóng/mở được, tìm kiếm toàn văn và liên kết trực tiếp đến các thí nghiệm kèm theo. Tự động xây dựng lại sau mỗi lần đẩy lên main.
+
+Mã nguồn tiếng Trung nằm trong [`book/`](../../book/); các bản Anh/Tây Ban Nha/Ả Rập/Trung phồn thể (Đài Loan)/Nga/Tamil/Việt/Nhật/Thổ Nhĩ Kỳ/Hàn là đóng góp cộng đồng (có thể chậm hơn bản gốc), nằm trong [`book-en/`](../../book-en/), [`book-es/`](../../book-es/), [`book-ar/`](../../book-ar/), [`book-zhtw/`](../../book-zhtw/), [`book-ru/`](../../book-ru/), [`book-ta/`](../../book-ta/), [`book-vi/`](../../book-vi/), [`book-ja/`](../../book-ja/), [`book-tr/`](../../book-tr/), [`book-ko/`](../../book-ko/).
+
+<details>
+<summary><b>🔧 Tự build PDF / EPUB?</b> (PDF cần pandoc / xelatex / ElegantBook)</summary>
+
+- **EPUB**: Sử dụng trình dựng chung; xem [hướng dẫn dựng EPUB](../../EPUB.md)
+- **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
+
+  ```bash
+  cd book && bash build_pdf.sh
+  ```
+
+  Hình vẽ được lưu dưới dạng SVG trong `book/images/` và được bản dựng sử dụng trực tiếp; chi tiết typography xem `book/preamble.tex` và `book/*.lua`.
+
+</details>
+
+## 📑 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** | **Agent = LLM + Context + Tools**; kỹ thuật Harness mới là lợi thế cạnh tranh thực sự | [Đọc](../../book-vi/chapter1.vi.md) | [4](../../chapter1/README.vi.md) |
+| 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](../../book-vi/chapter2.vi.md) | [9](../../chapter2/README.vi.md) |
+| 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](../../book-vi/chapter3.vi.md) | [12](../../chapter3/README.vi.md) |
+| 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](../../book-vi/chapter4.vi.md) | [8](../../chapter4/README.vi.md) |
+| 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](../../book-vi/chapter5.vi.md) | [13](../../chapter5/README.vi.md) |
+| 6 | 🎙️ **Tương tác: mở rộng không gian quan sát và không gian hành động** | Mở rộng không gian quan sát và hành động của Agent theo phương thức và thời gian: hệ thống bất đồng bộ và hướng sự kiện, giọng nói, Computer Use và robot | [Đọc](../../book-vi/chapter6.vi.md) | [13](../../chapter6/README.vi.md) |
+| 7 | 🎯 **Đánh giá Agent** | Biến hiệu suất thành tín hiệu có thể so sánh: môi trường, chỉ số, ý nghĩa thống kê và lựa chọn dựa trên đánh giá | [Đọc](../../book-vi/chapter7.vi.md) | [13](../../chapter7/README.vi.md) |
+| 8 | 🧠 **Post-training mô hình** | Ba giai đoạn—tiền huấn luyện, SFT và RL: khi nào chọn SFT hay RL, nội tại hóa lời gọi công cụ và hiệu quả mẫu | [Đọc](../../book-vi/chapter8.vi.md) | [19](../../chapter8/README.vi.md) |
+| 9 | 🔄 **Sự tiến hóa liên tục của Agent** | Lấy tín hiệu học tập từ quỹ đạo thực thi và cập nhật kiến thức, chỉ dẫn, chương trình và tham số | [Đọc](../../book-vi/chapter9.vi.md) | [9](../../chapter9/README.vi.md) |
+| 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](../../book-vi/chapter10.vi.md) | [7](../../chapter10/README.vi.md) |
+
+
+> 💡 **Đọ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](LEARNING.md)** (ý tưởng cốt lõi, lộ trình, phân cấp độ khó, mẹo thực hành).
+
+## 💻 Chạy các thí nghiệm đi kèm
+
+Phạm vi hỗ trợ chung là **Python 3.11–3.13**. Hãy cài phụ thuộc theo chương từ thư mục gốc của kho; thay `ch1` bằng `ch2` đến `ch10` cho chương khác:
+
+```bash
+# Khuyên dùng: sử dụng uv.lock đã commit để có môi trường chương tái lập được
+uv sync --locked --extra ch1
+
+# Không dùng uv: phân giải lại từ pyproject.toml bằng pip
+python -m pip install -e ".[ch1]"
+```
+
+Trước khi chạy thí nghiệm có gọi mô hình, hãy cấu hình khóa theo README của thí nghiệm đó. Các thí nghiệm hỗ trợ cấu hình ở thư mục gốc có thể sao chép `.env.example` thành `.env` và điền ít nhất một khóa provider; một số thí nghiệm yêu cầu `.env` đặt cạnh mã hoặc biến môi trường được export. Chỉ dùng Ollama cục bộ với `--provider ollama` khi README hoặc CLI của thí nghiệm đó liệt kê rõ provider này.
+
+Sau khi cài, chạy thí nghiệm từ thư mục gốc, ví dụ:
+
+```bash
+uv run python chapter1/context/main.py
+# Sau khi cài bằng pip: python chapter1/context/main.py
+```
+
+- Xem [hướng dẫn cài uv](https://docs.astral.sh/uv/getting-started/installation/). `pip` vẫn được hỗ trợ nhưng sẽ phân giải mới thay vì dùng lockfile.
+- Các tệp `requirements.txt` của từng thí nghiệm vẫn được hỗ trợ trong giai đoạn chuyển đổi, nhất là với dự án độc lập hoặc ràng buộc phiên bản đặc biệt.
+- `all` là tập rộng, thân thiện với CPU, không phải toàn bộ thí nghiệm. `uv sync` đồng bộ chính xác lựa chọn hiện tại mỗi lần chạy, vì vậy hãy gộp extra đặc biệt trong cùng một lệnh, ví dụ `uv sync --locked --extra ch2 --extra vllm` hoặc `uv sync --locked --extra ch7 --extra unsloth`; lệnh pip tương ứng là `python -m pip install -e ".[ch2,vllm]"`.
+- Làm theo README của từng thí nghiệm đối với phụ thuộc hệ thống như trình duyệt, CUDA, FFmpeg, Ollama, trình duyệt Playwright và kho ngoài. Một số thành phần bên thứ ba được đưa vào Chương 8 cần Python 3.12+.
+
+## 🔑 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](https://01.me/2025/07/llm-api-setup/) để chọn mô hình.
+
+| Nền tảng | Link | Đặc điểm | Điểm truy cập |
+| --- | --- | --- | --- |
+| **Kimi** (Moonshot) | <https://platform.moonshot.cn/> | Kimi series, ngữ cảnh dài và khả năng Agent mạnh | Trung Quốc đại lục |
+| **Zhipu GLM** | <https://open.bigmodel.cn/> | GLM-4.6, tiếng Trung mạnh, hiệu năng/ch giá tốt | Trung Quốc đại lục |
+| **Siliconflow** | <https://siliconflow.cn/> | Các mô hình mở (DeepSeek, Qwen, v.v.), truy cập nhanh từ Trung Quốc đại lục | Trung Quốc đại lục |
+| **DeepSeek** | <https://platform.deepseek.com/> | API chính thức của DeepSeek | Toàn cầu + Trung Quốc đại lục |
+| **Krill AI** | [www.krill-ai.net](https://www.krill-ai.net/register?invite=Q8D3L35725) | Truy cập một điểm đến các mô hình chính toàn cầu và nội địa Trung Quốc (OpenAI, Claude, Gemini, Grok, Kimi, GLM, DeepSeek, Qwen, Minimax) | Toàn cầu + Trung Quốc đại lục |
+| **OpenRouter** | <https://openrouter.ai/> | Truy cập một điểm đến các mô hình chính toàn cầu và nội địa Trung Quốc (GPT, Claude, Gemini, Kimi, GLM, DeepSeek, Qwen, v.v.) | Toàn cầu |
+
+## 💎 Nhà tài trợ
+
+Cảm ơn **Krill AI** đã tài trợ dự án này! Krill cung cấp dịch vụ trung chuyển API chính thức, ổn định và cực nhanh cho GPT / Claude / Gemini và nhiều mô hình Trung Quốc, hỗ trợ tùy chỉnh cấp doanh nghiệp, xuất hóa đơn, hỗ trợ kỹ thuật riêng 7×16h, cùng kết nối WebSocket được tối ưu độc quyền cho tốc độ token đầu tiên cực nhanh.
+
+Krill dành ưu đãi đặc biệt cho độc giả của sách: đăng ký qua [liên kết này](https://www.krill-ai.net/register?invite=Q8D3L35725) và nhập mã khuyến mãi "ai-agent-book" khi nạp tiền để được giảm 23% cho lần mua gói Codex đầu tiên!
+
+> 🧪 Trạng thái thực thi, bằng chứng và các tiêu chí nghiệm thu chưa đạt của thí nghiệm được theo dõi riêng tại [`EXPERIMENT_STATUS.md`](../EXPERIMENT_STATUS.md); việc clone hoặc cài đặt mã nguồn không chứng minh thí nghiệm đã hoàn thành.
+
+## 📦 Phụ lục · Lấy kho ngoài
+
+23 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
+
+<details>
+<summary><b>🔧 Mở rộng lệnh clone</b> (23 kho ngoài)</summary>
+
+```bash
+# 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/bojieli/SandboxFusion.git chapter7/SandboxFusion && git -C chapter7/SandboxFusion fetch origin 4a0d573ebd64c98234c190a9d1d49e4276199a0c && git -C chapter7/SandboxFusion checkout --detach 4a0d573ebd64c98234c190a9d1d49e4276199a0c && test "$(git -C chapter7/SandboxFusion rev-parse HEAD)" = "4a0d573ebd64c98234c190a9d1d49e4276199a0c"  # Exp 7-15 code sandbox
+git clone https://github.com/thinking-machines-lab/tinker-cookbook.git chapter7/tinker-cookbook
+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
+git clone https://github.com/Vector-Wangel/XLeRobot.git chapter9/XLeRobot && git -C chapter9/XLeRobot fetch origin 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && git -C chapter9/XLeRobot checkout --detach 3d14695e40c9c68229c0aacffca6053c75cd3eb6 && test "$(git -C chapter9/XLeRobot rev-parse HEAD)" = "3d14695e40c9c68229c0aacffca6053c75cd3eb6"  # Exp 9-7/9-9 shared
+git clone https://github.com/Grigorij-Dudnik/RoboCrew.git chapter9/RoboCrew && git -C chapter9/RoboCrew fetch origin c749148f29bd14e61347f9fc3530c343fff0d994 && git -C chapter9/RoboCrew checkout --detach c749148f29bd14e61347f9fc3530c343fff0d994 && test "$(git -C chapter9/RoboCrew rev-parse HEAD)" = "c749148f29bd14e61347f9fc3530c343fff0d994"  # Exp 9-8/9-9; RoboCrew v0.3.1
+git clone https://github.com/StoneT2000/lerobot-sim2real.git chapter9/lerobot-sim2real && git -C chapter9/lerobot-sim2real fetch origin 87d6c1d969f6e0ca4dc5697940804e231118a63a && git -C chapter9/lerobot-sim2real checkout --detach 87d6c1d969f6e0ca4dc5697940804e231118a63a && test "$(git -C chapter9/lerobot-sim2real rev-parse HEAD)" = "87d6c1d969f6e0ca4dc5697940804e231118a63a"  # Exp 9-11
+
+# 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-5 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](https://github.com/19PINE-AI/TalkAct) độc lập; kho này không đóng gói thư mục đó, hãy dùng lệnh clone ở trên để lấy về.
+
+</details>
+
+## 🤝 Đó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ẽ** | Cải tiến trực tiếp các biểu đồ SVG đã được lưu trong `book/images/` |
+| 🌐 **Bản dịch ngôn ngữ mới** | Hoan nghênh dịch sang nhiều ngôn ngữ; xem tiếng Anh (`book-en/`), Ả Rập (`book-ar/`), Trung phồn thể/Đài Loan (`book-zhtw/`), Tamil (`book-ta/`), Việt (`book-vi/`), Nhật (`book-ja/`), Thổ Nhĩ Kỳ (`book-tr/`) và Hàn (`book-ko/`) |
+
+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](../../LICENSE). Xem tệp [`LICENSE`](../../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
+
+<a href="https://star-history.com/#bojieli/ai-agent-book&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="../../assets/star-history-dark.png" />
+    <source media="(prefers-color-scheme: light)" srcset="../../assets/star-history-light.png" />
+    <img alt="Star History Chart" src="../../assets/star-history-light.png" width="100%" />
+  </picture>
+</a>
+
+<sub>Được tạo bởi [`scripts/gen_star_history.py`](../../scripts/gen_star_history.py), cập nhật hàng ngày bởi [GitHub Actions](../../.github/workflows/star-history.yml) · Nhấp vào hình để xem dữ liệu trực tiếp</sub>