# Học AI Agents

**"Học AI Agents"** là một hành trình thực tiễn giúp người đọc khám phá và xây dựng các ứng dụng AI Agent thông minh, linh hoạt. Với trọng tâm là các công nghệ hiện đại như **LangChain**, **LangGraph**, và các mô hình ngôn ngữ lớn (LLMs), sách hướng dẫn từng bước để phát triển các agent có khả năng tương tác, ra quyết định và sử dụng công cụ hiệu quả. Bên cạnh lý thuyết súc tích, sách đi kèm nhiều ví dụ thực tế như tạo chatbot, trợ lý cá nhân, hệ thống phân tích tự động. Đặc biệt phù hợp cho developer, data engineer và những ai đang muốn ứng dụng AI vào sản phẩm của mình. Đây là cuốn sách cầu nối giữa tư duy kỹ thuật và sức mạnh của AI hiện đại.  
**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Tìm Hiểu Tiềm Năng Thực Sự Của AI AGENTS

AI Agents đang thay đổi cách chúng ta làm việc, học tập và tương tác với công nghệ. Không chỉ đơn thuần là công cụ tự động hóa, chúng còn có khả năng ra quyết định, thích ứng và cộng tác như một “đồng nghiệp số” thực thụ. Để tận dụng hết tiềm năng này, chúng ta cần hiểu rõ cách AI Agents hoạt động, ứng dụng và tạo ra giá trị thực trong doanh nghiệp và cuộc sống.

# Gen AI và AI Agents

## Gen AI là gì?

**Gen AI** (viết tắt của *Generative Artificial Intelligence*) là một nhánh của trí tuệ nhân tạo tập trung vào việc **tạo ra nội dung mới** thay vì chỉ phân tích hay nhận diện như AI truyền thống.

### Ví dụ về Gen AI:

- Viết văn bản
- Vẽ tranh, tạo ảnh từ mô tả
- Viết code
- Tạo nhạc
- Viết bài thơ, kịch bản, v.v.

### Công nghệ nền tảng:

- **Mô hình ngôn ngữ lớn (Large Language Models – LLMs)** như GPT-4, Gemini, Claude, LLaMA...
- **Diffusion models**: thường dùng trong tạo hình ảnh (Stable Diffusion, Midjourney)

## AI Agents là gì?

**AI Agents** (hay còn gọi là Autonomous Agents) là những hệ thống AI có khả năng **tự chủ động thực hiện các hành động** để đạt được mục tiêu nào đó. Chúng không chỉ phản hồi một câu hỏi đơn giản, mà còn có thể:

- **Tự lên kế hoạch (planning)**
- **Tự thực hiện các bước nhỏ**
- **Tự điều chỉnh hành vi khi gặp lỗi hoặc có dữ liệu mới**

### Ví dụ dễ hiểu:

Bạn nói với AI Agent:  
*“Tìm kiếm thông tin về thị trường ô tô Việt Nam, viết báo cáo, tạo biểu đồ và gửi vào email tôi.”*

Thì AI Agent có thể:

1. Dùng công cụ tìm kiếm → tổng hợp thông tin
2. Phân tích dữ liệu → viết báo cáo
3. Tạo biểu đồ bằng code (Python, Excel, v.v.)
4. Kết nối Gmail → gửi mail

Tất cả các bước **đều tự động**, và **có logic suy nghĩ như một con người làm việc**.

### Một số Framework phổ biến:

- **LangChain**
- **AutoGPT**
- **AgentGPT**
- **CrewAI**

---

## So sánh đơn giản:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-%C4%90%E1%BA%B7c-%C4%91i%E1%BB%83m-gen-ai-ai-a"><table data-end="2095" data-start="1598"><thead data-end="1695" data-start="1598"><tr data-end="1695" data-start="1598"><th data-end="1625" data-start="1598">Đặc điểm</th><th data-end="1659" data-start="1625">Gen AI</th><th data-end="1695" data-start="1659">AI Agent</th></tr></thead><tbody data-end="2095" data-start="1796"><tr data-end="1895" data-start="1796"><td>Mục tiêu chính</td><td>Tạo nội dung</td><td>Hoàn thành nhiệm vụ</td></tr><tr data-end="1995" data-start="1896"><td>Tính chủ động</td><td>Phản hồi theo yêu cầu</td><td>Tự ra quyết định, tự thực hiện</td></tr><tr data-end="2095" data-start="1996"><td>Ví dụ</td><td>ChatGPT viết bài, DALL·E vẽ tranh</td><td>AutoGPT hoàn thành project</td></tr></tbody></table>

</div>Dưới đây là ví dụ cụ thể về **Gen AI** và **AI Agents** được áp dụng trong lĩnh vực **sản xuất** (ví dụ: cơ khí, nhà máy, ERP...):

## Gen AI trong sản xuất:

### Tình huống: Hỗ trợ lập báo cáo sản xuất

Bạn cần viết một **báo cáo năng suất xưởng gia công trong tuần** để gửi cho giám đốc.

### Gen AI làm gì?

Bạn chỉ cần nhập:

> “Tạo báo cáo tổng kết năng suất xưởng A từ dữ liệu sau: số lượng sản phẩm, tỷ lệ lỗi, thời gian vận hành máy...”

→ Gen AI (như ChatGPT) sẽ **viết một báo cáo hoàn chỉnh** với văn phong chuyên nghiệp, có thể thêm biểu đồ hoặc gợi ý cải tiến.

### Tình huống: Đào tạo công nhân mới

Bạn có một nhóm công nhân mới chưa quen quy trình.

#### Gen AI làm gì?

Bạn dùng Gen AI để:

- Tạo tài liệu đào tạo bằng ngôn ngữ dễ hiểu
- Tự động chuyển tài liệu thành video, hình ảnh minh hoạ
- Tạo chatbot nội bộ: “Hỏi gì cũng trả lời về quy trình sản xuất A”

## AI Agents trong sản xuất:

### Tình huống: Quản lý đơn hàng và tồn kho tự động

Bạn muốn tự động hoá việc:

- Theo dõi tồn kho
- Đặt hàng nguyên vật liệu
- Cảnh báo nếu hàng chậm trễ hoặc vượt định mức

### AI Agent làm gì?

1. **Theo dõi hệ thống tồn kho**
2. Nếu thấy sắp hết → tự động gửi đơn đặt hàng cho nhà cung cấp
3. Nếu phát hiện đơn hàng giao chậm → gửi cảnh báo cho phòng mua hàng
4. Nếu vượt mức tiêu hao nguyên vật liệu → gợi ý kiểm tra lỗi quy trình

Bạn chỉ cần thiết lập mục tiêu:

> “Đảm bảo tồn kho nguyên vật liệu tối thiểu 500 đơn vị và không để ngưng sản xuất”

→ Agent sẽ **tự vận hành như một nhân viên giám sát thông minh.**

---

### Tình huống: Kiểm soát chất lượng (QC)

Bạn muốn AI giám sát quy trình QC và đưa ra đánh giá.

#### AI Agent có thể:

- Nhận dữ liệu từ cảm biến, camera, máy đo
- Phân tích dữ liệu theo tiêu chuẩn
- Tự động báo lỗi, cảnh báo nếu chất lượng sản phẩm không đạt
- Gợi ý bước xử lý tiếp theo (ví dụ: cách khắc phục, đổi máy, kiểm tra lô hàng)

---

## Tóm lại:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-t%C3%ACnh-hu%E1%BB%91ng-gen-ai-l%C3%A0"><table data-end="2668" data-start="1946"><thead data-end="2063" data-start="1946"><tr data-end="2063" data-start="1946"><th data-end="1973" data-start="1946">Tình huống</th><th data-end="2015" data-start="1973">Gen AI làm gì</th><th data-end="2063" data-start="2015">AI Agent làm gì</th></tr></thead><tbody data-end="2668" data-start="2184"><tr data-end="2301" data-start="2184"><td>Viết báo cáo QC</td><td>Viết nội dung, định dạng báo cáo</td><td>Lấy dữ liệu, tổng hợp, gửi báo cáo đúng giờ</td></tr><tr data-end="2430" data-start="2302"><td>Đào tạo nhân viên mới</td><td>Tạo tài liệu học, video minh hoạ</td><td>Tùy theo trình độ nhân viên, chọn nội dung học phù hợp</td></tr><tr data-end="2549" data-start="2431"><td>Quản lý đơn hàng</td><td>Viết email, báo cáo mua hàng</td><td>Tự đặt hàng, kiểm tra tiến độ, báo lỗi</td></tr><tr data-end="2668" data-start="2550"><td>Giám sát sản xuất</td><td>Viết cảnh báo nếu có lỗi</td><td>Tự thu thập dữ liệu, phát hiện lỗi, báo cáo</td></tr></tbody></table>

</div>1. **AI Agent kiểm soát tồn kho tự động**
2. **Gen AI tạo báo cáo lỗi sản xuất từ dữ liệu thực tế**

---

## 1. AI Agent kiểm soát tồn kho (Tự động hóa)

### Mục tiêu:

> “Đảm bảo nguyên vật liệu *Thép tấm A* luôn đủ trong kho để sản xuất, không bị gián đoạn.”

### Quy trình hoạt động của Agent:

#### Input:

- Số lượng tồn kho hiện tại (lấy từ hệ thống ERP)
- Dữ liệu tiêu thụ trung bình hàng ngày
- Thời gian giao hàng từ nhà cung cấp (3 ngày)

---

#### Agent thực hiện:

1. **Kiểm tra tồn kho hiện tại**
    
    
    - Ví dụ: còn 120 tấm Thép A
2. **Dự đoán tiêu thụ trong 3 ngày tới**
    
    
    - Dựa vào dữ liệu lịch sử: 30 tấm/ngày → 3 ngày = 90 tấm
3. **So sánh tồn kho và mức an toàn**
    
    
    - Nếu 120 - 90 &lt; 50 → cần đặt hàng
4. **Tự động gửi đơn hàng**
    
    
    - Gửi email/mẫu đơn tới nhà cung cấp
5. **Gửi cảnh báo tới phòng vật tư**
    
    
    - “Dự kiến tồn kho xuống thấp trong 3 ngày. Đã gửi yêu cầu đặt hàng.”

---

#### Agent thực hiện mỗi ngày (cron job hoặc real-time)

---

### Có thể xây bằng gì?

- **LangChain + Python**: kết nối với Excel/ERP
- **Zapier/Make (no-code)** nếu ERP có API
- **Giao diện web mini** để giám sát Agent

---

## 2. Gen AI viết báo cáo lỗi sản xuất

### Mục tiêu:

> Viết báo cáo lỗi sản xuất trong tuần cho xưởng gia công cơ khí.

<table border="1" id="bkmrk--8" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/image.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/image.png)

</td></tr></tbody></table>

Gen AI tạo báo cáo:

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/gNximage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/gNximage.png)

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# AI Agents và Multi-Agents

## AI Agent là gì?

**AI Agent** là một hệ thống trí tuệ nhân tạo **có thể tự hành động để hoàn thành mục tiêu** nào đó. Nó có thể suy nghĩ, lên kế hoạch, ra quyết định và hành động mà **không cần con người can thiệp liên tục.**

### Một AI Agent thường gồm 4 thành phần:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-vai-tr%C3%B2-p"><table data-end="710" data-start="358"><thead data-end="388" data-start="358"><tr data-end="388" data-start="358"><th data-end="377" data-start="358">Thành phần</th><th data-end="388" data-start="377">Vai trò</th></tr></thead><tbody data-end="710" data-start="419"><tr data-end="491" data-start="419"><td>**Perception (Cảm nhận)**</td><td>Nhận dữ liệu từ môi trường hoặc hệ thống</td></tr><tr data-end="559" data-start="492"><td>**Reasoning (Suy luận)**</td><td>Phân tích dữ liệu và đưa ra lựa chọn</td></tr><tr data-end="619" data-start="560"><td>**Planning (Lập kế hoạch)**</td><td>Xác định các bước cần làm</td></tr><tr data-end="710" data-start="620"><td>**Action (Hành động)**</td><td>Thực hiện hành động cụ thể (gửi email, chạy code, gọi API...)</td></tr></tbody></table>

</div>---

### Ví dụ về AI Agent:

> "Tạo Agent kiểm soát tồn kho nguyên vật liệu"

- Nhận dữ liệu từ kho
- Phân tích mức tiêu thụ
- Dự đoán nguy cơ thiếu hụt
- Tự động gửi yêu cầu đặt hàng

---

## Multi-Agent là gì?

**Multi-Agent System (Hệ thống đa tác tử)** là một hệ thống gồm **nhiều AI Agents làm việc cùng nhau**, mỗi agent có vai trò riêng, phối hợp để hoàn thành một nhiệm vụ phức tạp hơn.

---

### So sánh:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-%C2%A0-ai-agent-multi-age"><table data-end="1492" data-start="1135"><thead data-end="1188" data-start="1135"><tr data-end="1188" data-start="1135"><th data-end="1155" data-start="1135"> </th><th data-end="1166" data-start="1155">AI Agent</th><th data-end="1188" data-start="1166">Multi-Agent System</th></tr></thead><tbody data-end="1492" data-start="1244"><tr data-end="1299" data-start="1244"><td>Số lượng Agent</td><td>1</td><td>Nhiều</td></tr><tr data-end="1350" data-start="1300"><td>Mức độ phức tạp</td><td>Thấp đến trung bình</td><td>Cao</td></tr><tr data-end="1421" data-start="1351"><td>Tự vận hành</td><td>Có</td><td>Có, và có phối hợp với agent khác</td></tr><tr data-end="1492" data-start="1422"><td>Ứng dụng</td><td>Tác vụ đơn</td><td>Tác vụ phức tạp cần chia vai trò</td></tr></tbody></table>

</div>---

### Ví dụ thực tế – Hệ thống Multi-Agent trong sản xuất

> **Mục tiêu**: Quản lý toàn bộ quy trình sản xuất từ đơn hàng → sản xuất → QC → giao hàng

### Gồm 4 AI Agents:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-agent-nhi%E1%BB%87m-v%E1%BB%A5-order"><table data-end="1968" data-start="1676"><thead data-end="1708" data-start="1676"><tr data-end="1708" data-start="1676"><th data-end="1696" data-start="1676">Agent</th><th data-end="1708" data-start="1696">Nhiệm vụ</th></tr></thead><tbody data-end="1968" data-start="1742"><tr data-end="1798" data-start="1742"><td>**Order Agent**</td><td>Nhận đơn hàng, lên lịch sản xuất</td></tr><tr data-end="1851" data-start="1799"><td>**Production Agent**</td><td>Giám sát tiến độ sản xuất</td></tr><tr data-end="1909" data-start="1852"><td>**QC Agent**</td><td>Theo dõi lỗi, kiểm tra chất lượng</td></tr><tr data-end="1968" data-start="1910"><td>**Logistics Agent**</td><td>Điều phối giao hàng, lên lịch xe</td></tr></tbody></table>

</div>→ Các Agent này **giao tiếp với nhau**: ví dụ khi Production Agent hoàn thành, nó sẽ báo cho QC Agent kiểm tra.

---

## Một số công cụ hỗ trợ Multi-Agent:

- **CrewAI** – thiết kế nhóm Agent như 1 đội làm việc
- **AutoGen (Microsoft)** – tạo Agent cộng tác với nhau
- **LangGraph (LangChain)** – thiết kế luồng Multi-Agent phức tạp
- **MetaGPT** – mô phỏng nhóm nhân viên (PM, Dev, QA...) làm dự án thật

---

## Tổng kết:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-kh%C3%A1i-ni%E1%BB%87m-ai-agent-m"><table data-end="2983" data-start="2401"><thead data-end="2492" data-start="2401"><tr data-end="2492" data-start="2401"><th data-end="2418" data-start="2401">Khái niệm</th><th data-end="2452" data-start="2418">AI Agent</th><th data-end="2492" data-start="2452">Multi-Agent System</th></tr></thead><tbody data-end="2983" data-start="2586"><tr data-end="2697" data-start="2586"><td>Định nghĩa</td><td>Hệ thống AI tự động xử lý một nhiệm vụ</td><td>Nhiều AI agents phối hợp để xử lý tác vụ phức tạp</td></tr><tr data-end="2790" data-start="2698"><td>Phạm vi</td><td>Tác vụ riêng lẻ</td><td>Dự án/Quy trình lớn</td></tr><tr data-end="2883" data-start="2791"><td>Giao tiếp</td><td>Không cần (hoặc ít)</td><td>Cần giao tiếp giữa các agent</td></tr><tr data-end="2983" data-start="2884"><td>Ứng dụng</td><td>Trả lời câu hỏi, giám sát thiết bị</td><td>Quản lý sản xuất, tài chính, lập kế hoạch</td></tr></tbody></table>

</div>Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# Minh hoạ một hệ thống Multi-Agent trong nhà máy sản xuất cơ khí

## **Mô hình Multi-Agent cho Nhà máy Cơ khí**

### Mục tiêu:

> Tự động hóa quy trình **từ đặt hàng → sản xuất → QC → lưu kho → giao hàng**, với các AI Agents phối hợp như một đội nhân sự.

---

## Các AI Agents và nhiệm vụ

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-t%C3%AAn-agent-vai-tr%C3%B2-ch"><table data-end="963" data-start="380"><thead data-end="420" data-start="380"><tr data-end="420" data-start="380"><th data-end="403" data-start="380">Tên Agent</th><th data-end="420" data-start="403">Vai trò chính</th></tr></thead><tbody data-end="963" data-start="462"><tr data-end="549" data-start="462"><td>🧾 **Order Agent**</td><td>Tiếp nhận đơn hàng, kiểm tra tồn kho, lên lịch sản xuất</td></tr><tr data-end="628" data-start="550"><td>⚙️ **Production Agent**</td><td>Theo dõi tiến độ sản xuất, cập nhật trạng thái</td></tr><tr data-end="712" data-start="629"><td>🔍 **QC Agent**</td><td>Tự động kiểm tra dữ liệu lỗi và đánh giá chất lượng</td></tr><tr data-end="805" data-start="713"><td>📦 **Inventory Agent**</td><td>Kiểm soát kho, đảm bảo tồn kho nguyên vật liệu và thành phẩm</td></tr><tr data-end="876" data-start="806"><td>🚚 **Logistics Agent**</td><td>Lên kế hoạch giao hàng và điều phối xe</td></tr><tr data-end="963" data-start="877"><td>🤝 **Communication Agent** (Tùy chọn)</td><td>Gửi thông báo email, cảnh báo hoặc báo cáo</td></tr></tbody></table>

</div>---

## Mô phỏng quy trình hoạt động

### **Order Agent**

- Nhận đơn hàng từ khách hàng (qua web/app)
- Kiểm tra kho nguyên vật liệu với `Inventory Agent`
- Nếu đủ → chuyển lệnh sản xuất cho `Production Agent`
- Nếu thiếu → gửi yêu cầu mua hàng

---

### **Production Agent**

- Nhận lệnh sản xuất
- Theo dõi từng công đoạn (CNC, hàn, phay…)
- Cập nhật tiến độ
- Khi hoàn tất từng lô → báo `QC Agent`

---

### **QC Agent**

- Nhận thông báo từ sản xuất
- Truy cập dữ liệu cảm biến/máy đo/ghi lỗi
- Phân tích dữ liệu → đánh giá đạt hay không đạt
- Gửi phản hồi:
    
    
    - Nếu đạt: chuyển hàng sang kho
    - Nếu lỗi: tạo báo cáo lỗi và gửi cảnh báo

---

### **Inventory Agent**

- Nhập hàng thành phẩm từ QC
- Cập nhật tồn kho theo lô
- Dự đoán thiếu hụt nguyên liệu và gửi cảnh báo
- Hợp tác với Order Agent để đặt hàng bổ sung

---

### **Logistics Agent**

- Nhận thông tin hàng đã sẵn sàng
- Lên lịch giao hàng
- Tạo lệnh xuất kho
- Gửi thông báo giao hàng cho khách

---

### **Communication Agent** (tuỳ chọn)

- Gửi thông báo qua Email/Zalo/Slack:
    
    
    - “Đơn hàng ABC đã hoàn tất QC, chuẩn bị giao hàng”
    - “Máy CNC-03 gặp lỗi liên tục, cần bảo trì”
    - “Tồn kho Thép SS400 dưới mức an toàn”

#### Sơ đồ hệ thống Multi-Agent (giản lược)

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/IeGimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/IeGimage.png)

## Công nghệ có thể sử dụng để triển khai:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-nhu-c%E1%BA%A7u-g%E1%BB%A3i-%C3%BD-c%C3%B4ng-n"><table data-end="3026" data-start="2477" style="height: 186px; width: 94.2857%;"><thead data-end="2530" data-start="2477"><tr data-end="2530" data-start="2477"><th data-end="2511" data-start="2477" style="width: 49.9369%;">Nhu cầu</th><th data-end="2530" data-start="2511" style="width: 49.9369%;">Gợi ý công nghệ</th></tr></thead><tbody data-end="3026" data-start="2587"><tr data-end="2744" data-start="2587"><td style="width: 49.9369%;">Xây dựng Agents</td><td style="width: 49.9369%;">[LangChain](https://www.langchain.com/), [CrewAI](https://crewai.com/), [AutoGen](https://github.com/microsoft/autogen)</td></tr><tr data-end="2808" data-start="2745"><td style="width: 49.9369%;">Kết nối dữ liệu, API, ERP</td><td style="width: 49.9369%;">Python, FastAPI, REST API</td></tr><tr data-end="2875" data-start="2809"><td style="width: 49.9369%;">Tích hợp với hệ thống sẵn có</td><td style="width: 49.9369%;">VHTerp, Odoo, SAP, SQL Server, Excel</td></tr><tr data-end="2955" data-start="2876"><td style="width: 49.9369%;">Giao tiếp giữa Agents</td><td style="width: 49.9369%;">WebSocket, Message Queue (RabbitMQ, MQTT)</td></tr><tr data-end="3026" data-start="2956"><td style="width: 49.9369%;">Trực quan hóa trạng thái</td><td style="width: 49.9369%;">Streamlit, Dash, React Dashboard</td></tr></tbody></table>

</div>---

## Lợi ích thực tế

Giảm thời gian xử lý thủ công  
Tăng độ chính xác trong lập lịch sản xuất  
Cảnh báo sớm rủi ro (thiếu nguyên vật liệu, lỗi hàng loạt)  
Tự động hoá báo cáo và thông báo  
Giao tiếp giữa các bộ phận hiệu quả, không lệ thuộc con người

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# Thị Trường AI Agents: Cơ Hội, Chi Phí và Xu Hướng Ứng Dụng Trong Doanh Nghiệp

## Cơ hội thị trường (Opportunities)

Thị trường AI Agents đang bùng nổ nhờ:

- **Tăng trưởng AI tổng quát (GenAI)**: ChatGPT, Claude, Gemini đang tạo đà phát triển cho các ứng dụng tự động hoá thông minh.
- **Tối ưu hoá vận hành doanh nghiệp**: AI Agents có thể xử lý các tác vụ như lập kế hoạch sản xuất, chăm sóc khách hàng, kiểm soát chất lượng, phân tích dữ liệu...
- **Giảm chi phí nhân sự và tăng tốc độ ra quyết định**.
- **Mở rộng khả năng cá nhân hoá trong trải nghiệm khách hàng**.

Theo báo cáo của McKinsey, đến năm 2030, AI Agents có thể giúp tăng thêm **13 nghìn tỷ USD cho nền kinh tế toàn cầu**.

---

## Chi phí (Cost)

Chi phí phát triển và triển khai AI Agents phụ thuộc vào nhiều yếu tố:

<div class="overflow-x-auto bg-no-repeat contain-inline-size" id="bkmrk-h%E1%BA%A1ng-m%E1%BB%A5c-chi-ph%C3%AD-%C6%B0%E1%BB%9Bc"><table data-end="1859" data-start="1397"><thead data-end="1452" data-start="1397"><tr data-end="1452" data-start="1397"><th data-end="1422" data-start="1397">Hạng mục</th><th data-end="1441" data-start="1422">Chi phí ước tính</th><th data-end="1452" data-start="1441">Ghi chú</th></tr></thead><tbody data-end="1859" data-start="1508"><tr data-end="1591" data-start="1508"><td>Phát triển nội bộ</td><td>Trung đến cao</td><td>Tốn thời gian, cần đội ngũ kỹ sư AI</td></tr><tr data-end="1683" data-start="1592"><td>Dùng nền tảng có sẵn</td><td>Thấp đến trung bình</td><td>CrewAI, LangChain, AutoGen, AgentOps...</td></tr><tr data-end="1773" data-start="1684"><td>Mô hình AI (LLM)</td><td>Biến động theo API</td><td>Dùng OpenAI, Claude, Mistral, LLaMA...</td></tr><tr data-end="1859" data-start="1774"><td>Bảo trì &amp; tích hợp hệ thống</td><td>Trung bình</td><td>Cần đảm bảo bảo mật, hiệu suất cao</td></tr></tbody></table>

</div>**Tổng quan**, chi phí đang giảm nhờ mã nguồn mở, mô hình mã hoá nhẹ, và nền tảng hỗ trợ no-code/low-code.

---

## Mức độ áp dụng trong doanh nghiệp (Enterprise adoption)

Các doanh nghiệp đang **tích cực thử nghiệm và triển khai AI Agents**, đặc biệt trong các khâu như:

- Tự động hoá email, lịch trình, tạo báo cáo
- Tối ưu chuỗi cung ứng và sản xuất
- Phân tích dữ liệu người dùng, dự đoán hành vi
- Trả lời câu hỏi nội bộ (internal Q&amp;A agents)

🔹 **Công ty đi đầu**: Microsoft, Google, Meta, SAP, ServiceNow, Nvidia, OpenAI  
🔹 **Thị trường SMB (doanh nghiệp vừa và nhỏ)** cũng đang thử nghiệm qua các nền tảng như **Zapier AI Agents**, **LangGraph**, hay **MultiOn**.

---

## Ứng dụng theo ngành

### 1. **Nội dung &amp; Marketing (Content)**

- Tạo nội dung tự động (blog, email, bài quảng cáo)
- Tối ưu SEO, phân tích hành vi khách hàng
- Tương tác tự động với người dùng qua chatbot

Công cụ: Jasper, Copy.ai, Writer, AutoGPT

---

### 2. **Y tế (Healthcare)**

- Trợ lý chẩn đoán ban đầu
- Tổng hợp bệnh án, dữ liệu lâm sàng
- Tư vấn sức khoẻ tự động (phù hợp cho telehealth)

Thí dụ: Agent kiểm tra triệu chứng, tổng hợp dữ liệu bệnh nhân để gửi bác sĩ.

---

### 3. **Công nghệ sinh học (Biotech)**

- Tự động hoá quá trình tìm thuốc
- Sàng lọc dữ liệu thử nghiệm lâm sàng
- Hợp tác giữa các AI Agents mô phỏng phản ứng sinh học

Ví dụ: Agent đề xuất cấu trúc phân tử mới dựa trên dữ liệu protein.

---

### 4. **Dịch vụ tài chính (Financial Services)**

- Phân tích rủi ro đầu tư, đề xuất danh mục
- Phát hiện gian lận giao dịch
- Tạo báo cáo tài chính định kỳ tự động

Ví dụ: Agent đọc và tổng hợp báo cáo lợi nhuận để hỗ trợ phòng tài chính ra quyết định.

---

### 5. **Phát triển phần mềm (Software Development)**

- AI Agent đảm nhiệm vai trò Product Owner, Developer, Tester
- Tạo/tối ưu code, viết tài liệu kỹ thuật
- Quản lý backlog, tracking tiến độ

Ví dụ: Dự án **MetaGPT** mô phỏng cả đội làm sản phẩm: PM, Tech Lead, QA, Dev...

---

## Tương lai của AI Agents

- **Tích hợp sâu với hệ thống doanh nghiệp** (ERP, CRM, Data Warehouse…)
- **Khả năng tự học liên tục**, nhớ ngữ cảnh, hiểu tổ chức
- **Multi-Agent coordination**: nhiều Agent phối hợp như một nhóm người thật
- **Điều chỉnh hành vi theo văn hóa doanh nghiệp**

**Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)**

# Lợi Ích Chính Của AI Agent Trong Doanh Nghiệp Hiện Đại

Trong kỷ nguyên chuyển đổi số, **AI Agent** (tác tử AI) đang trở thành một trong những công cụ mạnh mẽ nhất giúp doanh nghiệp **nâng cao hiệu suất, giảm chi phí và tăng khả năng cạnh tranh**. Với khả năng tự động hoá thông minh, phản ứng linh hoạt và học hỏi liên tục, AI Agent không chỉ là một công cụ – mà là một **trợ lý ảo có tư duy**.

Dưới đây là những **lợi ích chính mà AI Agent mang lại**:

---

## Tự động hoá thông minh

AI Agent có thể đảm nhiệm nhiều công việc phức tạp mà trước đây đòi hỏi con người, ví dụ:

- Xử lý email, phản hồi khách hàng
- Tạo báo cáo, phân tích dữ liệu
- Lên lịch họp, nhắc nhở công việc
- Theo dõi và tối ưu quy trình sản xuất

⏱️ **Kết quả**: Tiết kiệm thời gian, tăng hiệu suất và giảm sai sót.

---

## Ra quyết định nhanh và chính xác

AI Agent được hỗ trợ bởi các mô hình học máy (Machine Learning) và AI tổng quát (Generative AI), giúp:

- Đưa ra quyết định dựa trên dữ liệu thời gian thực
- Phân tích xu hướng, phát hiện bất thường
- Dự báo nhu cầu, rủi ro, hành vi khách hàng

📊 **Kết quả**: Doanh nghiệp đưa ra quyết định **dựa trên dữ liệu** thay vì cảm tính.

---

## Làm việc liên tục 24/7

Không như con người, AI Agent **không cần nghỉ ngơi** và có thể làm việc liên tục mọi thời điểm:

- Phản hồi khách hàng ngoài giờ hành chính
- Giám sát hệ thống, dây chuyền sản xuất cả ban đêm
- Tự động cập nhật dữ liệu định kỳ

🌙 **Kết quả**: Đảm bảo quy trình hoạt động liền mạch, không bị gián đoạn.

---

## Cá nhân hoá trải nghiệm người dùng

AI Agent có thể nhớ và học từ hành vi của từng người dùng để:

- Gợi ý sản phẩm/dịch vụ phù hợp
- Giao tiếp theo phong cách riêng biệt
- Tư vấn tự động trong chăm sóc khách hàng

💬 **Kết quả**: Tăng sự hài lòng, giữ chân khách hàng và tạo ấn tượng chuyên nghiệp.

---

## Giảm chi phí vận hành

Việc thay thế các thao tác thủ công bằng AI Agent giúp:

- Tối ưu nguồn lực nhân sự
- Giảm chi phí vận hành và đào tạo
- Tăng ROI (lợi tức đầu tư) từ hạ tầng số

💰 **Kết quả**: Doanh nghiệp có thể mở rộng quy mô mà không cần tăng tương ứng về nhân sự.

---

## Khả năng học hỏi và thích nghi

AI Agents có thể được huấn luyện và cải tiến liên tục để:

- Hiểu quy trình doanh nghiệp sâu hơn
- Thích ứng với thay đổi chính sách, quy định
- Giao tiếp và hành xử theo văn hoá tổ chức

🧠 **Kết quả**: AI Agent ngày càng "thông minh" hơn và phù hợp hơn với môi trường thực tế.

---

## Phối hợp linh hoạt trong môi trường Multi-Agent

Nhiều AI Agent có thể phối hợp như một đội ngũ chuyên trách, ví dụ:

- Một Agent theo dõi sản xuất → báo QC Agent kiểm tra chất lượng
- Agent phân tích dữ liệu → gọi báo cáo Agent tổng hợp thành báo cáo cuối

**Kết quả**: Xây dựng hệ thống làm việc thông minh, phân quyền rõ ràng và hiệu quả cao.

---

## Kết luận

AI Agent đang trở thành **“cánh tay phải kỹ thuật số”** của mọi tổ chức hiện đại. Dù là trong sản xuất, tài chính, y tế, marketing hay chăm sóc khách hàng, việc áp dụng AI Agent không chỉ giúp doanh nghiệp **đi nhanh hơn**, mà còn **đi đúng hướng** và **bền vững hơn** trong tương lai.

