Click: AI agent được quản lý qua API cho ứng dụng

Click dùng để làm gì? Giải thích dễ hiểu

Click là API chạy AI agent được quản lý, dành cho lập trình viên muốn đưa tác nhân AI vào ứng dụng riêng. Bạn cung cấp khóa mô hình, hướng dẫn và công cụ được phép dùng. Click thực hiện các lượt gọi mô hình và công cụ, giữ lịch sử hội thoại và quản lý việc khôi phục thực thi. Ứng dụng nhận kết quả qua API, luồng sự kiện hoặc webhook.

Ví dụ, bạn có thể thêm trợ lý đọc CSV bán hàng và tạo báo cáo. Ứng dụng của bạn kiểm soát giao diện, người dùng, quyền dữ liệu và phê duyệt; Click cung cấp phần chạy agent. Dịch vụ do Click AI Labs, Inc. vận hành, phù hợp với công việc nhiều bước và tác vụ nền dài. Cần tích hợp backend và kiểm tra kết quả trước khi sử dụng.

Tạo phiên AI agent đầu tiên qua API

1. Chuẩn bị khóa API nền tảng Click và khóa của nhà cung cấp mô hình được hỗ trợ. Tài liệu yêu cầu xác minh thẻ trước khi tạo hoặc sửa tài nguyên; tài khoản cũ có thể được miễn. Xác minh không thu tiền hay tự mở thuê bao trả phí.
2. Lưu khóa mô hình bằng POST /credentials và giữ ID trả về. Cả hai khóa phải ở backend.
3. Dùng GET /models để chọn mô hình đúng nhà cung cấp của khóa.
4. Tạo agent bằng POST /agents, gồm mô hình, hướng dẫn và quyền công cụ. Lưu latest_version.id, rồi gọi POST /sessions.
5. Gửi tác vụ tới POST /sessions/{session_id}/submissions. Thêm request_id để lần gửi lại trả về bản gửi ban đầu.
6. Chờ done, cancelled hoặc failed. Khi thành công, đọc mục trả lời được chỉ định; nếu không, kiểm tra lý do.

HTTP 202 chỉ xác nhận đầu vào đã được lưu, chưa phải công việc hoàn thành. Gắn ID phiên với tài liệu hoặc phiếu yêu cầu trong hệ thống để câu hỏi tiếp theo tiếp tục dùng lịch sử đó. Kiểm tra quyền người dùng trước khi trả dữ liệu.

Kết nối công cụ và tạo tệp kết quả

Click kết nối máy chủ MCP Streamable HTTP và endpoint HTTP riêng qua HTTPS công khai. Sau khi tạo kết nối, cần cấp rõ các công cụ agent được dùng. Công cụ HTTP mô tả tham số bằng JSON Schema và nhận JSON POST; thời gian chờ được ghi là 120 giây.

Endpoint tra cứu phiếu hỗ trợ có thể kiểm tra token ngắn hạn giới hạn theo khách hàng. Xác thực người dùng, ngân sách, phê duyệt và quy tắc nghiệp vụ vẫn do ứng dụng chịu trách nhiệm.

Các khả năng có sẵn gồm tìm kiếm web, tự động hóa trình duyệt và thao tác tệp hoặc lệnh trong sandbox. Tài liệu còn mô tả Blaxel, Daytona và thông tin xác thực Browserbase riêng. Điều kiện và chi phí của từng nhà cung cấp cần xem riêng.

Với tệp, dùng sandbox do Click quản lý: tải đầu vào bằng POST /files, tham chiếu ID trong tác vụ và yêu cầu agent lưu đầu ra qua publish_file. Sau đó liệt kê artifacts và tải bằng GET /files/{file_id}. Tệp làm việc trong sandbox chưa thay thế được đầu ra đã xuất bản bền vững; hãy kiểm tra nội dung thực tế.

Theo dõi tác vụ dài chạy nền

GET /sessions/{session_id}/events trả snapshot đầy đủ trước, sau đó là thay đổi văn bản, công cụ và trạng thái. Khi kết nối lại, thay trạng thái cục bộ bằng snapshot mới. Ngắt luồng không dừng công việc; luồng đóng khi phiên chuyển sang standby.

