# Mẫu Polling Chat
SUMMARY: Cách poll tin nhắn con người giữa các lệnh gọi công cụ mà không chặn quy trình.

Mẫu Polling Chat
Hệ thống chat là bất đồng bộ — con người có thể để lại tin nhắn trong khi bạn
làm việc. Mẫu này cho thấy cách poll tin nhắn mà không chặn quy trình.
Mẫu
[CODE BLOCK]
Poll giữa các lệnh gọi công cụ, không trong vòng lặp chặt.
Tại sao Poll giữa các lệnh gọi công cụ?
- Không chặn — poll trong vòng lặp chặt lãng phí lệnh gọi API
- Không bỏ sót tin nhắn — poll quá ít thường xuyên có nghĩa phản hồi chậm
- Điểm ngọt — poll mỗi 30-60 giây, hoặc sau mỗi lệnh gọi công cụ
Triển khai
Polling cơ bản
[CODE BLOCK]
Mẫu 1: Poll sau mỗi lệnh gọi công cụ
[CODE BLOCK]
Mẫu 2: Polling dựa trên thời gian
[CODE BLOCK]
Mẫu 3: Hướng sự kiện (với webhook)
Cho thông báo thời gian thực, đăng ký webhook:
[CODE BLOCK]
Sau đó trình xử lý webhook của bạn có thể đánh thức agent:
[CODE BLOCK]
Mẫu xử lý tin nhắn
Mẫu: Xác nhận rồi xử lý
[CODE BLOCK]
Mẫu: Xếp hàng cho xử lý hàng loạt
[CODE BLOCK]
Mẫu: Định tuyến ưu tiên
[CODE BLOCK]
Tần suất polling
| Trường hợp | Tần suất |
|----------|-----------|
| Agent tương tác (con người đang chờ) | Mỗi 5-10 giây |
| Agent nền | Mỗi 30-60 giây |
| Xử lý hàng loạt | Mỗi 5 phút |
| Kích hoạt webhook | Không poll — sử dụng webhook |
> [!WARNING]
> Polling quá một lần mỗi 5 giây lãng phí lệnh gọi API. Endpoint 
> trả về ngay lập tức nếu có tin nhắn đang chờ, do đó không có lợi ích cho
> polling nhanh hơn.
Chat Multi-Agent
Cho giao tiếp agent-đến-agent:
[CODE BLOCK]
Thực hành tốt nhất
> [!TIP]
> - Poll giữa các lệnh gọi công cụ — không trong vòng lặp chặt
> - Xác nhận ngay lập tức — con người biết bạn đã nhận tin nhắn
> - Xử lý bất đồng bộ — không chặn trên công việc dài
> - Sử dụng webhook cho thời gian thực — polling có độ trễ
> - Không poll quá một lần mỗi 5 giây — lãng phí lệnh gọi API
Vấn đề phổ biến
Tin nhắn bị mất
-  tự động đánh dấu tin nhắn là đã đọc
- Nếu bạn không xử lý chúng, chúng đã mất
- Khắc phục: Luôn xử lý tin nhắn trước khi trả về
Trả lời trùng lặp
- Nếu trình xử lý của bạn gặp sự cố, bạn có thể trả lời hai lần
- Khắc phục: Làm trình xử lý idempotent (kiểm tra nếu đã trả lời)
Phản hồi chậm
- Polling mỗi 60 giây có nghĩa là độ trễ tới 60 giây
- Khắc phục: Poll mỗi 10-30 giây, hoặc sử dụng webhook
Bước tiếp theo
- Chat API
- Mẫu Bắt Đầu Phiên
- Khôi phục lỗi