> Bạn đang cân nhắc đưa AI Agent vào doanh nghiệp mình? Hãy bắt đầu từ những tác vụ lặp đi lặp lại, nhiều dữ liệu – và mở rộng dần theo nhu cầu!  
> Gọi ngay cho đội ngũ [VHTSoft(0969661340)](https://vhtsoft.com), chúng tôi sẽ hỗ trợ lập kế hoạch truyển khai mô hình AI cho doanh nghiệp bạn

# Nguyên tắc triển khai AI agent

### 1.  **Cung cấp quyền truy cập nhật ký hệ thống(Provide Access to Logs)**

#### Giới thiệu:

Ghi lại và truy cập nhật ký hoạt động của AI agent giúp theo dõi, kiểm tra và phân tích hành vi của hệ thống trong suốt vòng đời vận hành.

#### Key Practices:

- Ghi nhật ký chi tiết các hành động, phản hồi, và đầu vào của AI.
- Phân loại mức độ nhật ký (debug, info, warning, error).
- Lưu trữ an toàn, bảo mật và có thể truy xuất lịch sử.
- Cung cấp công cụ phân tích nhật ký cho nhà phát triển hoặc quản trị viên.

#### Benefits:

- Giúp phát hiện lỗi và hành vi bất thường.
- Hỗ trợ điều tra sự cố hoặc hành vi sai lệch.
- Tăng cường tính minh bạch và độ tin cậy.
- Cải thiện hệ thống qua việc phân tích hành vi thực tế.

---

### 2. **Khả năng tạm dừng hoặc chấm dứt an toàn(Ability to Pause or Terminate Safely)**

#### Giới thiệu:

Một AI agent nên được thiết kế sao cho có thể được tạm dừng hoặc chấm dứt hoạt động một cách an toàn mà không gây ra hậu quả nghiêm trọng hay mất mát dữ liệu.

#### Key Practices:

- Thiết kế cơ chế “kill switch” (công tắc tắt nhanh).
- Đảm bảo dừng AI không gây rối loạn hệ thống khác.
- Tạo điểm dừng logic hoặc checkpoint cho việc tiếp tục.
- Hạn chế AI tự vô hiệu hóa khả năng bị dừng bởi người.

#### Benefits:

- Ngăn chặn hành vi ngoài kiểm soát.
- Đảm bảo an toàn khi AI hoạt động trong môi trường thực.
- Cho phép can thiệp kịp thời khi có sự cố.
- Tăng cường khả năng kiểm soát bởi con người.

---

### **Giám sát bởi con người(Human Supervision)**

#### Giới thiệu:

Sự can thiệp của con người đảm bảo rằng AI hoạt động đúng mục tiêu và đạo đức, đặc biệt khi xử lý các tình huống phức tạp hoặc có tác động lớn.

#### Key Practices:

- Thiết lập các vai trò giám sát viên AI.
- Tích hợp vòng phản hồi từ người giám sát.
- Giao diện thân thiện để quan sát, đánh giá, và chỉnh sửa hành vi AI.
- Áp dụng human-in-the-loop (con người trong vòng kiểm soát).

#### Benefits:

- Ngăn ngừa hành vi sai lệch hoặc nguy hiểm.
- Đảm bảo AI phù hợp với chuẩn mực xã hội và đạo đức.
- Cải thiện AI nhờ phản hồi của con người.
- Tăng niềm tin và khả năng chấp nhận từ người dùng.

---

### 4. **Kiểm tra có hệ thống các dữ liệu lệch lạc(Systematic Audit for Biases )**

#### Giới thiệu:

AI agent có thể vô tình học và khuếch đại các thiên lệch có trong dữ liệu huấn luyện. Do đó cần có quy trình kiểm tra định kỳ để phát hiện và giảm thiểu dữ liệu lệch lạc.

#### Key Practices:

- Phân tích dữ liệu huấn luyện để phát hiện dữ liệu lệch lạc.
- Thử nghiệm AI với các nhóm người dùng đa dạng.
- Dùng các công cụ kiểm tra công bằng (fairness toolkits).
- Lưu lại kết quả audit để đối chiếu theo thời gian.

#### Benefits:

- Tăng tính công bằng và không phân biệt đối xử.
- Tránh rủi ro pháp lý và tổn hại danh tiếng.
- Cải thiện chất lượng và hiệu quả của AI.
- Tạo ra trải nghiệm tích cực và đáng tin cậy cho người dùng.

---

### 5. **Bảo vệ khỏi truy cập trái phép(Protect Against Unauthorized Access)**

#### Giới thiệu:

AI agent cần được bảo vệ trước các mối đe dọa về an ninh mạng để tránh việc bị khai thác hoặc bị sử dụng vào mục đích xấu.

#### Key Practices:

- Áp dụng cơ chế xác thực mạnh (multi-factor authentication).
- Phân quyền truy cập theo vai trò.
- Mã hóa dữ liệu và giao tiếp.
- Kiểm tra bảo mật định kỳ và vá lỗ hổng kịp thời.

#### Benefits:

- Bảo vệ dữ liệu người dùng và hệ thống.
- Tránh bị lạm dụng hoặc điều khiển bởi tác nhân xấu.
- Đáp ứng các tiêu chuẩn bảo mật (GDPR, ISO/IEC 27001, v.v.).
- Duy trì sự tin tưởng và an toàn của hệ thống.

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# Các trường hợp ứng dụng của AI Agent trong đời sống

### 1. **Dịch vụ tài chính(Financial Services)**

**Giới thiệu:**  
AI agents đang thay đổi cách ngành tài chính hoạt động thông qua việc tự động hóa quy trình, phân tích rủi ro, và cá nhân hóa trải nghiệm khách hàng.

**Ứng dụng:**

- Phân tích tín dụng và rủi ro đầu tư
- Phát hiện gian lận giao dịch theo thời gian thực
- Tư vấn tài chính cá nhân (AI financial advisors)
- Tự động hóa giao dịch chứng khoán (AI trading bots)

---

### 2. **Phần mềm(Software )**

 **Giới thiệu:**  
AI agents hỗ trợ tăng tốc quá trình phát triển phần mềm và cải thiện hiệu suất bảo trì, kiểm thử và triển khai hệ thống.

**Ứng dụng:**

- Sinh mã tự động (code generation)
- Hỗ trợ kiểm thử phần mềm (test case generation)
- Phân tích lỗi và đề xuất sửa lỗi
- Trợ lý lập trình tích hợp trong IDE

---

### 3. **Marketing**

**Giới thiệu:**  
AI agents giúp cá nhân hóa nội dung, dự đoán hành vi khách hàng và tối ưu hóa chiến dịch tiếp thị một cách hiệu quả.

**Ứng dụng:**

- Gợi ý nội dung, thông điệp quảng cáo phù hợp
- Phân tích hành vi người dùng trên website/social media
- Tự động hóa email marketing và chatbot tư vấn sản phẩm
- Dự đoán xu hướng thị trường

---

### 4. **Y tế(Healthcare)**

 **Giới thiệu:**  
Trong ngành y tế, AI agents hỗ trợ chẩn đoán chính xác, theo dõi bệnh nhân và tối ưu hóa quá trình chăm sóc.

**Ứng dụng:**

- Hỗ trợ bác sĩ trong chẩn đoán hình ảnh y khoa (X-ray, MRI)
- Tư vấn sức khỏe ban đầu (virtual health assistant)
- Nhắc lịch uống thuốc và theo dõi bệnh mạn tính
- Phân tích hồ sơ bệnh án để phát hiện nguy cơ

---

### 5. **Chuỗi cung ứng(Supply Chain)**

**Giới thiệu:**  
AI agents cải thiện khả năng dự báo, tối ưu hóa vận hành và quản lý tồn kho hiệu quả trong chuỗi cung ứng.

**Ứng dụng:**

- Dự báo nhu cầu hàng hóa
- Tối ưu tuyến đường vận chuyển
- Quản lý kho thông minh
- Phân tích rủi ro trong chuỗi cung ứng toàn cầu

---

### 6. **Dịch vụ khách hàng(Customer Services)**

**Giới thiệu:**  
AI agents được sử dụng để cung cấp hỗ trợ khách hàng liên tục 24/7 và cá nhân hóa trải nghiệm tương tác.

**Ứng dụng:**

- Chatbot trả lời câu hỏi thường gặp
- Tự động phân loại và xử lý yêu cầu hỗ trợ
- Phân tích cảm xúc khách hàng qua email/cuộc gọi
- Tư vấn sản phẩm phù hợp dựa trên lịch sử mua hàng

---

### 7. **Ứng phó khẩn cấp(Emergency Response)**

**Giới thiệu:**  
AI agents giúp cải thiện phản ứng nhanh và hiệu quả trong các tình huống khẩn cấp như thiên tai, tai nạn hoặc y tế.

**Ứng dụng:**

- Dự đoán vị trí và tác động thiên tai (lũ, cháy rừng)
- Trợ lý điều phối cấp cứu 115
- Robot thăm dò khu vực nguy hiểm
- Phân tích thông tin thời gian thực để hỗ trợ quyết định

---

### 8. **Thương mại điện tử và bán lẻ(E-commerce and Retail)**

**Giới thiệu:**  
AI agents tạo ra trải nghiệm mua sắm thông minh hơn, giúp cá nhân hóa và tối ưu hóa chuỗi bán hàng.

**Ứng dụng:**

- Gợi ý sản phẩm theo hành vi người dùng
- Quản lý kho và tự động hóa đơn hàng
- Trợ lý mua sắm bằng giọng nói
- Phân tích phản hồi và đánh giá sản phẩm

---

### 9. **Giáo dục và đào tạo(Education and Training)**

**Giới thiệu:**  
AI agents hỗ trợ người học cá nhân hóa lộ trình học tập, đưa ra phản hồi kịp thời và nâng cao hiệu quả giảng dạy.

**Ứng dụng:**

- Gia sư ảo (AI tutor) theo dõi tiến độ học tập
- Đánh giá bài viết, kiểm tra tự động
- Tạo bài tập và đề thi phù hợp năng lực
- Mô phỏng đào tạo trong môi trường ảo (VR + AI)

---

### 10. **Trợ lý cá nhân và thiết bị thông minh(Personal Assistants and Smart Devices)**

**Giới thiệu:**  
AI agents ngày càng trở thành một phần thiết yếu trong đời sống cá nhân qua trợ lý ảo và các thiết bị IoT thông minh.

**Ứng dụng:**

- Trợ lý ảo (như Siri, Alexa, Google Assistant)
- Quản lý lịch, nhắc việc, điều khiển thiết bị trong nhà
- Học thói quen người dùng để tối ưu hóa tự động hóa
- Cảnh báo thời tiết, giao thông, sức khỏe

---

### 11. **Robot thông minh(Robotics)**

**Giới thiệu:**  
AI agents đóng vai trò "bộ não" cho robot, giúp robot nhận thức môi trường, tương tác và đưa ra quyết định.

**Ứng dụng:**

- Robot giao hàng, phục vụ trong nhà hàng
- Robot y tế, chăm sóc người già
- Robot cứu hộ ở khu vực nguy hiểm
- Robot hỗ trợ sản xuất công nghiệp

---

### 12. **Tác nhân đa nhiệm / Hệ thống nhiều tác nhân(Multi-Agents)**

**Giới thiệu:**  
Hệ thống nhiều AI agents làm việc cùng nhau để giải quyết các vấn đề phức tạp vượt quá khả năng của một tác nhân đơn lẻ.

**Ứng dụng:**

- Mạng lưới drone phối hợp tìm kiếm cứu hộ
- Tác nhân mô phỏng hành vi đám đông trong thành phố
- Quản lý giao thông thông minh với nhiều AI agent
- AI trong game chiến lược, mô phỏng hợp tác/đối đầu giữa nhiều tác nhân

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# Làm Thế Nào Để Xây Dựng Kế Hoạch Giới Thiệu AI Agents Trong Công Ty Của Bạn?

Trong bối cảnh công nghệ ngày càng phát triển, **AI Agents** (tác nhân trí tuệ nhân tạo) đang trở thành công cụ đột phá giúp các doanh nghiệp nâng cao hiệu suất, tối ưu hóa vận hành và mở rộng khả năng sáng tạo. Nhưng làm sao để bắt đầu? Làm thế nào để hiểu tiềm năng thật sự của AI agents và từng bước xây dựng kế hoạch triển khai chúng trong tổ chức?

Hãy cùng khám phá một cách tiếp cận thực tiễn để **giới thiệu AI Agents vào doanh nghiệp của bạn**, từ khâu tìm hiểu đến triển khai và mở rộng.

---

### 1. Hiểu Rõ AI Agents Là Gì Và Mang Lại Lợi Ích Gì?

AI agents là những hệ thống có khả năng:

- Quan sát môi trường,
- Ra quyết định dựa trên dữ liệu đầu vào,
- Hành động để đạt được mục tiêu cụ thể.

Khác với các hệ thống tự động hóa thông thường, AI agents có thể học hỏi, thích nghi và thậm chí phối hợp với các tác nhân khác (multi-agent systems) để giải quyết vấn đề phức tạp.

**Lợi ích tiềm năng của AI Agents:**

- Tăng hiệu quả công việc (tự động hóa các tác vụ lặp đi lặp lại)
- Cải thiện trải nghiệm khách hàng (chatbot, trợ lý ảo)
- Tối ưu hóa quyết định (dựa trên phân tích dữ liệu)
- Giảm sai sót và rủi ro vận hành

---

### 2. Đánh Giá Nhu Cầu Doanh Nghiệp &amp; Các Tình Huống Ứng Dụng (Use Cases)

Trước khi xây dựng, bạn cần **xác định các lĩnh vực có thể ứng dụng AI agents** trong doanh nghiệp của mình. Một số lĩnh vực tiềm năng:

👉 Hãy bắt đầu từ một hoặc hai tình huống rõ ràng, có thể đo lường hiệu quả, trước khi mở rộng.

---

### 3. Thiết Kế Lộ Trình Triển Khai AI Agent

Dưới đây là các bước đề xuất trong kế hoạch triển khai:

#### Bước 1: Xây dựng đội ngũ và xác định người phụ trách

- Tìm một nhóm nhỏ phụ trách AI (gồm kỹ thuật, nghiệp vụ và quản lý)
- Phân công rõ vai trò: kỹ sư AI, chuyên gia dữ liệu, quản lý dự án,…

#### Bước 2: Chọn công nghệ và công cụ phù hợp

- Có thể bắt đầu với các framework mã nguồn mở (LangChain, AutoGPT,…)
- Tích hợp với dữ liệu hiện có: CRM, ERP, hệ thống nội bộ
- Cân nhắc dùng nền tảng đám mây (Azure AI, OpenAI API, Google Vertex AI)

#### Bước 3: Phát triển phiên bản thử nghiệm (MVP)

- Bắt đầu với quy mô nhỏ: một quy trình, một bộ phận
- Đặt tiêu chí đo lường rõ ràng: tốc độ xử lý, độ chính xác, sự hài lòng người dùng

#### Bước 4: Đánh giá và cải tiến

- Lắng nghe phản hồi từ người dùng nội bộ
- Tinh chỉnh dữ liệu, mô hình và trải nghiệm tương tác

---

### 4. Đảm Bảo Các Yếu Tố Bảo Mật, Giám Sát Và Đạo Đức

Khi đưa AI agents vào hệ thống thực tế, bạn cần quan tâm đến:

- **Bảo mật dữ liệu:** Tránh lộ thông tin cá nhân, dữ liệu kinh doanh nhạy cảm
- **Giám sát và kiểm soát:** Cần có cơ chế để dừng AI agent khi cần
- **Tránh thiên vị (biases):** Đảm bảo dữ liệu huấn luyện khách quan và đầy đủ
- **Tính minh bạch:** Có khả năng truy vết và giải thích quyết định của AI

---

### 5. Mở Rộng Và Tích Hợp Sau Khi Thành Công Giai Đoạn Thử Nghiệm

Sau khi đã chứng minh hiệu quả của AI agent, bạn có thể:

- **Nhân rộng** sang các bộ phận khác
- **Liên kết các agent lại** thành hệ thống nhiều tác nhân (multi-agent)
- **Tối ưu liên tục** dựa trên dữ liệu thu thập được trong quá trình hoạt động

---

### Kết Luận

AI agents không phải là công nghệ xa vời — chúng đã và đang hiện diện trong các doanh nghiệp tiên phong. Với một kế hoạch rõ ràng, bạn hoàn toàn có thể:

- Khám phá tiềm năng to lớn của AI,
- Bắt đầu từ nhỏ và từng bước mở rộng,
- Xây dựng hệ thống thông minh có khả năng học hỏi, thích nghi và phục vụ mục tiêu kinh doanh.

**Bắt đầu hôm nay để đón đầu tương lai!**

**Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)**

# Những thách thức triển khai AI Agents

Việc triển khai AI Agents trong doanh nghiệp và các tổ chức mở ra nhiều cơ hội đổi mới, nhưng cũng đi kèm với không ít thách thức phức tạp. Về mặt kỹ thuật, các AI Agents có thể gặp rủi ro như vòng lặp phản hồi vô hạn, thiếu khả năng giải thích quyết định, và đòi hỏi tài nguyên tính toán lớn. Hạ tầng công nghệ như mô hình nền tảng, phần cứng, điện toán đám mây và khả năng tích hợp phần mềm cũng có thể trở thành điểm nghẽn. Trong quá trình triển khai, doanh nghiệp cần đối mặt với các vấn đề như định nghĩa quy trình, bảo mật dữ liệu, giám sát con người và đảm bảo đạo đức AI. Bên cạnh đó, thị trường AI đang bị chi phối bởi các nhà cung cấp lớn, thỏa thuận độc quyền và rào cản từ các nền tảng di động. Cuối cùng, vấn đề quản trị như khung pháp lý, tiêu chuẩn, cơ chế minh bạch và hợp tác liên ngành cũng là yếu tố sống còn để đảm bảo AI phát triển bền vững và có trách nhiệm.

### **I. Rủi ro và hạn chế kỹ thuật của AI Agents**

### 1. Sự hợp tác có nghĩa là nhiều rủi ro hơn

**Mô tả:** Khi nhiều AI agents cùng tương tác hoặc cộng tác để hoàn thành một nhiệm vụ, rủi ro hệ thống trở nên phức tạp hơn. Nếu một tác nhân có hành vi sai lệch, nó có thể ảnh hưởng dây chuyền đến các tác nhân khác, gây ra hiệu ứng domino.

**Ví dụ:** Trong một hệ thống AI hỗ trợ vận hành chuỗi cung ứng, một AI phụ trách dự đoán nhu cầu có thể đưa ra dự báo sai, khiến AI điều phối kho bãi nhập hàng dư thừa, và AI phụ trách vận chuyển phải xử lý khối lượng vượt mức — dẫn đến tắc nghẽn toàn hệ thống.

### 2. Vòng phản hồi vô hạn

**Mô tả:** Khi AI agent học từ phản hồi của chính mình hoặc từ tác nhân khác mà không có cơ chế giới hạn, có thể tạo ra vòng lặp phản hồi vô tận. Điều này dẫn đến hành vi lệch lạc, dữ liệu huấn luyện sai lệch hoặc quyết định ngày càng sai.

**Ví dụ:** Một chatbot AI trả lời khách hàng và đồng thời học từ phản hồi... của chính nó (vì bị nhầm là từ người dùng). Sau một thời gian, nó bắt đầu lặp lại câu trả lời không phù hợp và mất kiểm soát nội dung.

### 3. Tài nguyên tính toán

**Mô tả:** Các AI agents, đặc biệt là những agent phức tạp dùng mô hình ngôn ngữ lớn (LLMs), đòi hỏi sức mạnh tính toán rất cao. Điều này có thể làm tăng chi phí hạ tầng, chậm hệ thống hoặc gây quá tải.

**Ví dụ:** Một công ty triển khai AI trợ lý nội bộ sử dụng GPT để tổng hợp báo cáo. Khi hàng trăm nhân viên truy cập đồng thời, hệ thống trở nên chậm và tiêu tốn quá nhiều GPU trên cloud, gây tốn kém tài chính.

### 4. Thiếu khả năng giải thích

**Mô tả:** Nhiều AI agents hoạt động như hộp đen (black box), đưa ra quyết định mà con người khó hiểu được logic phía sau. Điều này gây khó khăn trong việc đánh giá, kiểm tra và tin tưởng AI.

**Ví dụ:** Một AI agent được giao nhiệm vụ từ chối hoặc duyệt đơn vay vốn, nhưng không thể giải thích lý do cụ thể tại sao đơn A được duyệt còn đơn B thì không, dù hồ sơ tương tự nhau. Điều này dễ dẫn đến nghi ngờ và khiếu nại.

###   
**II. Mô hình nền tảng**

**Mô tả:** AI Agents thường dựa trên các mô hình ngôn ngữ lớn hoặc mô hình thị giác sâu đã được huấn luyện trước. Tuy nhiên, việc phụ thuộc vào các mô hình nền này có thể gây ra các vấn đề về chi phí, quyền truy cập, và độ phù hợp với từng trường hợp cụ thể. Ngoài ra, những mô hình này cũng có thể mang theo những thiên kiến và hạn chế từ dữ liệu gốc.

**Ví dụ:** Một công ty tài chính sử dụng GPT để hỗ trợ phân tích báo cáo tài chính. Tuy nhiên, mô hình nền tảng không hiểu rõ các khái niệm chuyên sâu trong ngành tài chính Việt Nam, dẫn đến phân tích sai hoặc thiếu thông tin quan trọng.

#### 2. Phần cứng

**Mô tả:** Các tác nhân AI cần phần cứng mạnh mẽ, như GPU, TPU, RAM lớn hoặc thiết bị cảm biến chuyên biệt (trong robotics). Thiếu phần cứng phù hợp có thể làm chậm hệ thống, giảm hiệu suất, hoặc không thể chạy tác vụ thời gian thực.

**Ví dụ:** Một công ty bán lẻ triển khai robot AI để kiểm kê hàng hóa trong kho, nhưng robot không có đủ cảm biến hoặc camera chất lượng cao để đọc mã vạch trong điều kiện ánh sáng yếu — dẫn đến sai sót và tốn thời gian kiểm tra lại thủ công.

#### 3. Hạ tầng đám mây

**Mô tả:** Hầu hết AI Agents hiện nay vận hành trên nền tảng điện toán đám mây. Tuy nhiên, hiệu suất của AI phụ thuộc nhiều vào khả năng mở rộng, bảo mật, và độ ổn định của cloud provider. Bất kỳ sự cố nào về mạng, bảo mật, hay tài nguyên hạn chế cũng ảnh hưởng đến toàn hệ thống.

**Ví dụ:** Một AI chăm sóc khách hàng đang vận hành qua dịch vụ đám mây bị gián đoạn do sự cố từ nhà cung cấp (ví dụ AWS bị downtime). Kết quả là hệ thống phản hồi khách hàng bị tê liệt trong nhiều giờ, ảnh hưởng đến trải nghiệm và uy tín thương hiệu.

#### 4. Tích hợp phần mềm

**Mô tả:** Để AI agents hoạt động hiệu quả, chúng cần tích hợp liền mạch với các hệ thống hiện tại như CRM, ERP, HRM, v.v. Tuy nhiên, sự khác biệt về kiến trúc hệ thống, giao thức truyền thông hoặc độ tương thích có thể tạo ra rào cản lớn cho việc tích hợp.

**Ví dụ:** Một công ty muốn tích hợp AI để tự động tạo và gửi hóa đơn thông qua hệ thống kế toán cũ. Tuy nhiên, hệ thống hiện tại không hỗ trợ API hoặc không tương thích với mô hình AI hiện có, buộc phải xây dựng cầu nối trung gian tốn kém và mất thời gian.

### **III. Các vấn đề thực hiện**

Triển khai AI Agents trong môi trường doanh nghiệp không chỉ đơn thuần là việc đưa một công nghệ mới vào hệ thống hiện có — đó là một quá trình phức tạp đòi hỏi sự chuẩn bị kỹ lưỡng về quy trình, hạ tầng và con người. Những thách thức này bắt đầu từ việc **xác định rõ quy trình** mà AI sẽ tham gia, cho đến việc **tích hợp** AI với các hệ thống hiện hành. **Bảo mật dữ liệu** là mối quan tâm hàng đầu, đặc biệt khi AI xử lý thông tin nhạy cảm. Đồng thời, AI cần có **sự giám sát của con người** để đảm bảo hoạt động đúng định hướng và phù hợp với giá trị đạo đức. Ngoài ra, việc duy trì tính **công bằng, không dư thừa dữ liệu** và đảm bảo **khả năng mở rộng, bảo trì lâu dài** cũng là những yếu tố sống còn cho sự thành công của AI trong thực tế.

#### 1. Định nghĩa qui trình

**Mô tả:** Trước khi triển khai AI agent, doanh nghiệp cần xác định rõ quy trình nào sẽ được tự động hóa hoặc hỗ trợ. Thiếu định nghĩa quy trình rõ ràng sẽ khiến AI hoạt động không hiệu quả, chồng chéo với công việc con người hoặc gây gián đoạn vận hành.

**Ví dụ:** Một công ty muốn dùng AI để xử lý yêu cầu hỗ trợ khách hàng, nhưng không xác định rõ khi nào AI nên chuyển tiếp cho nhân viên thật. Hậu quả là AI giữ khách hàng quá lâu hoặc chuyển không đúng lúc, gây bất mãn.

#### 2. Tích hợp

**Mô tả:** AI agents cần được tích hợp liền mạch vào hệ thống hiện có (CRM, ERP, website, v.v.). Quá trình này thường gặp khó khăn do không tương thích, thiếu API, hoặc kiến trúc phần mềm cũ.

**Ví dụ:** Một bệnh viện triển khai AI hỗ trợ đọc kết quả chụp X-quang, nhưng hệ thống AI không kết nối được với phần mềm lưu trữ hồ sơ bệnh án (EMR), khiến nhân viên phải nhập tay kết quả → chậm trễ và sai sót.

#### 3. Bảo mật dữ liệu

**Mô tả:** AI agents cần truy cập và xử lý dữ liệu nhạy cảm như thông tin cá nhân, tài chính, y tế,… Nếu không được bảo vệ tốt, đây sẽ là lỗ hổng nghiêm trọng về bảo mật.

**Ví dụ:** Một AI hỗ trợ kế toán nội bộ bị khai thác qua API không được bảo mật, khiến dữ liệu lương và hợp đồng nhân sự bị rò rỉ ra bên ngoài.

#### 4. Giám sát của con người

**Mô tả:** AI cần được giám sát bởi con người để đảm bảo hoạt động đúng, tránh lỗi hệ thống hoặc đưa ra quyết định không phù hợp. Thiếu giám sát có thể gây hậu quả nghiêm trọng, nhất là trong các ngành nhạy cảm.

**Ví dụ:** Một AI phỏng vấn tuyển dụng tự động loại bỏ nhiều ứng viên chỉ vì giọng nói địa phương, nhưng không có người kiểm tra lại các tiêu chí đánh giá → dẫn đến mất ứng viên chất lượng và phản ứng tiêu cực.

#### 5. Mối quan tâm về đạo đức và thiên vị

**Mô tả:** AI có thể vô tình tái tạo hoặc khuếch đại các định kiến từ dữ liệu huấn luyện. Nếu không được kiểm soát, AI có thể đưa ra các quyết định phân biệt đối xử hoặc phi đạo đức.

**Ví dụ:** Một AI phân tích hồ sơ vay vốn học tập lại có xu hướng ưu tiên người từ khu vực đô thị hơn nông thôn, vì mô hình học từ dữ liệu lịch sử thiếu công bằng → gây bất bình đẳng xã hội.

#### 6. Khả năng mở rộng và bảo trì

**Mô tả:** AI agent ban đầu có thể chạy tốt, nhưng khi số lượng người dùng hoặc dữ liệu tăng lên, hệ thống có thể bị quá tải nếu không được thiết kế để mở rộng. Đồng thời, AI cần được cập nhật và bảo trì định kỳ.

**Ví dụ:** Một cửa hàng online dùng AI để gợi ý sản phẩm. Trong mùa sale, lượng truy cập tăng gấp 10 lần khiến AI đưa ra đề xuất sai hoặc đứng hệ thống → làm mất doanh thu và trải nghiệm khách hàng.

### III. Các nhà cung cấp chi phối thị trường

Thị trường hiện tại lại đang bị chi phối bởi một số rào cản lớn có thể cản trở khả năng phát triển và triển khai của các doanh nghiệp. Những thách thức này bao gồm sự thống trị của các nhà cung cấp lớn (dominant providers), các thỏa thuận độc quyền (exclusivity agreements), và sự kiểm soát chặt chẽ từ các nền tảng di động như hệ điều hành và chợ ứng dụng (mobile OS and app stores). Những yếu tố này không chỉ làm hạn chế sự lựa chọn công nghệ, mà còn ảnh hưởng đến khả năng tiếp cận, phân phối và sáng tạo trong không gian AI. Do đó, các doanh nghiệp muốn ứng dụng AI Agents cần hiểu rõ môi trường thị trường để xây dựng chiến lược thích nghi phù hợp và giảm thiểu rủi ro phụ thuộc.

#### 1. Các nhà cung cấp chi phối thị trường

**Mô tả:** Thị trường AI hiện đang bị thống trị bởi một số ít công ty lớn như OpenAI, Google, Microsoft, Anthropic... Họ kiểm soát các mô hình AI nền tảng, hạ tầng tính toán và API, khiến doanh nghiệp nhỏ phụ thuộc và thiếu lựa chọn.

**Ví dụ:** Một công ty khởi nghiệp muốn xây dựng AI agent nội bộ nhưng buộc phải phụ thuộc vào GPT của OpenAI vì không đủ nguồn lực huấn luyện mô hình riêng. Khi OpenAI tăng giá API hoặc thay đổi chính sách, công ty này không có phương án thay thế.

---

#### 2. Thỏa thuận độc quyền

**Mô tả:** Một số công ty công nghệ lớn ký thỏa thuận độc quyền với các nhà cung cấp AI, giới hạn quyền truy cập hoặc tích hợp vào nền tảng của đối thủ, khiến thị trường bị khóa và cản trở đổi mới.

**Ví dụ:** Microsoft ký thỏa thuận độc quyền tích hợp GPT vào các sản phẩm Microsoft 365. Một đối thủ trong lĩnh vực phần mềm văn phòng không thể tích hợp cùng mức độ hoặc chức năng tương đương, dẫn đến mất lợi thế cạnh tranh.

---

#### 3. Hệ điều hành và cửa hàng ứng dụng di động

**Mô tả:** Các nền tảng như iOS (Apple) và Android (Google) kiểm soát chặt chẽ hệ sinh thái ứng dụng, bao gồm quyền truy cập vào phần cứng, dữ liệu người dùng, và cả phân phối ứng dụng. Việc đưa AI agent lên điện thoại gặp rào cản chính sách, giới hạn kỹ thuật hoặc chia sẻ doanh thu.

**Ví dụ:** Một startup phát triển AI agent tương tác bằng giọng nói cho thiết bị di động, nhưng Apple không cho phép quyền truy cập toàn phần vào micro hoặc Siri. Ngoài ra, ứng dụng phải chia 30% doanh thu cho Apple nếu bán qua App Store.

### **IV. Quản trị AI Agents**

Quản trị(Governance) trong lĩnh vực AI đề cập đến việc xây dựng các cơ chế, chính sách, luật pháp và quy trình nhằm đảm bảo rằng các hệ thống AI – bao gồm cả AI Agents – được phát triển, triển khai và vận hành một cách **an toàn, minh bạch, có trách nhiệm và tuân thủ đạo đức**.

Khi AI Agents ngày càng trở nên tự chủ và mạnh mẽ, việc quản trị chúng không còn là một lựa chọn, mà là điều bắt buộc để ngăn ngừa rủi ro và bảo vệ lợi ích xã hội, doanh nghiệp và cá nhân.

#### 1. Quy định pháp lý

**Mô tả:** Các luật lệ và quy định từ chính phủ hoặc cơ quan quốc tế nhằm kiểm soát cách AI được thiết kế, triển khai và sử dụng.

**Ví dụ:**

- Liên minh Châu Âu ban hành **AI Act**, yêu cầu các hệ thống AI có mức rủi ro cao phải được kiểm tra nghiêm ngặt về an toàn, độ tin cậy và quyền riêng tư.
- Ở Việt Nam, nếu AI Agent xử lý dữ liệu cá nhân nhạy cảm mà không tuân thủ **Luật An ninh mạng** hoặc **Luật Bảo vệ dữ liệu cá nhân (dự thảo)**, doanh nghiệp có thể bị xử phạt.

---

### 2. Tiêu chuẩn kỹ thuật

**Mô tả:** Các hướng dẫn và tiêu chuẩn chung để thiết kế, phát triển và đánh giá AI một cách nhất quán, minh bạch và có thể kiểm chứng.

**Ví dụ:**

- **ISO/IEC 42001** là tiêu chuẩn quốc tế mới cho hệ thống quản lý AI.
- Doanh nghiệp xây dựng AI Agent theo chuẩn **IEEE P7001** để đảm bảo tính minh bạch trong thuật toán ra quyết định.

---

#### 3. Cơ chế trách nhiệm

**Mô tả:** Xác định rõ **ai chịu trách nhiệm khi AI Agent gây ra sự cố** hoặc hành vi sai lệch. Điều này giúp doanh nghiệp không "đổ lỗi cho AI" mà phải gắn trách nhiệm với con người hoặc tổ chức cụ thể.

**Ví dụ:**  
Nếu một AI Agent từ chối đơn bảo hiểm sai do lỗi thuật toán, công ty bảo hiểm cần có bộ phận chịu trách nhiệm xử lý khiếu nại, sửa lỗi hệ thống, và bồi thường nếu cần.

---

#### 4. Yêu cầu minh bạch

**Mô tả:** Các AI Agent cần minh bạch trong hoạt động của mình: chúng đưa ra quyết định như thế nào, sử dụng dữ liệu gì, và người dùng có thể hiểu (hoặc kiểm tra) quá trình đó.

**Ví dụ:**  
Một AI Agent gợi ý sản phẩm trên sàn thương mại điện tử cần nêu rõ lý do: "Sản phẩm này được đề xuất vì bạn đã mua các sản phẩm tương tự trong 30 ngày qua".

---

#### 5. Hợp tác liên ngành

**Mô tả:** Các tổ chức, doanh nghiệp, cơ quan chính phủ và giới học thuật cần phối hợp cùng nhau để đảm bảo AI phát triển một cách cân bằng, bền vững, và toàn diện.

**Ví dụ:**

- Một AI Agent hỗ trợ chẩn đoán y tế cần được xây dựng với sự hợp tác giữa công ty công nghệ, bệnh viện, bộ y tế và các tổ chức đạo đức để đảm bảo tính chính xác, an toàn và nhân đạo.
- Trong lĩnh vực tài chính, ngân hàng cần hợp tác với các chuyên gia pháp lý và công nghệ để triển khai AI tuân thủ các quy định chống rửa tiền (AML) và biết khách hàng (KYC).

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com)

# Yêu cầu pháp lý (Regulatory) trong xây dựng AI Agents:

1. **Đảm bảo thị trường cạnh tranh và thúc đẩy đổi mới sáng tạo**  
    Tránh độc quyền công nghệ, tạo môi trường để các công ty nhỏ và startup cũng có cơ hội tham gia và sáng tạo AI Agents.
2. **Đảm bảo quyền riêng tư và bảo mật dữ liệu**  
    AI Agents cần tuân thủ nghiêm ngặt các quy định về bảo vệ dữ liệu cá nhân, tránh thu thập hoặc xử lý dữ liệu nhạy cảm một cách trái phép.
3. **Bảo vệ quyền sở hữu trí tuệ**  
    Các mô hình AI không được sao chép hoặc tái sử dụng nội dung, phần mềm, hoặc dữ liệu của bên thứ ba mà không có sự cho phép hợp pháp.
4. **Ngăn chặn thông tin sai lệch, đe doạ mạng và lạm dụng AI**  
    AI Agents không được trở thành công cụ phát tán tin giả, tấn công mạng, hoặc bị sử dụng cho các mục đích độc hại như deepfake hoặc lừa đảo.
5. **Giảm thiểu tác động môi trường và đảm bảo phát triển bền vững**  
    Khuyến khích phát triển các mô hình AI tiết kiệm năng lượng, tối ưu hóa tính toán và giảm phát thải carbon.
6. **Hạn chế sự thiên lệch (bias)**  
    Đảm bảo AI Agents không tạo ra hoặc tái tạo định kiến giới, chủng tộc, địa lý, hoặc xã hội trong quá trình xử lý dữ liệu hay ra quyết định.
7. **Đảm bảo tính minh bạch và cơ chế giải trình**  
    Người dùng và tổ chức phải hiểu được cách AI Agents hoạt động, đưa ra quyết định và có thể kiểm tra, truy xuất nguồn gốc kết quả nếu cần.
8. **Bồi thường thiệt hại do mất việc làm và tác động kinh tế tiêu cực**  
    Khi AI thay thế công việc truyền thống, cần có chính sách hỗ trợ đào tạo lại lao động, phân phối lại lợi ích một cách công bằng.
9. **Cân bằng giữa đổi mới công nghệ và trách nhiệm xã hội**  
    Khuyến khích phát triển AI nhanh chóng nhưng không đánh đổi các giá trị đạo đức, quyền con người và lợi ích cộng đồng.

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/)

# Sự hiện hữu của AI Agents

#### **1. Từ bản demo đến sản phẩm thực tế (From Demos to Products)**

- AI Agents không còn bị giới hạn trong các thử nghiệm phòng lab. Trước đây, AI Agents chủ yếu là mô hình thử nghiệm mang tính nghiên cứu. Hiện nay, chúng đang được triển khai thực tế để **giải quyết vấn đề cụ thể trong doanh nghiệp** như chăm sóc khách hàng, xử lý đơn hàng, tự động hóa công việc nội bộ.
- **Ví dụ:** Một AI Agent giúp xử lý email khách hàng tự động đã không còn là thử nghiệm – nó đang hoạt động tại các trung tâm hỗ trợ thực tế.

---

#### **2. Tăng tốc triển khai (Acceleration)**

- Việc ứng dụng AI Agents sẽ diễn ra nhanh chóng khi nhiều tổ chức nhận ra giá trị của chúng. Doanh nghiệp nào áp dụng AI Agents sớm (early adopters) sẽ có **lợi thế cạnh tranh** nhờ tối ưu chi phí, cải thiện năng suất và đổi mới sản phẩm nhanh hơn.

---

#### **3. Mở rộng các tình huống ứng dụng (Expansion of use cases)**

- Các lĩnh vực khác nhau sẽ ngày càng áp dụng AI Agents, không chỉ giới hạn trong công nghệ hay tài chính, AI Agents sẽ xuất hiện trong **giáo dục, logistics, y tế, sản xuất, dịch vụ công**, v.v.

---

#### **4. Kết hợp với công nghệ mới nổi (With Emerging Tech)**

- AI Agents sẽ được tích hợp với các công nghệ khác như **IoT, Blockchain, Robot, AR/VR, 5G** để tạo ra những giải pháp thông minh mạnh mẽ và tương tác tốt hơn.
- **Ví dụ:** Một AI Agent trong dây chuyền sản xuất có thể kết nối với cảm biến IoT để tự động phát hiện lỗi kỹ thuật.

---

#### **5. Cuộc cách mạng lực lượng lao động (Workforce Revolution)**

- AI Agents sẽ thay đổi cách con người làm việc, giúp tự động hóa các công việc lặp đi lặp lại và tạo điều kiện để nhân viên tập trung vào các nhiệm vụ sáng tạo, chiến lược hơn.
- **Ví dụ:** Thay vì xử lý thủ công hàng trăm đơn hàng, nhân viên chỉ cần giám sát AI Agent làm việc đó và đưa ra quyết định cuối cùng.

---

#### **6. Đối tác cộng tác thông minh (Collaborative Partners)**

- AI Agents không phải thay thế con người, mà sẽ trở thành **trợ lý kỹ thuật số** hợp tác để nâng cao hiệu suất công việc.

---

#### **7. Đội nhóm lai (Hybrid Teams)**

- Doanh nghiệp trong tương lai sẽ có các nhóm làm việc "lai", nơi con người và AI Agents cùng tham gia xử lý công việc – mỗi bên phát huy thế mạnh của mình.
- **Ví dụ:** Một nhóm marketing có thể bao gồm 3 nhân viên và 1 AI Agent chuyên tổng hợp dữ liệu thị trường mỗi ngày.

---

#### **8. Thị trường AI Agent (AI Agent Marketplaces)**

- Sẽ có các nền tảng cho phép doanh nghiệp tìm mua, thuê hoặc chia sẻ AI Agents đã được huấn luyện sẵn theo từng lĩnh vực.
- **Ví dụ:** Bạn có thể truy cập marketplace để tải về một AI Agent chuyên về hỗ trợ pháp lý hoặc chăm sóc khách hàng bằng tiếng Việt.

---

#### **9. Khuyến nghị (Recommendations)**

Để chuẩn bị cho tương lai này, các tổ chức nên:

- **Training:** Đào tạo đội ngũ về kỹ năng AI cơ bản và ứng dụng AI Agents.
- **Experiment:** Bắt đầu thử nghiệm AI Agents trong một vài quy trình nhỏ.
- **Optimize Costs:** Lựa chọn giải pháp AI phù hợp với ngân sách, tối ưu chi phí khi triển khai.

---

#### **10. Sự phát triển công nghệ (Tech Evolution)**

- Hạ tầng phần cứng, mô hình ngôn ngữ lớn (LLMs), điện toán biên, GPU… sẽ tiếp tục phát triển, giúp AI Agents ngày càng thông minh, nhanh và đáng tin cậy hơn.

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/)

# Cách Xây Dựng AI AGENTS Chuyên Nghiệp

Hướng dẫn dành cho các tổ chức, doanh nghiệp và nhà phát triển muốn khai thác tối đa tiềm năng của AI Agents. Bài viết sẽ giúp bạn hiểu rõ các yếu tố cốt lõi trong thiết kế, triển khai và quản trị AI Agents một cách bài bản. Từ chiến lược công nghệ đến yếu tố đạo đức và vận hành, đây là nền tảng để xây dựng các tác nhân AI hiệu quả, an toàn và đáng tin cậy.

# Xây Dựng AI Agents Chuyên Nghiệp với LangGraph

Trong hành trình này, bạn sẽ được học cách xây dựng các AI Agent hiện đại bằng **LangGraph** – một công cụ mạnh mẽ đang thay đổi cách chúng ta tạo ra các hệ thống AI tương tác. Khóa học được thiết kế từ cơ bản đến nâng cao, từng bước hướng dẫn bạn vượt qua những khó khăn ban đầu, để rồi làm chủ những mô hình phức tạp, thực tế và hiệu quả.

# Trang mới



# Bài học thực chiến với ví dụ chi tiết

# Message

Trong **LangChain**, các loại **Message** đóng vai trò rất quan trọng khi làm việc với các mô hình như ChatOpenAI, nhất là khi xây dựng các hệ thống hội thoại (conversational agents). Những message này mô phỏng cách người và AI giao tiếp với nhau trong một cuộc trò chuyện.

# Giới thiệu

Trong LangChain, **Message** là thành phần cốt lõi dùng để mô tả các tương tác giữa người dùng, hệ thống và mô hình ngôn ngữ (LLM). Việc hiểu rõ các loại Message giúp bạn xây dựng các tác vụ hội thoại, agent, và ứng dụng AI một cách chính xác, dễ kiểm soát và có thể mở rộng.

LangChain định nghĩa nhiều loại message khác nhau, mỗi loại phản ánh một vai trò cụ thể trong quá trình giao tiếp. Dưới đây là tổng quan các loại message chính:

### 1. `HumanMessage` – Tin nhắn từ người dùng

Đây là loại message đại diện cho đầu vào từ người dùng cuối. Khi bạn nhập văn bản để hỏi AI, LangChain sẽ đóng gói nội dung đó thành một `HumanMessage`.

```python
from langchain.schema import HumanMessage

message = HumanMessage(content="Bạn có thể giúp tôi tính 5 nhân 3 không?")
```

Dùng khi mô phỏng hoặc truyền input từ con người.

### 2. `AIMessage` – Phản hồi từ AI

Đại diện cho phản hồi từ LLM, thường là kết quả sau khi xử lý `HumanMessage`. Ngoài văn bản, AIMessage còn có thể bao gồm **tool calls**, nếu AI quyết định gọi một công cụ thay vì trả lời trực tiếp.

```python
from langchain.schema import AIMessage

message = AIMessage(content="Kết quả là 15.")
```

Dùng để mô tả output từ AI.

### 3. `SystemMessage` – Định hướng AI

Được dùng để thiết lập bối cảnh hoặc hướng dẫn hành vi của AI từ đầu. Những chỉ dẫn như “bạn là một trợ lý thân thiện” hay “chỉ trả lời bằng tiếng Việt” thường được đặt trong SystemMessage.

```python
from langchain.schema import SystemMessage

message = SystemMessage(content="Bạn là một trợ lý AI chuyên nghiệp.")
```

Dùng để hướng dẫn mô hình trước khi bắt đầu cuộc trò chuyện.

### 4. `ToolMessage` – Phản hồi từ công cụ (tool)

Khi một AI gọi tool (hàm toán học, API, công cụ bên ngoài…), kết quả trả về sẽ được biểu diễn qua ToolMessage. Nó mô tả output của tool, và giúp AI tiếp tục hội thoại dựa trên dữ liệu đó.