Webhook có chữ ký cho submission.updated và artifact.created giúp nhận kết quả khi người dùng đã rời trang. Sau thông báo, đọc tài nguyên liên quan để biết trạng thái hiện tại trước khi cập nhật sản phẩm.

Miễn phí đến đâu và trả tiền cho phần nào?

Giá tháng công khai bằng USD được kiểm tra ngày 3 tháng 11 năm 2026 trên trang giá chính thức. Đây không phải tổng thanh toán bằng VNĐ hay xác nhận về thuế và phương thức thanh toán tại Việt Nam.

• Free: 0 USD/tháng. Hai phiên thường trú đồng thời, 100 MB lưu tệp; mỗi tháng có một giờ sandbox quản lý, một giờ trình duyệt và 100 lượt tìm kiếm.
• Pro: 199 USD/tháng. 50 phiên thường trú đồng thời, 10 GB; mỗi tháng có 100 giờ sandbox, 100 giờ trình duyệt và 5.000 lượt tìm kiếm.
• Enterprise: giá và dung lượng theo thỏa thuận.

BYOK nghĩa là dùng khóa mô hình riêng, nên cần tính phí nhà cung cấp mô hình tách biệt. Dịch vụ ngoài tự kết nối cũng có thể thu phí riêng. Lưu trữ là dung lượng hiện tại, không phải lượng mới mỗi tháng. Hạn mức quản lý dùng chung trong tenant. Free đặt lại theo tháng lịch UTC, Pro theo kỳ thuê bao đã thanh toán.

Phiên hoạt động và nhàn rỗi có runtime được tính vào số đồng thời; standby không tính. Hết hạn mức có thể chặn công cụ và dừng tác vụ. Tài liệu cho biết không tự tính phí vượt hạn mức.

Dữ liệu và quyền truy cập của ứng dụng

Tuyên bố quyền riêng tư bao gồm hướng dẫn, tin nhắn, tệp, yêu cầu và kết quả công cụ, cùng thông tin xác thực. Dữ liệu có thể chuyển tới nhà cung cấp mô hình và công cụ để thực hiện việc được yêu cầu; chính sách của họ cũng có thể áp dụng.

Nhân viên Click có thể truy cập nội dung khi hỗ trợ bắt đầu, hỗ trợ kỹ thuật, xử lý lỗi và cải thiện dịch vụ. Thời gian lưu theo nhu cầu hợp lý, không có số ngày cố định chung. Việc xử lý có thể diễn ra tại Mỹ và các nước khác. Không thể suy ra cam kết lưu tại Việt Nam, không lưu dữ liệu hay không dùng huấn luyện trong mọi trường hợp.

Đặt bí mật trong phần thông tin xác thực chuyên dụng, không đưa vào tin nhắn hay tệp. Chính sách yêu cầu không gửi thông tin chịu quản lý đặc biệt có độ nhạy cảm cao.

Câu hỏi thường gặp

Có thể dùng Click miễn phí không?

Có, trong hạn mức Free. Nhà cung cấp mô hình có thể tính phí riêng và việc tạo tài nguyên thường cần xác minh thẻ.

Có cần khóa API của mô hình riêng không?

Có. Hướng dẫn chính thức lưu khóa nhà cung cấp và chọn mô hình tương thích bằng GET /models. Khóa Click và khóa mô hình có vai trò khác nhau, đều cần giữ ở backend.

Có kết nối công cụ và API sẵn có được không?

Có thể qua MCP hoặc công cụ HTTPS với quyền cấp rõ ràng. Quyền truy cập khách hàng và phê duyệt thao tác quan trọng vẫn được thực thi trong ứng dụng.

Tài nguyên chính thức cho lập trình viên

• Tài liệu API: công cụ, sự kiện, webhook và tệp.
• Bắt đầu nhanh: tạo agent, phiên và gửi tác vụ đầu tiên.
• Điều khoản và hỗ trợ: điều kiện dịch vụ và kênh hỗ trợ chính thức.