Adapter

Adapter so với connector

Adapter là phần tích hợp sẵn trong agent-hub cho Telegram, Discord, Slack và Webhook. Nếu nền tảng chat của bạn chưa có trong danh sách này, hãy thử trang Connector — nếu nền tảng có bot API kiểu long-polling, bạn kết nối được mà không cần viết code.

Việc một adapter đảm nhiệm

• Tin đến — mỗi tin từ nền tảng được chuyển thành một hình dạng chung, bất kể nền tảng nào: ai gửi, gửi ở đâu (chat / topic / thread), nội dung, có phải reply vào tin của agent không, và tin có đính kèm gì.
• Khả năng của nền tảng — mỗi nền tảng khai báo nó hỗ trợ gì (thread, nút bấm, reaction, sửa tin, báo đang gõ…). Lõi tự thay thế phần nền tảng không hỗ trợ — ví dụ hiện lựa chọn thành danh sách đánh số nếu nền tảng không có nút bấm. Adapter không bao giờ tự giả lập một khả năng nó không có.
• Gửi tin — luôn trả về một trong ba trạng thái: đã gửi; chắc chắn chưa gửi (được thử lại một lần ở dạng chữ thường); hoặc không chắc (không bao giờ thử lại, để tránh gửi trùng).

Khi không có adapter dùng được

Nếu không chọn được adapter nào khả dụng (cấu hình sai hoặc nền tảng không khả dụng), bạn sẽ thấy:

FATAL: no usable gateway adapter (active gateway: telegram)

Chỉ đúng một adapter chạy tại một thời điểm — adapter đang hoạt động được chọn qua cấu hình gateway đang active (gateway được enable trên trang Integrations), không phải qua biến môi trường.