```python
from langchain.schema import ToolMessage

message = ToolMessage(
    tool_call_id="abc123",
    content="Kết quả của phép chia là 2.5"
)

```

Dùng khi bạn có workflow với tool calling.

### 5. `ToolCall` – Yêu cầu từ AI gọi một tool

Không phải là message, nhưng thường được **gói trong AIMessage**. Khi AI muốn gọi một hàm cụ thể, nó tạo ra một `ToolCall` để mô tả tên tool và các tham số truyền vào.

```python
from langchain.schema.messages import ToolCall

call = ToolCall(
    name="multiply",
    args={"a": 5, "b": 3},
    id="tool_call_1"
)
```

Gắn liền với quá trình sử dụng `bind_tools()` hoặc khi xây dựng các agent có tool.

#### **Tóm lại**  


<table class="min-w-full" data-end="3578" data-start="2831" id="bkmrk-message-type-vai-tr%C3%B2" style="height: 178px; width: 100%;"><thead data-end="2936" data-start="2831"><tr data-end="2936" data-start="2831"><th class="align-left" data-end="2850" data-start="2831" style="width: 33.2924%;">**Message Type**</th><th class="align-left" data-end="2890" data-start="2850" style="width: 33.2924%;">**Vai trò chính**</th><th class="align-left" data-end="2936" data-start="2890" style="width: 33.2962%;">**Dùng khi nào?**</th></tr></thead><tbody data-end="3578" data-start="3044"><tr data-end="3150" data-start="3044"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3063" data-start="3044" style="width: 33.2924%;">`HumanMessage`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3104" data-start="3063" style="width: 33.2924%;">Người dùng gửi yêu cầu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3150" data-start="3104" style="width: 33.2962%;">Mọi input của người dùng</td></tr><tr data-end="3257" data-start="3151"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3170" data-start="3151" style="width: 33.2924%;">`AIMessage`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3211" data-start="3170" style="width: 33.2924%;">AI phản hồi hoặc gọi tool</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3257" data-start="3211" style="width: 33.2962%;">Output từ AI</td></tr><tr data-end="3364" data-start="3258"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3277" data-start="3258" style="width: 33.2924%;">`SystemMessage`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3318" data-start="3277" style="width: 33.2924%;">Thiết lập bối cảnh và hành vi AI</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3364" data-start="3318" style="width: 33.2962%;">Trước khi bắt đầu cuộc trò chuyện</td></tr><tr data-end="3471" data-start="3365"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3384" data-start="3365" style="width: 33.2924%;">`ToolMessage`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3425" data-start="3384" style="width: 33.2924%;">Phản hồi từ công cụ (tool)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3471" data-start="3425" style="width: 33.2962%;">Khi một tool được AI gọi và trả về kết quả</td></tr><tr data-end="3578" data-start="3472"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3491" data-start="3472" style="width: 33.2924%;">`ToolCall`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3532" data-start="3491" style="width: 33.2924%;">(Không phải message) – Gọi hàm/tool</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3578" data-start="3532" style="width: 33.2962%;">Khi AI quyết định gọi tool thay vì trả lời</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# HumanMessage – Tin nhắn từ người dùng

Trong LangChain, `HumanMessage` là một trong những loại message cơ bản nhất, đại diện cho **lời nói, câu hỏi hoặc yêu cầu từ người dùng** trong cuộc trò chuyện với mô hình ngôn ngữ (LLM).

Khi bạn gọi mô hình bằng `ChatModel` như `ChatOpenAI`, bạn có thể truyền vào một danh sách các message. `HumanMessage` mô phỏng nội dung do con người nhập vào — tương đương với việc bạn gõ câu hỏi vào ChatGPT.

Cú pháp khai báo

```python
from langchain.schema import HumanMessage

message = HumanMessage(content="Hôm nay thời tiết thế nào?")
```

- `content`: là văn bản người dùng gửi.
- Có thể dùng thêm `name` nếu bạn muốn đặt tên cho người gửi (không bắt buộc).

Ví dụ đơn giản sử dụng với `ChatOpenAI`

```python
from langchain.chat_models import ChatOpenAI
from langchain.schema import HumanMessage

# Khởi tạo mô hình
llm = ChatOpenAI()

# Tạo HumanMessage
user_message = HumanMessage(content="Hãy tính giúp tôi 7 + 5 là bao nhiêu?")

# Gửi message đến mô hình và in kết quả
response = llm([user_message])
print(response.content)

```

Kết quả có thể là:  
`7 + 5 = 12.`

Dùng nhiều messages trong cuộc hội thoại

```python
from langchain.schema import HumanMessage, AIMessage, SystemMessage
from langchain.chat_models import ChatOpenAI

chat = ChatOpenAI()

messages = [
    SystemMessage(content="Bạn là một trợ lý AI thông minh và lịch sự."),
    HumanMessage(content="Bạn tên là gì?"),
    AIMessage(content="Tôi là trợ lý AI được thiết kế để hỗ trợ bạn."),
    HumanMessage(content="Bạn có thể dịch câu 'Hello' sang tiếng Việt không?")
]

response = chat(messages)
print(response.content)

```

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# AIMessage – Tin nhắn phản hồi từ AI

Trong LangChain, `AIMessage` đại diện cho **phản hồi từ mô hình ngôn ngữ** (LLM) sau khi nhận một hoặc nhiều `HumanMessage`.

Bạn có thể nghĩ nó giống như câu trả lời mà ChatGPT gửi lại sau khi bạn hỏi.

LangChain cho phép bạn truyền danh sách các message vào mô hình — trong đó `AIMessage` giúp mô phỏng những phản hồi trước đó từ AI để giữ **ngữ cảnh hội thoại**.

Cú pháp khai báo

```python
from langchain.schema import AIMessage

message = AIMessage(content="Tôi có thể giúp gì cho bạn hôm nay?")
```

- `content`: là nội dung phản hồi của AI.
- Cũng có thể dùng thêm `name`, nhưng thường không cần vì AI chỉ có 1 vai trò chính.

Ví dụ sử dụng với `ChatOpenAI`

```python
from langchain.chat_models import ChatOpenAI
from langchain.schema import HumanMessage, AIMessage

chat = ChatOpenAI()

messages = [
    HumanMessage(content="Bạn tên là gì?"),
    AIMessage(content="Tôi là trợ lý ảo của bạn."),
    HumanMessage(content="Bạn có thể giúp tôi dịch từ 'apple' sang tiếng Việt không?")
]

response = chat(messages)
print(response.content)
```

Kết quả có thể là:  
**"Từ 'apple' trong tiếng Việt là 'quả táo'."**

**Sử dụng trong hội thoại nhiều lượt (multi-turn conversation)**

```python
from langchain.schema import HumanMessage, AIMessage, SystemMessage

messages = [
    SystemMessage(content="Bạn là trợ lý lịch sự, trả lời bằng tiếng Việt."),
    HumanMessage(content="Xin chào!"),
    AIMessage(content="Chào bạn! Tôi có thể giúp gì hôm nay?"),
    HumanMessage(content="Thời tiết hôm nay như thế nào ở Hà Nội?")
]

```

Bạn có thể gửi `messages` này vào `ChatOpenAI()` để giữ toàn bộ ngữ cảnh từ đầu đến cuối.

#### **`AIMessage` sử dụng trong những trường hợp**

- Khi bạn **lưu trữ phản hồi của AI** trong một cuộc trò chuyện và muốn **phát lại** sau này.
- Khi bạn cần **thêm bối cảnh** vào lời nhắc (prompt) hiện tại để mô hình hiểu mạch hội thoại.
- Khi bạn muốn mô phỏng lại các cuộc đối thoại giữa người dùng và AI.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# SystemMessage -  Thiết lập ngữ cảnh

Trong LangChain, `SystemMessage` là một loại message đặc biệt dùng để **thiết lập ngữ cảnh hoặc hướng dẫn hành vi** cho mô hình ngôn ngữ (LLM).

> Nó giống như "lệnh nền" mà người dùng không thấy, nhưng ảnh hưởng đến cách AI trả lời.

Cú pháp

```python
from langchain.schema import SystemMessage

system_msg = SystemMessage(content="Bạn là một trợ lý AI nói tiếng Việt và luôn lịch sự.")
```

- `content`: Văn bản chỉ dẫn cho mô hình.
- Không hiển thị với người dùng cuối, nhưng cực kỳ quan trọng để **định hình cá tính và hành vi** của AI.

#### **Mục đích sử dụng**

- Thiết lập **vai trò** cho AI (ví dụ: giáo viên, chuyên gia, chatbot vui vẻ...).
- Quy định **giọng điệu** (ví dụ: lịch sự, vui vẻ, nghiêm túc).
- Áp đặt **giới hạn**, như "không trả lời nếu không chắc chắn".

#### **Ví dụ đơn giản**

```python
from langchain.chat_models import ChatOpenAI
from langchain.schema import HumanMessage, SystemMessage

llm = ChatOpenAI()

messages = [
    SystemMessage(content="Bạn là một trợ lý AI lịch sự và vui tính."),
    HumanMessage(content="Hôm nay bạn khỏe không?")
]

response = llm(messages)
print(response.content)
```

Kết quả có thể là

```
Cảm ơn bạn đã hỏi! Tôi là AI nên không có cảm giác, nhưng nếu có thì chắc chắn hôm nay tôi rất tuyệt vời. Còn bạn thì sao?
```

Thấy không? AI trở nên "vui tính" và "lịch sự" đúng như chỉ dẫn trong `SystemMessage`.

Ví dụ hội thoại có nhiều loại message

```python
from langchain.schema import HumanMessage, AIMessage, SystemMessage
from langchain.chat_models import ChatOpenAI

llm = ChatOpenAI()

messages = [
    SystemMessage(content="Bạn là một chuyên gia lịch sử Việt Nam, nói ngắn gọn."),
    HumanMessage(content="Ai là vua đầu tiên của triều Nguyễn?"),
]

response = llm(messages)
print(response.content)
```

**Kết quả mẫu**:

```
Vua đầu tiên của triều Nguyễn là Gia Long, lên ngôi năm 1802.
```

#### **Mẹo chuyên sâu**

- `SystemMessage` nên luôn được **đặt đầu tiên** trong danh sách messages.
- Nếu dùng `memory`, bạn có thể **thêm `SystemMessage` một lần duy nhất** để mô hình nhớ bối cảnh trong suốt cuộc trò chuyện.
- Bạn có thể sử dụng `SystemMessage` để **giới hạn độ dài, độ chính xác, hoặc hành vi không mong muốn** của AI.
- Muốn ví dụ sử dụng `SystemMessage` để tạo các kiểu AI khác nhau như:
    
    
    - Trợ lý thân thiện
    - Chuyên gia tài chính
    - Luật sư
    - Dịch giả tự động
    
    **Tác giả: Đỗ Ngọc Tú**  
    **Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# ToolMessage - Kết quả phản hồi từ một công cụ (tool)

Trong LangChain, `ToolMessage` đại diện cho **kết quả phản hồi từ một công cụ (tool)** sau khi mô hình LLM gọi tool đó.

> Nó giống như AI bảo: "Tôi cần dùng máy tính để tính 2 + 2", sau đó bạn gửi lại kết quả "4" bằng `ToolMessage`.

#### **Khi nào dùng `ToolMessage`?**

Khi bạn dùng `bind_tools()` để cho phép LLM gọi các hàm (tools), LangChain sẽ:

1. **LLM tạo một ToolCall** (ví dụ: gọi hàm `multiply(a=2, b=3)`).
2. Bạn thực thi hàm Python tương ứng.
3. Sau đó, bạn dùng `ToolMessage` để **truyền kết quả trả về của tool đó lại cho LLM**.

**Cú pháp**

```python
from langchain_core.messages import ToolMessage

msg = ToolMessage(tool_call_id="abc123", content="Kết quả là 6")
```

**Các tham số:**

<table class="min-w-full" data-end="1264" data-start="924" id="bkmrk-tham-s%E1%BB%91-%C3%9D-ngh%C4%A9a-tool" style="height: 103px; width: 100%;"><thead data-end="1008" data-start="924"><tr data-end="1008" data-start="924"><th class="align-left" data-end="942" data-start="924" style="width: 49.9405%;">**Tham số**</th><th class="align-left" data-end="1008" data-start="942" style="width: 49.9405%;">**Ý nghĩa**</th></tr></thead><tbody data-end="1264" data-start="1095"><tr data-end="1179" data-start="1095"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1114" data-start="1095" style="width: 49.9405%;">`tool_call_id`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1179" data-start="1114" style="width: 49.9405%;">ID của lời gọi hàm (do `ToolCallMessage` sinh ra)</td></tr><tr data-end="1264" data-start="1180"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1199" data-start="1180" style="width: 49.9405%;">`content`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1264" data-start="1199" style="width: 49.9405%;">Nội dung trả lời (kết quả của tool)</td></tr></tbody></table>

##### **Ví dụ đầy đủ: Gọi hàm nhân trong Python**

**1. Định nghĩa hàm (tool)**

```python
def multiply(a: int, b: int) -> int:
    """Nhân hai số."""
    return a * b
```

**2. Dùng LLM + tool**

```python
from langchain_core.messages import HumanMessage, ToolMessage
from langchain_openai import ChatOpenAI

chat = ChatOpenAI().bind_tools([multiply], parallel_tool_calls=False)
```

**3. LLM đưa ra ToolCall**

```python
messages = [
    HumanMessage(content="Hãy nhân 4 với 5")
]

response = chat.invoke(messages)
tool_call = response.tool_calls[0]
print(tool_call)  # --> thông tin về lời gọi hàm multiply

```

**4. Gửi kết quả về lại cho LLM bằng ToolMessage**

```python
# Gọi hàm thủ công
result = multiply(**tool_call.args)

# Gửi kết quả về lại
followup = chat.invoke([
    response,
    ToolMessage(tool_call_id=tool_call.id, content=str(result))
])

print(followup.content)  # => LLM phản hồi dựa trên kết quả tool
```

## **Quan trọng**

- `ToolMessage` cực kỳ quan trọng khi bạn dùng nhiều bước logic có liên quan đến tool.
- `tool_call_id` phải khớp chính xác với `ToolCallMessage` từ LLM, để LLM biết bạn đang trả lời cho yêu cầu nào.
- Bạn có thể dùng nhiều `ToolMessage` nếu LLM gọi nhiều hàm cùng lúc (nếu `parallel_tool_calls=True`).

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# ToolCall - Mô hình ngôn ngữ gọi đến một công cụ

Trong LangChain, **`ToolCall`** đại diện cho việc **mô hình ngôn ngữ gọi đến một công cụ (function)** để thực hiện một hành động cụ thể.

> Nói cách khác, khi bạn dạy AI cách gọi các hàm Python, thì `ToolCall` là cách mô hình nói: *“Tôi muốn dùng hàm `add(5, 3)` nhé.”*

#### **Tại sao cần `ToolCall`?**

Mô hình ngôn ngữ rất giỏi hiểu và tạo ra văn bản, nhưng lại **không giỏi tính toán, truy vấn API, hoặc thao tác với dữ liệu phức tạp**.  
Khi cần làm những việc như vậy, mô hình sẽ **gọi một “tool”** (được định nghĩa trước bằng Python), thông qua một `ToolCall`.

#### **Cấu trúc cơ bản của `ToolCall`**

```python
from langchain_core.messages import ToolCall

tool_call = ToolCall(
    name="multiply",
    args={"a": 5, "b": 3},
    id="call_123"
)
```

#### Các thành phần:

- `name`: tên hàm (tool) mà AI muốn gọi (giống với tên bạn đăng ký khi dùng `bind_tools`).
- `args`: tham số truyền vào cho hàm đó.
- `id`: mã định danh của tool call (thường là tự sinh).

##### **Ví dụ đầy đủ: Sử dụng `ToolCall` với LLM**

**Bước 1: Định nghĩa công cụ**

```python
def add(a: int, b: int) -> int:
    return a + b
```

**Bước 2: Bind tool vào LLM**

```python
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="gpt-4o")
llm_with_tools = llm.bind_tools([add])

```

**Bước 3: Gửi tin nhắn có yêu cầu tính toán**

```python
from langchain_core.messages import HumanMessage

messages = [HumanMessage(content="Hãy cộng 4 và 7 giúp tôi")]
response = llm_with_tools.invoke(messages)

print(response.tool_calls)  # Đây chính là danh sách ToolCall
```

<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary" id="bkmrk-output-m%E1%BA%ABu%3A"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2">  
</div></div><div class="overflow-y-auto p-4" dir="ltr">**Output mẫu:**</div><div class="overflow-y-auto p-4" dir="ltr">  
</div><div class="overflow-y-auto p-4" dir="ltr">  
</div></div>```
[
    ToolCall(
        name='add',
        args={'a': 4, 'b': 7},
        id='toolu_abc123'
    )
]

```

Tức là mô hình quyết định gọi hàm `add` với a=4, b=7 thông qua ToolCall.

**Tương tác hoàn chỉnh: Gọi Tool và trả lại kết quả**

```python
from langchain_core.messages import AIMessage, ToolMessage

# Gọi hàm add
tool_result = add(4, 7)

# Trả kết quả lại cho AI thông qua ToolMessage
final_response = llm_with_tools.invoke([
    HumanMessage(content="Hãy cộng 4 và 7"),
    AIMessage(tool_calls=[ToolCall(name="add", args={"a": 4, "b": 7}, id="call_1")]),
    ToolMessage(tool_call_id="call_1", content=str(tool_result))
])

print(final_response.content)
```

**Output**

```
Kết quả là 11!
```

**Tóm tắt so sánh**

<table class="min-w-full" data-end="2948" data-start="2551" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-vai-tr%C3%B2-t" style="height: 129px; width: 100%;"><thead data-end="2630" data-start="2551"><tr data-end="2630" data-start="2551"><th data-end="2570" data-start="2551" style="width: 49.9405%;">Thành phần</th><th data-end="2630" data-start="2570" style="width: 49.9405%;">Vai trò</th></tr></thead><tbody data-end="2948" data-start="2711"><tr data-end="2790" data-start="2711"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2730" data-start="2711" style="width: 49.9405%;">`ToolCall`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2790" data-start="2730" style="width: 49.9405%;">Yêu cầu gọi hàm từ mô hình LLM</td></tr><tr data-end="2869" data-start="2791"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2810" data-start="2791" style="width: 49.9405%;">`ToolMessage`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2869" data-start="2810" style="width: 49.9405%;">Trả kết quả từ tool về để LLM tiếp tục xử lý</td></tr><tr data-end="2948" data-start="2870"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2889" data-start="2870" style="width: 49.9405%;">`bind_tools`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2948" data-start="2889" style="width: 49.9405%;">Cho LLM biết có thể gọi những hàm nào</td></tr></tbody></table>

#### **Khi nào cần dùng `ToolCall`?**

- Khi mô hình phải tính toán, xử lý logic cụ thể, hoặc truy vấn dữ liệu thật.
- Khi xây dựng chatbot có khả năng "hành động", như đặt lịch, gọi API, v.v.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Giới thiệu về LangGraph

Dưới đây là một bài viết giới thiệu về **LangGraph**, được trình bày theo kiểu bài viết chia sẻ kiến thức công nghệ, phù hợp cho tài liệu kỹ thuật.

# Giới thiệu về LangGraph

 LangGraph Tạo LLM Workflow dễ dàng như vẽ đồ thị

Trong thời đại của trí tuệ nhân tạo và mô hình ngôn ngữ lớn (LLM), việc xây dựng các workflow phức tạp để xử lý ngôn ngữ tự nhiên đang trở nên ngày càng quan trọng. Tuy nhiên, quản lý các chuỗi tác vụ, rẽ nhánh logic, và vòng lặp trong quá trình tương tác với LLM có thể nhanh chóng trở nên phức tạp. Đây chính là lý do **LangGraph** ra đời.

[![](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/3r2image.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/3r2image.png)

### LangGraph là gì?

**LangGraph** là một thư viện mã nguồn mở được phát triển dựa trên **LangChain**, cho phép bạn xây dựng các **đồ thị trạng thái (stateful graphs)** cho các ứng dụng sử dụng LLM. Thay vì chỉ chạy một chuỗi cố định các bước, LangGraph cho phép bạn xây dựng các quy trình linh hoạt hơn, bao gồm:

- Rẽ nhánh điều kiện (conditional branching)
- Vòng lặp (looping)
- Giao tiếp hai chiều giữa người dùng và LLM
- Quản lý trạng thái qua nhiều bước xử lý

LangGraph mang lại cách tiếp cận **kết hợp giữa Lập trình khai báo(**declarative**) và Lập trình mệnh lệnh(**imperative**)**, giúp bạn dễ dàng hình dung và kiểm soát luồng dữ liệu và trạng thái trong quá trình xử lý.

### Vì sao nên sử dụng LangGraph?

#### Dễ hiểu, dễ hình dung

Bạn xây dựng workflow như một **đồ thị gồm các nút (nodes)**, mỗi nút thực hiện một tác vụ cụ thể, như gọi API, xử lý dữ liệu, tương tác với LLM, hay rẽ nhánh theo điều kiện.

#### Tái sử dụng và mở rộng tốt

Mỗi nút trong LangGraph là một function, nên bạn dễ dàng viết lại, mở rộng hoặc chia sẻ logic giữa các ứng dụng khác nhau.

#### Tích hợp chặt chẽ với LangChain

LangGraph kế thừa sức mạnh từ LangChain nên bạn có thể dễ dàng kết hợp với các **PromptTemplate**, **Agents**, **Memory**, hay **Tools** trong hệ sinh thái LangChain.

---

### Cách hoạt động của LangGraph

Cấu trúc cơ bản của một LangGraph bao gồm:

- **State**: Biến lưu trữ dữ liệu cần thiết trong quá trình chạy đồ thị.
- **Node**: Hàm xử lý dữ liệu (có thể là gọi LLM, tính toán, rẽ nhánh…).
- **Edges**: Kết nối các node theo logic định sẵn.

Ví dụ đơn giản về đồ thị gồm 3 node:

```python
from langgraph.graph import StateGraph, END

# Định nghĩa trạng thái
class MyState(TypedDict):
    input: str
    output: str

# Định nghĩa node
def process_input(state):
    result = state["input"].upper()
    return {"output": result}

# Tạo đồ thị
builder = StateGraph(MyState)
builder.add_node("process", process_input)
builder.set_entry_point("process")
builder.set_finish_point("process", END)
graph = builder.compile()

# Chạy đồ thị
result = graph.invoke({"input": "hello"})
print(result)

```

### Ứng dụng thực tế

LangGraph rất phù hợp cho các bài toán phức tạp với LLM như:

- Chatbot nhiều bước với trạng thái duy trì qua từng lượt chat
- Tóm tắt tài liệu theo yêu cầu với logic tùy chỉnh
- Agent phức tạp với hành vi có điều kiện
- Hệ thống tư vấn, hỏi đáp với nhiều nhánh logic

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Vì sao LangGraph ra đời và Graph có ý nghĩa gì

Khi các ứng dụng xây dựng trên mô hình ngôn ngữ lớn (LLM) ngày càng trở nên phức tạp – từ chatbot đơn giản đến hệ thống tự động hóa tác vụ – thì nhu cầu về **cách điều phối luồng suy nghĩ, trạng thái, và hành động của LLMs** cũng tăng theo.

Đó là lý do vì sao **LangGraph** ra đời.

LangGraph là một **framework kết hợp LLMs với cấu trúc đồ thị trạng thái (stateful graphs)**, giúp tạo ra các ứng dụng có khả năng:

- Gọi nhiều công cụ khác nhau
- Lặp lại hành động nếu cần thiết
- Chuyển hướng luồng xử lý dựa trên kết quả
- Giữ được trạng thái trong suốt quá trình suy luận

## **I. Tại sao lại là LangGraph?**

#### **1. Giới hạn của mô hình agent truyền thống (LangChain Agents)**

Các agents trong LangChain rất linh hoạt, nhưng đôi khi:

- Thiếu khả năng kiểm soát luồng suy luận
- Khó kiểm tra và debug khi có nhiều bước
- Thiếu khả năng giữ trạng thái rõ ràng (statefulness)
- Gặp khó khăn với các vòng lặp (loop), nhánh (branch), hoặc điều kiện lặp lại

Kết quả là khi xây dựng các ứng dụng phức tạp như AutoGPT, trợ lý đa tác vụ, hệ thống hỏi đáp nhiều bước... developer phải viết rất nhiều code xử lý luồng hoặc hack workaround.

#### **2. LangGraph: Giải pháp điều phối LLM theo kiểu đồ thị trạng thái**

LangGraph đưa ra một kiến trúc mới, nơi **quá trình suy nghĩ và hành động của LLM được mô hình hóa như một đồ thị (graph)**.

Mỗi node trong đồ thị:

- Có thể là một hành động cụ thể (gọi API, suy nghĩ, hỏi người dùng…)
- Có thể gọi LLM để đưa ra quyết định chuyển hướng (routing)

####  **Lợi ích chính:**

<table class="min-w-full" data-end="2157" data-start="1768" id="bkmrk-t%C3%ADnh-n%C4%83ng-%C3%9D-ngh%C4%A9a-c%C3%B3" style="height: 173px; width: 98.3333%;"><thead data-end="1791" data-start="1768"><tr data-end="1791" data-start="1768"><th data-end="1780" data-start="1768" style="width: 49.9395%;">Tính năng</th><th data-end="1791" data-start="1780" style="width: 49.9395%;">Ý nghĩa</th></tr></thead><tbody data-end="2157" data-start="1814"><tr data-end="1867" data-start="1814"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1832" data-start="1814" style="width: 49.9395%;">Có trạng thái</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1867" data-start="1832" style="width: 49.9395%;">Lưu giữ thông tin giữa các bước</td></tr><tr data-end="1950" data-start="1868"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1885" data-start="1868" style="width: 49.9395%;">Có vòng lặp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1950" data-start="1885" style="width: 49.9395%;">Hỗ trợ dễ dàng quá trình phản xạ (reflection), retry, sửa lỗi</td></tr><tr data-end="2000" data-start="1951"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1964" data-start="1951" style="width: 49.9395%;">Modular</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2000" data-start="1964" style="width: 49.9395%;">Mỗi node độc lập, dễ tái sử dụng</td></tr><tr data-end="2078" data-start="2001"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2015" data-start="2001" style="width: 49.9395%;">Dễ debug</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2078" data-start="2015" style="width: 49.9395%;">Có thể quan sát từng node và hướng đi trong quá trình xử lý</td></tr><tr data-end="2157" data-start="2079"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2099" data-start="2079" style="width: 49.9395%;">Tùy chọn luồng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2157" data-start="2099" style="width: 49.9395%;">Có thể dùng LLM để quyết định đi hướng nào trong graph</td></tr></tbody></table>

### **II. Tại sao lại dùng từ “Graph”?**

#### **1. Graph = Đồ thị trạng thái có hướng**

LangGraph sử dụng  **lý thuyết đồ thị (directed graph)** như một cách để **mô hình hóa quy trình tư duy** của một agent.

 Trong graph:

- **Node** là một bước trong quy trình (ví dụ: "Phân tích yêu cầu", "Tìm kiếm trên web", "Tóm tắt dữ liệu", "Phản hồi")
- **Edge** là hướng đi từ một bước đến bước kế tiếp, có thể **phụ thuộc vào điều kiện** (ví dụ: nếu LLM nói "Chưa đủ dữ liệu", hãy quay lại bước tìm kiếm)

Graph này **giống như flowchart thông minh**, nhưng được điều khiển bởi LLM.

#### **2. Graph giúp dễ hình dung quy trình phức tạp**

Dưới dạng graph, developer có thể:

- Nhìn thấy toàn bộ hành trình của agent
- Điều chỉnh từng bước mà không ảnh hưởng đến toàn hệ thống
- Thêm logic phức tạp (loop, điều kiện, xử lý lỗi) một cách trực quan

Ví dụ:

```
[User Input]
    ↓
[LLM hiểu yêu cầu]
    ↓
[Chọn hành động] ──→ [Dùng công cụ] ──→ [Tóm tắt kết quả]
    ↑                                  ↓
 [Thiếu dữ liệu?] ←──────[Kiểm tra đủ chưa?]

```

### **III. Khi nào nên dùng LangGraph?**

LangGraph **cực kỳ phù hợp** khi bạn xây dựng:

Multi-step reasoning (suy luận nhiều bước)  
Agents có khả năng reflection / retry / repair  
Workflow có trạng thái (stateful flows)  
Hệ thống cần kiểm soát logic chặt chẽ  
Quy trình có loop, branching hoặc fallback logic

**Ví dụ ứng dụng:**

- Trợ lý hỏi đáp tài liệu nhiều bước (hay bị "không đủ dữ liệu")
- Tác nhân viết báo cáo (chia nhỏ tác vụ và lặp lại từng phần)
- QA system với logic xác minh độ chính xác
- Tác nhân phân tích dữ liệu và tự sửa lỗi truy vấn

<table class="min-w-full" data-end="4139" data-start="3800" id="bkmrk-%E2%9D%93-c%C3%A2u-h%E1%BB%8Fi-%E2%9C%85-tr%E1%BA%A3-l%E1%BB%9Di-"><thead data-end="3825" data-start="3800"><tr data-end="3825" data-start="3800"><th data-end="3812" data-start="3800">❓ Câu hỏi</th><th data-end="3825" data-start="3812">✅ Trả lời</th></tr></thead><tbody data-end="4139" data-start="3852"><tr data-end="3984" data-start="3852"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3876" data-start="3852">**Vì sao LangGraph?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/2)]" data-end="3984" data-start="3876">Vì các ứng dụng LLM ngày càng phức tạp, cần khả năng điều phối, giữ trạng thái, và xử lý logic phức tạp.</td></tr><tr data-end="4139" data-start="3985"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4007" data-start="3985">**Vì sao "Graph"?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/2)]" data-end="4139" data-start="4007">Vì LangGraph mô hình hóa tư duy của agent dưới dạng **đồ thị trạng thái có hướng** — giúp kiểm soát, mở rộng, debug dễ dàng hơn.</td></tr></tbody></table>

# Lập trình khai báo(declarative) và Lập trình mệnh lệnh(imperative)

Lập trình khai báo(declarative) và Lập trình mệnh lệnh(imperative) là hai **phong cách lập trình** khác nhau — chúng phản ánh **cách bạn mô tả công việc mà máy tính cần thực hiện**

### **I. Lập trình khai báo(declarative)** 

- **Bạn nói cho máy tính biết *bạn muốn đạt được gì***.
- Tập trung vào **cái gì** là kết quả cuối cùng.
- Máy tính sẽ tự lo cách thực hiện.

```
# Declarative (giống kiểu functional programming)
result = [x * 2 for x in data if x > 10]

```

Hoặc ví dụ quen thuộc hơn:

```
SELECT * FROM users WHERE age > 18;
```

Bạn không nói “lặp qua từng dòng, kiểm tra tuổi”, mà chỉ nói “hãy lấy dữ liệu theo điều kiện”.

### **II. Lập trình mệnh lệnh(imperative)**

- **Bạn nói cho máy tính biết *từng bước phải làm gì***.
- Tập trung vào **cách** để đạt được mục tiêu.
- Ví dụ: viết một vòng lặp `for`, gọi hàm này rồi hàm kia, kiểm tra điều kiện…
    
     ```
    # Imperative
    result = []
    for x in data:
        if x > 10:
            result.append(x * 2)
    
    ```
    
    Bạn phải quản lý từng bước cụ thể.

### **III. Trong LangGraph thì sao?**

LangGraph **kết hợp cả hai phong cách**:

- Bạn **khai báo các node và mối quan hệ giữa chúng** (kiểu **Lập trình khai báo(declarative)**  – giống vẽ sơ đồ luồng).
- Nhưng bên trong mỗi node, bạn viết **các bước cụ thể xử lý dữ liệu** (kiểu **Lập trình mệnh lệnh(imperative)** – như viết hàm bình thường).

 Ví dụ:

```
builder.add_node("process", process_input)  # declarative
def process_input(state):                   # imperative
    return {"output": state["input"].upper()}

```

### Tóm lại:

LangGraph giúp bạn tận dụng **sức mạnh kết hợp**: vừa dễ hình dung (declarative), vừa dễ điều khiển (imperative).

<div class="tableContainer horzScrollShadows" id="bkmrk-phong-c%C3%A1ch-b%E1%BA%A1n-m%C3%B4-t%E1%BA%A3"><table class="min-w-full" data-end="2128" data-start="1656"><thead data-end="1772" data-start="1656"><tr data-end="1772" data-start="1656"><th data-end="1675" data-start="1656">Phong cách</th><th data-end="1711" data-start="1675">Bạn mô tả...</th><th data-end="1741" data-start="1711">Ưu điểm</th><th data-end="1772" data-start="1741">Nhược điểm</th></tr></thead><tbody data-end="2128" data-start="1892"><tr data-end="2010" data-start="1892"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1911" data-start="1892">Imperative</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1947" data-start="1911">CÁCH máy tính phải làm</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1977" data-start="1947">Kiểm soát chi tiết</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2010" data-start="1977">Dễ rối với quy trình phức tạp</td></tr><tr data-end="2128" data-start="2011"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2030" data-start="2011">Declarative</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2066" data-start="2030">CÁI GÌ bạn muốn đạt được</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2096" data-start="2066">Gọn, dễ hiểu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2128" data-start="2096">Khó kiểm soát từng bước nhỏ</td></tr></tbody></table>

</div>Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")

# So sánh LangGraph và LangChain

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/zXIimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/zXIimage.png)

Với sự phát triển nhanh chóng của các mô hình ngôn ngữ lớn như GPT, Claude, Mistral..., các thư viện như **LangChain** và **LangGraph** ra đời để giúp lập trình viên dễ dàng xây dựng ứng dụng sử dụng LLM. Nhưng giữa hai cái tên quen thuộc này, bạn nên chọn cái nào? Hoặc khi nào nên dùng cả hai?

Bài viết này sẽ giúp bạn hiểu rõ **sự khác biệt, điểm mạnh, và cách sử dụng** của **LangChain** và **LangGraph**.

### I. Tổng quan

<div class="tableContainer horzScrollShadows" id="bkmrk-%C4%90%E1%BA%B7c-%C4%91i%E1%BB%83m-langchain-l"><table class="min-w-full" data-end="1543" data-start="687" style="width: 99.6429%;"><thead data-end="792" data-start="687"><tr data-end="792" data-start="687"><th data-end="705" data-start="687" style="width: 17.4583%;">Đặc điểm</th><th data-end="745" data-start="705" style="width: 36.2949%;">**LangChain**</th><th data-end="792" data-start="745" style="width: 46.4023%;">**LangGraph**</th></tr></thead><tbody data-end="1543" data-start="899"><tr data-end="1007" data-start="899"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="917" data-start="899" style="width: 17.4583%;">Mục tiêu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="958" data-start="917" style="width: 36.2949%;">Tạo **pipeline** (chuỗi) LLM logic</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1007" data-start="958" style="width: 46.4023%;">Tạo **workflow** (đồ thị trạng thái) phức tạp</td></tr><tr data-end="1114" data-start="1008"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1026" data-start="1008" style="width: 17.4583%;">Cấu trúc</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1067" data-start="1026" style="width: 36.2949%;">Tuyến tính (linear chain / agent)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1114" data-start="1067" style="width: 46.4023%;">Đồ thị trạng thái có vòng lặp, rẽ nhánh</td></tr><tr data-end="1222" data-start="1115"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1133" data-start="1115" style="width: 17.4583%;">Mô hình dữ liệu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1174" data-start="1133" style="width: 36.2949%;">Stateless (không lưu trạng thái)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1222" data-start="1174" style="width: 46.4023%;">Stateful (quản lý trạng thái qua nhiều bước)</td></tr><tr data-end="1329" data-start="1223"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1241" data-start="1223" style="width: 17.4583%;">Tích hợp LLM</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1282" data-start="1241" style="width: 36.2949%;">Rất mạnh, nhiều tools tích hợp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1329" data-start="1282" style="width: 46.4023%;">Kế thừa từ LangChain</td></tr><tr data-end="1436" data-start="1330"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1348" data-start="1330" style="width: 17.4583%;">Độ linh hoạt</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1389" data-start="1348" style="width: 36.2949%;">Cao với chuỗi đơn giản hoặc agents</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1436" data-start="1389" style="width: 46.4023%;">Rất cao với workflow phức tạp</td></tr><tr data-end="1543" data-start="1437"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1455" data-start="1437" style="width: 17.4583%;">Sử dụng chính</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1496" data-start="1455" style="width: 36.2949%;">Chatbot, Q&amp;A, Retrieval, Agents</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1543" data-start="1496" style="width: 46.4023%;">Bot đa bước, phân nhánh logic, memory flows</td></tr></tbody></table>

</div>### II. Kiến trúc hoạt động

#### **LangChain**

LangChain cung cấp một tập hợp các **abstractions** như:

- `LLMChain`: Gọi một LLM với prompt
- `Chain`: Kết hợp nhiều bước xử lý nối tiếp nhau
- `Agent`: Cho phép mô hình quyết định hành động tiếp theo
- `Memory`: Lưu trạng thái cuộc hội thoại tạm thời

Mỗi chain là **tuyến tính** — dữ liệu đi từ đầu đến cuối qua từng bước.

**Ưu điểm**: Dễ dùng, dễ hiểu, setup nhanh.  
**Nhược điểm**: Hạn chế khi bạn muốn rẽ nhánh, lặp lại, hoặc xử lý logic phức tạp.

#### **LangGraph**

LangGraph đưa kiến trúc lên tầm cao hơn: bạn không chỉ nối các bước, bạn **vẽ ra một đồ thị trạng thái**. Trong đó:

- Mỗi node là một bước xử lý
- Bạn có thể rẽ nhánh tùy vào điều kiện
- Có thể lặp lại một node hoặc quay lại node trước
- **Trạng thái được lưu và truyền qua toàn bộ đồ thị**

LangGraph kế thừa toàn bộ các công cụ từ LangChain như `LLMChain`, `PromptTemplate`, `Tool`, `Memory`, `Agent`,… nhưng nâng cấp khả năng tổ chức luồng xử lý lên **mức workflow engine**.

**Ưu điểm**: Xử lý logic phức tạp, hỗ trợ đa chiều, có vòng lặp.  
**Nhược điểm**: Khó hơn để bắt đầu, yêu cầu hiểu về state và luồng.

### III. Khi nào dùng LangChain?

Dùng **LangChain** khi bạn:

- Chỉ cần chạy một chuỗi các bước (pipeline)
- Viết một chatbot đơn giản
- Làm Q&amp;A với Retriever
- Gọi LLM để xử lý văn bản đầu vào và trả lại đầu ra ngay lập tức
- Không cần quản lý nhiều trạng thái phức tạp

