Cách xây dựng agent WhatsApp với OpenAI Agents SDK

OpenAI Agents SDK là framework mã nguồn mở của OpenAI để xây dựng agent: một mô hình cùng hướng dẫn, các công cụ nó có thể gọi, handoff sang các agent khác và guardrail quanh đầu vào và đầu ra, tất cả chạy trong một vòng lặp cho đến khi nhiệm vụ hoàn thành. Đây là một cách tuyệt vời để xây dựng agent. Nhưng bản thân nó không cung cấp cho bạn số WhatsApp, hộp thư đội ngũ, tin nhắn mẫu hay cách để một người tiếp quản. Với Agent Harness của MonoChat, bạn chọn OpenAI Agents SDK làm một AI Harness, đặt một node AI Agent vào luồng, kết nối WhatsApp và kiểm thử, còn MonoChat lo phần còn lại.

Hướng dẫn này trình bày SDK mang lại những gì, ba cách dùng agent OpenAI trong MonoChat, cách thiết lập từng bước và những chi tiết riêng của WhatsApp quyết định việc khách hàng có tin tưởng agent hay không.

OpenAI Agents SDK mang lại gì

SDK được xây dựng quanh một tập nhỏ các ý tưởng:

• Agent: một mô hình cùng hướng dẫn mô tả công việc của nó.
• Công cụ: các hàm agent có thể gọi, chẳng hạn “tra cứu đơn hàng” hoặc “kiểm tra khung giờ”, cùng các máy chủ MCP.
• Handoff: một agent chuyển nhiệm vụ cho agent khác chuyên về nó, ví dụ từ agent hỗ trợ chung sang agent xử lý trả hàng.
• Guardrail: các bước kiểm tra chạy song song với agent để chặn các đầu vào hoặc đầu ra bạn không muốn.
• Phiên và truy vết: bộ nhớ qua các lượt và bản ghi những gì agent đã làm, từng bước một.

Gộp lại, đó là một agent harness: vòng lặp cho phép mô hình hành động, kiểm tra công việc của mình và tiếp tục, thay vì chỉ trả lời một lần. Với nhắn tin cho khách hàng, đây là sự khác biệt giữa việc giải thích chính sách trả hàng và việc thực sự tạo yêu cầu trả hàng.

WhatsApp bổ sung thêm gì cho bài toán

Xây dựng agent mới chỉ là một nửa công việc. Đưa nó đến với khách hàng trên WhatsApp có nghĩa là phải xử lý:

• WhatsApp Business Platform. Một kết nối API chính thức, một doanh nghiệp đã xác minh và một số điện thoại đã được duyệt.
• Khung 24 giờ. Câu trả lời tự do được phép trong vòng 24 giờ kể từ tin nhắn cuối cùng của khách hàng; sau đó bạn cần một mẫu đã được duyệt.
• Chính sách. Từ ngày 15 tháng 1 năm 2026, WhatsApp không cho phép các trợ lý AI đa dụng trên nền tảng. Một agent phục vụ chính khách hàng của bạn thì được phép, và cần có đường dẫn rõ ràng đến người thật khi các câu trả lời là tự động.
• Con người. Một số cuộc trò chuyện phải chuyển cho người thật, giữ nguyên lịch sử, ngay trong công cụ mà đội ngũ của bạn đang dùng.
• Các kênh khác. Khách hàng nhắn trên Instagram, Messenger hay website của bạn cũng mong đợi những câu trả lời giống nhau.

MonoChat xử lý những việc này xung quanh agent, nên công việc của bạn chỉ tập trung vào chính agent.

Ba cách dùng agent OpenAI trong MonoChat

Lựa chọn	Nơi chạy	Bạn cần gì
OpenAI Agents SDK	Bên trong MonoChat	Không cần thêm gì; dùng các mô hình AI của bạn
OpenAI Agents API (do OpenAI lưu trữ)	Đám mây của OpenAI	Khóa API OpenAI của bạn
Custom (dịch vụ Agents SDK của riêng bạn)	Máy chủ của riêng bạn	URL endpoint và một khóa bí mật dùng chung

Hãy bắt đầu với harness OpenAI Agents SDK nếu bạn muốn một agent kiểu OpenAI mà không phải triển khai gì. Hãy chọn OpenAI Agents API nếu các agent của bạn đã nằm trên nền tảng được lưu trữ của OpenAI. Hãy chọn Custom nếu lập trình viên của bạn đã tự viết agent bằng SDK, với công cụ, handoff và kiểm thử riêng, và muốn tiếp tục chạy đoạn code đó; xem cách kết nối AI agent của riêng bạn với WhatsApp.

Từng bước: một agent OpenAI Agents SDK trên WhatsApp

1. Thêm một AI Harness

Thêm một AI Harness trong MonoChat và chọn OpenAI Agents SDK làm nhà cung cấp. Nó chạy bên trong MonoChat và dùng các mô hình AI bạn đã thiết lập, nên bước này không cần thêm khóa hay máy chủ nào.

2. Thêm node AI Agent vào một luồng

