Mọi thông báo mà AI agent, tập lệnh hoặc người dùng có thể thấy với API, máy chủ MCP và trang AI agents & API của Clevera, được nhóm theo nguyên nhân: token, gói dịch vụ, quyền, công việc trả phí, giới hạn tốc độ, xung đột và ứng dụng kết nối, cùng với cách khắc phục.
Đã cập nhật 12 phút đọc
Khi Clevera từ chối yêu cầu của một agent, agent đó sẽ nhận được mã và thông báo cho biết cần làm gì. Bài viết này liệt kê mọi thông báo mà agent, tập lệnh hoặc người dùng có thể thấy với AI agents & API, nguyên nhân gây ra và cách khắc phục. Qua REST API, mã này nằm trong error.code; qua MCP, cùng thông báo đó sẽ trả về dưới dạng lỗi công cụ.
AI agents & API (token, ứng dụng kết nối và webhook) có sẵn trên các gói Pro, Business và Custom. Trên gói Free và Starter, trang này hiển thị "AI agents & API are included in Pro" cùng với Nâng cấp lên Pro. Việc nâng cấp sẽ giúp các token, ứng dụng và webhook hiện có hoạt động trở lại; không có gì bị xóa.
Thông báo
Mã
Nguyên nhân
Khắc phục
"The agent API is not on this workspace's plan. It is on Pro and up."
plan_locked (HTTP 403)
Không gian làm việc đang ở gói Free hoặc Starter, hoặc đã chuyển sang gói này. Mọi yêu cầu từ token và ứng dụng kết nối đều bị từ chối.
Nâng cấp lên Pro. Các token chưa hết hạn sẽ hoạt động trở lại.
Claude hoặc ChatGPT chỉ báo rằng không thể kết nối, hoặc các công cụ Clevera của nó bị lỗi
plan_locked phía sau
Từ chối do gói dịch vụ, được ứng dụng hiển thị dưới dạng lỗi kết nối chung.
Nâng cấp không gian làm việc lên Pro, sau đó thử lại trong ứng dụng.
"The API and agent access are not on your plan."
—
Tạo token hoặc nhấp vào Phê duyệt trên một yêu cầu của agent khi không ở gói Pro.
Nâng cấp lên Pro. Từ chối vẫn hoạt động.
"The API and agent access are on Pro and up." / "Claude.ai and ChatGPT connectors are on Pro and up." / "Webhooks are on Pro and up."
—
Một điều khiển bị khóa trên gói Free hoặc Starter.
Nâng cấp lên Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps."
—
Kết nối Claude hoặc ChatGPT với không gian làm việc không có gói Pro.
Nâng cấp hoặc chọn không gian làm việc khác trên màn hình kết nối.
Tạo lại mã bí mật mở hộp thoại nâng cấp
—
Không thể tạo lại mã bí mật nếu không ở gói Pro.
Nâng cấp lên Pro hoặc thu hồi token.
"Webhooks are not on your plan."
—
Gửi sự kiện kiểm thử hoặc Gửi lại khi không ở gói Pro. Không có gì được gửi; các lần thử lại chờ đợi sẽ kết thúc với lỗi plan_locked.
Nâng cấp lên Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it."
plan_locked
Công việc trả phí trên gói không hỗ trợ tính năng này.
"This would pass the token's spend cap. A workspace admin can raise it."
cap_exceeded
Báo giá vượt quá giới hạn chi tiêu Mỗi công việc, Mỗi ngày hoặc Mỗi tháng của token.
Chờ đến ngày hoặc tháng tiếp theo, hoặc tạo token với giới hạn cao hơn.
Một thông báo về việc hết tín dụng
insufficient_credits
Không gian làm việc không đủ tín dụng.
Mua thêm tín dụng hoặc chờ phân bổ.
"Your workspace cannot spend credits right now."
plan_locked
Thanh toán chặn việc chi tiêu, ví dụ như đến hạn thanh toán.
Kiểm tra Thanh toán.
"This quote has expired. Ask for a new quote."
quote_expired
Báo giá có hiệu lực trong 15 phút.
Yêu cầu báo giá mới.
"This quote was already used. Ask for a new quote."
quote_used
Một báo giá chỉ bắt đầu một công việc.
Yêu cầu báo giá mới.
"This quote is for another kind of job."
quote_mismatch
Ví dụ: báo giá video đã được sử dụng để bắt đầu một clip.
Sử dụng lệnh bắt đầu phù hợp.
"Another start is being checked. Try again in a moment."
busy
Hai yêu cầu bắt đầu cùng một lúc.
Thử lại sau một giây.
Công việc chờ với needs_input
—
Đang chờ phê duyệt trên Yêu cầu của tác nhân.
Chủ sở hữu hoặc quản trị viên phê duyệt hoặc từ chối trong vòng 24 giờ.
Công việc kết thúc expired
—
Không ai quyết định trong vòng 24 giờ.
Bắt đầu lại và phê duyệt.
"This job can no longer be canceled."
not_cancelable
Công việc đã hoàn thành hoặc đã quá thời điểm có thể hủy.
—
Các thông báo đầu vào phổ biến khi yêu cầu video: "This recording is still processing. Please wait until it is ready.", "Choose how_to, product_demo, cleanup or styled_video.", "Choose 1080p, 2k or 4k.", "Exports are always 60 fps.", "This item is an article; only videos can be exported.", "Social clips cannot be translated by agents yet.", "This language is already translated.", "That material was not found in this workspace. Upload it first."
"This token is over its request rate. Wait and retry."
rate_limited
300 yêu cầu mỗi phút cho mỗi token
"This workspace is over its agent request rate. Wait and retry."
rate_limited
1.200 yêu cầu mỗi phút cho mỗi không gian làm việc
"Too many writes from this token. Wait and retry."
rate_limited
60 lượt ghi mỗi phút cho mỗi token
"This token reached its daily write limit. Try again tomorrow."
rate_limited
2.000 lượt ghi mỗi ngày cho mỗi token
"This token reached its hourly publish limit. Try again later."
rate_limited
10 lượt xuất bản mỗi giờ cho mỗi token
"Too many uploads from this token. Wait and retry."
rate_limited
30 lượt tải lên mỗi phút
"This token reached its daily upload volume. Try again tomorrow."
rate_limited
500 MB mỗi ngày cho mỗi token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified."
rate_limited
Hoạt động bất thường: tạm dừng ghi trong 10 phút
"Too many requests. Wait and retry."
rate_limited
60 yêu cầu mỗi phút cho mỗi địa chỉ IP không có token hợp lệ
Các lượt bắt đầu trả phí cũng bị giới hạn ở mức 20 mỗi giờ cho mỗi token và 100 mỗi ngày cho mỗi không gian làm việc. Mỗi 429 đều có tiêu đề Retry-After; hãy đợi trong khoảng thời gian đó.