**Ví dụ**: Lấy nội dung từ một file, tóm tắt nó bằng GPT, rồi gửi email.

## IV. Khi nào dùng LangGraph?

Dùng **LangGraph** khi bạn:

- Cần xây dựng các **hệ thống xử lý nhiều bước có rẽ nhánh**
- Muốn xây chatbot đa luồng hội thoại (conversation flows)
- Có logic phức tạp: vòng lặp, kiểm tra điều kiện, lùi lại bước trước
- Quản lý trạng thái giữa nhiều bước, hoặc muốn lưu vào database
- Xây dựng agent với logic phức tạp hơn `ReAct`

**Ví dụ**:  
Hệ thống kiểm tra đơn hàng:

1. Người dùng gửi mã đơn →
2. Hệ thống kiểm tra trạng thái đơn →
3. Nếu đơn đang giao: gửi thông báo;
4. Nếu đơn bị huỷ: hỏi lý do → ghi log → gửi xác nhận.

Bạn khó làm điều này gọn gàng với LangChain, nhưng **LangGraph làm rất tốt**.

## V. Có thể dùng kết hợp không?

**Hoàn toàn có thể!**  
LangGraph thực tế **được xây dựng trên nền LangChain**, nên bạn có thể dùng `LLMChain`, `RetrievalChain`, `Agents`, `PromptTemplate` bên trong các node của LangGraph.

**Ví dụ**: Một node trong đồ thị LangGraph có thể gọi một LangChain Agent để xử lý một phần công việc.

### VI. So sánh ngắn gọn qua ví dụ

 **LangChain (linear):**

```
chain = SimpleSequentialChain(chains=[chain1, chain2])
result = chain.run("Hello world")

```

**LangGraph (graph):**

```
builder = StateGraph()
builder.add_node("step1", step1)
builder.add_node("step2", step2)
builder.add_edge("step1", "step2")
builder.set_entry_point("step1")
graph = builder.compile()
graph.invoke({"input": "Hello world"})

```

### VII. Kết luận

<table class="min-w-full" data-end="4931" data-start="4511" id="bkmrk-n%E1%BA%BFu-b%E1%BA%A1n-c%E1%BA%A7n...-h%C3%A3y-c" style="width: 100.357%; height: 195.578px;"><thead data-end="4571" data-start="4511"><tr data-end="4571" data-start="4511" style="height: 29.7969px;"><th data-end="4553" data-start="4511" style="width: 70.1711%; height: 29.7969px;">Nếu bạn cần...</th><th data-end="4571" data-start="4553" style="width: 29.8289%; height: 29.7969px;">Hãy chọn...</th></tr></thead><tbody data-end="4931" data-start="4632"><tr data-end="4691" data-start="4632" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4673" data-start="4632" style="width: 70.1711%; height: 29.7969px;">Xây dựng nhanh một chuỗi xử lý</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4691" data-start="4673" style="width: 29.8289%; height: 29.7969px;">🟢 LangChain</td></tr><tr data-end="4751" data-start="4692" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4733" data-start="4692" style="width: 70.1711%; height: 29.7969px;">Quản lý nhiều trạng thái phức tạp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4751" data-start="4733" style="width: 29.8289%; height: 29.7969px;">🟢 LangGraph</td></tr><tr data-end="4811" data-start="4752" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4793" data-start="4752" style="width: 70.1711%; height: 29.7969px;">Làm chatbot đơn giản</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4811" data-start="4793" style="width: 29.8289%; height: 29.7969px;">🟢 LangChain</td></tr><tr data-end="4871" data-start="4812" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4853" data-start="4812" style="width: 70.1711%; height: 29.7969px;">Làm agent với hành vi linh hoạt</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4871" data-start="4853" style="width: 29.8289%; height: 29.7969px;">🟢 LangGraph</td></tr><tr data-end="4931" data-start="4872" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4913" data-start="4872" style="width: 70.1711%; height: 46.5938px;">Kết hợp các công cụ và logic rẽ nhánh</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4931" data-start="4913" style="width: 29.8289%; height: 46.5938px;">🟢 LangGraph</td></tr></tbody></table>

Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")

# Tác nhân điều phối(Agentic) trong ứng dụng mô hình ngôn ngữ lớn (LLMs)

Với sự phát triển mạnh mẽ của các mô hình ngôn ngữ lớn (LLMs), chúng ta có thể xây dựng nhiều loại ứng dụng khác nhau. Trong đó, hai hướng tiếp cận nổi bật là:

- **Non-Agentic LLM Apps** – ứng dụng không có tác nhân điều phối
- **Agentic LLM Apps** – ứng dụng có "tác nhân" (agent) tự điều phối hành động

Vậy đâu là sự khác biệt, điểm mạnh – điểm yếu, và bạn nên chọn loại nào cho dự án của mình?

## I. Định nghĩa

#### 1. Non-Agentic LLM App là gì?

Đây là các ứng dụng **chạy theo logic tuyến tính**, được xác định rõ ràng. Mỗi bước được lập trình cụ thể, LLM chỉ làm từng nhiệm vụ một cách tường minh.

 **Đặc điểm:**

- Không có khả năng tự ra quyết định.
- Luồng xử lý cố định.
- Phù hợp với các tác vụ đơn giản, lặp lại.

**Ví dụ**:

- Tóm tắt văn bản.
- Dịch ngôn ngữ.
- Chatbot hỗ trợ theo kịch bản cố định.
- Lấy dữ liệu từ cơ sở kiến thức rồi trả lời.

```
summary = llm("Tóm tắt đoạn văn sau...")

```

#### 2. Agentic LLM App là gì?

Là ứng dụng mà trong đó **LLM hoạt động như một "agent" (tác nhân)** — có khả năng:

- **Ra quyết định**
- **Lập kế hoạch**
- **Chọn công cụ phù hợp để thực thi nhiệm vụ**
- **Tự kiểm tra lại kết quả** và tiếp tục cho đến khi hoàn thành

**Đặc điểm:**

- Có khả năng tư duy nhiều bước.
- Có thể gọi nhiều công cụ khác nhau.
- Tự động hóa quy trình phức tạp.

**Ví dụ**:

- Một trợ lý AI có thể:
    
    
    - Tìm kiếm trên Google,
    - Lấy dữ liệu từ API,
    - Phân tích dữ liệu,
    - Gửi email báo cáo → mà bạn chỉ cần ra lệnh: **“Tóm tắt số liệu bán hàng tuần này và gửi qua email cho sếp.”**

### **II. So sánh chi tiết**

<div class="tableContainer horzScrollShadows" id="bkmrk-%C4%90%E1%BA%B7c-%C4%91i%E1%BB%83m-non-agentic"><table class="min-w-full" data-end="3251" data-start="1825"><thead data-end="1966" data-start="1825"><tr data-end="1966" data-start="1825"><th data-end="1859" data-start="1825">Đặc điểm</th><th data-end="1909" data-start="1859">**Non-Agentic**</th><th data-end="1966" data-start="1909">**Agentic**</th></tr></thead><tbody data-end="3251" data-start="2111"><tr data-end="2253" data-start="2111"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2145" data-start="2111">Mục tiêu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2196" data-start="2145">Xử lý 1 nhiệm vụ đơn giản hoặc theo kịch bản</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2253" data-start="2196">Tự động hóa nhiều bước, xử lý tác vụ mở</td></tr><tr data-end="2395" data-start="2254"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2288" data-start="2254">Luồng xử lý</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2338" data-start="2288">Tuyến tính, xác định trước</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2395" data-start="2338">Rẽ nhánh, điều kiện, có thể điều phối vòng lặp</td></tr><tr data-end="2538" data-start="2396"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2430" data-start="2396">Khả năng lập kế hoạch</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2481" data-start="2430">❌ Không</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2538" data-start="2481">**Có (có thể lên kế hoạch và thực thi từng bước)**</td></tr><tr data-end="2680" data-start="2539"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2572" data-start="2539">Khả năng chọn công cụ phù hợp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2623" data-start="2572">❌ Không</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2680" data-start="2623">**Có thể chọn tool/action phù hợp theo ngữ cảnh**</td></tr><tr data-end="2824" data-start="2681"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2715" data-start="2681">Tính linh hoạt</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2766" data-start="2715">Trung bình – cao</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2824" data-start="2766">Rất cao</td></tr><tr data-end="2966" data-start="2825"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2858" data-start="2825">Dễ debug, kiểm soát</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2909" data-start="2858"> **Rất dễ**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2966" data-start="2909">❌ Phức tạp hơn do có hành vi tự động</td></tr><tr data-end="3110" data-start="2967"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3001" data-start="2967">Hiệu suất</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3052" data-start="3001">Nhanh hơn, ít token hơn</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3110" data-start="3052">Chậm hơn, tốn token hơn do phải lập kế hoạch</td></tr><tr data-end="3251" data-start="3111"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3144" data-start="3111">Khả năng sử dụng thực tế</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3194" data-start="3144">Rất tốt với quy trình ổn định</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3251" data-start="3194">Tốt với quy trình phức tạp hoặc cần tự thích nghi</td></tr></tbody></table>

</div>### 3. Minh họa đơn giản

#### Tác vụ: “Hãy tìm thông tin về Elon Musk và tóm tắt”

#### **Non-Agentic:**

- Gửi prompt: “Tóm tắt thông tin về Elon Musk”
- GPT trả lời bằng những gì đã học.

#### **Agentic:**

- Agent tự chọn hành động:
    
    
    1. Gọi công cụ `WebSearch`
    2. Lấy 3 kết quả đầu
    3. Tóm tắt chúng
    4. Kiểm tra nếu có thông tin mới → bổ sung → xuất bản kết quả

### **4. Công nghệ hỗ trợ**

<div class="tableContainer horzScrollShadows" id="bkmrk-t%C3%ADnh-n%C4%83ng-non-agenti"><table class="min-w-full" data-end="4280" data-start="3657" style="width: 100.952%; height: 182.578px;"><thead data-end="3760" data-start="3657"><tr data-end="3760" data-start="3657" style="height: 29.7969px;"><th data-end="3688" data-start="3657" style="width: 28.0193%; height: 29.7969px;">Tính năng</th><th data-end="3719" data-start="3688" style="width: 28.8245%; height: 29.7969px;">Non-Agentic</th><th data-end="3760" data-start="3719" style="width: 43.1562%; height: 29.7969px;">Agentic</th></tr></thead><tbody data-end="4280" data-start="3865"><tr data-end="3968" data-start="3865" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3895" data-start="3865" style="width: 28.0193%; height: 46.5938px;">Thư viện phổ biến</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3926" data-start="3895" style="width: 28.8245%; height: 46.5938px;">LangChain, Transformers</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3968" data-start="3926" style="width: 43.1562%; height: 46.5938px;">LangChain Agents, LangGraph, AutoGPT</td></tr><tr data-end="4071" data-start="3969" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3999" data-start="3969" style="width: 28.0193%; height: 46.5938px;">Công cụ gọi ngoài (Tools)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4030" data-start="3999" style="width: 28.8245%; height: 46.5938px;">Có, nhưng gọi tường minh</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4071" data-start="4030" style="width: 43.1562%; height: 46.5938px;">LLM tự chọn công cụ thông minh</td></tr><tr data-end="4175" data-start="4072" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4102" data-start="4072" style="width: 28.0193%; height: 29.7969px;">Bộ nhớ (Memory)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4133" data-start="4102" style="width: 28.8245%; height: 29.7969px;">Đơn giản hoặc không có</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4175" data-start="4133" style="width: 43.1562%; height: 29.7969px;">Quan trọng để theo dõi trạng thái</td></tr><tr data-end="4280" data-start="4176" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4206" data-start="4176" style="width: 28.0193%; height: 29.7969px;">Loop / Retry logic</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4238" data-start="4206" style="width: 28.8245%; height: 29.7969px;">Phải lập trình thủ công</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4280" data-start="4238" style="width: 43.1562%; height: 29.7969px;">Agent có thể tự thực hiện</td></tr></tbody></table>

</div>### **5. Khi nào nên dùng loại nào?**

<div class="tableContainer horzScrollShadows" id="bkmrk-tr%C6%B0%E1%BB%9Dng-h%E1%BB%A3p-n%C3%AAn-ch%E1%BB%8Dn-"><table class="min-w-full" data-end="5131" data-start="4324" style="width: 100.357%;"><thead data-end="4424" data-start="4324"><tr data-end="4424" data-start="4324"><th class="align-left" data-end="4377" data-start="4324" style="width: 71.9807%;">**Trường hợp**</th><th class="align-left" data-end="4424" data-start="4377" style="width: 28.0193%;">**Nên chọn**</th></tr></thead><tbody data-end="5131" data-start="4526"><tr data-end="4626" data-start="4526"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="4579" data-start="4526" style="width: 71.9807%;">Xử lý một bước (dịch, tóm tắt, phân loại)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4626" data-start="4579" style="width: 28.0193%;">✅ Non-Agentic</td></tr><tr data-end="4727" data-start="4627"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4680" data-start="4627" style="width: 71.9807%;">Luồng cố định, logic rõ ràng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4727" data-start="4680" style="width: 28.0193%;">✅ Non-Agentic</td></tr><tr data-end="4828" data-start="4728"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4781" data-start="4728" style="width: 71.9807%;">Tác vụ phức tạp, cần suy luận nhiều bước</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4828" data-start="4781" style="width: 28.0193%;">✅ Agentic</td></tr><tr data-end="4929" data-start="4829"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="4882" data-start="4829" style="width: 71.9807%;">Cần tương tác nhiều hệ thống / API / Tool</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4929" data-start="4882" style="width: 28.0193%;">✅ Agentic</td></tr><tr data-end="5030" data-start="4930"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="4983" data-start="4930" style="width: 71.9807%;">Trợ lý AI hoặc hệ thống hỗ trợ quyết định</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5030" data-start="4983" style="width: 28.0193%;">✅ Agentic</td></tr><tr data-end="5131" data-start="5031"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="5084" data-start="5031" style="width: 71.9807%;">Ưu tiên tốc độ, đơn giản, tiết kiệm tài nguyên</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5131" data-start="5084" style="width: 28.0193%;">✅ Non-Agentic</td></tr></tbody></table>

</div>### 6. Tổng kết

<table class="min-w-full" data-end="6082" data-start="5157" id="bkmrk-ti%C3%AAu-ch%C3%AD-non-agentic" style="width: 100%;"><thead data-end="5271" data-start="5157"><tr data-end="5271" data-start="5157"><th data-end="5178" data-start="5157" style="width: 33.7469%;">Tiêu chí</th><th data-end="5224" data-start="5178" style="width: 32.2581%;">**Non-Agentic App**</th><th data-end="5271" data-start="5224" style="width: 33.995%;">**Agentic App**</th></tr></thead><tbody data-end="6082" data-start="5387"><tr data-end="5502" data-start="5387"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5409" data-start="5387" style="width: 33.7469%;">Đơn giản</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5455" data-start="5409" style="width: 32.2581%;">✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5502" data-start="5455" style="width: 33.995%;">❌ (phức tạp hơn)</td></tr><tr data-end="5618" data-start="5503"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5525" data-start="5503" style="width: 33.7469%;">Linh hoạt</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5571" data-start="5525" style="width: 32.2581%;">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5618" data-start="5571" style="width: 33.995%;">✅</td></tr><tr data-end="5734" data-start="5619"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5641" data-start="5619" style="width: 33.7469%;">Tự chủ</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5687" data-start="5641" style="width: 32.2581%;">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5734" data-start="5687" style="width: 33.995%;">✅</td></tr><tr data-end="5850" data-start="5735"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5757" data-start="5735" style="width: 33.7469%;">Dễ kiểm soát</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5803" data-start="5757" style="width: 32.2581%;">✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5850" data-start="5803" style="width: 33.995%;">❌</td></tr><tr data-end="5966" data-start="5851"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5873" data-start="5851" style="width: 33.7469%;">Tác vụ phức tạp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5919" data-start="5873" style="width: 32.2581%;">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5966" data-start="5919" style="width: 33.995%;">✅</td></tr><tr data-end="6082" data-start="5967"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="5989" data-start="5967" style="width: 33.7469%;">Sử dụng tool ngoài</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="6035" data-start="5989" style="width: 32.2581%;">Có nhưng hạn chế</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="6082" data-start="6035" style="width: 33.995%;">Mạnh mẽ, linh hoạt</td></tr></tbody></table>

Không có lựa chọn "tốt hơn tuyệt đối" — bạn cần chọn dựa trên **mức độ phức tạp của bài toán**, khả năng chấp nhận rủi ro, và yêu cầu logic xử lý.

- Nếu bạn đang **xây chatbot trả lời kiến thức công ty**, hãy bắt đầu với **Non-Agentic**.
- Nếu bạn muốn một **trợ lý AI làm việc như con người**, thì **Agentic** là tương lai.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Cấp độ hành vi của tác nhân(Agentic) trong ứng dụng LLM

![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/E5ximage.png)

**LLMs** như GPT, Claude, hay Gemini, ngày càng nhiều ứng dụng được xây dựng theo kiến trúc **agentic** – tức là cho phép mô hình **"suy nghĩ"**, **lập kế hoạch**, và **tự ra quyết định**. Nhưng không phải ứng dụng nào cũng cần mức độ agentic giống nhau.

Vì vậy, khái niệm Cấp độ hành vi của tác nhân(**Degrees of Agentic Behavior)** ra đời – mô tả các **cấp độ từ đơn giản đến phức tạp** mà một hệ thống có thể thể hiện hành vi như một tác nhân (agent).

## Agentic Behavior là gì?

"Agentic behavior" đề cập đến **khả năng hành động một cách có mục đích** của mô hình – không chỉ trả lời từng lệnh một, mà còn:

- Lập kế hoạch hành động
- Chọn công cụ phù hợp
- Gọi nhiều hành động kế tiếp
- Đánh giá lại kết quả
- Điều chỉnh chiến lược

Ví dụ, thay vì chỉ trả lời “không biết”, một agentic app có thể:

> “Tôi không có thông tin trong cơ sở dữ liệu. Tôi sẽ tìm kiếm trên web, tóm tắt, rồi trình bày kết quả.”

## 5 Cấp độ Hành vi Agentic (Degrees of Agentic Behavior)

Chúng ta có thể chia hành vi agentic thành **năm cấp độ**, từ đơn giản (non-agentic) đến phức tạp (autonomous agents):

---

#### **Level 0 – **Không có hành vi tác nhân(**Non-Agentic)**

🔹 Chỉ thực hiện một hành động theo prompt đã lập trình sẵn.  
🔹 Không có logic điều phối, không lập kế hoạch.

*Ví dụ*:

```
response = llm("Hãy tóm tắt đoạn văn sau...")

```

Dùng cho:

- Tóm tắt, dịch, phân loại
- Chatbot trả lời trực tiếp

#### **Level 1 – Tăng cường bằng công cụ - Sử dụng công cụ một bước(Tool-Enhanced - Single-step Tool Use)**

🔹 Ứng dụng có thể sử dụng **một công cụ bên ngoài**, nhưng người lập trình phải chỉ định rõ **khi nào dùng tool nào**.

*Ví dụ*:

```
if "search" in user_input:
    result = web_search_tool(query)
else:
    result = llm(user_input)

```

Dùng cho:

- Tìm kiếm trên web theo trigger
- Trích xuất dữ liệu từ cơ sở kiến thức

---

#### **Level 2 – Các tác nhân phản ứng - Sử dụng công cụ động(Reactive Agents - Dynamic Tool Use)**

🔹 LLM **tự quyết định khi nào cần dùng công cụ nào**  
🔹 Các công cụ (tools) được mô tả bằng prompt hoặc API  
🔹 LLM chọn hành động tốt nhất dựa trên ngữ cảnh hiện tại

*Ví dụ*: LLM tự chọn `Calculator` để tính toán thay vì chỉ đoán kết quả.

Dùng LangChain Agents, OpenAI Function Calling, hoặc LangGraph Nodes.

Dùng cho:

- Trợ lý cá nhân AI có khả năng tìm kiếm, phân tích, tóm tắt
- Chatbot hiểu ngữ cảnh và chọn hành động phù hợp

---

#### **Level 3 – Các tác nhân t**ự phản hồi hoặc thực hiện vòng lặp (**Reflective / Iterative)**

🔹 Agent có khả năng **tự phản hồi (self-reflect)** và thực hiện **vòng lặp xử lý** đến khi đạt được mục tiêu  
🔹 Có thể lập kế hoạch, thực hiện hành động, kiểm tra lại, và sửa lỗi

*Ví dụ*:

```
if "search" in user_input:
    result = web_search_tool(query)
else:
    result = llm(user_input)

```

Dùng **Looping Graphs** trong LangGraph hoặc Agent Executors có khả năng hồi quy.

Dùng cho:

- Tác vụ đòi hỏi tư duy nhiều bước (multi-step reasoning)
- Tự kiểm tra và cải thiện kết quả

---

#### **Level 4 – Các tác nhân tự chủ đa mục tiêu (Autonomous Multi-goal Agents)**

🔹 Agent có khả năng:

- Nhận mục tiêu tổng quát ("Viết báo cáo thị trường tháng này")
- **Tự chia nhỏ thành các sub-goals**
- **Tự lên kế hoạch**
- **Tự chạy, điều chỉnh, giám sát tiến trình**

*Ví dụ*: AutoGPT, BabyAGI, OpenDevin

Có thể chạy **nhiều vòng lặp**, tự lưu trạng thái và chuyển hướng kế hoạch khi có lỗi.

Dùng cho:

- Quản lý dự án
- Trợ lý lập trình hoặc viết báo cáo tự động
- Tự động hóa tác vụ phức tạp không xác định trước logic

### **So sánh nhanh**

<table class="min-w-full" data-end="4611" data-start="3756" id="bkmrk-c%E1%BA%A5p-%C4%91%E1%BB%99-t%C3%AAn-g%E1%BB%8Di-m%E1%BB%A9c-%C4%91"><thead data-end="3878" data-start="3756"><tr data-end="3878" data-start="3756"><th data-end="3765" data-start="3756">Cấp độ</th><th data-end="3795" data-start="3765">Tên gọi</th><th data-end="3811" data-start="3795">Mức độ tự chủ</th><th data-end="3829" data-start="3811">Có lập kế hoạch</th><th data-end="3850" data-start="3829">Có hành vi phản xạ</th><th data-end="3878" data-start="3850">Dùng cho tác vụ phức tạp</th></tr></thead><tbody data-end="4611" data-start="4005"><tr data-end="4126" data-start="4005"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4014" data-start="4005">0</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4044" data-start="4014">Không có hành vi tác nhân

(Non-agentic)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4059" data-start="4044">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4077" data-start="4059">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4098" data-start="4077">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4126" data-start="4098">❌</td></tr><tr data-end="4248" data-start="4127"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4136" data-start="4127">1</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4166" data-start="4136">Tăng cường bằng công cụ

(Tool-enhanced)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4181" data-start="4166">⬤</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4199" data-start="4181">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4220" data-start="4199">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4248" data-start="4220">❌</td></tr><tr data-end="4370" data-start="4249"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4258" data-start="4249">2</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4288" data-start="4258">Các tác nhân phản ứng

(Reactive agents)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4303" data-start="4288">✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4321" data-start="4303">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4342" data-start="4321">❌</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4370" data-start="4342">✅ (mức vừa)</td></tr><tr data-end="4491" data-start="4371"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4380" data-start="4371">3</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4409" data-start="4380">Các tác nhân tự phản hồi hoặc thực hiện vòng lặp

(Reflective/Iterative agents)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4424" data-start="4409">✅✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4442" data-start="4424">✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4463" data-start="4442">✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4491" data-start="4463">✅✅</td></tr><tr data-end="4611" data-start="4492"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4501" data-start="4492">4</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4531" data-start="4501">Các tác nhân tự chủ đa mục tiêu

(Autonomous agents)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4545" data-start="4531">✅✅✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4563" data-start="4545">✅✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4584" data-start="4563">✅✅</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4611" data-start="4584">✅✅✅</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# LangGraph Studio, giới thiệu, cài đặt và cách dùng

**Giới thiệu LangGraph Studio – Trình quan sát &amp; phát triển Agentic Graphs**

### **I. LangGraph Studio là gì?**

**LangGraph Studio** là một công cụ **giao diện đồ họa (GUI)** giúp bạn:

- Quan sát trực quan đồ thị agent (agent graph)
- Gỡ lỗi (debug) các bước thực thi của LLM agent
- Theo dõi trạng thái, dữ liệu, và hướng đi qua từng node
- Phát triển và kiểm thử agent nhanh chóng

Nó giống như một **"developer console" dành riêng cho LangGraph**, giúp bạn hiểu và kiểm soát quá trình suy luận và hành động của mô hình AI một cách rõ ràng, trực quan.

### **II. Tại sao nên dùng LangGraph Studio?**

<table class="min-w-full" data-end="1155" data-start="754" id="bkmrk-v%E1%BA%A5n-%C4%91%E1%BB%81-khi-kh%C3%B4ng-c%C3%B3-" style="height: 174px; width: 99.5238%;"><thead data-end="808" data-start="754"><tr data-end="808" data-start="754"><th data-end="783" data-start="754" style="width: 49.9402%;">Vấn đề khi không có Studio</th><th data-end="808" data-start="783" style="width: 49.9402%;">LangGraph Studio giúp</th></tr></thead><tbody data-end="1155" data-start="866"><tr data-end="947" data-start="866"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="902" data-start="866" style="width: 49.9402%;">❌ Debug khó vì agent ẩn trong LLM</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="947" data-start="902" style="width: 49.9402%;">Hiển thị chi tiết từng bước, trạng thái</td></tr><tr data-end="1012" data-start="948"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="983" data-start="948" style="width: 49.9402%;">❌ Khó hiểu LLM đang đi hướng nào</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1012" data-start="983" style="width: 49.9402%;">Hiển thị flow trực quan</td></tr><tr data-end="1079" data-start="1013"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1049" data-start="1013" style="width: 49.9402%;">❌ Phát triển agent lặp đi lặp lại</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1079" data-start="1049" style="width: 49.9402%;">Test từng phần trực tiếp</td></tr><tr data-end="1155" data-start="1080"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1107" data-start="1080" style="width: 49.9402%;">❌ Không biết LLM nghĩ gì</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1155" data-start="1107" style="width: 49.9402%;">Hiển thị prompt, output, action, tool dùng</td></tr></tbody></table>

### **III. Cài đặt LangGraph Studio**

LangGraph Studio được tích hợp sẵn trong thư viện `langgraph`. Để cài đặt và sử dụng, bạn chỉ cần:

### 1. Cài đặt thư viện:

```
pip install langgraph[dev]

```

Hoặc nếu bạn đã có `langgraph`:

```
pip install -U "langgraph[dev]"

```

`dev` extras sẽ cài thêm các gói phục vụ cho Studio như `fastapi`, `uvicorn`, `jupyter`, v.v.

### **IV. Cách dùng LangGraph Studio**

LangGraph Studio hiện hỗ trợ **hai cách chính để sử dụng**:

---

#### **1. Chạy dưới dạng local app (FastAPI server)**

Bạn có thể thêm dòng sau vào project của bạn để chạy Studio như một app mini:

```
from langgraph.studio import start_trace_server

start_trace_server()

```

Mặc định server chạy tại `http://localhost:4000`

Khi bạn chạy graph của mình, Studio sẽ tự động ghi lại luồng xử lý, trạng thái, inputs/outputs, và hiển thị trên giao diện web.

#### **2 . Tích hợp trong Jupyter Notebook**

Nếu bạn đang làm việc trong Jupyter (hoặc Google Colab), bạn có thể dùng:

```
from langgraph.studio.jupyter import trace_graph

with trace_graph(graph) as session:
    result = session.invoke(input_data)

```

Tính năng này giúp bạn:

- Thấy flow đồ thị ngay trong notebook
- Click để xem chi tiết từng node, prompt, tool call, response
- So sánh nhiều lần chạy khác nhau (useful for debugging)

```
from langgraph.graph import StateGraph
from langgraph.studio import start_trace_server

# Define some simple node functions
def say_hello(state):
    print("Hello!")
    return state

def ask_name(state):
    state["name"] = "Alice"
    return state

# Build graph
builder = StateGraph(dict)
builder.add_node("hello", say_hello)
builder.add_node("ask", ask_name)
builder.set_entry_point("hello")
builder.add_edge("hello", "ask")

graph = builder.compile()

# Start studio server
start_trace_server()

# Run
graph.invoke({})

```

Khi chạy đoạn code này, bạn có thể truy cập `http://localhost:4000` để thấy luồng `hello → ask` cùng với trạng thái và log chi tiết.

### **VI. Các tính năng nổi bật**

<table class="min-w-full" data-end="3706" data-start="3228" id="bkmrk-t%C3%ADnh-n%C4%83ng-m%C3%B4-t%E1%BA%A3-flow" style="width: 101.31%; height: 208.578px;"><thead data-end="3249" data-start="3228"><tr data-end="3249" data-start="3228" style="height: 29.7969px;"><th data-end="3240" data-start="3228" style="width: 41.2727%; height: 29.7969px;">Tính năng</th><th data-end="3249" data-start="3240" style="width: 58.7273%; height: 29.7969px;">Mô tả</th></tr></thead><tbody data-end="3706" data-start="3271"><tr data-end="3344" data-start="3271" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3292" data-start="3271" style="width: 41.2727%; height: 29.7969px;">Flow Graph View</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3344" data-start="3292" style="width: 58.7273%; height: 29.7969px;">Hiển thị đồ thị agent và luồng thực tế đã đi qua</td></tr><tr data-end="3407" data-start="3345" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3364" data-start="3345" style="width: 41.2727%; height: 29.7969px;">Prompt Viewer</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3407" data-start="3364" style="width: 58.7273%; height: 29.7969px;">Hiển thị đầy đủ prompt mà LLM nhận được</td></tr><tr data-end="3474" data-start="3408" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3430" data-start="3408" style="width: 41.2727%; height: 29.7969px;">Input/Output Log</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3474" data-start="3430" style="width: 58.7273%; height: 29.7969px;">Xem tất cả input và output của từng bước</td></tr><tr data-end="3549" data-start="3475" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3501" data-start="3475" style="width: 41.2727%; height: 29.7969px;">Multi-run Comparison</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3549" data-start="3501" style="width: 58.7273%; height: 29.7969px;">So sánh nhiều phiên bản chạy graph khác nhau</td></tr><tr data-end="3636" data-start="3550" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3586" data-start="3550" style="width: 41.2727%; height: 29.7969px;">Token usage &amp; Cost (tương lai)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3636" data-start="3586" style="width: 58.7273%; height: 29.7969px;">Theo dõi chi phí sử dụng OpenAI, Anthropic,...</td></tr><tr data-end="3706" data-start="3637" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3653" data-start="3637" style="width: 41.2727%; height: 29.7969px;"> Node debug</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3706" data-start="3653" style="width: 58.7273%; height: 29.7969px;">Hiển thị error và traceback nếu có lỗi ở một node</td></tr></tbody></table>

### **VII. Khi nào nên dùng LangGraph Studio?**

- Khi bạn xây dựng agent có nhiều bước
- Khi bạn xử lý luồng có điều kiện, vòng lặp, branch
- Khi cần kiểm soát tool call / prompt / phản hồi
- Khi muốn debug graph state dễ dàng

### **VIII. Tổng kết**

<table class="min-w-full" data-end="4362" data-start="3961" id="bkmrk-c%C3%A2u-h%E1%BB%8Fi-tr%E1%BA%A3-l%E1%BB%9Di-lang"><thead data-end="3982" data-start="3961"><tr data-end="3982" data-start="3961"><th data-end="3971" data-start="3961">Câu hỏi</th><th data-end="3982" data-start="3971">Trả lời</th></tr></thead><tbody data-end="4362" data-start="4004"><tr data-end="4131" data-start="4004"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4034" data-start="4004">**LangGraph Studio là gì?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/2)]" data-end="4131" data-start="4034">Là công cụ GUI để quan sát và phát triển LangGraph Agents một cách trực quan và có thể debug.</td></tr><tr data-end="4235" data-start="4132"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4158" data-start="4132">**Làm gì được với nó?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="4235" data-start="4158">Theo dõi prompt, response, trạng thái, tool call... từng bước trong graph</td></tr><tr data-end="4290" data-start="4236"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4258" data-start="4236">**Cài đặt ra sao?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4290" data-start="4258">`pip install langgraph[dev]`</td></tr><tr data-end="4362" data-start="4291"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="4309" data-start="4291">**Chạy ở đâu?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="4362" data-start="4309">Trong local (FastAPI) hoặc trong Jupyter Notebook</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Tạo ứng dụng cơ bản LangGraph AI Agents.