Trong luồng nhận các cuộc trò chuyện WhatsApp của bạn, thêm một node AI Agent và chọn harness. Viết hướng dẫn cho agent: nó phục vụ ai, làm được gì, không bao giờ được làm gì và khi nào chuyển giao.

3. Chọn mô hình chính, dự phòng và nhanh

Mỗi node AI Agent có ba vai trò mô hình:

• Mô hình chính suy luận và viết câu trả lời.
• Mô hình dự phòng tiếp quản sau giới hạn mềm hoặc khi gặp lỗi.
• Mô hình nhanh xử lý các tác vụ nền.

Hãy thêm giới hạn ngân sách cho mỗi lượt chạy để một cuộc trò chuyện bất thường không thể tạo ra hóa đơn lớn. Chưa chắc cách chọn mô hình dự phòng? Hãy đọc vì sao AI agent tiếp xúc khách hàng của bạn cần mô hình dự phòng.

4. Kết nối công cụ của bạn

Cung cấp cho agent các công cụ phù hợp với những yêu cầu thường gặp nhất của bạn:

• Công cụ hàm AI cho các lệnh gọi đến API của riêng bạn với đầu vào có cấu trúc.
• Tích hợp MCP cho các công cụ từ các hệ thống tương thích MCP.
• Cơ sở tri thức AI cho các câu trả lời dựa trên tài liệu và chính sách của bạn.
• Hàm tùy chỉnh cho logic chạy bên trong cuộc trò chuyện.

Ba công cụ tốt hơn mười lăm công cụ kiểm thử dở dang. Hãy thêm nhiều hơn khi bạn đã thấy các cuộc trò chuyện thực tế.

5. Kết nối WhatsApp (và mọi thứ khác)

Kết nối số WhatsApp Business của bạn qua MonoChat, một Đối tác Kinh doanh chính thức của Meta. Cùng một luồng có thể chạy trên Instagram, Messenger, TikTok, Telegram, web chat, SMS và thoại, nên một agent bao phủ mọi kênh.

6. Kiểm thử với tin nhắn thật

Hãy dùng các cuộc trò chuyện của tháng trước làm bộ kiểm thử. Bao gồm cả những ca khó: khách hàng tức giận, câu hỏi mơ hồ, nhiều yêu cầu trong một tin nhắn, khách hàng yêu cầu gặp người thật ngay lập tức. Kiểm tra các lệnh gọi công cụ, giọng điệu và chuyển giao. Sau đó đưa vào hoạt động.

Các mẫu hoạt động tốt trên WhatsApp

Mỗi tin nhắn một câu hỏi. Các agent được xây dựng cho chat trên web thường trả lời bằng danh sách dài. Trên điện thoại, tin nhắn ngắn và mỗi lần một câu hỏi rõ ràng sẽ nhận được phản hồi tốt hơn từ khách hàng.

Xác nhận trước các hành động không thể hoàn tác. Hãy để agent đề xuất và khách hàng xác nhận trước khi hủy đơn, hoàn tiền hoặc thay đổi đặt chỗ.

Chuyên gia qua handoff, con người qua hộp thư. Handoff của SDK rất tốt để định tuyến giữa các agent (bán hàng, hỗ trợ, trả hàng). Việc chuyển giao cho một người thật thuộc về hộp thư chung của đội ngũ trong MonoChat, nơi cuộc trò chuyện đến với đầy đủ lịch sử.

Hướng dẫn nêu rõ giới hạn. “Hoàn tiền đến €50 bạn có thể phê duyệt; trên mức đó, chuyển cho đội thanh toán.” Con số rõ ràng tốt hơn quy tắc mơ hồ.

Giữ trong phạm vi doanh nghiệp của bạn. Một agent giúp khách hàng của bạn thì được phép trên WhatsApp. Một agent trả lời mọi thứ có nguy cơ vi phạm quy tắc năm 2026 của WhatsApp; hướng dẫn về chính sách chatbot AI của WhatsApp của chúng tôi giải thích ranh giới nằm ở đâu.

Chi phí

Ba khoản cộng lại: gói MonoChat của bạn, mức sử dụng mô hình AI và phí tin nhắn WhatsApp của Meta. Từ ngày 1 tháng 10 năm 2026, Meta tính phí các câu trả lời dịch vụ sau 1.000 tin đầu tiên mỗi tháng cho mỗi số doanh nghiệp; xem hướng dẫn về giá WhatsApp API của chúng tôi.

Về phía AI, MonoChat không cộng thêm phụ phí khi bạn dùng khóa nhà cung cấp của riêng mình. Ngân sách cho mỗi lượt chạy, một mô hình nhanh rẻ hơn cho tác vụ nền và một mô hình dự phòng đáng tin cậy giúp hóa đơn dễ dự đoán.

Không bị khóa chặt

Agent Harness cho phép bạn chọn framework, không chỉ mô hình. Nếu sau này bạn muốn thử Claude Agent SDK, Pi, Claude Managed Agents hoặc framework của riêng bạn, hãy thêm một AI Harness khác và trỏ node AI Agent sang nó. Các kênh, công cụ và cách chuyển giao của bạn vẫn giữ nguyên. So sánh tất cả nhà cung cấp trên trang Agent Harness.