Nền tảng được hỗ trợ
Điều kiện tiên quyết
- Một tài khoản Flespi có quyền vào Flespi panel tại flespi.io.
- Quyền tạo token trong tài khoản đó.
Chọn loại token
Với ACL token chỉ đọc, hãy cấp GET cho từng module mà agent cần xem:
Bỏ qua mọi module agent không cần. Chỉ cấp các method ghi (POST, PUT, DELETE) nếu bạn muốn agent thay đổi dữ liệu. Xem Quyền ghi.
ACL token mặc định từ chối mọi quyền, và các quyền không bao hàm lẫn nhau. Quyền ghi trên devices không bao gồm quyền đọc devices, trừ khi bạn cấp thêm quyền đọc.
Thiết lập
1
Tạo token trong Flespi
Trong Flespi panel, mở Tokens ở menu bên trái và nhấn +. Đặt:
- Name:
CloudThinker - Type: ACL. Trong trình chỉnh sửa ACL, thêm một mục cho mỗi module trong bảng ACL và cho phép method GET trên từng mục
- Expiration: Flespi yêu cầu mọi token phải có TTL hoặc ngày hết hạn. Hãy dùng TTL 90 ngày không hoạt động. TTL được đặt lại sau mỗi lệnh gọi, nên token đang được dùng vẫn còn hiệu lực, còn token bỏ không sẽ bị dọn đi
2
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Flespi. Dán token vào FLESPI_TOKEN. Chỉ dán giá trị token, không kèm tiền tố
FlespiToken. CloudThinker tự thêm header đó.Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi chuyển sang Connected. Nếu xác minh thất bại, kết nối hiển thị Failed kèm thông báo lỗi. Đối chiếu thông báo với phần Khắc phục sự cố.Chi tiết kết nối
Khả năng của agent
Agent làm được gì phụ thuộc vào quyền mà token cho phép:
Một số tool có AI hỗ trợ của Flespi, như tìm kiếm tài liệu Flespi, sẽ dùng vào hạn mức AI của tài khoản Flespi. Hãy xem ô AI trong Flespi panel nếu bạn dựa vào các tool này. Các thao tác đọc thiết bị, channel và stream thông thường không dùng hạn mức này.
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Thiết lập khuyến nghị là ACL token chỉ đọc, và Flespi từ chối mọi thao tác ghi mà token không cho phép. Nếu bạn cấp method ghi, mỗi thao tác ghi agent thực hiện đều đi qua Approvals. Rules và Approval mode của bạn quyết định thao tác đó được chạy, phải chờ người duyệt, hay bị từ chối. Thao tác đọc không bao giờ cần phê duyệt.Khắc phục sự cố
Invalid or expired token
Invalid or expired token
Flespi xóa token khi token hết hạn. Kiểm tra TTL của token trong Flespi panel, tạo token mới nếu token cũ đã mất, rồi cập nhật FLESPI_TOKEN trên kết nối.
Action is not permitted by ACL
Action is not permitted by ACL
ACL token thiếu module và method cho request đó. Thêm quyền cho token trong Flespi panel. Lưu ý quyền đọc và quyền ghi được cấp riêng.
HTTP 429 rate limit
HTTP 429 rate limit
Flespi giới hạn mức sử dụng mỗi phút trên toàn bộ API, MQTT và lưu lượng của tài khoản. Hãy yêu cầu khoảng thời gian hẹp hơn hoặc ít thiết bị hơn mỗi lần, hoặc đợi một phút rồi thử lại.
Tra cứu có AI hỗ trợ bị từ chối
Tra cứu có AI hỗ trợ bị từ chối
Hạn mức AI trong tháng của tài khoản Flespi đã dùng hết. Các thao tác đọc thiết bị, channel và stream vẫn hoạt động. Xem ô AI trong Flespi panel để biết mức sử dụng.
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Token riêng cho CloudThinker: không dùng chung với integration khác, để bạn có thể thu hồi riêng token này.
- Không bao giờ dùng Master token: dùng ACL với đúng các module và method agent cần.
- Giữ TTL 90 ngày không hoạt động: token đang được dùng sẽ còn hiệu lực. Nếu kết nối bỏ không lâu như vậy, Flespi xóa token và bạn cần tạo token mới. Ngoài ra, hãy xoay vòng token theo lịch thay thông tin xác thực thường lệ.
Liên quan
Tổng quan kết nối
Xem mọi dịch vụ bạn có thể kết nối và cách kết nối hoạt động.
Approvals
Quyết định thao tác ghi nào được chạy, phải chờ người duyệt, hay bị từ chối.