Tài liệu này sẽ hướng dẫn bạn cách cài đặt dự án và hiểu rõ các thành phần cốt lõi trong một đồ thị (graph).  
Từ đó, bạn có thể dễ dàng tùy chỉnh, mở rộng hoặc tích hợp thêm các công cụ để phù hợp với nhu cầu thực tế.  
Biên soạn bởi:   
Đỗ Ngọc Tú  
CEO [VHTSoft](https://vhtsoft.com "VHTSoft")

# LangGraph: Framework Xây Dựng Ứng Dụng LLM Dựa Trên Agent + Graph

**LangGraph** là một framework mã nguồn mở được xây dựng trên nền tảng của **LangChain**, cho phép bạn phát triển các ứng dụng sử dụng **LLM (Large Language Models)** theo mô hình **agentic** – nơi AI không chỉ trả lời câu hỏi, mà còn **suy luận, quyết định, gọi tool, và ghi nhớ trạng thái** trong nhiều bước.

Điểm đặc biệt của LangGraph là nó tổ chức toàn bộ logic ứng dụng dưới dạng một **đồ thị trạng thái (stateful graph)** – mỗi "node" là một hành động, một agent, hoặc một bước xử lý.

## Tại sao cần LangGraph?

Các ứng dụng AI ngày nay không chỉ dừng ở hỏi-đáp đơn lẻ. Chúng cần:

- Gọi nhiều công cụ (tool use)
- Ghi nhớ trạng thái để suy luận liên tục
- Lặp lại hành động hoặc rẽ nhánh theo kết quả
- Kiểm soát logic phức tạp có điều kiện

LangGraph giúp bạn làm tất cả điều đó **một cách có cấu trúc, dễ theo dõi và mở rộng.**

---

## LangGraph hoạt động như thế nào?

LangGraph xây dựng ứng dụng theo mô hình **Finite-State Machine (FSM)**:

- **Mỗi node** là một bước xử lý (ví dụ: gọi LLM, tìm kiếm, phân tích, v.v.)
- **State** là dữ liệu được lưu và truyền qua từng bước
- **Edge** quyết định luồng đi tiếp theo dựa trên kết quả hoặc trạng thái

Bạn có thể tạo các ứng dụng như:

- Chatbot thông minh
- Multi-tool agent (Google + Calculator + Document Retriever…)
- Workflow phân tích dữ liệu
- Trợ lý quy trình nghiệp vụ (ERP, CRM…)

### Cú pháp cơ bản

```
from langgraph.graph import StateGraph

def greet(state): print("Hello!"); return state
def ask_name(state): state["name"] = "Alice"; return state

builder = StateGraph(dict)
builder.add_node("greet", greet)
builder.add_node("ask", ask_name)
builder.set_entry_point("greet")
builder.add_edge("greet", "ask")

graph = builder.compile()
graph.invoke({})

```

# 5 Khái Niệm Trụ Cột

LangGraph là một framework mạnh mẽ để xây dựng các ứng dụng LLM có logic phức tạp theo mô hình **graph-based agent**. Để làm chủ LangGraph, bạn cần hiểu rõ 5 thành phần chính: **State**, **Schema**, **Node**, **Edge**, và **Compile**.

#### **1. State = Memory (Trạng thái là bộ nhớ)**

Trong LangGraph, **State** là nơi lưu trữ toàn bộ thông tin mà ứng dụng của bạn cần ghi nhớ trong suốt quá trình chạy.

- Nó có thể chứa input từ người dùng, kết quả từ LLM, thông tin truy xuất từ tool, v.v.
- Mỗi node trong graph có thể **đọc và ghi vào state**.
- State giúp ứng dụng **suy nghĩ nhiều bước**, ghi nhớ dữ kiện, và sử dụng lại ở bước sau.

**Ví dụ:**

```python
{"question": "Chủ tịch nước Việt Nam là ai?", "llm_response": "..." }
```

State giống như **RAM** của agent – càng tổ chức tốt, agent càng thông minh và hiệu quả.

#### **2. Schema = Data Format (Định dạng dữ liệu)**

LangGraph yêu cầu bạn **định nghĩa Schema cho State** để đảm bảo dữ liệu được quản lý nhất quán, an toàn và rõ ràng.

- Schema là một **class Python** (thường dùng `pydantic.BaseModel` hoặc `TypedDict`)
- Nó xác định rõ những gì tồn tại trong state, loại dữ liệu, và bắt buộc hay không.

**Ví dụ:**

```python
from typing import TypedDict

class MyState(TypedDict):
    question: str
    answer: str

```

**Schema = **bản thiết kế dữ liệu**, giúp bạn tránh lỗi, dễ debug và mở rộng.**

#### **3. Node = Step (Một bước xử lý)**

**Node** là một bước trong đồ thị – nơi một phần công việc được thực hiện.

- Có thể là một LLM call, một hành động với tool, một quyết định logic, v.v.
- Mỗi node nhận `state`, xử lý và trả lại `state` đã được cập nhật.

**Ví dụ node đơn giản:**

```python
def call_llm(state):
    response = llm.invoke(state["question"])
    state["answer"] = response
    return state

```

#### **4. Edge = Kết nối giữa các bước(**Operation Between Steps**)**

**Edge** là mối liên kết giữa các node – giúp bạn định nghĩa luồng đi của chương trình.

- Một node có thể có **nhiều edge** đi tới các bước khác nhau (ví dụ dựa vào kết quả).
- Có thể định nghĩa **logic rẽ nhánh (branching)**, **lặp lại (loop)** hoặc **kết thúc** tại đây.

**Ví dụ:**

```python
graph.add_edge("ask_user", "call_llm")
graph.add_conditional_edges("call_llm", {
    "need_more_info": "search_tool",
    "done": END
})

```

**Edge quyết định **luồng suy nghĩ** và **logic quyết định** của agent.**

#### **5. Compile = Đóng gói đồ thị để sử dụng**(Pack)

Sau khi bạn đã định nghĩa đầy đủ các **node, edge và schema**, bước cuối cùng là **compile** – để tạo ra một graph sẵn sàng chạy.

- `compile()` sẽ kiểm tra sự nhất quán, ràng buộc, và đóng gói toàn bộ graph.
- Sau đó, bạn có thể dùng `.invoke()` để chạy agent một cách mượt mà.

**Ví dụ:**

```python
builder = StateGraph(MyState)
# add node, edge...
graph = builder.compile()
graph.invoke({"question": "..."})

```

Compile = **chuyển bản thiết kế sang sản phẩm hoàn chỉnh có thể vận hành.**

**Tóm lại**

<table class="min-w-full" data-end="3848" data-start="3275" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-vai-tr%C3%B2-v" style="width: 100.357%; height: 178.781px;"><thead data-end="3315" data-start="3275"><tr data-end="3315" data-start="3275" style="height: 29.7969px;"><th data-end="3288" data-start="3275" style="width: 13.1429%; height: 29.7969px;">Thành phần</th><th data-end="3298" data-start="3288" style="width: 42.8571%; height: 29.7969px;">Vai trò</th><th data-end="3315" data-start="3298" style="width: 44.1429%; height: 29.7969px;">Ví dụ dễ hiểu</th></tr></thead><tbody data-end="3848" data-start="3358"><tr data-end="3449" data-start="3358" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3371" data-start="3358" style="width: 13.1429%; height: 29.7969px;">**State**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3417" data-start="3371" style="width: 42.8571%; height: 29.7969px;">Bộ nhớ dùng để truyền dữ liệu giữa các bước</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3449" data-start="3417" style="width: 44.1429%; height: 29.7969px;">“Tôi nhớ câu hỏi người dùng”</td></tr><tr data-end="3554" data-start="3450" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3463" data-start="3450" style="width: 13.1429%; height: 29.7969px;">**Schema**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3513" data-start="3463" style="width: 42.8571%; height: 29.7969px;">Định nghĩa cấu trúc và loại dữ liệu trong state</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3554" data-start="3513" style="width: 44.1429%; height: 29.7969px;">“State phải có ‘question’ dạng chuỗi”</td></tr><tr data-end="3639" data-start="3555" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3568" data-start="3555" style="width: 13.1429%; height: 29.7969px;">**Node**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3615" data-start="3568" style="width: 42.8571%; height: 29.7969px;">Một bước xử lý như LLM call, tool call, v.v.</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3639" data-start="3615" style="width: 44.1429%; height: 29.7969px;">“Gọi GPT để trả lời”</td></tr><tr data-end="3747" data-start="3640" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3653" data-start="3640" style="width: 13.1429%; height: 29.7969px;">**Edge**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3696" data-start="3653" style="width: 42.8571%; height: 29.7969px;">Điều khiển luồng di chuyển giữa các node</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3747" data-start="3696" style="width: 44.1429%; height: 29.7969px;">“Nếu xong thì kết thúc, nếu thiếu thì tìm tiếp”</td></tr><tr data-end="3848" data-start="3748" style="height: 29.7969px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3761" data-start="3748" style="width: 13.1429%; height: 29.7969px;">**Compile**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3798" data-start="3761" style="width: 42.8571%; height: 29.7969px;">Đóng gói toàn bộ graph để vận hành</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3848" data-start="3798" style="width: 44.1429%; height: 29.7969px;">“Biến các bước rời rạc thành một chương trình”</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Giới thiệu Poetry

**Poetry** – một công cụ hiện đại để quản lý gói (package) và môi trường (environment) trong Python.

### **Poetry là gì?**

**Poetry** là một công cụ giúp bạn:

- Quản lý dependencies (thư viện phụ thuộc).
- Quản lý và build package Python.
- Tạo môi trường ảo tự động.
- Publish package lên PyPI dễ dàng.

Poetry thay thế việc bạn phải dùng `pip`, `venv`, `requirements.txt`, `setup.py`, `pyproject.toml`,... riêng lẻ — **tất cả tích hợp trong một công cụ**.

### **Tại sao nên dùng Poetry?**

<table class="min-w-full" data-end="1044" data-start="590" id="bkmrk-truy%E1%BB%81n-th%E1%BB%91ng-%28pip-%2B-" style="height: 178px; width: 100%;"><thead data-end="643" data-start="590"><tr data-end="643" data-start="590"><th data-end="633" data-start="590" style="width: 49.9404%;">Truyền thống (pip + venv + requirements)</th><th data-end="643" data-start="633" style="width: 50.0596%;">Poetry</th></tr></thead><tbody data-end="1044" data-start="696"><tr data-end="754" data-start="696"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="737" data-start="696" style="width: 49.9404%;">Quản lý môi trường và dependency riêng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="754" data-start="737" style="width: 50.0596%;">Tất cả-in-one</td></tr><tr data-end="830" data-start="755"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="796" data-start="755" style="width: 49.9404%;">Cần nhiều file config khác nhau</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="830" data-start="796" style="width: 50.0596%;">Dùng duy nhất `pyproject.toml`</td></tr><tr data-end="897" data-start="831"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="872" data-start="831" style="width: 49.9404%;">Khó pin version chính xác</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="897" data-start="872" style="width: 50.0596%;">Poetry lock chính xác</td></tr><tr data-end="967" data-start="898"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="939" data-start="898" style="width: 49.9404%;">Không tự động tạo môi trường</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="967" data-start="939" style="width: 50.0596%;">Poetry tự tạo virtualenv</td></tr><tr data-end="1044" data-start="968"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1009" data-start="968" style="width: 49.9404%;">Không có tính năng publish</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1044" data-start="1009" style="width: 50.0596%;">Poetry có lệnh `poetry publish`</td></tr></tbody></table>

### **Khi nào nên dùng Poetry?**

- Khi bạn muốn quản lý dependency dễ dàng và sạch sẽ.
- Khi bạn muốn tạo project có thể publish lên PyPI.
- Khi bạn làm việc nhóm hoặc CI/CD cần môi trường chính xác.
- Khi bạn phát triển package, lib hoặc ứng dụng production.

### **Cài đặt Poetry**

```
curl -sSL https://install.python-poetry.org | python3 -
```

```
Sau đó thêm vào shell config nếu cần:
export PATH="$HOME/.local/bin:$PATH"

poetry --version

```

### **Khởi tạo project với Poetry**

```
poetry new myproject
cd myproject

```

Cấu trúc thư mục sẽ được tạo sẵn:

```
myproject/
├── myproject/
│   └── __init__.py
├── tests/
├── pyproject.toml
└── README.rst

```

### **Thêm dependency**

```
poetry add requests

```

Poetry sẽ:

- Cài thư viện vào virtualenv riêng.
- Ghi lại vào `pyproject.toml` và `poetry.lock`.

### Muốn thêm dev-dependency?

```
poetry add --dev black

```

**Tạo môi trường và chạy shell**

```
poetry shell
```

Giống như `source venv/bin/activate` — bạn sẽ vào môi trường ảo của Poetry.

Hoặc chạy lệnh trong môi trường mà không cần shell:

```
poetry run python script.py
```

### **pyproject.toml là gì?**

Đây là file cấu hình trung tâm của project Python hiện đại.  
Poetry dùng file này để:

- Khai báo tên project, version, mô tả...
- Danh sách dependencies.
- Cấu hình build.

Ví dụ:

```
[tool.poetry]
name = "VHTSoft"
version = "0.1.0"
description = "Dự án tuyệt vời"
authors = ["Bạn <admin@vhtsoft.com>"]

[tool.poetry.dependencies]
python = "^3.10"
requests = "^2.31.0"

[tool.poetry.dev-dependencies]
black = "^23.0.0"

```

### **Build và Publish**

```
poetry build
poetry publish --username __token__ --password pypi-***

```

Bạn có thể đăng lên [PyPI](https://pypi.org/) nếu muốn chia sẻ package.

### **Lệnh phổ biến**

<div class="tableContainer horzScrollShadows group relative" id="bkmrk-l%E1%BB%87nh-ch%E1%BB%A9c-n%C4%83ng-poetr"><span class="absolute end-2 top-2 z-10" data-state="closed"><button class="hover:bg-token-main-surface-secondary text-token-text-secondary rounded-lg px-1 py-1 opacity-0 transition-opacity duration-200 group-focus-within:opacity-100 group-hover:opacity-100"><svg class="icon-md-heavy" fill="none" height="24" viewbox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg"><path clip-rule="evenodd" d="M7 5C7 3.34315 8.34315 2 10 2H19C20.6569 2 22 3.34315 22 5V14C22 15.6569 20.6569 17 19 17H17V19C17 20.6569 15.6569 22 14 22H5C3.34315 22 2 20.6569 2 19V10C2 8.34315 3.34315 7 5 7H7V5ZM9 7H14C15.6569 7 17 8.34315 17 10V15H19C19.5523 15 20 14.5523 20 14V5C20 4.44772 19.5523 4 19 4H10C9.44772 4 9 4.44772 9 5V7ZM5 9C4.44772 9 4 9.44772 4 10V19C4 19.5523 4.44772 20 5 20H14C14.5523 20 15 19.5523 15 19V10C15 9.44772 14.5523 9 14 9H5Z" fill="currentColor" fill-rule="evenodd"></path></svg></button></span><table class="min-w-full" data-end="3613" data-start="2677" style="height: 297px; width: 100%;"><thead data-end="2754" data-start="2677"><tr data-end="2754" data-start="2677"><th data-end="2709" data-start="2677" style="width: 49.9405%;">Lệnh</th><th data-end="2754" data-start="2709" style="width: 49.9405%;">Chức năng</th></tr></thead><tbody data-end="3613" data-start="2833"><tr data-end="2910" data-start="2833"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2864" data-start="2833" style="width: 49.9405%;">`poetry new myproject`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2910" data-start="2864" style="width: 49.9405%;">Tạo mới một project</td></tr><tr data-end="2989" data-start="2911"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2942" data-start="2911" style="width: 49.9405%;">`poetry init`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2989" data-start="2942" style="width: 49.9405%;">Tạo `pyproject.toml` trong thư mục hiện tại</td></tr><tr data-end="3067" data-start="2990"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3021" data-start="2990" style="width: 49.9405%;">`poetry add <package>`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3067" data-start="3021" style="width: 49.9405%;">Thêm dependency</td></tr><tr data-end="3145" data-start="3068"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3099" data-start="3068" style="width: 49.9405%;">`poetry install`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3145" data-start="3099" style="width: 49.9405%;">Cài dependencies từ `pyproject.toml`</td></tr><tr data-end="3223" data-start="3146"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3177" data-start="3146" style="width: 49.9405%;">`poetry update`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3223" data-start="3177" style="width: 49.9405%;">Cập nhật toàn bộ thư viện</td></tr><tr data-end="3301" data-start="3224"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3255" data-start="3224" style="width: 49.9405%;">`poetry lock`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3301" data-start="3255" style="width: 49.9405%;">Tạo/cập nhật `poetry.lock`</td></tr><tr data-end="3379" data-start="3302"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3333" data-start="3302" style="width: 49.9405%;">`poetry run <cmd>`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3379" data-start="3333" style="width: 49.9405%;">Chạy lệnh trong môi trường ảo</td></tr><tr data-end="3457" data-start="3380"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3411" data-start="3380" style="width: 49.9405%;">`poetry shell`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3457" data-start="3411" style="width: 49.9405%;">Mở môi trường ảo</td></tr><tr data-end="3535" data-start="3458"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3489" data-start="3458" style="width: 49.9405%;">`poetry build`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3535" data-start="3489" style="width: 49.9405%;">Đóng gói project</td></tr><tr data-end="3613" data-start="3536"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3567" data-start="3536" style="width: 49.9405%;">`poetry publish`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3613" data-start="3567" style="width: 49.9405%;">Đăng lên PyPI</td></tr></tbody></table>

</div>**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Cơ bản về GraphBuilder

Trong LangGraph, bạn sẽ sử dụng một **GraphBuilder** để định nghĩa các bước (nodes), luồng xử lý (edges), điều kiện phân nhánh (routers), và điểm bắt đầu/kết thúc của một ứng dụng dựa trên LLM.

```python
from langgraph.graph import StateGraph

builder = StateGraph(StateType)

```

Ở đây `StateType` là schema mô tả state (thường là TypedDict hoặc pydantic model).

Ví dụ

```python
from typing import TypedDict, Literal

class DrinkState(TypedDict):
    preference: Literal["coffee", "tea", "unknown"]
```

#### **1. builder.add\_node(name, node\_callable)**

Thêm một bước xử lý (node) vào graph.

**Cú pháp:**

```python
builder.add_node("tên_node", hàm_xử_lý)

```

Ví dụ

```python
def ask_name(state):
    state["name"] = input("Tên bạn là gì? ")
    return state

builder.add_node("ask_name", ask_name)

```

##### **2. builder.add\_edge(from\_node, to\_node)**

Tạo liên kết (đường đi) giữa hai node.

**Cú pháp:**

```python
builder.add_edge("node_nguồn", "node_đích")
```

**Ví dụ:**

```python
builder.add_edge("ask_name", "ask_preference")
```

##### **3. builder.add\_conditional\_edges(from\_router\_node, conditions\_dict)**

Tạo đường đi có điều kiện (routing) từ một node tới nhiều node tùy thuộc vào kết quả của node đó.

**Cú pháp:**

```python
builder.add_conditional_edges("router_node", {
    "kết_quả_1": "node_1",
    "kết_quả_2": "node_2",
    ...
})

```

**Ví dụ:**

```python
builder.add_conditional_edges("router", {
    "coffee_node": "coffee_node",
    "tea_node": "tea_node",
    "fallback_node": "fallback_node"
})

```

=&gt; Node `"router"` sẽ trả về một chuỗi (ví dụ `"coffee_node"`), và flow sẽ đi đến node tương ứng.

##### **4. builder.set\_entry\_point(node\_name)**

Xác định điểm bắt đầu của graph.

Ví dụ

```python
builder.set_entry_point("start")
```

##### **5. builder.set\_finish\_point(node\_name)**

Đánh dấu node kết thúc, tức là sau node này thì flow dừng lại.

Có thể có nhiều node kết thúc!

**Ví dụ**

```python
builder.set_finish_point("coffee_node")
builder.set_finish_point("tea_node")

```

##### **6. builder.compile()**

**Biên dịch graph** của bạn thành một `CompiledGraph` có thể chạy được.

**Ví dụ**

```python
app = builder.compile()

```

Sau đó

```python
app.invoke({"preference": "unknown"}
```

##### **7. Tổng kết**

<table class="min-w-full" data-end="1655" data-start="438" id="bkmrk-h%C3%A0m-m%C3%B4-t%E1%BA%A3-add_node%28n"><thead data-end="486" data-start="438"><tr data-end="486" data-start="438"><th data-end="477" data-start="438">Hàm</th><th data-end="486" data-start="477">Mô tả</th></tr></thead><tbody data-end="1655" data-start="535"><tr data-end="611" data-start="535"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="574" data-start="535">`add_node(name, node_fn)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="611" data-start="574">Thêm một bước xử lý đơn vào graph</td></tr><tr data-end="690" data-start="612"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="651" data-start="612">`add_edge(from_node, to_node)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="690" data-start="651">Tạo liên kết tuyến tính giữa 2 node</td></tr><tr data-end="768" data-start="691"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="732" data-start="691">`add_conditional_edges(name, mapping)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="768" data-start="732">Tạo node phân nhánh có điều kiện</td></tr><tr data-end="842" data-start="769"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="808" data-start="769">`set_entry_point(name)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="842" data-start="808">Xác định điểm bắt đầu của flow</td></tr><tr data-end="908" data-start="843"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="882" data-start="843">`set_finish_point(name)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="908" data-start="882">Xác định điểm kết thúc</td></tr><tr data-end="1001" data-start="909"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="948" data-start="909">`add_branch(name, sub_graph)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1001" data-start="948">Thêm một graph phụ (dạng phân nhánh) vào một node</td></tr><tr data-end="1080" data-start="1002"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1043" data-start="1002">`add_recursion(name, recursive_graph)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1080" data-start="1043">Cho phép gọi đệ quy một graph con</td></tr><tr data-end="1176" data-start="1081"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1120" data-start="1081">`compile()`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1176" data-start="1120">Biên dịch toàn bộ graph thành một ứng dụng chạy được</td></tr><tr data-end="1275" data-start="1177"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1222" data-start="1177">`add_generator_node(name, generator_node)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1275" data-start="1222">Thêm một node sử dụng generator (yield từng bước)</td></tr><tr data-end="1359" data-start="1276"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1315" data-start="1276">`add_parallel_nodes(nodes: dict)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1359" data-start="1315">Chạy nhiều node song song trong một bước</td></tr><tr data-end="1483" data-start="1360"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1426" data-start="1360">`add_conditional_edges_with_default(name, conditions, default)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1483" data-start="1426">Giống `add_conditional_edges` nhưng có nhánh mặc định</td></tr><tr data-end="1570" data-start="1484"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1523" data-start="1484">`add_stateful_node(name, node_fn)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1570" data-start="1523">Dùng khi node cần giữ trạng thái riêng biệt</td></tr><tr data-end="1655" data-start="1571"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1610" data-start="1571">`add_async_node(name, async_node)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1655" data-start="1610">Thêm node xử lý bất đồng bộ (`async def`)</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Xây dựng một ứng dụng đơn giản (graph) quyết định xem người dùng nên uống cà phê hay trà

Mục tiêu của bài tập này là làm quen với các thành phần và bước chính của ứng dụng LangGraph cơ bản. **State**, **Schema**, **Node**, **Edge**, và **Compile**.

I. Cài đặt

- Cài đặt [Peotry tại đây](https://docs.vhterp.com/books/hoc-ai-agents/page/gioi-thieu-poetry)
- tại terminal:
    
    
    - cd project\_name
    - pyenv local 3.11.4
    - poetry install
    - poetry shell
    - jupyter lab
- Tạo file .env
- ```python
    OPENAI_API_KEY=your_openai_api_key
    LANGCHAIN_TRACING_V2=true
    LANGCHAIN_ENDPOINT=https://api.smith.langchain.com # Bạn sẽ cần đăng ký tài khoản tại smith.langchain.com để lấy API key.
    LANGCHAIN_API_KEY=your_langchain_api_key
    LANGCHAIN_PROJECT=your_project_name
    ```
- Kết nối với tệp .env nằm trong cùng thư mục vào notebook
- ```
    #pip install python-dotenv
    ```
- ```python
    import os
    from dotenv import load_dotenv, find_dotenv
    _ = load_dotenv(find_dotenv())
    openai_api_key = os.environ["OPENAI_API_KEY"]
    ```
- Cài đặt LangChain(Nếu bạn đang sử dụng poetry shell được tải sẵn, bạn không cần phải cài đặt gói sau vì nó đã được tải sẵn cho bạn:)
- ```
    #!pip install langchain
    ```
- Kết nối với **LLM**
- ```python
    #!pip install langchain-openai
    from langchain_openai import ChatOpenAI
    
    chatModel35 = ChatOpenAI(model="gpt-3.5-turbo-0125")
    chatModel4o = ChatOpenAI(model="gpt-4o")
    ```

Đây là hình ảnh đồ họa của ứng dụng chúng ta sẽ xây dựng

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/aUMimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/aUMimage.png)

### 2. Xác định lược đồ trạng thái(state schema)

- Điều đầu tiên chúng ta sẽ làm là xác định State của ứng dụng.
- State schema cấu hình những gì, sẽ có trong state và với định dạng nào.
- State thường sẽ là TypedDict hoặc mô hình Pydantic.

Đối với ví dụ này, lớp State sẽ chỉ có một khóa, graph\_state, với định dạng chuỗi

```python
from typing_extensions import TypedDict

class State(TypedDict):
    graph_state: str
```

**TypedDict là gì?**  
\- TypedDict cho phép bạn định nghĩa các từ điển có cấu trúc cụ thể. Nó cho phép bạn chỉ định các khóa chính xác và các loại giá trị liên quan của chúng, giúp mã của bạn rõ ràng hơn và an toàn hơn về mặt kiểu.

Ví dụ, thay vì một từ điển đơn giản như

```
{"name": "Ngoc Tu", "age": 40}
```

bạn có thể định nghĩa một TypedDict để thực thi rằng tên phải luôn là một chuỗi và tuổi phải luôn là một số nguyên.

Ở đây, một cấu trúc giống như từ điển mới có tên là State được định nghĩa.  
State kế thừa từ TypedDict, nghĩa là nó hoạt động giống như một từ điển, nhưng có các quy tắc cụ thể về các khóa và giá trị mà nó phải có.

```python
state: State = {"graph_state": "active"}  # Đúng
```

```python
state: State = {"graph_state": 123}  # Sai, Điều này sẽ gây ra lỗi kiểm tra kiểu vì giá trị 123 không phải là chuỗi.
```

#### **3. Xác định các Nodes của ứng dụng**

Các Nodes của ứng dụng này được định nghĩa là các hàm python.  
Đối số đầu tiên của hàm Node là state. Mỗi Node có thể truy cập khóa graph\_state, với state\['graph\_state'\].  
Trong bài tập này, mỗi Node sẽ trả về một giá trị mới của khóa trạng thái graph\_state. Giá trị mới do mỗi Node trả về sẽ ghi đè lên giá trị **state** trước đó.  
Nếu luồng đồ thị là Node 1 đến Node 2, trạng thái cuối cùng sẽ là "**Chọn Trà**".  
Nếu luồng đồ thị là nút 1 đến nút 3, trạng thái cuối cùng sẽ là "**Chọn Coffee**".

```python
def node_1(state):
    print("---Node 1---")
    return {"graph_state": state['graph_state'] +" Tôi sẽ quyết định"}

def node_2(state):
    print("---Node 2---")
    return {"graph_state": state['graph_state'] +" Chọn Trà"}

def node_3(state):
    print("---Node 3---")
    return {"graph_state": state['graph_state'] +" Chọn Coffee"}
```

#### **4. Xác định các Edges(cạnh) kết nối các Node**

Cạnh thông thường đi từ Node này sang Node khác.

##### **4.1 Edge không điều kiện giữa các node**

```python
builder = GraphBuilder()

# Thêm các node
builder.add_node("node_1", node_1)
builder.add_node("node_2", node_2)
builder.add_node("node_3", node_3)

# Tạo edge không điều kiện
builder.add_edge("node_1", "node_2")  # Sau node_1 thì luôn đi đến node_2
builder.add_edge("node_2", "node_3")  # Sau node_2 thì luôn đi đến node_3

# Đặt node bắt đầu
builder.set_entry_point("node_1")

# Tạo app và chạy thử
app = builder.compile()

initial_state = {"graph_state": ""}
final_state = app.invoke(initial_state)
print("Kết quả:", final_state["graph_state"])
```

- `add_edge("node_1", "node_2")`: Khi node\_1 chạy xong, **luôn luôn** chuyển sang node\_2.
- `add_edge("node_2", "node_3")`: Khi node\_2 chạy xong, **luôn luôn** chuyển sang node\_3.
- Không cần bất kỳ điều kiện nào – đó là lý do gọi là **unconditional edge**.

```
---Node 1---
---Node 2---
---Node 3---
Kết quả: Tôi sẽ quyết định. Chọn Trà. Chọn Coffee.
```

##### **4.2 Edge Có điều kiện giữa các node**

Cạnh có điều kiện được sử dụng khi bạn muốn tùy chọn định tuyến giữa các Node. Chúng là các hàm chọn nút tiếp theo dựa trên một số logic.  
Trong ví dụ trên, để sao chép kết quả quyết định của người dùng, chúng ta sẽ xác định một hàm để mô phỏng xác suất **Chọn Trà** là 60%.

```python
import random
from typing import Literal

def decide_dring(state) -> Literal["node_2", "node_3"]:
    """
    Quyết định nút tiếp theo dựa trên xác suất chia 60/40.
    """
    # Mô phỏng xác suất 60% cho "node_2"
    if random.random() < 0.6:  # 60% chance
        return "node_2"
    
    # Còn lại 40% cơ hội
    return "node_3"
```

```python
from IPython.display import Image, display
from langgraph.graph import StateGraph, START, END

# Build graph
builder = StateGraph(State)

builder.add_node("node_1", node_1)
builder.add_node("node_2", node_2)
builder.add_node("node_3", node_3)

# Add the logic of the graph
builder.add_edge(START, "node_1")
builder.add_conditional_edges("node_1", decide_dring) #decide_dring trả về tên `node 2` hoặc `node 3`
builder.add_edge("node_2", END)
builder.add_edge("node_3", END)

# Compile the graph
graph = builder.compile()

# Visualize the graph
display(Image(graph.get_graph().draw_mermaid_png()))
```

Đầu tiên, chúng ta khởi tạo StateGraph với lớp State mà chúng ta đã định nghĩa ở trên.  
Sau đó, chúng ta thêm các nút và cạnh.  
START Node là một nút đặc biệt gửi dữ liệu đầu vào của người dùng đến **graph**, để chỉ ra nơi bắt đầu đồ thị của chúng ta.

```
builder.add_conditional_edges("node_1", decide_dring)
```

Mỗi lần hàm được gọi, nó đưa ra quyết định dựa trên cơ hội ngẫu nhiên:  
60% cơ hội: Trả về "node\_2".  
40% cơ hội: Trả về "node\_3".  
Tại sao sử dụng điều này?  
Để ra quyết định: Nó mô phỏng một lựa chọn xác suất, có thể hữu ích trong các ứng dụng như mô phỏng, trò chơi hoặc học máy.  
Kiểu trả về theo nghĩa đen đảm bảo rằng hàm sẽ luôn chỉ trả về "node\_2" hoặc "node\_3", giúp dễ dự đoán và gỡ lỗi hơn.

END Node là một nút đặc biệt biểu thị một nút đầu cuối.  
Chúng ta biên dịch **graph** của mình để thực hiện một vài kiểm tra cơ bản trên cấu trúc **graph**.

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/uKuimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/uKuimage.png)

### **5. Chạy ứng dụng**

Graph đã biên dịch triển khai giao thức runnable, một cách chuẩn để thực thi các thành phần LangChain. Do đó, chúng ta có thể sử dụng invoke làm một trong những phương pháp chuẩn để chạy ứng dụng này.

Đầu vào ban đầu của chúng ta là từ điển {"graph\_state": "Xin chào, đây là VHTSoft."}, từ điển này đặt giá trị ban đầu cho từ điển trạng thái.

Khi invoke được gọi:

Biểu đồ bắt đầu thực thi từ nút START.

Nó tiến triển qua các nút đã xác định (node\_1, node\_2, node\_3) theo thứ tự.

Cạnh có điều kiện sẽ đi qua từ nút 1 đến nút 2 hoặc 3 bằng quy tắc quyết định 60/40.

Mỗi hàm nút nhận trạng thái hiện tại và trả về một giá trị mới, giá trị này sẽ ghi đè trạng thái biểu đồ.

Việc thực thi tiếp tục cho đến khi đạt đến nút END.

```python
graph.invoke({"graph_state" : "Hi, Tôi là VHTSoft."})
```

```python
{'graph_state': 'Hi, Tôi là VHTSoft. Tôi sẽ quyết định Chọn Trà'}
```

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Ứng dụng LangGraph cơ bản với chatbot và công cụ

### Mục tiêu của ứng dụng.

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/oCmimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/oCmimage.png)

Sử dụng LangGraph quyết định phản hồi bằng chatbot hoặc sử dụng công cụ

Chúng ta sẽ xây dựng một ứng dụng cơ bản thực hiện 4 thao tác  
Sử dụng chat messages làm **State**

Sử dụng chat model làm **Node**

Liên kết một công cụ với chat model

Thực hiện lệnh gọi công cụ trong **Node**

**I. Cài đặt**

```
* cd project_name
* pyenv local 3.11.4
* poetry install
* poetry shell
* jupyter lab
```

tạo file .env

```
OPENAI_API_KEY=your_openai_api_key
* LANGCHAIN_TRACING_V2=true
* LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
* LANGCHAIN_API_KEY=your_langchain_api_key
* LANGCHAIN_PROJECT=your_project_name

```

Bạn sẽ cần đăng ký tài khoản tại [smith.langchain.com](https://smith.langchain.com/) để lấy API key.

Kết nối với file .env nằm trong cùng thư mục của notebook

```python
#pip install python-dotenv
import os
from dotenv import load_dotenv, find_dotenv
_ = load_dotenv(find_dotenv())
openai_api_key = os.environ["OPENAI_API_KEY"]
```

<div id="bkmrk-c%C3%A0i%C2%A0-langchain"><div>Cài LangChain</div><div>  
</div></div>```python
#!pip install langchain-openai

from langchain_openai import ChatOpenAI

chatModel35 = ChatOpenAI(model="gpt-3.5-turbo-0125")
chatModel4o = ChatOpenAI(model="gpt-4o")
```

#### **II. Xác định State schema**

```python
from typing_extensions import TypedDict
from langchain_core.messages import AnyMessage
from typing import Annotated
from langgraph.graph.message import add_messages

class MessagesState(TypedDict):
    messages: Annotated[list[AnyMessage], add_messages]
```

```python
from typing_extensions import TypedDict
```

- `TypedDict` cho phép bạn định nghĩa một kiểu dictionary có cấu trúc rõ ràng, giống như `dataclass`, nhưng dành cho dict.
- `typing_extensions` được dùng để hỗ trợ các tính năng mới khi bạn đang dùng phiên bản Python cũ hơn

```python
from langchain_core.messages import AnyMessage

```

- `AnyMessage` là một kiểu tin nhắn (message) tổng quát trong LangChain.
- Có thể là tin nhắn từ người dùng (`HumanMessage`), AI (`AIMessage`), hệ thống (`SystemMessage`)

```
from typing import Annotated
```

- `Annotated` là một cách để **gắn thêm metadata** vào kiểu dữ liệu.
- Không thay đổi kiểu dữ liệu, nhưng cho phép các công cụ/phần mềm xử lý kiểu đó biết thêm thông tin phụ.

Metadata là gì? [Xem tại đây](https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/metadata "Metadata là gì")

Annotated là gì? [Xem tại đây](https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/annotated "Annotated là gì")

```python
from langgraph.graph.message import add_messages

```

- `add_messages` là một **annotation handler** từ thư viện `langgraph`.
- Nó được dùng để **bổ sung logic** cho cách mà LangGraph xử lý trường `messages`

```python
class MessagesState(TypedDict):
    messages: Annotated[list[AnyMessage], add_messages]
```

<div id="bkmrk-%C4%91%C3%A2y-l%C3%A0-%C4%91%E1%BB%8Bnh-ngh%C4%A9a-m%E1%BB%99"><div>đây là định nghĩa một State schema</div></div><div id="bkmrk--1">  
</div>#### **III. Xác định Node duy nhất của ứng dụng** 

```python
def simple_llm(state: MessagesState):
    return {"messages": [chatModel4o.invoke(state["messages"])]}
```

Đây là một **LangGraph Node Function**. Nó:

1. Nhận vào `state` (dạng dictionary có cấu trúc `MessagesState`)
2. Lấy danh sách tin nhắn từ `state["messages"]`
3. Gửi toàn bộ danh sách đó vào mô hình ngôn ngữ `chatModel4o`
4. Nhận lại một phản hồi từ LLM
5. Trả về phản hồi đó trong một dict mới dưới dạng `{"messages": [<message>]}`

Ví dụ minh họa

Giả sử:

```python
state = {
    "messages": [
        HumanMessage(content="Chào bạn"),
    ]
}
```

Gọi

```python
simple_llm(state)
```

Trả về

```python
{
    "messages": [
        AIMessage(content="Chào bạn! Tôi có thể giúp gì?")
    ]
}

```

Tóm lại

<table class="min-w-full" data-end="2496" data-start="2252" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-vai-tr%C3%B2-s" style="height: 159px; width: 100%;"><thead data-end="2276" data-start="2252"><tr data-end="2276" data-start="2252"><th data-end="2265" data-start="2252" style="width: 49.9405%;">Thành phần</th><th data-end="2276" data-start="2265" style="width: 49.9405%;">Vai trò</th></tr></thead><tbody data-end="2496" data-start="2301"><tr data-end="2369" data-start="2301"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2326" data-start="2301" style="width: 49.9405%;">`state: MessagesState`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2369" data-start="2326" style="width: 49.9405%;">Trạng thái hiện tại (danh sách message)</td></tr><tr data-end="2420" data-start="2370"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2398" data-start="2370" style="width: 49.9405%;">`chatModel4o.invoke(...)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2420" data-start="2398" style="width: 49.9405%;">Gửi prompt đến LLM</td></tr><tr data-end="2496" data-start="2421"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2452" data-start="2421" style="width: 49.9405%;">`return {"messages": [...]}`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2496" data-start="2452" style="width: 49.9405%;">Trả về message mới để nối thêm vào state</td></tr></tbody></table>

**Vì trong ví dụ này chúng ta chỉ có một nút nên chúng ta không cần phải xác định các cạnh.**

##### **IV. Biên dịch ứng dụng**

```python
from IPython.display import Image, display
from langgraph.graph import StateGraph, START, END
    
# Build graph
builder = StateGraph(MessagesState)

builder.add_node("simple_llm", simple_llm)

# Add the logic of the graph
builder.add_edge(START, "simple_llm")
builder.add_edge("simple_llm", END)

# Compile the graph
graph = builder.compile()

# Visualize the graph
display(Image(graph.get_graph().draw_mermaid_png()))
```

```python
from IPython.display import Image, display

```

- Dùng trong Jupyter Notebook để hiển thị hình ảnh (ở đây là sơ đồ luồng graph).
- `display(...)` dùng để hiển thị hình ảnh.
- `Image(...)` nhận vào dữ liệu ảnh hoặc URL.

```python
from langgraph.graph import StateGraph, START, END

```

- `StateGraph`: class để **xây dựng graph gồm các bước (nodes)** xử lý state.
- `START` và `END`: các node mặc định dùng để đánh dấu điểm **bắt đầu** và **kết thúc**.

Xây dựng Graph:

```
builder = StateGraph(MessagesState)
```

Khởi tạo 1 builder để tạo ra graph, với `MessagesState` là định nghĩa schema cho **state**.

```python
builder.add_node("simple_llm", simple_llm)
```

- Thêm một node có tên `"simple_llm"` và hàm xử lý tương ứng là `simple_llm`.

**Kết nối các bước xử lý:**

```
builder.add_edge(START, "simple_llm")
builder.add_edge("simple_llm", END)
```

`START → simple_llm → END`: bạn đang định nghĩa **luồng chạy của graph** theo thứ tự:

1. **Bắt đầu**
2. Chạy `simple_llm`
3. Kết thúc

**Biên dịch Graph:**

```python
graph = builder.compile()
```

**Hiển thị sơ đồ:**

```python
display(Image(graph.get_graph().draw_mermaid_png()))
```

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/6L9image.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/6L9image.png)

V. Chạy ứng dụng

```python
from pprint import pprint
from langchain_core.messages import AIMessage, HumanMessage

messages = graph.invoke({"messages": HumanMessage(content="Where is the Golden Gate Bridge?")})

for m in messages['messages']:
    m.pretty_print()
```

  
\- \*\*Gọi Graph để xử lý một prompt\*\* (giống như một chatbot).  
\- `graph.invoke(...)` là cách chạy luồng xử lý bạn đã định nghĩa bằng `StateGraph`.  
\- Bạn truyền vào một `dict` có key `"messages"` và giá trị là một \*\*HumanMessage duy nhất\*\*.

Trong thực tế, `"messages"` thường là \*\*list\[BaseMessage\]\*\*, nhưng LangGraph tự động chuyển đổi nếu bạn truyền một message duy nhất (nó sẽ biến nó thành `\[HumanMessage(...)\]`)

\---### ```python  
for m in messages\['messages'\]:  
 m.pretty\_print()

#### Kết quả in ra (ví dụ)

Giả sử AI trả lời như sau, bạn sẽ thấy:

```python
Human: Where is the Golden Gate Bridge?
AI: The Golden Gate Bridge is located in San Francisco, California, USA.

```

#### Diễn giải toàn bộ quy trình

1. Bạn tạo một **HumanMessage** hỏi AI một câu.
2. Gửi message đó vào graph (đã xây bằng LangGraph).
3. Graph chạy các node, ví dụ `simple_llm`, và thêm `AIMessage` phản hồi vào state.
4. Trả về danh sách messages mới (có cả user + AI).
5. In ra từng message bằng `.pretty_print()`.

##### **V. Bây giờ chúng ta hãy thêm một công cụ vào ChatModel4o** 

```python
def multiply(a: int, b: int) -> int:
    """Multiply a and b.

    Args:
        a: first int
        b: second int
    """
    return a * b

chatModel4o_with_tools = chatModel4o.bind_tools([multiply])
```

Định nghĩa một hàm nhân 2 số nguyên `a` và `b`.

`chatModel4o.bind_tools([multiply])`

- Gắn hàm `multiply` vào mô hình `chatModel4o` như một **tool** (công cụ).
- Khi mô hình nhận câu hỏi phù hợp (ví dụ: *"What is 6 times 7?"*), nó có thể **gọi hàm `multiply`** để xử lý thay vì tự trả lời.

#### **VI. Bây giờ chúng ta hãy tạo một ứng dụng LangGraph thứ hai có thể quyết định xem ứng dụng đó có sử dụng chatbot LLM hay Công cụ Multiply để trả lời câu hỏi của người dùng hay không**

```python
# Node
def llm_with_tool(state: MessagesState):
    return {"messages": [chatModel4o_with_tools.invoke(state["messages"])]}
```

```python
from IPython.display import Image, display
from langgraph.graph import StateGraph, START, END
    
# Build graph
builder = StateGraph(MessagesState)

builder.add_node("llm_with_tool", llm_with_tool)

# Add the logic of the graph
builder.add_edge(START, "llm_with_tool")
builder.add_edge("llm_with_tool", END)

# Compile the graph
graph = builder.compile()

# Visualize the graph
display(Image(graph.get_graph().draw_mermaid_png()))
```

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/eXZimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/eXZimage.png)

```python
from pprint import pprint
from langchain_core.messages import AIMessage, HumanMessage

# The following two lines are the most frequent way to 
# run and print a LangGraph chatbot-like app results.
messages = graph.invoke({"messages": HumanMessage(content="Where is the Eiffel Tower?")})

for m in messages['messages']:
    m.pretty_print()
```

<span class="">================================</span><span class="code-bold"> Human Message </span><span class="">================================= Where is the Eiffel Tower? ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== The Eiffel Tower is located in Paris, France. It is situated on the Champ de Mars, near the Seine River.</span>

```python
from pprint import pprint
from langchain_core.messages import AIMessage, HumanMessage

# The following two lines are the most frequent way to 
# run and print a LangGraph chatbot-like app results.
messages = graph.invoke({"messages": HumanMessage(content="Multiply 4 and 5")})

for m in messages['messages']:
    m.pretty_print()
```

<span class="">================================<span class="code-bold"> Human Message </span>================================= Multiply 4 and 5 ==================================<span class="code-bold"> Ai Message </span>================================== Tool Calls: multiply (call\_QRyPmp5TdcIlfEOyBrJ9E7V5) Call ID: call\_QRyPmp5TdcIlfEOyBrJ9E7V5 Args: a: 4 b: 5</span>

**<span class="">Tác giả: Đỗ Ngọc Tú  
Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")</span>**

# Định tuyến(Router) trong LangGraph

#### **Router trong LangGraph là gì?**

Trong LangGraph, **`Router`** là một **Node đặc biệt** (tức một bước – `step`) cho phép bạn **tạo ra các nhánh (branches)** dựa trên dữ liệu hoặc trạng thái hiện tại.

Nói đơn giản:

> **Router giống như ngã ba đường** — dựa trên state hiện tại, bạn chọn hướng đi tiếp theo (chuyển tới node A, B hoặc C).

#### **Khi nào bạn cần dùng Router?**

Khi bạn có logic như:

- Nếu người dùng chọn "Coffee" → đi tới node xử lý coffee.
- Nếu người dùng chọn "Tea" → đi tới node xử lý trà.
- Nếu không rõ → hỏi lại hoặc kết thúc.

Bạn không muốn xử lý tất cả trong một node, mà **tách nhánh theo logic**, thì `Router` là giải pháp.

#### **Cách dùng Router trong LangGraph**

```python
def my_router(state):
    if state["preference"] == "coffee":
        return "coffee_node"
    elif state["preference"] == "tea":
        return "tea_node"
    else:
        return "unknown_preference"

```

Đây là một **Router node**, tức là nó nhận một `state` (trạng thái hiện tại), và **trả về tên node kế tiếp** dựa trên logic.

> **`state["preference"]`** là giá trị đầu vào mà bạn đưa vào để quyết định nhánh.

- Nếu thích **coffee**, thì đi tới node `coffee_node`.
- Nếu thích **tea**, thì đi tới node `tea_node`.
- Nếu không rõ, thì về `unknown_preference` (mặc dù node này **chưa được thêm** trong ví dụ – mình sẽ nói thêm ở dưới).

**Đăng ký Router node trong graph**

**Ví dụ sau, Router không thực thi hành động chính mà **chọn node tiếp theo dựa trên logic phân nhánh**.**

```python
builder = StateGraph(StateSchema)
builder.add_node("start", start_node)
builder.add_node("router", my_router)
builder.add_node("coffee_node", coffee_node)
builder.add_node("tea_node", tea_node)

# Router branching
builder.add_edge("start", "router")
builder.add_conditional_edges(
    "router",
    {
        "coffee_node": "coffee_node",
        "tea_node": "tea_node"
    }
)

```

- Node router sử dụng hàm my\_router, hàm này sẽ trả về các giá trị là tea\_node, coffee\_node hoặc unknown\_preference, LangGraph dùng kết quả đó để **tra trong từ điển**:
- ```
    {
        "coffee_node": "coffee_node",
        "tea_node": "tea_node"
    }
    
    ```
- Nếu kết quả là `"coffee_node"` → đi đến node `"coffee_node"`
- Nếu kết quả là `"tea_node"` → đi đến node `"tea_node"`

#### **Lợi ích của Router**

- **Tách logic phức tạp thành các bước nhỏ**.
- **Tạo flow rõ ràng và dễ debug**.
- **Xây dựng app agent có khả năng phân nhánh tùy theo trạng thái**.
- Dễ áp dụng trong các hệ thống có điều kiện (if/else).

#### **Gợi ý dùng thực tế**

<table class="min-w-full" data-end="2295" data-start="1986" id="bkmrk-use-case-router-logi" style="height: 124px; width: 99.881%;"><thead data-end="2013" data-start="1986"><tr data-end="2013" data-start="1986"><th class="align-left" data-end="1997" data-start="1986" style="width: 49.9404%;">**Use case**</th><th class="align-left" data-end="2013" data-start="1997" style="width: 49.9404%;">**Router logic**</th></tr></thead><tbody data-end="2295" data-start="2042"><tr data-end="2140" data-start="2042"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2059" data-start="2042" style="width: 49.9404%;">Trợ lý cá nhân</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2140" data-start="2059" style="width: 49.9404%;">Phân nhánh theo yêu cầu người dùng: tra cứu lịch, gửi mail, hoặc dịch văn bản</td></tr><tr data-end="2217" data-start="2141"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2160" data-start="2141" style="width: 49.9404%;">Ứng dụng học tập</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2217" data-start="2160" style="width: 49.9404%;">Phân hướng học viên đến bài kiểm tra phù hợp trình độ</td></tr><tr data-end="2295" data-start="2218"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2238" data-start="2218" style="width: 49.9404%;">Ứng dụng đặt hàng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2295" data-start="2238" style="width: 49.9404%;">Nếu sản phẩm còn → đặt hàng; nếu không → đề xuất khác</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "VHTSoft")**

# So sánh Router và Node trong LangGraph

Dưới đây là **bài so sánh chi tiết giữa Router và Node** trong LangGraph, giúp bạn dễ phân biệt và áp dụng chính xác trong từng tình huống.

<table class="min-w-full" data-end="1381" data-start="207" id="bkmrk-ti%C3%AAu-ch%C3%AD-node-%28n%C3%BAt-x"><thead data-end="352" data-start="207"><tr data-end="352" data-start="207"><th class="align-left" data-end="235" data-start="207">**Tiêu chí**</th><th class="align-left" data-end="284" data-start="235">**Node (Nút xử lý)**</th><th class="align-left" data-end="352" data-start="284">**Router (Bộ định tuyến)**</th></tr></thead><tbody data-end="1381" data-start="497"><tr data-end="641" data-start="497"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="525" data-start="497">**Chức năng chính**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="573" data-start="525">Xử lý logic cụ thể và trả về dữ liệu mới</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="641" data-start="573">Định tuyến (chọn nhánh tiếp theo dựa trên trạng thái)</td></tr><tr data-end="787" data-start="642"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="671" data-start="642">**Trả về**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="719" data-start="671">Một dictionary chứa các giá trị mới cho state</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="787" data-start="719">Một chuỗi (string) tên của node tiếp theo</td></tr><tr data-end="938" data-start="788"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="817" data-start="788">**Điều hướng tiếp theo**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="870" data-start="817">Sử dụng `add_edge()` hoặc `add_conditional_edges()`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="938" data-start="870">Sử dụng `add_conditional_edges()` để ánh xạ chuỗi → node</td></tr><tr data-end="1084" data-start="939"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="968" data-start="939">**Tính logic**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1016" data-start="968">Chứa logic chính như gọi LLM, xử lý dữ liệu...</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1084" data-start="1016">Chứa logic quyết định hướng đi tiếp theo</td></tr><tr data-end="1232" data-start="1085"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1116" data-start="1085">**Dữ liệu trả về**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1164" data-start="1116">Ví dụ: `{ "graph_state": "Tôi chọn trà" }`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1232" data-start="1164">Ví dụ: `"coffee_node"` hoặc `"tea_node"`</td></tr><tr data-end="1381" data-start="1233"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1263" data-start="1233">**Dùng khi nào?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1312" data-start="1263">Khi cần thực hiện một hành động/ghi nhớ dữ liệu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1381" data-start="1312">Khi cần rẽ nhánh theo điều kiện hoặc phân luồng logic</td></tr></tbody></table>

##### **Ví dụ minh họa**

**Node bình thường trả về giá trị mới cho state:**

```python
def coffee_node(state):
    print("☕ Tôi chọn coffee")
    return {"result": "Bạn sẽ có một ly coffee"}

```

**Router trả về tên của node tiếp theo:**

```python
def my_router(state):
    if state["preference"] == "coffee":
        return "coffee_node"
    elif state["preference"] == "tea":
        return "tea_node"
    else:
        return "unknown_node"

```

#### Khi nào dùng Router thay vì Node?

- Khi bạn cần **rẽ nhánh logic** theo điều kiện → dùng `router`.
- Khi bạn cần **thực hiện hành động cụ thể** (gọi LLM, tính toán, ghi log,...) → dùng `node`.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Hiểu rõ hơn về add_conditional_edges

Chúng ta lấy 2 ví dụ để so sánh

```
builder.add_conditional_edges("node_1", decide_dring)
```

và

```
builder.add_conditional_edges("router", {
    "coffee_node": "coffee_node",
    "tea_node": "tea_node",
    "fallback_node": "fallback_node"
})
```

Hai dòng `builder.add_conditional_edges(...)` trên **đều dùng để thêm điều kiện rẽ nhánh**, nhưng **cách dùng và mục đích của chúng có sự khác biệt rõ ràng**.

<table class="min-w-full" data-end="2162" data-start="206" id="bkmrk-ti%C3%AAu-ch%C3%AD-builder.add" style="width: 100%; height: 372.75px;"><thead data-end="423" data-start="206"><tr data-end="423" data-start="206" style="height: 46.5938px;"><th data-end="241" data-start="206" style="width: 14.5201%; height: 46.5938px;">Tiêu chí</th><th data-end="325" data-start="241" style="width: 40.824%; height: 46.5938px;">`builder.add_conditional_edges("node_1", decide_dring)`</th><th data-end="423" data-start="325" style="width: 44.5368%; height: 46.5938px;">`builder.add_conditional_edges("router", { "coffee_node": ..., ... })`</th></tr></thead><tbody data-end="2162" data-start="643"><tr data-end="860" data-start="643" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="679" data-start="643" style="width: 14.5201%; height: 46.5938px;">**Kiểu truyền đối số**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="763" data-start="679" style="width: 40.824%; height: 46.5938px;">Truyền **một hàm** điều kiện (condition function)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="860" data-start="763" style="width: 44.5368%; height: 46.5938px;">Truyền **một dict** ánh xạ giá trị trả về từ router đến các node tương ứng</td></tr><tr data-end="1077" data-start="861" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="897" data-start="861" style="width: 14.5201%; height: 46.5938px;">**Ai quyết định rẽ nhánh?**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="980" data-start="897" style="width: 40.824%; height: 46.5938px;">Hàm `decide_dring(state)` sẽ quyết định đi đến node nào</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/2)]" data-end="1077" data-start="980" style="width: 44.5368%; height: 46.5938px;">Hàm `router(state)` sẽ trả về một string → dict ánh xạ string đó đến node tương ứng</td></tr><tr data-end="1294" data-start="1078" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1113" data-start="1078" style="width: 14.5201%; height: 46.5938px;">**Giá trị trả về** của hàm</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1197" data-start="1113" style="width: 40.824%; height: 46.5938px;">Trả về tên node dưới dạng string</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1294" data-start="1197" style="width: 44.5368%; height: 46.5938px;">Trả về tên node dưới dạng string, **phải trùng với key trong dict**</td></tr><tr data-end="1512" data-start="1295" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1330" data-start="1295" style="width: 14.5201%; height: 46.5938px;">**Node được gắn vào**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1414" data-start="1330" style="width: 40.824%; height: 46.5938px;">Gắn vào một node bình thường (`node_1`)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1512" data-start="1414" style="width: 44.5368%; height: 46.5938px;">Gắn vào một router node (`router`)</td></tr><tr data-end="1729" data-start="1513" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1548" data-start="1513" style="width: 14.5201%; height: 46.5938px;">**Sử dụng khi**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1632" data-start="1548" style="width: 40.824%; height: 46.5938px;">Khi bạn muốn **node đang xử lý** tự quyết định rẽ nhánh tiếp theo</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1729" data-start="1632" style="width: 44.5368%; height: 46.5938px;">Khi bạn tách riêng logic định tuyến ra một **router riêng biệt**</td></tr><tr data-end="1946" data-start="1730" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1766" data-start="1730" style="width: 14.5201%; height: 46.5938px;">**Ví dụ hàm điều kiện**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1849" data-start="1766" style="width: 40.824%; height: 46.5938px;">`def decide_dring(state): return "coffee_node" if ... else "tea_node"`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1946" data-start="1849" style="width: 44.5368%; height: 46.5938px;">`def router(state): return "coffee_node" / "tea_node" / "fallback_node"`</td></tr><tr data-end="2162" data-start="1947" style="height: 46.5938px;"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1982" data-start="1947" style="width: 14.5201%; height: 46.5938px;">**Thường dùng khi**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2065" data-start="1982" style="width: 40.824%; height: 46.5938px;">Bạn muốn `node_1` vừa xử lý vừa quyết định hướng đi tiếp</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2162" data-start="2065" style="width: 44.5368%; height: 46.5938px;">Bạn muốn tách riêng xử lý (node) và định tuyến (router) một cách rõ ràng</td></tr></tbody></table>

<table class="min-w-full" data-end="2436" data-start="2194" id="bkmrk-d%E1%BA%A1ng-%C3%9D-ngh%C4%A9a-add_con" style="height: 92px; width: 100%;"><thead data-end="2212" data-start="2194"><tr data-end="2212" data-start="2194"><th class="align-left" data-end="2201" data-start="2194" style="width: 49.9405%;">**Dạng**</th><th class="align-left" data-end="2212" data-start="2201" style="width: 49.9405%;">**Ý nghĩa**</th></tr></thead><tbody data-end="2436" data-start="2232"><tr data-end="2328" data-start="2232"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2282" data-start="2232" style="width: 49.9405%;">`add_conditional_edges("node_1", decide_dring)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2328" data-start="2282" style="width: 49.9405%;">Node xử lý xong rồi chọn tiếp theo đi đâu.</td></tr><tr data-end="2436" data-start="2329"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2374" data-start="2329" style="width: 49.9405%;">`add_conditional_edges("router", { ... })`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2436" data-start="2374" style="width: 49.9405%;">Router chỉ quyết định hướng đi, còn xử lý nằm ở node khác.</td></tr></tbody></table>

#### **Khi nào dùng cái nào?**

<table class="min-w-full" data-end="3361" data-start="2974" id="bkmrk-n%E1%BA%BFu-b%E1%BA%A1n-mu%E1%BB%91n...-h%C3%A3y-" style="height: 102px; width: 100%;"><thead data-end="3071" data-start="2974"><tr data-end="3071" data-start="2974"><th data-end="3019" data-start="2974" style="width: 49.9405%;">Nếu bạn muốn...</th><th data-end="3071" data-start="3019" style="width: 49.9405%;">Hãy dùng...</th></tr></thead><tbody data-end="3361" data-start="3170"><tr data-end="3265" data-start="3170"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3214" data-start="3170" style="width: 49.9405%;">Một node tự quyết định rẽ nhánh tiếp theo</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3265" data-start="3214" style="width: 49.9405%;">`add_conditional_edges("node_1", decide_dring)`</td></tr><tr data-end="3361" data-start="3266"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3310" data-start="3266" style="width: 49.9405%;">Một router chuyên dùng để rẽ nhánh</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="3361" data-start="3310" style="width: 49.9405%;">`add_conditional_edges("router", { ... })`</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Bài Thực Hành Router Trong LangGraph

> Mục tiêu: Tạo một LangGraph gồm các bước đơn giản, giúp người dùng quyết định sẽ uống Coffee hay Trà.

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/tL4image.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/tL4image.png)

I. Cài đặt

```
* cd project_name
* pyenv local 3.11.4
* poetry install
* poetry shell
* jupyter lab
```

Tạo .env file

```
OPENAI_API_KEY=your_openai_api_key
LANGCHAIN_TRACING_V2=true
LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
LANGCHAIN_API_KEY=your_langchain_api_key
LANGCHAIN_PROJECT=your_project_name
```

Kết nối file .env

```
#pip install python-dotenv
```

```python
import os
from dotenv import load_dotenv, find_dotenv
_ = load_dotenv(find_dotenv())
openai_api_key = os.environ["OPENAI_API_KEY"]
```

**II. Kết nối LangChain**

```python
#!pip install langgraph langchain openai
```

#### **III. Định nghĩa `State Schema` (State = Memory)**

```python
from typing import TypedDict, Literal

class DrinkState(TypedDict):
    preference: Literal["coffee", "tea", "unknown"]

```

#### `TypedDict`

- Đây là một **tính năng của Python (từ `typing` module)** cho phép bạn khai báo **dictionary có cấu trúc rõ ràng**, giống như một `class`.
- Mục đích là để **giúp IDE và trình kiểm tra kiểu như MyPy bắt lỗi sớm** nếu bạn dùng sai key hoặc giá trị.

#### `DrinkState`

- Là tên của lớp, đại diện cho **trạng thái (state)** của ứng dụng LangGraph của bạn.

#### `preference: Literal["coffee", "tea", "unknown"]`

- Trường `preference` chỉ chấp nhận **một trong ba giá trị cụ thể**: `"coffee"`, `"tea"` hoặc `"unknown"`.
- Đây là cách giới hạn giá trị hợp lệ, giúp bạn tránh lỗi như `"cofee"` hay `"t"` do gõ sai.

#### **IV. Định nghĩa các `Nodes` (mỗi Node là một Step)**

```python
# Node: Bắt đầu
def start_node(state: DrinkState) -> DrinkState:
    print("👉 Bạn thích uống gì hôm nay?")
    choice = input("Nhập 'coffee' hoặc 'tea': ").strip().lower()
    if choice not in ["coffee", "tea"]:
        choice = "unknown"
    return {"preference": choice}

# Node: Nếu chọn coffee
def coffee_node(state: DrinkState) -> DrinkState:
    print("☕ Bạn đã chọn Coffee! Tuyệt vời!")
    return state

# Node: Nếu chọn tea
def tea_node(state: DrinkState) -> DrinkState:
    print("🍵 Bạn đã chọn Trà! Thanh tao ghê!")
    return state

# Node: Nếu nhập sai
def fallback_node(state: DrinkState) -> DrinkState:
    print("Không rõ bạn chọn gì. Vui lòng thử lại.")
    return state

```

#### **V. Định nghĩa Router**

```python
def drink_router(state: DrinkState) -> str:
    if state["preference"] == "coffee":
        return "coffee_node"
    elif state["preference"] == "tea":
        return "tea_node"
    else:
        return "fallback_node"

```

#### **VI. Xây dựng Graph**

```python
from langgraph.graph import StateGraph

builder = StateGraph(DrinkState)

# Thêm các nodes
builder.add_node("start", start_node)
builder.add_node("coffee_node", coffee_node)
builder.add_node("tea_node", tea_node)
builder.add_node("fallback_node", fallback_node)
builder.add_node("router", drink_router)

# Tạo flow giữa các bước
builder.set_entry_point("start")
builder.add_edge("start", "router")

builder.add_conditional_edges("router", {
    "coffee_node": "coffee_node",
    "tea_node": "tea_node",
    "fallback_node": "fallback_node"
})

# Gắn điểm kết thúc cho mỗi nhánh
builder.set_finish_point("coffee_node")
builder.set_finish_point("tea_node")
builder.set_finish_point("fallback_node")

# Compile graph
app = builder.compile()

```

####  

#### **VII. Chạy thử**

```python
# Trạng thái khởi đầu rỗng
initial_state: DrinkState = {"preference": "unknown"}
final_state = app.invoke(initial_state)

```

## Kết quả

Tùy người dùng nhập vào `coffee` hay `tea`, graph sẽ tự động điều hướng tới đúng bước xử lý, và in kết quả tương ứng.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com "Công Ty Phần Mềm VHTSoft")**

# Giới thiệu về ReAct Architecture

Kiến trúc **ReAct** là một mô hình rất quan trọng trong việc xây dựng các Agent dựa trên LLM. Tên “ReAct” là viết tắt của **Reasoning and Acting** – tức là kết hợp giữa *lập luận* và *hành động*. Đây là cách mà một Agent thông minh có thể thực hiện nhiều bước để hoàn thành một nhiệm vụ, thay vì chỉ trả lời một lần rồi kết thúc.

#### **Giới thiệu về ReAct Architecture**

ReAct cho phép các LLM (Large Language Models) hoạt động theo chu trình:

1. **act (hành động)**  
    Mô hình quyết định gọi một công cụ (tool) để thực hiện một hành động cụ thể. Ví dụ: tìm kiếm thông tin, tính toán, tra dữ liệu từ API, v.v.
2. **observe (quan sát)**  
    Công cụ thực hiện hành động và trả về kết quả. Kết quả này sẽ được đưa trở lại LLM như một phần của cuộc hội thoại (hoặc “context”).
3. **reason (lập luận)**  
    LLM tiếp nhận kết quả, phân tích và quyết định bước tiếp theo: có thể gọi thêm một công cụ khác, tiếp tục hỏi người dùng, hoặc kết thúc bằng một câu trả lời.

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/1NJimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/1NJimage.png)

**ReAct** là cách mà **AI (LLM)** suy nghĩ và hành động như một con người:

> “Nghĩ – Làm – Quan sát – Nghĩ tiếp – Làm tiếp…”

##### **Câu chuyện đơn giản**

Bạn nói với AI:

> "Tính giúp tôi 3 + 5"

AI làm gì?

<table class="min-w-full" data-end="796" data-start="403" id="bkmrk-b%C6%B0%E1%BB%9Bc-h%C3%A0nh-%C4%91%E1%BB%99ng-gi%E1%BA%A3i-" style="height: 161px; width: 100%;"><thead data-end="444" data-start="403"><tr data-end="444" data-start="403"><th class="align-left" data-end="410" data-start="403" style="width: 13.4921%;">**Bước**</th><th class="align-left" data-end="422" data-start="410" style="width: 53.254%;">**Hành động**</th><th class="align-left" data-end="444" data-start="422" style="width: 33.3731%;">**Giải thích dễ hiểu**</th></tr></thead><tbody data-end="796" data-start="487"><tr data-end="573" data-start="487"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="497" data-start="487" style="width: 13.4921%;">**Act**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="542" data-start="497" style="width: 53.254%;">"Tôi sẽ gọi công cụ máy tính để tính toán"</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="573" data-start="542" style="width: 33.3731%;">(Gọi hàm `calculator_tool`)</td></tr><tr data-end="633" data-start="574"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="585" data-start="574" style="width: 13.4921%;">**Tool**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="630" data-start="585" style="width: 53.254%;">Máy tính nhận yêu cầu, tính ra kết quả `8`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="633" data-start="630" style="width: 33.3731%;"> </td></tr><tr data-end="708" data-start="634"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="648" data-start="634" style="width: 13.4921%;">**Observe**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="675" data-start="648" style="width: 53.254%;">AI nhìn vào kết quả: `8`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="708" data-start="675" style="width: 33.3731%;">(Cập nhật kết quả vào bộ nhớ)</td></tr><tr data-end="796" data-start="709"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="722" data-start="709" style="width: 13.4921%;">**Reason**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="770" data-start="722" style="width: 53.254%;">AI tự hỏi: “Người dùng muốn tính tiếp không?”</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="796" data-start="770" style="width: 33.3731%;">Nếu có, lặp lại từ đầu</td></tr></tbody></table>

#### **Ví dụ thực tế**

Giả sử bạn hỏi:  
**"Hôm nay thời tiết ở TP Hồ Chí Minh như thế nào và tôi có nên mang ô không?"**

Agent thực hiện:

- **act**: Gọi một công cụ thời tiết để lấy dữ liệu thời tiết tại **TP Hồ Chí Minh**.
- **observe**: Nhận được kết quả: *"Trời có khả năng mưa vào chiều tối."*
- **reason**: LLM suy luận: *"Trời có thể mưa → nên mang ô → trả lời người dùng."*

Trả lời cuối cùng:  
*"Hôm nay **TP Hồ Chí Minh** có khả năng mưa vào chiều tối, bạn nên mang theo ô."*

#### **Ứng dụng của ReAct**

- Xây dựng **multi-step agents**: Giải quyết các bài toán phức tạp cần nhiều hành động trung gian.
- Cho phép Agent có thể **tự khám phá**, điều chỉnh kế hoạch dựa trên kết quả trung gian.
- Hữu ích trong các hệ thống như **LangGraph**, **LangChain**, nơi bạn cần điều phối nhiều bước và công cụ.

**Ví dụ cơ bản**

Tạo một agent hỏi người dùng một phép tính, gọi một công cụ để tính, rồi tiếp tục hỏi đến khi người dùng muốn dừng.

Kiến trúc Agent như sau

```
START
  ↓
LLM (hỏi phép tính)
  ↓
TOOL (tính kết quả)
  ↓
LLM (xem kết quả, hỏi tiếp hay kết thúc?)
  → Nếu tiếp → quay lại TOOL
  → Nếu kết thúc → END

```

**1. Định nghĩa `State`**

```python
from typing import TypedDict, List, Optional

class CalcState(TypedDict):
    history: List[str]
    next_action: Optional[str]
    question: Optional[str]
    answer: Optional[str]

```

**2. Tạo Tool Node**

```python
def calculator_tool(state: CalcState) -> CalcState:
    question = state["question"]
    try:
        answer = str(eval(question))  # WARNING: chỉ dùng với ví dụ đơn giản!
    except:
        answer = "Không thể tính được."

    state["answer"] = answer
    state["history"].append(f"Q: {question}\nA: {answer}")
    return state

```

**3. Tạo LLM Node**

```python
def llm_node(state: CalcState) -> CalcState:
    print("🧠 LLM: Tôi đang nghĩ...")
    print(f"Câu hỏi: {state.get('question')}")
    print(f"Kết quả: {state.get('answer')}")
    
    # Quyết định bước tiếp theo
    choice = input("Bạn muốn tiếp tục (yes/no)? ")
    if choice.lower() == "no":
        state["next_action"] = "end"
    else:
        new_q = input("Nhập phép tính mới: ")
        state["question"] = new_q
        state["next_action"] = "calculate"
    return state

```

**4. Router**

```python
def calc_router(state: CalcState) -> str:
    return state["next_action"]
```

**5. Kết nối các bước bằng LangGraph**

```python
from langgraph.graph import StateGraph

builder = StateGraph(CalcState)

builder.add_node("llm_node", llm_node)
builder.add_node("tool_node", calculator_tool)
builder.add_node("router", calc_router)

builder.set_entry_point("llm_node")
builder.add_edge("llm_node", "router")

builder.add_conditional_edges("router", {
    "calculate": "tool_node",
    "end": "__end__"
})

builder.add_edge("tool_node", "llm_node")
graph = builder.compile()

```

- Dòng 5,6,7 Chúng ta thêm 3 nodes: llm\_node, calculator\_tool, calc\_router
- Dòng 9, llm\_node là được đặt là node đầu tiên
- Dòng 10, chúng ta nối node có id là llm\_node với node có id là `router`**(router là một node đặc biệt, node này không trả về một state mà trả về một chuỗi)**
- Dòng 12, router thực hiện rẽ nhánh dựa trên add\_conditional\_edges 
    - "router" là id của node calc\_router, nếu calc\_router trả về "calculate" thì thực hiên tool\_node, nếu calc\_router trả về "end" thì thực hiện "\_\_end\_\_"
- Dòng 17, thực hiện nối "tool\_node" với "llm\_node" và tiếp tục

**6. Chạy thử**

```python
state = {
    "history": [],
    "next_action": None,
    "question": "2 + 3",
    "answer": None,
}

graph.invoke(state)

```

**Output mẫu**

```
LLM: Tôi đang nghĩ...
Câu hỏi: 2 + 3
Kết quả: None
Nhập phép tính mới: 2 + 3
Q: 2 + 3
A: 5
Bạn muốn tiếp tục (yes/no)? yes
Nhập phép tính mới: 10 * 2
...

```

##### **Tóm tắt kiến trúc ReAct**

<table class="min-w-full" data-end="592" data-start="163" id="bkmrk-pha-vai-tr%C3%B2-%C3%9D-ngh%C4%A9a-" style="height: 136px; width: 100%;"><thead data-end="190" data-start="163"><tr data-end="190" data-start="163"><th class="align-left" data-end="169" data-start="163" style="width: 24.2064%;">**Pha**</th><th class="align-left" data-end="179" data-start="169" style="width: 42.5397%;">**Vai trò**</th><th class="align-left" data-end="190" data-start="179" style="width: 33.3731%;">**Ý nghĩa**</th></tr></thead><tbody data-end="592" data-start="217"><tr data-end="290" data-start="217"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="225" data-start="217" style="width: 24.2064%;">`Act`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="247" data-start="225" style="width: 42.5397%;">**LLM gọi công cụ**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="290" data-start="247" style="width: 33.3731%;">LLM yêu cầu tính một biểu thức toán học</td></tr><tr data-end="392" data-start="291"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="303" data-start="291" style="width: 24.2064%;">`Observe`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="329" data-start="303" style="width: 42.5397%;">**Công cụ trả kết quả**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="392" data-start="329" style="width: 33.3731%;">Công cụ `calculator_tool` xử lý phép tính và trả về kết quả</td></tr><tr data-end="494" data-start="393"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="404" data-start="393" style="width: 24.2064%;">`Reason`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="440" data-start="404" style="width: 42.5397%;">**LLM quyết định bước tiếp theo**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="494" data-start="440" style="width: 33.3731%;">Dựa trên kết quả, LLM quyết định tiếp tục hay dừng</td></tr><tr data-end="592" data-start="495"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="504" data-start="495" style="width: 24.2064%;">`Tool`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="531" data-start="504" style="width: 42.5397%;">**Công cụ được LLM gọi**</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="592" data-start="531" style="width: 33.3731%;">Ở đây là hàm `calculator_tool` dùng `eval()` để tính toán</td></tr></tbody></table>

**Phân tích chi tiết ví dụ trên**

1\. **Act – LLM gọi công cụ**

Trong hàm `llm_node`, nếu người dùng muốn tiếp tục:

```python
state["next_action"] = "calculate"
```

LLM quyết định hành động tiếp theo là **gọi công cụ tính toán**.

2\. **Observe – Công cụ trả kết quả**

```python
def calculator_tool(state: CalcState) -> CalcState:
    ...
    state["answer"] = answer
```

Công cụ thực hiện tính toán và **cập nhật lại state** (trạng thái) với kết quả.  
LLM sẽ **quan sát lại kết quả** ở bước tiếp theo.

3\. **Reason – LLM quyết định tiếp theo**

Sau khi đã có kết quả trong `state["answer"]`, LLM đánh giá và hỏi:

```
choice = input("Bạn muốn tiếp tục (yes/no)? ")
```

Nếu **yes** thì act lần nữa (gọi lại công cụ).  
Nếu **no** thì kết thúc (gọi `"end"`).

4\. **Tool – Công cụ độc lập**

```python
def calculator_tool(state: CalcState) -> CalcState:
    ...
```

Đây chính là một công cụ (Tool) – thực hiện công việc cụ thể do LLM yêu cầu.  
Nó không thông minh, chỉ đơn thuần xử lý dữ liệu đầu vào.

**Tổng kết dễ hiểu**

<table class="min-w-full" data-end="1929" data-start="1688" id="bkmrk-b%C6%B0%E1%BB%9Bc-th%C3%A0nh-ph%E1%BA%A7n-vai-" style="height: 122px; width: 100%;"><thead data-end="1719" data-start="1688"><tr data-end="1719" data-start="1688"><th class="align-left" data-end="1695" data-start="1688" style="width: 7.9857%;">**Bước**</th><th class="align-left" data-end="1708" data-start="1695" style="width: 19.9508%;">**Thành phần**</th><th class="align-left" data-end="1719" data-start="1708" style="width: 72.0635%;">**Vai trò**</th></tr></thead><tbody data-end="1929" data-start="1751"><tr data-end="1798" data-start="1751"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1757" data-start="1751" style="width: 7.9857%;">1</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1770" data-start="1757" style="width: 19.9508%;">`llm_node`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1798" data-start="1770" style="width: 72.0635%;">Act: Quyết định gọi tool</td></tr><tr data-end="1852" data-start="1799"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1805" data-start="1799" style="width: 7.9857%;">2</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1825" data-start="1805" style="width: 19.9508%;">`calculator_tool`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1852" data-start="1825" style="width: 72.0635%;">Observe: Trả kết quả về</td></tr><tr data-end="1929" data-start="1853"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1859" data-start="1853" style="width: 7.9857%;">3</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1872" data-start="1859" style="width: 19.9508%;">`llm_node`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1929" data-start="1872" style="width: 72.0635%;">Reason: Xem kết quả và quyết định hành động tiếp theo</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Thực hành – Node LLM quyết định bước tiếp theo

Chúng ta sẽ xây dựng lại ứng dụng trước đó, nhưng lần này sẽ bổ sung hành vi mang tính "agent" điển hình. Theo cách gọi của nhóm LangGraph, đây sẽ là **Agent đầu tiên** của chúng ta.

**Những điểm chính:**

- **Hành vi agent điển hình**: node công cụ (tool node) sẽ phản hồi lại cho LLM, và sau đó LLM sẽ quyết định bước tiếp theo.
- Node bao gồm chatbot, công cụ (tool), và thông điệp hệ thống (system message).
- Các thao tác gọi công cụ theo trình tự (sequential tool-calling operations).

### **Agent Cơ Bản**

- **Mục tiêu**: Chúng ta sẽ xây dựng một ứng dụng tương tự như trong bài thực hành trước. **Điểm khác biệt chính** là trong ứng dụng lần này, **node công cụ (tools node) sẽ phản hồi trở lại cho assistant (LLM) thay vì đi thẳng đến node KẾT THÚC (END Node)**.
- Điều này thể hiện kiến trúc được gọi là **ReAct**: mô hình LLM sẽ tiếp tục sử dụng các công cụ cho đến khi nhận được phản hồi thỏa đáng.
    
    
    - **act** – LLM gọi một công cụ.
    - **observe** – công cụ trả kết quả lại cho LLM.
    - **reason** – LLM quyết định bước tiếp theo (gọi công cụ khác hoặc trả lời trực tiếp).

### **Thực hành**

Tạo một agent sử dụng kiến trúc ReAct với quy trình:

1. Người dùng không biết chọn gì → LLM hỏi ý kiến.
2. LLM gọi một tool để kiểm tra trạng thái năng lượng người dùng.
3. Tool trả lời về mức năng lượng.
4. Dựa vào đó, LLM đưa ra lời khuyên nên uống trà hay cà phê.

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/34gimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/34gimage.png)

1\. **Cài đặt và chuẩn bị**

```
pip install langgraph openai
```

2\. **Định nghĩa State**

```python
from typing import TypedDict, Literal, Optional

class DrinkState(TypedDict):
    preference: Literal["coffee", "tea", "unknown"]
    energy_level: Optional[str]
    messages: list[dict]
```

3\. **Tạo công cụ kiểm tra năng lượng**

```python
def check_energy_level(state: DrinkState) -> DrinkState:
    # Giả sử công cụ xác định người dùng đang "mệt"
    energy = "tired"
    state["energy_level"] = energy
    state["messages"].append({"role": "tool", "content": f"Energy level is {energy}"})
    return state
```

**4. **Tạo node LLM để đưa ra quyết định****

```python
from langchain.chat_models import ChatOpenAI

llm = ChatOpenAI(temperature=0)

def llm_node(state: DrinkState) -> DrinkState:
    messages = state["messages"]
    response = llm.invoke(messages)
    state["messages"].append({"role": "assistant", "content": response.content})
    if "coffee" in response.content.lower():
        state["preference"] = "coffee"
    elif "tea" in response.content.lower():
        state["preference"] = "tea"
    return state
```

****5. **Tạo Graph******

```python
from langgraph.graph import StateGraph

builder = StateGraph(DrinkState)

builder.add_node("llm", llm_node)
builder.add_node("check_energy", check_energy_level)

builder.set_entry_point("llm")

# LLM gọi tool rồi quay lại chính nó
builder.add_edge("llm", "check_energy")
builder.add_edge("check_energy", "llm")

# Thiết lập điểm kết thúc
builder.set_finish_point("llm")

graph = builder.compile()
```

******6. **Chạy thử********

```python
initial_state = {
    "preference": "unknown",
    "energy_level": None,
    "messages": [{"role": "user", "content": "Tôi không biết nên uống gì hôm nay"}],
}

final_state = graph.invoke(initial_state)
print("Gợi ý của Agent:", final_state["preference"])

```

### **Giải thích luồng hoạt động**

1. Người dùng không đưa ra lựa chọn cụ thể.
2. LLM phân tích và quyết định cần kiểm tra mức năng lượng.
3. Tool `check_energy` trả về trạng thái "mệt".
4. LLM đưa ra khuyến nghị uống cà phê để tăng tỉnh táo.
5. Kết thúc.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Kết nối các công cụ (tools) bằng bind_tools

`bind_tools` là một tính năng trong LangChain (thường dùng với các mô hình như OpenAI’s GPT) để **kết nối các công cụ (tools)** với LLM. Nó cho phép mô hình gọi những tool đó khi cần, như tính toán, truy xuất thông tin, tra cứu, v.v.

`ind_tools` giúp bạn nói với LLM rằng:

> "Ê, ngoài việc trả lời bằng văn bản, mày có thể **gọi** mấy tool này nếu thấy cần."

Cú pháp cơ bản

```python
llm_with_tools = chat_model.bind_tools(
    tools=[tool_1, tool_2],
    parallel_tool_calls=False  # hoặc True nếu muốn gọi song song nhiều tool
)

```

- `tools`: danh sách các tool bạn định sử dụng (được định nghĩa trước).
- `parallel_tool_calls`: nếu `True`, mô hình có thể gọi nhiều tool một lúc (song song). Nếu `False`, gọi từng cái một theo thứ tự.

Ví dụ đơn giản

Bước 1: Định nghĩa các tool

```python
from langchain.tools import tool

@tool
def add(a: int, b: int) -> int:
    """Cộng hai số"""
    return a + b

@tool
def multiply(a: int, b: int) -> int:
    """Nhân hai số"""
    return a * b

```

Bước 2: Bind tools vào mô hình

```python
from langchain.chat_models import ChatOpenAI

chat_model = ChatOpenAI(model="gpt-4")

llm_with_tools = chat_model.bind_tools(
    tools=[add, multiply],
    parallel_tool_calls=False  # toán học thường nên làm tuần tự
)

```

Bước 3: Gọi mô hình và để nó tự chọn tool

```python
response = llm_with_tools.invoke("Hãy cộng 3 và 5 giúp tôi")
print(response.content)

```

Nếu LLM hiểu rằng cần thực hiện phép cộng, nó sẽ tự động gọi tool `add(3, 5)` và trả lại kết quả là `8`.

`bind_tools` hữu ích vì

- **Modular hóa**: LLM không cần biết cách hoạt động nội bộ của tool, chỉ cần mô tả chức năng.
- **Mở rộng dễ dàng**: Bạn có thể thêm bao nhiêu tool tùy thích.
- **Tự động lựa chọn**: LLM tự chọn tool phù hợp dựa trên yêu cầu người dùng.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Xây dựng một ứng dụng quyết định xem có nên trò chuyện bằng LLM hay sử dụng công cụ

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/qiIimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/qiIimage.png)

1\. Cài đặt

```
* cd project_name
* pyenv local 3.11.4
* poetry install
* poetry shell
* jupyter lab
```

2\. Tạo .env file

```
* OPENAI_API_KEY=your_openai_api_key
* LANGCHAIN_TRACING_V2=true
* LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
* LANGCHAIN_API_KEY=your_langchain_api_key
* LANGCHAIN_PROJECT=your_project_name
```

3\. Kết nối file .env

```
#pip install python-dotenv
```

```python
import os
from dotenv import load_dotenv, find_dotenv
_ = load_dotenv(find_dotenv())
openai_api_key = os.environ["OPENAI_API_KEY"]
```

4\. Cài đặt LangChain

```python
#!pip install langchain
#!pip install langchain-openai
```

```python
from langchain_openai import ChatOpenAI

chatModel35 = ChatOpenAI(model="gpt-3.5-turbo-0125")
chatModel4o = ChatOpenAI(model="gpt-4o")
```

5\. LLM với các công cụ

```python
from langchain.tools import tool

@tool
def multiply(a: int, b: int) -> int:
    """Multiply a and b.

    Args:
        a: first int
        b: second int
    """
    return a * b

@tool
def add(a: int, b: int) -> int:
    """Adds a and b.

    Args:
        a: first int
        b: second int
    """
    return a + b
@tool
def divide(a: int, b: int) -> float:
    """Divide a and b.

    Args:
        a: first int
        b: second int
    """
    return a / b

tools = [add, multiply, divide]

llm_with_tools = chatModel4o.bind_tools(tools, parallel_tool_calls=False)
```

#### Define the State schema

```python
from langgraph.graph import MessagesState

class MessagesState(MessagesState):
    # Add any keys needed beyond messages, which is pre-built 
    pass
```

#### Define the first Node

```python
from langchain_core.messages import HumanMessage, SystemMessage

# System message, system prompt
sys_msg = SystemMessage(content="You are a helpful assistant tasked with performing arithmetic on a set of inputs.")

# Node
def assistant(state: MessagesState):
   return {"messages": [llm_with_tools.invoke([sys_msg] + state["messages"])]}
```

\* Các nút của đồ thị được định nghĩa là các hàm python.  
\* Đối số đầu tiên của hàm Node là trạng thái. Do đó, trong bài tập này, mỗi nút có thể truy cập khóa `messages`, với `state\['messages'\]`.  
\* Trong ví dụ này, chúng ta sẽ bắt đầu bằng một nút tương tự như nút chúng ta đã tạo trong bài tập trước, \*\*nhưng lần này bằng SystemMessage\*\*:

#### Kết hợp các nút và cạnh để xây dựng đồ thị

```python
from langgraph.graph import START, StateGraph
from langgraph.prebuilt import tools_condition
from langgraph.prebuilt import ToolNode
from IPython.display import Image, display

# Build graph
builder = StateGraph(MessagesState)

builder.add_node("assistant", assistant)
builder.add_node("tools", ToolNode(tools))

# Add the logic of the graph
builder.add_edge(START, "assistant")

builder.add_conditional_edges(
    "assistant",
    # If the latest message (result) from assistant is a tool call -> tools_condition routes to tools
    # If the latest message (result) from assistant is a not a tool call -> tools_condition routes to END
    tools_condition,
)

# PAY ATTENTION HERE: from the tools node, back to the assistant
builder.add_edge("tools", "assistant")

# PAY ATTENTION: No END edge.

# Compile the graph
react_graph = builder.compile()

# Visualize the graph
display(Image(react_graph.get_graph(xray=True).draw_mermaid_png()))
```

  
\* act - LLM gọi một công cụ.  
\* observer - công cụ chuyển đầu ra trở lại LLM.  
\* reason - LLM quyết định phải làm gì tiếp theo (gọi một công cụ khác hoặc phản hồi trực tiếp).

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/0OFimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/0OFimage.png)

##### Chạy ứng dụng

```python
messages = [HumanMessage(content="What was the relationship between Marilyn and JFK?")]
messages = react_graph.invoke({"messages": messages})

for m in messages['messages']:
    m.pretty_print()
```

```
================================ Human Message =================================

What was the relationship between Marilyn and JFK?
================================== Ai Message ==================================

Marilyn Monroe and President John F. Kennedy (JFK) are often rumored to have had a romantic relationship, though concrete details about the nature and extent of their relationship remain speculative and are part of popular lore. The most famous public connection between them was Marilyn Monroe's sultry performance of "Happy Birthday, Mr. President" at a Democratic Party fundraiser and early birthday celebration for Kennedy in May 1962. However, both contemporaneous accounts and historical research have not conclusively proven a long-term affair, and much of the speculation is based on anecdotal evidence and hearsay.
```

```python
messages = [HumanMessage(content="Add 3 and 4. Multiply the output by 2. Divide the output by 5")]
messages = react_graph.invoke({"messages": messages})

for m in messages['messages']:
    m.pretty_print()
```

```
================================ Human Message =================================

Add 3 and 4. Multiply the output by 2. Divide the output by 5
================================== Ai Message ==================================
Tool Calls:
  add (call_UR7Cp0pbVpRyof8Dyq4kZUHm)
 Call ID: call_UR7Cp0pbVpRyof8Dyq4kZUHm
  Args:
    a: 3
    b: 4
================================= Tool Message =================================
Name: add

7
================================== Ai Message ==================================
Tool Calls:
  multiply (call_OiwYtGUW13AY8CB3qY3Y3Vlt)
 Call ID: call_OiwYtGUW13AY8CB3qY3Y3Vlt
  Args:
    a: 7
    b: 2
================================= Tool Message =================================
Name: multiply

14
...
2.8
================================== Ai Message ==================================

The final result after adding 3 and 4, multiplying the result by 2, and then dividing by 5 is 2.8.
```

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Tóm tắt chương

**Tạm dừng một chút để cùng nhau ôn lại những gì chúng ta đã học được nhé!**

Chúng ta bắt đầu chương này với cảm giác khá lo lắng – có lẽ bạn cũng từng nghĩ: "Cái LangGraph này nghe thật rối rắm và phức tạp", đúng không? Những khái niệm nghe có vẻ như dành riêng cho những người có siêu năng lực, phải có bằng tiến sĩ hay ít nhất là thạc sĩ mới hiểu nổi cách dùng nó!

Nhưng rồi khi đi đến cuối chương, ta nhận ra rằng **ai cũng có thể xây dựng ứng dụng với LangGraph**. Đằng sau những thuật ngữ nghe phức tạp đó thật ra lại là những khái niệm rất đơn giản. Và chúng ta đã thấy rằng **bất kỳ ai cũng có thể tạo ra những agent thông minh, thậm chí là những ứng dụng có thể thay đổi cả thế giới**.

### Vậy cụ thể, ta đã làm gì?

- Đầu tiên, chúng ta học các **khái niệm cơ bản** của một ứng dụng LangGraph: state là gì, schema của state là gì, node là gì, edge là gì, quá trình compile là gì...
- Sau đó, ta xây dựng một app đơn giản dự đoán người dùng sẽ chọn Trà hay Coffee.
- Ta học được quy trình 5 bước để xây dựng một ứng dụng LangGraph:
    
    
    1. Định nghĩa state.
    2. Thêm node và edge.
    3. Biên dịch (compile).
    4. Hiển thị sơ đồ (visualize).
    5. Chạy ứng dụng.

Đơn giản đúng không nào?

- Tiếp theo, ta xây dựng một **chatbot** sử dụng LangGraph, học về khái niệm **reducer** – một từ nghe "kêu" nhưng thực chất chỉ là cách để cập nhật lại state theo cách riêng của mình.
- Ta sử dụng các **module có sẵn** như `message state`, giúp giảm lượng code cần viết.
- Sau đó, ta nâng cấp chatbot bằng cách **thêm tool** và **xây dựng hành vi agent**, nơi mà ứng dụng quyết định dùng chatbot hay gọi tool để trả lời người dùng.
- Ta học cách dùng `tool node` và `tool condition`, tạo router để định tuyến theo điều kiện đầu vào.

Và cuối cùng, **ta đã tạo ra agent đầu tiên của mình** bằng cách cho phép tool phản hồi trở lại LLM – chính là mô hình **ReAct**: act (gọi tool), observe (quan sát kết quả), reason (suy luận xem làm gì tiếp theo).

---

### Sắp tới là gì?

Trong chương tiếp theo, chúng ta sẽ khám phá một chủ đề cực kỳ quan trọng trong thế giới LangGraph: **Memory (Bộ nhớ)**.

Dù trước giờ ta đã nói về state và một chút về memory, nhưng bạn sẽ thấy rằng, trong LangGraph, **memory không đơn giản chỉ là lưu trữ thông tin – nó là cốt lõi để tạo ra những agent thông minh và có tính phản hồi cao**.

Hãy chuẩn bị tinh thần để bước vào một chương siêu hấp dẫn nhé!

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Memory (Bộ nhớ)

**Một trong những yếu tố quan trọng nhất để tạo nên sự khác biệt** giữa một agent “bình thường” và một agent “đỉnh cao” sẵn sàng chạy trên môi trường thực tế (production).  
**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Giới Thiệu

#### **Tiếp tục hành trình – Bước vào một chủ đề cực kỳ quan trọng: Memory (Bộ nhớ) trong LangGraph**

Trong phần này, chúng ta sẽ đào sâu vào một chủ đề đóng vai trò sống còn khi xây dựng agent bằng LangGraph – đó chính là **memory (bộ nhớ)**. Và không chỉ nói đến **trí nhớ ngắn hạn(short term memory)**, mà cả **trí nhớ dài hạn(long term memory)** nữa!

Ngay từ đầu, bạn sẽ nhận ra: đây chính là **một trong những yếu tố quan trọng nhất để tạo nên sự khác biệt** giữa một agent “bình thường” và một agent “đỉnh cao” sẵn sàng chạy trên môi trường thực tế (production).

Nói đơn giản:  
**Ứng dụng của bạn có thật sự thông minh và đáng nhớ hay chỉ dừng lại ở mức “cho vui” – tất cả nằm ở cách bạn xử lý memory.**

#### **Vậy chúng ta sẽ học gì?**

Chúng ta sẽ bắt đầu với phần dễ trước – **trí nhớ ngắn hạn(short term memory)**. Đây là loại bộ nhớ gắn liền với **cuộc trò chuyện hiện tại** giữa người dùng và agent.

Nếu bạn muốn agent của mình **hiểu được mạch hội thoại** (biết bạn vừa nói gì, nhớ câu hỏi trước, không bị “mất trí nhớ ngắn hạn”), thì bạn cần phải **kích hoạt **trí nhớ dài hạn(long term memory)**** cho nó.

Và bạn sẽ thấy: Việc này **cực kỳ đơn giản** với LangGraph.

#### **Có những thứ bạn cần nắm trước**

Trong tài liệu chính thức của LangGraph, khi họ bắt đầu nói về memory, họ thường đưa ra rất nhiều khái niệm như:

- cách định dạng schema của state,
- dùng reducer tùy chỉnh (custom reducers),
- hay sử dụng nhiều schema trạng thái trong một ứng dụng.

Thành thật mà nói, **cách LangGraph viết tài liệu không phải lúc nào cũng dễ hiểu**, thậm chí có thể gây rối nếu bạn mới bắt đầu.

Vì vậy, chúng ta sẽ làm rõ ba khái niệm đó trước – theo cách **đơn giản, trực quan và đúng bản chất**, giúp bạn hiểu sâu mà **không bị rối bởi quá nhiều dòng code**.

#### **Mục tiêu của phần này là gì?**

- Giúp bạn hiểu rõ **trí nhớ ngắn hạn(short term memory)** hoạt động như thế nào trong LangGraph.
- Làm quen với các khái niệm nâng cao: `state schema`, `custom reducer`, và `multiple schemas`.
- Tập trung vào phần **tư duy và logic**, không sa đà vào chi tiết lập trình.

 Hãy sẵn sàng! Trong những bài tiếp theo, chúng ta sẽ cùng nhau khám phá kỹ hơn về 4 khái niệm trên, với những ví dụ thực tế và trực quan nhất.

Bạn chỉ cần nhớ: **đừng để tài liệu khó hiểu làm bạn nản lòng – chúng ta sẽ đi từng bước, và bạn chắc chắn sẽ làm được.**

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Thêm Bộ Nhớ Ngắn Hạn vào Agent trong LangGraph

Trong bài học này, chúng ta sẽ tìm hiểu cách thêm **bộ nhớ ngắn hạn (short-term memory)** vào agent để nó có thể ghi nhớ ngữ cảnh của cuộc trò chuyện. Điều này giúp agent hiểu được các yêu cầu liên tiếp từ người dùng một cách chính xác hơn.

#### **Vấn đề của Agent Không Có Bộ Nhớ**

Trong bài tập trước, chúng ta đã xây dựng một agent đơn giản có thể thực hiện các phép tính toán học bằng cách di chuyển qua các node **"assistant"** và **"tools"**. Tuy nhiên, agent này có một hạn chế lớn: **nó không có bộ nhớ**.

##### **Ví dụ minh họa:**

1. Người dùng yêu cầu:  
    *"3 + 5."*  
    → Agent trả lời: *"Tổng của 3 + 5 = 8"*
2. Người dùng tiếp tục:  
    *"nhân kết quả với 2"*

Nếu agent **không có bộ nhớ**, nó sẽ không hiểu *"kết quả"* ám chỉ kết quả trước đó và yêu cầu người dùng cung cấp lại số:  
*"Tôi cần một số cụ thể để nhân với hai. Bạn vui lòng cung cấp số bạn muốn nhân"*

Điều này gây bất tiện vì người dùng phải lặp lại thông tin đã cung cấp trước đó.

#### **Cách Thêm Bộ Nhớ Ngắn Hạn vào Agent**

Trong **LangGraph**, việc thêm bộ nhớ ngắn hạn rất đơn giản bằng cách sử dụng module **`MemorySaver`**. Module này giúp lưu trữ thông tin tạm thời trong một phiên hội thoại cụ thể.

#### **1. Sử dụng `MemorySaver` tại bước `compile`**

Khi khởi tạo agent, chúng ta thêm bộ nhớ vào trong quá trình **compile**:

```python
from langgraph.checkpoint.memory import MemorySaver

memory = MemorySaver()

react_graph_memory = builder.compile(checkpointer=memory)
```

#### **2. Sử dụng `thread_id` để phân biệt các cuộc hội thoại**

Để đảm bảo bộ nhớ chỉ áp dụng cho **một phiên trò chuyện cụ thể**, ta sử dụng **`thread_id`** khi gọi `invoke`:

```
config = {"configurable": {"thread_id": "1"}}

messages = [HumanMessage(content="Add 3 and 4.")]

messages = react_graph_memory.invoke({"messages": messages},config)

```

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Thực hành bộ nhớ ngắn hạn

Trong bài học này, chúng ta sẽ học cách thêm bộ nhớ ngắn hạn vào agent của mình.

#### **1. Cài đặt**

**Tại console:**

```
* cd project_name
* pyenv local 3.11.4
* poetry install
* poetry shell
* jupyter lab
```

#### **2. Tạo file .env**

```
* OPENAI_API_KEY=your_openai_api_key
* LANGCHAIN_TRACING_V2=true
* LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
* LANGCHAIN_API_KEY=your_langchain_api_key
* LANGCHAIN_PROJECT=your_project_name
```

3\. Kết nối với tệp .env nằm trong cùng thư mục của notebook

```
#pip install python-dotenv
```

```python
import os
from dotenv import load_dotenv, find_dotenv
_ = load_dotenv(find_dotenv())
openai_api_key = os.environ["OPENAI_API_KEY"]
```

#### **3. Cài đặt LangChain**

```python
#!pip install langchain
#!pip install langchain-openai
```

```python
from langchain_openai import ChatOpenAI

chatModel35 = ChatOpenAI(model="gpt-3.5-turbo-0125")
chatModel4o = ChatOpenAI(model="gpt-4o")
```

#### **4. LLM kết hợp với nhiều công cụ hỗ trợ**

```python
from langchain_openai import ChatOpenAI
from langchain.tools import tool

@tool
def multiply(a: int, b: int) -> int:
    """Multiply a and b.

    Args:
        a: first int
        b: second int
    """
    return a * b

@tool
def add(a: int, b: int) -> int:
    """Adds a and b.

    Args:
        a: first int
        b: second int
    """
    return a + b
  
@tool
def divide(a: int, b: int) -> float:
    """Divide a and b.

    Args:
        a: first int
        b: second int
    """
    return a / b

tools = [add, multiply, divide]
llm_with_tools = chatModel4o.bind_tools(tools, parallel_tool_calls=False)
```

##### **`parallel_tool_calls=True`**

Đây là **gọi công cụ song song** (chạy nhiều công cụ cùng lúc).

- **Ý tưởng:** Nếu mô hình cần gọi nhiều công cụ để trả lời người dùng, nó có thể gọi tất cả các công cụ cùng một lúc, không cần chờ từng cái chạy xong.
- **Ưu điểm:** Nhanh hơn! Vì các công cụ chạy đồng thời.
- **Khi nào nên dùng:** Khi các công cụ **không phụ thuộc** vào kết quả của nhau. Ví dụ: bạn hỏi đồng thời "thời tiết ở TP. Hồ Chí Minh?" và "giá Bitcoin hôm nay?" — hai việc này độc lập nhau.

##### **`parallel_tool_calls=False`**

Đây là **gọi công cụ tuần tự** (chạy lần lượt từng cái một).

- **Ý tưởng:** Mỗi công cụ được gọi **theo thứ tự**, cái sau có thể dùng kết quả của cái trước.
- **Ưu điểm:** Giữ đúng logic nếu cần kết quả từng bước.
- **Khi nào nên dùng:** Khi các công cụ **phụ thuộc lẫn nhau**. Ví dụ:
    
    
    - Bước 1: Tính tổng
    - Bước 2: Dùng kết quả tổng để chia 2  
        → Phải làm từng bước theo thứ tự.

Chi tiết tại

[https://python.langchain.com/docs/how\_to/tool\_calling\_parallel/](https://python.langchain.com/docs/how_to/tool_calling_parallel/)

#### **5. Xây dựng một ứng dụng (gọi là đồ thị trong langgraph) quyết định xem có nên trò chuyện bằng LLM hay sử dụng công cụ**

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/LVyimage.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/LVyimage.png)

##### **5.1 Định nghĩa State schema**

```python
from langgraph.graph import MessagesState

class MessagesState(MessagesState):
    # Add any keys needed beyond messages, which is pre-built 
    pass
```

5.2 Định nghĩa Node đầu tiên

```python
from langgraph.graph import MessagesState
from langchain_core.messages import HumanMessage, SystemMessage

# Khai báo System message
sys_msg = SystemMessage(content="Bạn là trợ lý hữu ích có nhiệm vụ thực hiện phép tính số học trên một tập hợp dữ liệu đầu vào.")

# Định nghĩa Node
def assistant(state: MessagesState):
   return {"messages": [llm_with_tools.invoke([sys_msg] + state["messages"])]}
```

##### \[sys\_msg\] + state\["messages"\]

- sys\_msg là 1 **SystemMessage** định hướng vai trò AI, ví dụ: SystemMessage(content="Bạn là trợ lý toán học.")
- `state["messages"]`: là các tin nhắn trước đó (giữa người dùng và AI).

##### **5.3. Kết hợp các Node và Edge để xây dựng Graph**

```python
from langgraph.graph import START, StateGraph
from langgraph.prebuilt import tools_condition
from langgraph.prebuilt import ToolNode
from IPython.display import Image, display

# Build graph
builder = StateGraph(MessagesState)

builder.add_node("assistant", assistant)
builder.add_node("tools", ToolNode(tools))

# Add the logic of the graph
builder.add_edge(START, "assistant")

builder.add_conditional_edges(
    "assistant",
    # Nếu câu trả lời gần nhất của assistant là một lời gọi tới tool, Thì điều kiện tools_condition sẽ quyết định đi tiếp đến node tools
    # Ngược lại, tools_condition sẽ quyết định chuyển sang node END (kết thúc luồng, trả kết quả ra ngoài).
    tools_condition,
)

# PAY ATTENTION HERE: from the tools node, back to the assistant
builder.add_edge("tools", "assistant")

# PAY ATTENTION: No END edgge.

# Compile the graph
react_graph = builder.compile()

# Visualize the graph
display(Image(react_graph.get_graph(xray=True).draw_mermaid_png()))
```

[![image.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/Dd0image.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/Dd0image.png)

##### **5.4 Chạy ứng dụng**

```python
messages = [HumanMessage(content="Add 3 and 4.")]

messages = react_graph.invoke({"messages": messages})

for m in messages['messages']:
    m.pretty_print()
```

<span class="">================================</span><span class="code-bold"> Human Message </span><span class="">================================= Add 3 and 4. ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== Tool Calls: add (call\_AKxpCcslEcimrNFvBEWZ2Ru3) Call ID: call\_AKxpCcslEcimrNFvBEWZ2Ru3 Args: a: 3 b: 4 =================================</span><span class="code-bold"> Tool Message </span><span class="">================================= Name: add 7 ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== The sum of 3 and 4 is 7.</span>

#### <span class="">**5.5 Tiếp tục hỏi Agent** </span>

```python
messages = [HumanMessage(content="Multiply that by 2.")]

messages = react_graph.invoke({"messages": messages})

for m in messages['messages']:
    m.pretty_print()
```

<span class="">================================</span><span class="code-bold"> Human Message </span><span class="">================================= Multiply that by 2. ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== I need a specific number to multiply by 2. Could you please provide the number you want to multiply?</span>

> *<span class="">Như bạn thấy, Agent yêu cầu cung cấp một số cụ thể để thực hiện phép tính nhân, nó không nhớ được kết quả của phép tính cộng đã thực hiện ở trên</span>*

##### **6. Thêm bộ nhớ**

```python
from langgraph.checkpoint.memory import MemorySaver

memory = MemorySaver()

react_graph_memory = builder.compile(checkpointer=memory)
```

```python
# PAY ATTENTION HERE: see how we specify a thread
config = {"configurable": {"thread_id": "1"}}

# Enter the input
messages = [HumanMessage(content="Add 3 and 4.")]

# PAY ATTENTION HERE: see how we add config to referr to the thread_id
messages = react_graph_memory.invoke({"messages": messages},config)

for m in messages['messages']:
    m.pretty_print()
```

**Kết quả**

<span class="">================================</span><span class="code-bold"> Human Message </span><span class="">================================= Add 3 and 4. ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== Tool Calls: add (call\_7lH6zvBw4rMeTG3Zu66i53eW) Call ID: call\_7lH6zvBw4rMeTG3Zu66i53eW Args: a: 3 b: 4 =================================</span><span class="code-bold"> Tool Message </span><span class="">================================= Name: add 7 ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== The sum of 3 and 4 is 7.</span>

**Tiếp tục yêu cầu phép tính nhân**

```python
# PAY ATTENTION HERE: see how we check if the app has memory
messages = [HumanMessage(content="Multiply that by 2.")]

# Again, see how we use config here to referr to the thread_id
messages = react_graph_memory.invoke({"messages": messages}, config)

for m in messages['messages']:
    m.pretty_print()
```

<span class="">================================</span><span class="code-bold"> Human Message </span><span class="">================================= Multiply that by 2. ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== Tool Calls: multiply (call\_x3tKpGBsTHUCbVwzBr3PiNn1) Call ID: call\_x3tKpGBsTHUCbVwzBr3PiNn1 Args:</span>

<div id="bkmrk-...">...</div><span class="">14 ==================================</span><span class="code-bold"> Ai Message </span><span class="">================================== The result of multiplying 7 by 2 is 14.</span>

<span class="">Agent đã nhớ được kết quả của phép tính cộng và thực hiện phép tính nhân</span>

<span class="">**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**</span>

# Định dạng state schema trong LangGraph từ TypeDict sang Pydantic

#### **Trong ba bài học tiếp theo, chúng tôi sẽ giới thiệu cho bạn về một số khái niệm thú vị mà bạn sẽ gặp trong tài liệu của LangGraph, đặc biệt là trong phần *memo*.**

Tuy nhiên, ở thời điểm này, những khái niệm này có thể gây xao nhãng cho bạn. Vì vậy, chúng tôi **không khuyến khích bạn đào sâu vào các chủ đề này ngay lúc này**. Mục tiêu là **giúp bạn hiểu khái niệm** và **biết nơi có thể tìm hiểu thêm khi cần thiết**.

#### **Chủ đề đầu tiên là các cách định dạng state schema trong LangGraph.**

Nếu bạn còn nhớ, khi tạo **state schema** trong các bài tập trước, chúng ta **luôn sử dụng loại `TypeDict`**.

`TypeDict` là một cách rất đơn giản để xây dựng state schema.  
Tuy nhiên, **khi bạn làm việc với các ứng dụng ở cấp độ production**, cách này có thể **quá đơn giản** và **thiếu tính an toàn**, đặc biệt trong việc **phát hiện lỗi** hoặc **cảnh báo khi có điều gì đó sai** trong ứng dụng của bạn.

**Trong bài học này, chúng tôi sẽ giải thích nội dung mà tài liệu của LangGraph đề cập về các cách định dạng state schema:**

**Bao gồm:**

- Cách sử dụng `TypeDict` (cơ bản nhất)
- Sử dụng `Literal` để làm cho `TypeDict` mạnh mẽ hơn
- Sử dụng `dataclass` (tiến bộ hơn)
- Cuối cùng và quan trọng nhất: **sử dụng `Pydantic`**

#### **I. TypeDict trong State Schema**

`TypeDict` là một cách đơn giản và nhanh chóng để định nghĩa **state schema** – tức là cấu trúc trạng thái (state) mà LangGraph sẽ lưu trữ và truyền giữa các node (hoặc giữa LLM và công cụ).

Nó là một alias của `TypedDict` trong Python, được dùng để định nghĩa dictionary có kiểu rõ ràng cho từng key.

**Khi nào nên dùng `TypeDict`?**

- Khi bạn muốn tạo **state đơn giản**
- Phù hợp với các **ứng dụng nhỏ hoặc giai đoạn thử nghiệm**
- Không yêu cầu xác thực đầu vào quá nghiêm ngặt

**Cách định nghĩa State Schema với `TypeDict`**

```python
from typing import TypedDict

class MyState(TypedDict):
    name: str
    mood: str
    count: int
```

Trong ví dụ trên, `MyState` định nghĩa một state có 3 trường:

- `name`: kiểu `str`
- `mood`: kiểu `str`
- `count`: kiểu `int`

##### **Ví dụ trong LangGraph**

```python
from langgraph.graph import StateGraph

# Định nghĩa schema bằng TypeDict
class State(TypedDict):
    name: str
    mood: str

# Tạo Graph với state schema
builder = StateGraph(State)

# Add nodes, edges... (ví dụ đơn giản)
def greet(state: State) -> State:
    print(f"Hello, {state['name']}! You seem {state['mood']} today.")
    return state

builder.add_node("greet", greet)
builder.set_entry_point("greet")

app = builder.compile()

# Chạy thử
initial_state = {"name": "Alice", "mood": "happy"}
app.invoke(initial_state)
```

**Lưu ý khi dùng TypeDict**

- **Không kiểm tra giá trị hợp lệ** – ví dụ, nếu bạn muốn `mood` chỉ nhận `"happy"` hoặc `"sad"`, thì TypeDict **không báo lỗi** nếu bạn truyền `"angry"`.
- **Không hỗ trợ xác thực dữ liệu phức tạp**
- Nếu state sai kiểu (ví dụ `count="abc"`), nó vẫn có thể chạy mà không báo lỗi rõ ràng

<table class="min-w-full" data-end="2354" data-start="1996" id="bkmrk-%C6%AFu-%C4%91i%E1%BB%83m-h%E1%BA%A1n-ch%E1%BA%BF-d%E1%BB%85-v" style="height: 103px; width: 100%;"><thead data-end="2067" data-start="1996"><tr data-end="2067" data-start="1996"><th data-end="2028" data-start="1996" style="width: 49.9405%;">Ưu điểm</th><th data-end="2067" data-start="2028" style="width: 49.9405%;">Hạn chế</th></tr></thead><tbody data-end="2354" data-start="2139"><tr data-end="2210" data-start="2139"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2171" data-start="2139" style="width: 49.9405%;">Dễ viết, nhanh chóng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2210" data-start="2171" style="width: 49.9405%;">Không xác thực dữ liệu</td></tr><tr data-end="2282" data-start="2211"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2243" data-start="2211" style="width: 49.9405%;">Phù hợp cho prototyping(giai đoạn thử nghiệm hoặc xây dựng bản mẫu)</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2282" data-start="2243" style="width: 49.9405%;">Dễ gây lỗi trong ứng dụng lớn</td></tr><tr data-end="2354" data-start="2283"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2315" data-start="2283" style="width: 49.9405%;">Sử dụng chuẩn Python typing</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2354" data-start="2315" style="width: 49.9405%;">Không cảnh báo khi sai dữ liệu</td></tr></tbody></table>

##### **II. Literal**

Trong Python, `Literal` được cung cấp bởi thư viện `typing` và cho phép bạn **ràng buộc giá trị của một biến chỉ được phép nằm trong một tập hợp cụ thể**. Đây là một cách tuyệt vời để **tăng tính an toàn** cho state schema, đảm bảo rằng người dùng hoặc ứng dụng chỉ có thể nhập những giá trị hợp lệ.

**`Literal` trong State Schema**

Khi định nghĩa **trạng thái (state)** trong LangGraph, bạn có thể muốn giới hạn một trường nào đó chỉ nhận một số giá trị nhất định.  
Ví dụ: trạng thái "mood" chỉ được là `"happy"` hoặc `"sad"` — không được là `"angry"`, `"confused"`, v.v.

Ví dụ 1

```python
from typing import TypedDict, Literal

class MyState(TypedDict):
    mood: Literal["happy", "sad"]
```

Trong ví dụ trên:

- Trường `mood` **chỉ được nhận một trong hai giá trị**: `"happy"` hoặc `"sad"`.
- Nếu bạn cố gắng gán giá trị khác như `"excited"` hoặc `"angry"`, thì trình phân tích tĩnh (hoặc các công cụ như `pydantic`) sẽ cảnh báo lỗi.

Ví dụ 2

```python
from typing import TypedDict, Literal

class UserState(TypedDict):
    name: str
    mood: Literal["happy", "sad"]
```

Giá trị hợp lệ:

```python
state: UserState = {
    "name": "Alice",
    "mood": "happy"
}
```

Giá trị không hợp lệ (trình kiểm tra type sẽ cảnh báo):

```python
state: UserState = {
    "name": "Alice",
    "mood": "angry"  # ❌ Không nằm trong Literal["happy", "sad"]
}
```

Trong LangGraph, bạn có thể sử dụng `Literal` để đảm bảo rằng luồng logic của bạn hoạt động đúng như mong đợi.  
Ví dụ:

```python
class WorkflowState(TypedDict):
    step: Literal["start", "processing", "done"]

```

Với định nghĩa này, bạn có thể đảm bảo:

- Chỉ các bước `"start"`, `"processing"`, hoặc `"done"` mới được sử dụng.
- Tránh lỗi do nhập sai chuỗi hoặc thiếu kiểm tra logic.

#### **III. `dataclass` để tạo state schema**

**Nhắc lại dataclass trong python**

`dataclasses `giúp bạn **tự động tạo ra các phương thức** như:

- `__init__()` – hàm khởi tạo
- `__repr__()` – biểu diễn đối tượng
- `__eq__()` – so sánh bằng
- `__hash__()` – dùng cho tập hợp, từ điển
- `__lt__()`, `__le__()`... nếu bạn bật `order=True`

Ví dụ

```python
from dataclasses import dataclass

@dataclass
class Person:
    name: str
    age: int
```

**Python sẽ tự động sinh ra:**

```python
def __init__(self, name: str, age: int):
    self.name = name
    self.age = age
```

#### **`dataclass` để tạo state schema(Chi tiết về [dataclass tại đây](https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/dataclass))**

```python
from dataclasses import dataclass

@dataclass
class ConversationState:
    name: str
    mood: str
    count: int = 0  # Giá trị mặc định

```

**`__post_init__`: logic sau khi khởi tạo**

```python
@dataclass
class State:
    name: str
    mood: str

    def __post_init__(self):
        if self.mood not in ["happy", "sad"]:
            raise ValueError("Mood must be 'happy' or 'sad'")

```

Hợp lệ

```python
state = State(name="Lan", mood="happy")
print(state)
# Output: ConversationState(name='Lan', mood='happy')
```

<span style="color: rgb(224, 62, 45);">Không hợp lệ</span>

```python
state = State(name="Lan", mood="angry")
# Output: ValueError: Mood must be 'happy' or 'sad'

```

##### **IV. Dùng `Pydantic` làm State Schema trong LangGraph**

[**Chi tiết về Pydantic**](https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/pydantic "Chi tiết về Pydantic")

Trong LangGraph, **State Schema** định nghĩa cấu trúc dữ liệu sẽ được truyền và cập nhật giữa các node trong graph.  
Pydantic là một thư viện mạnh mẽ giúp **xác thực dữ liệu, kiểm tra lỗi đầu vào và định kiểu rõ ràng**, rất phù hợp cho các ứng dụng thực tế (production-level).

**Ưu điểm khi dùng Pydantic cho State Schema**

- Tự động kiểm tra và xác thực dữ liệu đầu vào
- Xác định kiểu dữ liệu rõ ràng, dễ đọc
- Hiển thị lỗi rõ ràng và chi tiết khi dữ liệu không đúng định dạng
- Dễ mở rộng, dễ bảo trì khi project phức tạp hơn

#### **Cách định nghĩa State Schema bằng Pydantic**

Bạn sẽ tạo một lớp kế thừa từ `pydantic.BaseModel`.  
Mỗi thuộc tính của lớp đại diện cho một phần trong trạng thái.

**1. Cài đặt pydantic**

```python
pip install pydantic
```

**2. Tạo State**

```python
from pydantic import BaseModel
from typing import Literal

class MyState(BaseModel):
    name: str
    age: int
    mood: Literal["happy", "sad"]

```

- `name`: bắt buộc phải là chuỗi (`str`)
- `age`: là số nguyên
- `mood`: chỉ chấp nhận `"happy"` hoặc `"sad"`→ nếu giá trị khác sẽ báo lỗi

##### **Ví dụ sử dụng trong LangGraph:**

```python
from langgraph.graph import StateGraph, END
from langgraph.checkpoint import MemorySaver

# Định nghĩa schema với Pydantic
class State(BaseModel):
    name: str
    mood: Literal["happy", "sad"]

# Node đơn giản: in trạng thái hiện tại
def print_state(state: State):
    print(f"👤 {state.name} đang cảm thấy {state.mood}")
    return state

# Tạo graph
builder = StateGraph(State)
builder.add_node("printer", print_state)
builder.set_entry_point("printer")
builder.set_finish_point("printer")

# Chạy
graph = builder.compile()
graph.invoke({"name": "An", "mood": "happy"})  # ✅ OK
graph.invoke({"name": "An", "mood": "angry"})  # ❌ Gây lỗi ValidationError

```

**Khi có lỗi, bạn sẽ thấy:**

```python
ValidationError: 1 validation error for State
mood
  unexpected value; permitted: 'happy', 'sad' (type=value_error.const; given=angry; permitted=('happy', 'sad'))

```

**Mở rộng với mặc định và tùy chỉnh:**

```python
from pydantic import Field

class State(BaseModel):
    name: str = Field(..., description="Tên người dùng")
    mood: Literal["happy", "sad"] = "happy"  # mặc định là happy

```

- Đây là cách bạn tạo một **State Schema** trong LangGraph bằng `Pydantic`.
- `BaseModel` là lớp cơ sở của Pydantic dùng để định nghĩa và kiểm tra kiểu dữ liệu.

`name: str = Field(..., description="Tên người dùng")`

- `name` là một **thuộc tính bắt buộc** phải là chuỗi (`str`).
- `Field(...)` với dấu ba chấm `...` có nghĩa là **giá trị này bắt buộc phải được truyền vào**.
- `description="Tên người dùng"` chỉ là mô tả – không bắt buộc, nhưng hữu ích khi dùng để sinh docs hoặc debug.

Nếu bạn không truyền `name`, bạn sẽ nhận được lỗi:

```
ValidationError: 1 validation error for State
name
  field required (type=value_error.missing)
```

### `mood: Literal["happy", "sad"] = "happy"`

- `mood` là một **thuộc tính tùy chọn** với giá trị mặc định là `"happy"`.
- `Literal["happy", "sad"]` có nghĩa là: chỉ được phép là `"happy"` hoặc `"sad"`. Bất kỳ giá trị nào khác đều bị từ chối.
- `= "happy"` nghĩa là nếu người dùng không truyền giá trị `mood`, thì mặc định sẽ là `"happy"`.

```python
State(name="An")  # OK, mood mặc định là "happy"
State(name="An", mood="sad")  # OK
State(name="An", mood="angry")  # ❌ Lỗi vì "angry" không nằm trong ["happy", "sad"]

```

**Tổng kết:**

<table class="min-w-full" data-end="1873" data-start="1567" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-gi%E1%BA%A3i-th%C3%ADc" style="height: 126px; width: 100%;"><thead data-end="1594" data-start="1567"><tr data-end="1594" data-start="1567"><th class="align-left" data-end="1580" data-start="1567" style="width: 49.9405%;">**Thành phần**</th><th class="align-left" data-end="1594" data-start="1580" style="width: 49.9405%;">**Giải thích**</th></tr></thead><tbody data-end="1873" data-start="1623"><tr data-end="1674" data-start="1623"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1638" data-start="1623" style="width: 49.9405%;">`Field(...)`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1674" data-start="1638" style="width: 49.9405%;">Đánh dấu giá trị là **bắt buộc**</td></tr><tr data-end="1723" data-start="1675"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1691" data-start="1675" style="width: 49.9405%;">`description`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1723" data-start="1691" style="width: 49.9405%;">Ghi chú mô tả, dùng cho docs</td></tr><tr data-end="1801" data-start="1724"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1741" data-start="1724" style="width: 49.9405%;">`Literal[...]`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1801" data-start="1741" style="width: 49.9405%;">Ràng buộc giá trị chỉ được nằm trong một tập hợp cố định</td></tr><tr data-end="1873" data-start="1802"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="1818" data-start="1802" style="width: 49.9405%;">`= "giá trị"`</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="1873" data-start="1818" style="width: 49.9405%;">Thiết lập giá trị **mặc định** nếu không truyền vào</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Cách Tùy Chỉnh Cập Nhật Trạng Thái bằng Reducers

Trong LangGraph, **Reducers** là những hàm đặc biệt được sử dụng để **tổng hợp dữ liệu** hoặc **kết hợp trạng thái** khi có nhiều luồng song song (parallel branches) trả về kết quả khác nhau.

Nói cách khác:

> Khi bạn chạy nhiều node cùng lúc (parallel), và muốn gom kết quả từ chúng lại để đưa vào bước tiếp theo – thì bạn cần một **Reducer**.

Bạn cần dùng Reducer khi:

- Bạn có **các nhánh song song** trong graph.
- Mỗi nhánh thực hiện công việc riêng và trả về một phần kết quả.
- Bạn cần gom các kết quả đó về **một trạng thái chung** trước khi đi tiếp.

<table class="min-w-full" data-end="3042" data-start="2745" id="bkmrk-m%E1%BB%A5c-%C4%91%C3%ADch-chi-ti%E1%BA%BFt-k%E1%BA%BF" style="height: 155px; width: 100%;"><thead data-end="2768" data-start="2745"><tr data-end="2768" data-start="2745"><th class="align-left" data-end="2756" data-start="2745" style="width: 49.9405%;">**Mục đích**</th><th class="align-left" data-end="2768" data-start="2756" style="width: 49.9405%;">**Chi tiết**</th></tr></thead><tbody data-end="3042" data-start="2792"><tr data-end="2850" data-start="2792"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2813" data-start="2792" style="width: 49.9405%;">Kết hợp dữ liệu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2850" data-start="2813" style="width: 49.9405%;">Khi có nhiều nhánh chạy song song</td></tr><tr data-end="2908" data-start="2851"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2869" data-start="2851" style="width: 49.9405%;">Nhận đầu vào</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2908" data-start="2869" style="width: 49.9405%;">Một danh sách các trạng thái (dict)</td></tr><tr data-end="2969" data-start="2909"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2925" data-start="2909" style="width: 49.9405%;">Trả đầu ra</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2969" data-start="2925" style="width: 49.9405%;">Một trạng thái duy nhất đã được tổng hợp</td></tr><tr data-end="3042" data-start="2970"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2984" data-start="2970" style="width: 49.9405%;">Ứng dụng</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="3042" data-start="2984" style="width: 49.9405%;">Tổng hợp kết quả LLM, kết hợp thông tin từ nhiều nguồn</td></tr></tbody></table>

Giả sử bạn có 3 nhánh song song:

- Node A xử lý phần tên.
- Node B xử lý địa chỉ.
- Node C xử lý số điện thoại.

Sau khi 3 node này chạy xong, bạn cần gộp kết quả lại thành:

```python
{
  "name": "VHTSoft",
  "address": "TP. Hồ Chí Minh",
  "phone": "0123456789"
}
```

Reducer sẽ **gom và hợp nhất** những giá trị này thành một trạng thái chung.

#### **Định nghĩa Reducer**

Reducer là một hàm nhận vào nhiều trạng thái (dưới dạng danh sách) và trả về một trạng thái duy nhất.

```python
def my_reducer(states: list[dict]) -> dict:
    result = {}
    for state in states:
        result.update(state)  # Gộp tất cả dict lại
    return result

```

#### **Cách sử dụng trong LangGraph**

Khi bạn xây dựng graph với `StateGraph`, bạn có thể chỉ định reducer cho một node nhất định như sau:

```python
from langgraph.graph import StateGraph

builder = StateGraph(dict)
# Các node song song được thêm ở đây...

# Thêm reducer cho node tổng hợp
builder.add_reducer("merge_node", my_reducer)

```

#### **Ví dụ thực tế**

**1. Khai báo các node**

```python
def node_1(state): return {"name": "VHTSoft"}
def node_2(state): return {"address": "TP.Hồ Chí Minh"}
def node_3(state): return {"phone": "0123456789"}

```

**2. Tạo graph**

```python
builder = StateGraph(dict)
builder.add_node("node_1", node_1)
builder.add_node("node_2", node_2)
builder.add_node("node_3", node_3)
builder.add_node("merge_node", lambda x: x)  # Dummy node

# Thêm reducer
def my_reducer(states):  # states là list các dict
    result = {}
    for s in states:
        result.update(s)
    return result

builder.add_reducer("merge_node", my_reducer)

# Chạy 3 node song song → gộp về merge_node
builder.add_edge("node_1", "merge_node")
builder.add_edge("node_2", "merge_node")
builder.add_edge("node_3", "merge_node")

builder.set_entry_point("node_1")  # node_1 là điểm vào chính

graph = builder.compile()
```

#### **Các hàm hữu ích về Reducers trong LangGraph**

##### 1. **Custom Logic trong Reducer**

Bạn không bị giới hạn bởi việc chỉ dùng `dict.update()`. Bạn có thể áp dụng **bất kỳ logic tùy chỉnh nào** để gộp dữ liệu:

**Ví dụ: Lọc trạng thái hợp lệ**

```python
def filtered_reducer(states: list[dict]) -> dict:
    final_state = {}
    for state in states:
        # Bỏ qua những trạng thái thiếu dữ liệu cần thiết
        if "score" in state and state["score"] >= 0.8:
            final_state.update(state)
    return final_state

```

#### Dùng khi:

- Bạn chỉ muốn lấy kết quả “đủ tốt” từ các nhánh.
- Bạn có các nhánh xử lý có thể bị lỗi, hoặc chất lượng không đồng đều.

Trong ví dụ này, ta sẽ có 3 nhánh song song trả về thông tin khác nhau cùng với một chỉ số **độ tin cậy (`score`)**. Sau đó, ta sẽ dùng một `reducer` để **chỉ giữ lại những kết quả có `score >= 0.8`**.

Giả sử bạn có một graph với 3 agent xử lý một nhiệm vụ phân tích cảm xúc từ một đoạn văn. Mỗi agent trả về:

- `sentiment`: happy/sad/neutral
- `score`: độ tin cậy (confidence score)

Bạn chỉ muốn giữ lại kết quả của các agent **có độ tin cậy cao (score ≥ 0.8)**.

**Bước 1: Tạo các node trả về kết quả**

```python
from langgraph.graph import StateGraph, END
from typing import TypedDict

class State(TypedDict):
    sentiment: str
    score: float

# Mỗi node trả về một kết quả khác nhau
def analyzer_1(state):
    return {"sentiment": "happy", "score": 0.9}

def analyzer_2(state):
    return {"sentiment": "sad", "score": 0.7}  # Không đạt

def analyzer_3(state):
    return {"sentiment": "neutral", "score": 0.85}

```

**Bước 2: Tạo `filtered_reducer`**

```python
def filtered_reducer(states: list[dict]) -> dict:
    for state in states:
        if state.get("score", 0) >= 0.8:
            return state  # Trả về state đầu tiên đạt yêu cầu
    return {"sentiment": "unknown", "score": 0.0}
```

**Bước 3: Dựng graph và chạy thử**

```python
graph = StateGraph(State)
graph.add_node("analyzer_1", analyzer_1)
graph.add_node("analyzer_2", analyzer_2)
graph.add_node("analyzer_3", analyzer_3)

graph.add_edge("analyzer_1", END)
graph.add_edge("analyzer_2", END)
graph.add_edge("analyzer_3", END)

graph.set_entry_point(["analyzer_1", "analyzer_2", "analyzer_3"])
graph.set_finish_point(END, filtered_reducer)

app = graph.compile()

result = app.invoke({})
print(result)
```

**Kết quả mong đợi:**

```
{'sentiment': 'happy', 'score': 0.9}
```

Vì analyzer\_1 là node đầu tiên đạt yêu cầu `score >= 0.8`, nên nó được giữ lại. Các kết quả khác bị bỏ qua.

##### **Biến thể nâng cao: Trả về danh sách tất cả các kết quả tốt**

```python
def filtered_reducer(states: list[dict]) -> dict:
    good_results = [s for s in states if s.get("score", 0) >= 0.8]
    return {"results": good_results}
```

**Kết quả:**

```python
{
  'results': [
    {'sentiment': 'happy', 'score': 0.9},
    {'sentiment': 'neutral', 'score': 0.85}
  ]
}

```

## 2. **Merging trạng thái phức tạp (nested)**

Giả sử mỗi nhánh trả về trạng thái **dạng lồng nhau (nested)**:

```python
{
  "agent": {
    "name": "Alice",
    "tasks": ["translate"]
  }
}
```

Bạn có thể merge có điều kiện, thậm chí hợp nhất danh sách:

```python
def deep_merge_reducer(states: list[dict]) -> dict:
    merged = {"agent": {"name": "", "tasks": []}}
    for state in states:
        agent = state.get("agent", {})
        if "name" in agent:
            merged["agent"]["name"] = agent["name"]
        if "tasks" in agent:
            merged["agent"]["tasks"] += agent["tasks"]
    return merged
```

Giả sử bạn có một hệ thống thu thập thông tin sản phẩm từ nhiều nguồn. Mỗi node (agent) sẽ trả về thông tin chi tiết khác nhau về sản phẩm, như:

- `name`
- `price`
- `reviews`

Mỗi thông tin nằm trong một cấu trúc **nested dictionary**:

```python
{
  "product": {
    "name": ...,
    "price": ...,
    "reviews": [...],
  }
}
```

Chúng ta sẽ merge lại tất cả thành một `state` hoàn chỉnh.

**1. Định nghĩa state phức tạp**

```python
from typing import TypedDict, Optional
from langgraph.graph import StateGraph, END

class ProductInfo(TypedDict, total=False):
    name: Optional[str]
    price: Optional[float]
    reviews: list[str]

class State(TypedDict, total=False):
    product: ProductInfo
```

**2. Các node thu thập thông tin khác nhau**

```python
def fetch_name(state):
    return {
        "product": {
            "name": "Smartphone X"
        }
    }

def fetch_price(state):
    return {
        "product": {
            "price": 799.99
        }
    }

def fetch_reviews(state):
    return {
        "product": {
            "reviews": ["Good value", "Excellent battery", "Fast delivery"]
        }
    }
```

#### **3. Merge state phức tạp bằng custom reducer**

LangGraph sẽ merge các dicts theo mặc định, **nhưng với dict lồng nhau**, bạn cần viết `custom reducer`.

```python
def nested_merge_reducer(states: list[dict]) -> dict:
    merged = {"product": {}}
    for state in states:
        product = state.get("product", {})
        for key, value in product.items():
            if key == "reviews":
                merged["product"].setdefault("reviews", []).extend(value)
            else:
                merged["product"][key] = value
    return merged
```

**4. Tạo Graph**

```python
graph = StateGraph(State)

graph.add_node("name", fetch_name)
graph.add_node("price", fetch_price)
graph.add_node("reviews", fetch_reviews)

graph.add_edge("name", END)
graph.add_edge("price", END)
graph.add_edge("reviews", END)

graph.set_entry_point(["name", "price", "reviews"])
graph.set_finish_point(END, nested_merge_reducer)

app = graph.compile()
result = app.invoke({})

print(result)

```

**Kết quả mong đợi:**

```python
{
  "product": {
    "name": "Smartphone X",
    "price": 799.99,
    "reviews": [
      "Good value",
      "Excellent battery",
      "Fast delivery"
    ]
  }
}

```

**Ghi chú:**

- Nếu bạn không viết `reducer`, các dict lồng nhau sẽ **bị ghi đè**.
- `nested_merge_reducer` giúp **kết hợp thông minh** các phần tử trong `product`.

#### 3. **Giữ thứ tự hoặc gán vai trò**

Trong một số trường hợp, bạn muốn biết được nhánh nào trả về cái gì, thay vì merge chung.

```python
def role_based_reducer(states: list[dict]) -> dict:
    return {
        "summarizer_result": states[0]["output"],
        "validator_result": states[1]["output"],
        "rewriter_result": states[2]["output"],
    }
```

#### **Ví Dụ**

Bạn đang xây dựng một ứng dụng **hội thoại** với nhiều agent khác nhau tham gia đối thoại. Mỗi agent đóng một vai trò (ví dụ: Customer, Support, Bot), và bạn muốn giữ **thứ tự lời thoại** cùng với **vai trò** rõ ràng.

**1. Định nghĩa `State`**

```python
from typing import TypedDict
from langgraph.graph import StateGraph, END

class Message(TypedDict):
    role: str
    content: str

class ChatState(TypedDict, total=False):
    messages: list[Message]
```

**2. Các node đóng vai khác nhau**

```python
def customer_node(state):
    return {
        "messages": [
            {"role": "customer", "content": "Tôi muốn kiểm tra đơn hàng của mình."}
        ]
    }

def support_node(state):
    return {
        "messages": [
            {"role": "support", "content": "Chào anh/chị, vui lòng cung cấp mã đơn hàng ạ."}
        ]
    }

def bot_node(state):
    return {
        "messages": [
            {"role": "bot", "content": "Tôi có thể hỗ trợ những câu hỏi thường gặp. Bạn muốn hỏi gì?"}
        ]
    }

```

**3. Custom reducer giữ thứ tự lời thoại**

```python
def ordered_reducer(states: list[dict]) -> dict:
    all_messages = []
    for state in states:
        msgs = state.get("messages", [])
        all_messages.extend(msgs)
    return {"messages": all_messages}

```

 Lưu ý: `extend` giúp nối danh sách lời thoại từ các node theo **đúng thứ tự gọi**.

**4. Xây dựng LangGraph**

```python
graph = StateGraph(ChatState)

graph.add_node("customer", customer_node)
graph.add_node("support", support_node)
graph.add_node("bot", bot_node)

graph.add_edge("customer", "support")
graph.add_edge("support", "bot")
graph.add_edge("bot", END)

graph.set_entry_point("customer")
graph.set_finish_point(END, reducer=ordered_reducer)

app = graph.compile()
result = app.invoke({})

from pprint import pprint
pprint(result)

```

**Kết quả mong đợi:**

```python
{
  'messages': [
    {'role': 'customer', 'content': 'Tôi muốn kiểm tra đơn hàng của mình.'},
    {'role': 'support', 'content': 'Chào anh/chị, vui lòng cung cấp mã đơn hàng ạ.'},
    {'role': 'bot', 'content': 'Tôi có thể hỗ trợ những câu hỏi thường gặp. Bạn muốn hỏi gì?'}
  ]
}

```

#### **4. Gộp theo trọng số(Weighted merge )**

Khi bạn có nhiều nguồn dữ liệu và muốn **ưu tiên nguồn nào đó**, bạn có thể merge có trọng số.

```python
def weighted_merge_reducer(states: list[dict]) -> dict:
    scores = [0.5, 0.3, 0.2]  # trọng số cho từng nhánh
    merged_output = ""
    for state, score in zip(states, scores):
        merged_output += f"{score:.1f} * {state['text']}\n"
    return {"combined_output": merged_output}

```

Ví dụ

Giả sử có 3 agent khác nhau đề xuất một câu trả lời cho cùng một câu hỏi, nhưng mỗi agent có **độ tin cậy khác nhau**. Bạn muốn:

- Gộp kết quả trả về của họ,
- Nhưng kết quả nào đáng tin hơn thì nên ảnh hưởng **nhiều hơn** đến kết quả cuối cùng.

**1. Khai báo State**

```python
from typing import TypedDict

class State(TypedDict, total=False):
    suggestions: list[dict]  # Mỗi đề xuất có 'text' và 'score'
```

**2. Tạo các node với "đề xuất" khác nhau**

```python
def agent_1(state):
    return {"suggestions": [{"text": "Trả lời từ agent 1", "score": 0.8}]}

def agent_2(state):
    return {"suggestions": [{"text": "Trả lời từ agent 2", "score": 0.6}]}

def agent_3(state):
    return {"suggestions": [{"text": "Trả lời từ agent 3", "score": 0.9}]}
```

3\. **Gộp theo trọng số(Weighted merge )**

```python
def weighted_merge(states: list[dict]) -> dict:
    from collections import defaultdict

    scores = defaultdict(float)

    for state in states:
        for suggestion in state.get("suggestions", []):
            text = suggestion["text"]
            score = suggestion.get("score", 1.0)
            scores[text] += score  # Cộng điểm nếu có trùng câu trả lời

    # Chọn text có tổng điểm cao nhất
    best_text = max(scores.items(), key=lambda x: x[1])[0]
    return {"final_answer": best_text}
```

defaultdict: xem chi tiết tại [https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/defaultdict](https://docs.vhterp.com/books/ky-thuat-lap-trinh-python/page/defaultdict)

**4. Xây dựng đồ thị**

```python
from langgraph.graph import StateGraph, END

graph = StateGraph(State)

graph.add_node("agent_1", agent_1)
graph.add_node("agent_2", agent_2)
graph.add_node("agent_3", agent_3)

graph.add_edge("agent_1", END)
graph.add_edge("agent_2", END)
graph.add_edge("agent_3", END)

graph.set_entry_point("agent_1")
graph.set_finish_point(END, reducer=weighted_merge)

app = graph.compile()
result = app.invoke({})

print(result)

```

Kết quả:

```
{'final_answer': 'Trả lời từ agent 3'}
```

#### **5. Reducers + Pydantic = An toàn tuyệt đối**

Khi reducer trả về một dict, bạn có thể dùng **Pydantic** để đảm bảo kết quả hợp lệ và chặt chẽ:

```python
from pydantic import BaseModel

class FinalState(BaseModel):
    name: str
    summary: str
    mood: str

def reducer_with_validation(states):
    merged = {}
    for s in states:
        merged.update(s)
    return FinalState(**merged).dict()

```

#### **Tình huống thực tế:**

Giả sử bạn đang xây dựng một hệ thống trợ lý AI cho chăm sóc khách hàng. Bạn có nhiều "nhánh" (agents) cùng phân tích yêu cầu của người dùng để trích xuất thông tin: `name`, `email`, `issue`.

> Mỗi agent có thể phát hiện **một phần** thông tin. Bạn muốn:

- Gộp kết quả lại,
- Và đảm bảo kết quả cuối cùng **đúng định dạng**, **đầy đủ**, **an toàn**.

**1. Định nghĩa `State` với Pydantic**

```python
from pydantic import BaseModel, EmailStr
from typing import Optional

class UserRequest(BaseModel):
    name: Optional[str]
    email: Optional[EmailStr]
    issue: Optional[str]

```

##### **2. Tạo các Agent**

```python
def extract_name(state):
    return {"name": "Nguyễn Văn A"}

def extract_email(state):
    return {"email": "nguyenvana@example.com"}

def extract_issue(state):
    return {"issue": "Không đăng nhập được vào tài khoản"}

```

**3. Tạo Reducer sử dụng Pydantic để kiểm tra tính hợp lệ**

```python
def safe_merge(states: list[dict]) -> dict:
    merged = {}
    for state in states:
        merged.update(state)

    # Kiểm tra hợp lệ bằng Pydantic
    validated = UserRequest(**merged)
    return validated.dict()

```

**4. Xây dựng Graph**

```python
from langgraph.graph import StateGraph, END

graph = StateGraph(UserRequest)

graph.add_node("name", extract_name)
graph.add_node("email", extract_email)
graph.add_node("issue", extract_issue)

# Cho các node chạy song song
graph.add_edge("name", END)
graph.add_edge("email", END)
graph.add_edge("issue", END)

graph.set_entry_point("name")
graph.set_finish_point(END, reducer=safe_merge)

app = graph.compile()
result = app.invoke({})

print(result)

```

#### **Kết quả**

```python
{
  'name': 'Nguyễn Văn A',
  'email': 'nguyenvana@example.com',
  'issue': 'Không đăng nhập được vào tài khoản'
}

```

#### **6. Kết hợp với ToolCall**

Nếu các nhánh là các công cụ (tools), bạn có thể dùng reducer để phân tích kết quả từ từng công cụ:

```python
def tool_result_reducer(states):
    results = {}
    for state in states:
        tool_name = state["tool"]
        result = state["result"]
        results[tool_name] = result
    return {"tools_result": results}

```

## Tình huống thực tế:

Bạn có một hệ thống AI assistant, khi người dùng hỏi:

> "Tôi tên là Minh, email của tôi là <a data-end="401" data-start="385" rel="noopener">minh@example.com</a>, tôi cần hỗ trợ về hóa đơn."

Bạn dùng LLM để tách thông tin đó, nhưng thay vì chỉ tách thủ công, bạn dùng **ToolCall** để giao cho từng tool xử lý riêng một phần.

##### **1. Định nghĩa `Tool` và `State` với Pydantic**

```python
from pydantic import BaseModel, EmailStr
from typing import Optional
from langchain_core.tools import tool

class UserInfo(BaseModel):
    name: Optional[str]
    email: Optional[EmailStr]
    issue: Optional[str]

```

##### **2. Định nghĩa các Tool dùng ToolCall**

```python
@tool
def extract_name_tool(text: str) -> dict:
    if "tên là" in text:
        return {"name": "Minh"}
    return {}

@tool
def extract_email_tool(text: str) -> dict:
    if "email" in text:
        return {"email": "minh@example.com"}
    return {}

@tool
def extract_issue_tool(text: str) -> dict:
    return {"issue": "hỗ trợ về hóa đơn"}

```

##### **3. Dùng LangGraph gọi các Tool + Gộp lại bằng Reducer**

```python
from langgraph.graph import StateGraph, END
from langgraph.graph.message import ToolMessage
from langgraph.prebuilt.tool_node import ToolNode

# Khởi tạo ToolNode
tool_node = ToolNode(tools=[extract_name_tool, extract_email_tool, extract_issue_tool])

# Reducer sử dụng Pydantic để validate kết quả
def merge_tool_results(states: list[dict]) -> dict:
    merged = {}
    for state in states:
        merged.update(state)
    return UserInfo(**merged).dict()

```

##### **4. Tạo Graph**

```python
graph = StateGraph(UserInfo)

# Tạo một node để gọi tool dựa vào user input
def prepare_tool_call(state):
    return ToolMessage(
        tool_name="extract_name_tool",  # Không cần quá cụ thể vì ToolNode sẽ tự chọn tool phù hợp
        tool_input={"text": "Tôi tên là Minh, email của tôi là minh@example.com, tôi cần hỗ trợ về hóa đơn."}
    )

graph.add_node("call_tool", prepare_tool_call)
graph.add_node("tool_node", tool_node)

graph.add_edge("call_tool", "tool_node")
graph.add_edge("tool_node", END)

graph.set_entry_point("call_tool")
graph.set_finish_point(END, reducer=merge_tool_results)

app = graph.compile()
result = app.invoke({})

print(result)

```

**Kết quả**

```python
{
  "name": "Minh",
  "email": "minh@example.com",
  "issue": "hỗ trợ về hóa đơn"
}

```

**Lợi ích của việc dùng ToolCall:**

<table class="min-w-full" data-end="2999" data-start="2666" id="bkmrk-t%C3%ADnh-n%C4%83ng-l%E1%BB%A3i-%C3%ADch-t%C3%A1" style="height: 125px; width: 100%;"><thead data-end="2689" data-start="2666"><tr data-end="2689" data-start="2666"><th data-end="2678" data-start="2666" style="width: 49.9405%;">Tính năng</th><th data-end="2689" data-start="2678" style="width: 49.9405%;">Lợi ích</th></tr></thead><tbody data-end="2999" data-start="2713"><tr data-end="2766" data-start="2713"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2731" data-start="2713" style="width: 49.9405%;">Tách vai trò</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2766" data-start="2731" style="width: 49.9405%;">Mỗi Tool xử lý một phần dữ liệu</td></tr><tr data-end="2846" data-start="2767"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2786" data-start="2767" style="width: 49.9405%;">Kết hợp logic</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2846" data-start="2786" style="width: 49.9405%;">Dễ dàng mở rộng thêm Tool mà không phải viết lại toàn bộ</td></tr><tr data-end="2922" data-start="2847"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2869" data-start="2847" style="width: 49.9405%;">An toàn dữ liệu</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2922" data-start="2869" style="width: 49.9405%;">`Pydantic` đảm bảo kết quả hợp lệ, đúng định dạng</td></tr><tr data-end="2999" data-start="2923"><td class="max-w-[calc(var(--thread-content-max-width)*2/3)]" data-end="2936" data-start="2923" style="width: 49.9405%;">Tự động</td><td class="max-w-[calc(var(--thread-content-max-width)*2/3)] min-w-[calc(var(--thread-content-max-width)/3)]" data-end="2999" data-start="2936" style="width: 49.9405%;">ToolNode sẽ **chọn tool phù hợp** dựa vào tên tool và input</td></tr></tbody></table>

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary" id="bkmrk-"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-sidebar-surface-primary text-token-text-secondary dark:bg-token-main-surface-secondary flex items-center rounded-sm px-2 font-sans text-xs">  
</div></div></div><div class="overflow-y-auto p-4" dir="ltr">  
</div></div><div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary" id="bkmrk--1"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-sidebar-surface-primary text-token-text-secondary dark:bg-token-main-surface-secondary flex items-center rounded-sm px-2 font-sans text-xs">  
</div></div></div><div class="overflow-y-auto p-4" dir="ltr">  
</div></div>

# Public State, Private State và  Multiple State Schemas trong LangGraph

#### **Ví Dụ Minh Họa: Cửa Hàng Sửa Máy Tính**

##### **1. Public State - Giao Tiếp Đơn Giản Với Khách Hàng**

- **Kịch bản**: Bạn mang máy tính bị hỏng đến cửa hàng sửa chữa.
- **Cuộc trò chuyện**:
    
    
    - Bạn: "Máy tính của tôi không hoạt động nữa, tôi không biết lý do."
    - Nhân viên: "Chúng tôi sẽ kiểm tra và báo lại cho bạn sau."
- **Đặc điểm**:
    
    
    - Thông tin **đơn giản**, dễ hiểu.
    - Không đi vào chi tiết kỹ thuật.

→ Đây chính là **public state** trong Landgraaf: trạng thái mà người dùng cuối (khách hàng) tương tác trực tiếp.

##### **2. Private State - Giao Tiếp Nội Bộ Kỹ Thuật**

- **Kịch bản**: Nhân viên chuyển máy tính cho đội kỹ thuật.
- **Cuộc trò chuyện**:
    
    
    - Kỹ thuật viên 1: "Kiểm tra nguồn điện, có thể do adapter."
    - Kỹ thuật viên 2: "Test RAM và ổ cứng, có thể bị bad sector."
- **Đặc điểm**:
    
    
    - Thông tin **kỹ thuật phức tạp**, chỉ dành cho nội bộ.
    - Khách hàng không cần biết chi tiết này.

→ Đây là **private state**: trạng thái nội bộ để xử lý logic phức tạp.

##### **3. Kết Quả Cuối Cùng - Quay Lại Public State**

- Kỹ thuật viên tổng hợp kết quả và báo lại cho nhân viên:
    
    
    - "Máy bị lỗi ổ cứng, cần thay thế với chi phí 3 triệu đồng."
- Nhân viên thông báo lại cho khách hàng:
    
    
    - "Máy của bạn bị hỏng ổ cứng, chúng tôi sẽ sửa trong 2 ngày."

→ Thông tin được **đơn giản hóa** từ private state trở lại public state.

#### **Áp Dụng Vào LangGraph**

##### **1. Public State Schema**

- **Vai trò**: Giao diện tương tác với người dùng.
- **Đặc điểm**:
    
    
    - Dữ liệu đầu vào/đầu ra đơn giản.
    - Ví dụ: Form đăng ký, kết quả tìm kiếm.

##### **2. Private State Schema**

- **Vai trò**: Xử lý logic nghiệp vụ phức tạp.
- **Đặc điểm**:
    
    
    - Chứa các biến và thuật toán kỹ thuật.
    - Ví dụ: Xử lý dữ liệu từ database, tính toán AI.

##### **3. Chuyển Đổi Giữa Các Trạng Thái**

- **Node 1 (Nhận Public State → Tạo Private State)**:
    
    
    - Nhận thông tin đơn giản từ người dùng.
    - **"Tăng độ phức tạp lên 1000 lần"** để xử lý nội bộ.
- **Node 2 (Nhận Private State → Trả Public State)**:
    
    
    - Tổng hợp kết quả phức tạp.
    - **"Giảm độ phức tạp 999 lần"** để trả về người dùng.

#### **Tại Sao Điều Này Quan Trọng?**

1. **Bảo Mật**: Private state giúp che giấu logic nhạy cảm khỏi người dùng.
2. **Hiệu Suất**: Tách biệt xử lý phức tạp khỏi giao diện người dùng.
3. **Dễ Bảo Trì**: Thay đổi logic kỹ thuật mà không ảnh hưởng đến trải nghiệm người dùng.

##### **Lời Khuyên Khi Áp Dụng**

- **Ghi nhớ khái niệm**: Hiểu rõ sự khác biệt giữa public/private state.
- **Đừng sa lầy vào chi tiết ngay**: Tập trung vào bài học thực hành trước.
- **Quay lại khi cần**: Khi xây dựng ứng dụng phức tạp, hãy tra cứu lại tài liệu này.

> **"LandGraph không chỉ dành cho siêu anh hùng - nó đơn giản nếu bạn hiểu cách tổ chức trạng thái!"**

##### **Kết Luận**

Việc phân chia **public/private state** giống như cách một cửa hàng sửa chữa hoạt động:

- **Public state** = Giao tiếp với khách hàng.
- **Private state** = Thảo luận nội bộ kỹ thuật.  
    Hiểu được điều này sẽ giúp bạn thiết kế ứng dụng LangGraph mạnh mẽ và dễ bảo trì!

#### **Multiple State Schemas Qua Ví Dụ Cửa Hàng Sửa Máy Tính**

## **1. Multiple State Schemas Là Gì?**

Trong LangGraph, **Multiple State Schemas** (Đa lược đồ trạng thái) là cách phân chia trạng thái ứng dụng thành nhiều "lớp" khác nhau, mỗi lớp có:

- **Mục đích riêng** (giao tiếp với người dùng vs xử lý nội bộ)
- **Độ phức tạp riêng** (đơn giản vs kỹ thuật)
- **Phạm vi truy cập riêng** (public vs private)

**Giống như một cửa hàng có khu vực bán hàng (public) và xưởng sửa chữa (private)**.

##### **2. Áp Dụng Vào Ví Dụ Cửa Hàng Sửa Máy Tính**

**Schema 1: Public State Schema**

*(Khu vực tiếp tân)*

- **Đặc điểm**:
    
    
    - Ngôn ngữ: Đơn giản, không chuyên môn
    - Dữ liệu: Chỉ thông tin cần thiết cho khách hàng
- **Ví dụ**:
- ```json
    // Public State Schema
    {
      customerName: "Nguyễn Văn A",
      device: "Laptop Dell XPS",
      problem: "Không khởi động được",
      status: "Đang chẩn đoán"
    }
    ```

**Schema 2: Private State Schema**

*(Xưởng kỹ thuật)*

- **Đặc điểm**:
    
    
    - Ngôn ngữ: Kỹ thuật, chi tiết
    - Dữ liệu: Đầy đủ thông tin để sửa chữa
- **Ví dụ**:
- ```json
    // Private State Schema
    {
      deviceId: "DELL-XPS-2023-SN-12345",
      diagnosticLogs: [
        { test: "Power Supply", result: "12V rail unstable" },
        { test: "HDD S.M.A.R.T", result: "Reallocated sectors: 512" }
      ],
      repairPlan: [
        { action: "Replace PSU", part: "PSU-DELL-120W" },
        { action: "Clone HDD to SSD", tools: ["Acronis", "USB-SATA adapter"] }
      ]
    }
    ```

##### **3. Cách Chuyển Đổi Giữa Các State Schema**

**Quy Trình Xử Lý**

1. **Public → Private (Node 1)**
    
    
    - Nhận yêu cầu đơn giản từ khách
    - **"Mở rộng" thành thông số kỹ thuật**
    - ```python
        def public_to_private(public_state):
            private_state = {
                'deviceId': lookup_device_id(public_state['device']),
                'diagnosticLogs': run_hardware_tests(),
                'repairPlan': generate_repair_options()
            }
            return private_state
        ```
2. **Private → Public (Node 2)**
    
    
    - Tổng hợp kết quả kỹ thuật
    - **"Rút gọn" thành thông báo dễ hiểu**
    - ```python
        def private_to_public(private_state):
            public_state_update = {
                'status': "Đã xác định lỗi",
                'solution': f"Thay {private_state['repairPlan'][0]['part']}",
                'cost': calculate_cost(private_state)
            }
            return public_state_update
        ```

#### **4. Lợi Ích Của Multiple State Schemas**

<div class="markdown-table-wrapper" id="bkmrk-ti%C3%AAu-ch%C3%AD-public-stat"><table style="height: 145px; width: 100%;"><thead><tr><th style="width: 33.2924%;">**Tiêu Chí**</th><th style="width: 33.2924%;">**Public State**</th><th style="width: 33.2962%;">**Private State**</th></tr></thead><tbody><tr><td style="width: 33.2924%;">**Đối tượng**</td><td style="width: 33.2924%;">Khách hàng</td><td style="width: 33.2962%;">Kỹ thuật viên</td></tr><tr><td style="width: 33.2924%;">**Độ phức tạp**</td><td style="width: 33.2924%;">1x (dễ hiểu)</td><td style="width: 33.2962%;">1000x (chi tiết)</td></tr><tr><td style="width: 33.2924%;">**Bảo mật**</td><td style="width: 33.2924%;">Ai cũng thấy</td><td style="width: 33.2962%;">Nội bộ</td></tr><tr><td style="width: 33.2924%;">**Ví dụ thực tế**</td><td style="width: 33.2924%;">App Mobile</td><td style="width: 33.2962%;">Database + Microservices</td></tr></tbody></table>

</div>**Ưu điểm**:

- Giảm tải thông tin cho người dùng cuối
- Dễ dàng thay đổi logic nghiệp vụ mà không ảnh hưởng giao diện
- Bảo mật thông tin nhạy cảm (giá vốn, lỗi hệ thống...)

#### **5. Sai Lầm Cần Tránh**

1. **Nhồi nhét private state vào public**  
    → Làm người dùng bối rối với thông báo kiểu:  
    *"Lỗi 0x7F do sector 512 bị bad, cần remap cluster"*
2. **Thiếu chuyển đổi giữa các schema**  
    → Dẫn đến mất mát thông tin khi giao tiếp giữa các thành phần
3. **Dùng chung schema cho mục đích khác nhau**  
    → Như bắt kỹ thuật viên dùng form đơn giản của khách để ghi chép

## **Câu Hỏi Thực Hành**

Hãy thử thiết kế Multiple State Schemas cho các tình huống sau:

1. **Ứng dụng ngân hàng**
    
    
    - Public: Số dư tài khoản
    - Private: Lịch sử giao dịch chi tiết + thuật toán chống gian lận
2. **Trợ lý ảo y tế**
    
    
    - Public: Triệu chứng đơn giản ("Đau đầu 3 ngày")
    - Private: Dữ liệu EHR + mô hình chẩn đoán AI

> 💡 **Mẹo**: Luôn tự hỏi *"Thông tin này có CẦN THIẾT cho người dùng cuối không?"* khi thiết kế schema.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**

# Thực hành Public State and Private State

#### **1. Cài Đặt LangGraph**

```
pip install langgraph
```

#### **2. Triển Khai Code**

```python
from langgraph.graph import Graph
from typing import Dict, Any

# ======================================
# ĐỊNH NGHĨA SCHEMAS
# ======================================

# Public State Schema (Dành cho khách hàng)
PublicState = Dict[str, Any]  # Ví dụ: {'customer_name': 'John', 'problem': 'Không khởi động'}

# Private State Schema (Dành cho kỹ thuật viên)
PrivateState = Dict[str, Any]  # Ví dụ: {'diagnostics': ['lỗi ổ cứng', 'pin hỏng'], 'repair_cost': 200}

# ======================================
# ĐỊNH NGHĨA CÁC NODE
# ======================================

def receive_complaint(state: PublicState) -> Dict[str, Any]:
    """Node 1: Tiếp nhận yêu cầu từ khách hàng (Public State)"""
    print(f"🎤 Nhân viên nhận máy từ khách hàng: {state['customer_name']}")
    print(f"🔧 Vấn đề mô tả: {state['problem']}")
    return {"internal_note": f"Khách hàng {state['customer_name']} báo: {state['problem']}"}

def diagnose_problem(state: Dict[str, Any]) -> PrivateState:
    """Node 2: Chuyển sang Private State để chẩn đoán"""
    print("\n🔎 Kỹ thuật viên đang kiểm tra...")
    diagnostics = [
        "Test nguồn: OK",
        "Ổ cứng bị bad sector (LBA 1024-2048)",
        "Mainboard lỗi khe RAM"
    ]
    return {
        'diagnostics': diagnostics,
        'repair_cost': 350,
        'technician_notes': "Cần thay ổ cứng SSD 256GB + vệ sinh khe RAM"
    }

def summarize_report(state: PrivateState) -> PublicState:
    """Node 3: Chuyển kết quả về Public State cho khách hàng"""
    print("\n📝 Tổng hợp báo cáo đơn giản...")
    return {
        'customer_name': state['internal_note'].split()[2],  # Lấy tên từ internal_note
        'solution': "Thay ổ cứng SSD + bảo dưỡng",
        'cost': f"${state['repair_cost']}",
        'time_estimate': "2 ngày"
    }

# ======================================
# XÂY DỰNG GRAPH
# ======================================

workflow = Graph()

# Thêm các node vào graph
workflow.add_node("receive_complaint", receive_complaint)
workflow.add_node("diagnose_problem", diagnose_problem)
workflow.add_node("summarize_report", summarize_report)

# Kết nối các node
workflow.add_edge("receive_complaint", "diagnose_problem")
workflow.add_edge("diagnose_problem", "summarize_report")

# Biên dịch graph
chain = workflow.compile()

# ======================================
# CHẠY VÍ DỤ
# ======================================

# Khởi tạo Public State ban đầu
initial_state = {
    'customer_name': 'Nguyễn Văn A',
    'problem': 'Máy tính không lên nguồn',
    'status': 'received'
}

# Thực thi workflow
final_state = chain.invoke(initial_state)

# ======================================
# KẾT QUẢ
# ======================================
print("\n📢 Kết quả cuối cùng (Public State):")
print(final_state)
```

#### **3. Giải Thích Hoạt Động**

##### **Luồng Dữ Liệu**

**[![20250423_5ef500.png](https://docs.vhterp.com/uploads/images/gallery/2025-04/scaled-1680-/20250423-5ef500.png)](https://docs.vhterp.com/uploads/images/gallery/2025-04/20250423-5ef500.png)**

##### **Kết Quả Khi Chạy**

```
🎤 Nhân viên nhận máy từ khách hàng: Nguyễn Văn A
🔧 Vấn đề mô tả: Máy tính không lên nguồn

🔎 Kỹ thuật viên đang kiểm tra...

📝 Tổng hợp báo cáo đơn giản...

📢 Kết quả cuối cùng (Public State):
{
    'customer_name': 'Nguyễn',
    'solution': 'Thay ổ cứng SSD + bảo dưỡng',
    'cost': '$350',
    'time_estimate': '2 ngày'
}
```

#### **4. Ghi nhớ**

1. **Public State → Private State**
    
    
    - Node 1 nhận thông tin đơn giản, Node 2 mở rộng thành dữ liệu kỹ thuật.
2. **Private State → Public State**
    
    
    - Node 3 lọc bỏ chi tiết không cần thiết, chỉ giữ lại thông tin khách hàng cần biết.
3. **Ưu Điểm LangGraph**
    
    
    - Dễ dàng mở rộng thêm node (vd: thêm node "Xác nhận thanh toán")
    - Tách biệt rõ ràng giữa các tầng logic.

**Tác giả: Đỗ Ngọc Tú**  
**Công Ty Phần Mềm [VHTSoft](https://vhtsoft.com/ "Công Ty Phần Mềm VHTSoft")**