ข้ามไปยังเนื้อหา
Clevera Help Center

แก้ไขข้อผิดพลาดของ AI agent และ API

ทุกข้อความที่ AI agent, สคริปต์ หรือบุคคลอาจพบเมื่อใช้ API, MCP server และหน้า AI agents & API ของ Clevera โดยจัดกลุ่มตามสาเหตุ: โทเค็น, แผนบริการ, สิทธิ์การใช้งาน, งานที่ต้องชำระเงิน, ขีดจำกัดอัตราการใช้งาน, ความขัดแย้ง และแอปที่เชื่อมต่อ พร้อมวิธีแก้ไข

อัปเดตเมื่อ ใช้เวลาอ่าน 11 นาที

เมื่อ Clevera ปฏิเสธการเรียกใช้งานของ agent, agent จะได้รับรหัสและข้อความที่ระบุสิ่งที่ต้องทำ บทความนี้แสดงรายการข้อความทั้งหมดที่ agent, สคริปต์ หรือบุคคลอาจพบเมื่อใช้ AI agents & API, สาเหตุของข้อผิดพลาด และวิธีแก้ไข สำหรับ REST API รหัสจะอยู่ใน error.code; ส่วนใน MCP ข้อความเดียวกันจะส่งกลับมาเป็นข้อผิดพลาดของเครื่องมือ

โทเค็นไม่ได้รับการยอมรับ

ข้อความ รหัส สาเหตุ วิธีแก้ไข
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated ไม่มีการส่งโทเค็น ส่ง Authorization: Bearer <token> ตรวจสอบว่ามีการตั้งค่า CLEVERA_TOKEN ไว้ในที่ที่ agent ทำงานอยู่
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated ค่าที่ระบุพิมพ์ผิด, ถูกตัดทอน หรือไม่ใช่โทเค็นของ Clevera วางโทเค็นทั้งหมดอีกครั้ง
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera ไม่รู้จักโทเค็นนี้ สร้างโทเค็นใหม่
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated มีการใช้การลงชื่อเข้าใช้ของแอปที่เชื่อมต่อบน REST API ใช้โทเค็น API สำหรับ REST
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired อายุการใช้งานหมดลงแล้ว สร้างโทเค็นใหม่
"This token was revoked." token_revoked มีคนเพิกถอนโทเค็น, โทเค็นถูกสร้างใหม่, เจ้าของออกจากระบบ หรือ Clevera เพิกถอนโทเค็นนั้น ดู เหตุผลที่โทเค็นหยุดทำงาน
"The account that owns this token is suspended." token_revoked บัญชีที่เป็นเจ้าของโทเค็นนี้ถูกระงับ ติดต่อฝ่ายสนับสนุน
"This token can't be used from this IP address." ip_not_allowed การเรียกใช้งานมาจากภายนอกรายการ IP ที่อนุญาตของโทเค็น เรียกใช้ agent จากที่อยู่ที่ได้รับอนุญาต หรือสร้างโทเค็นใหม่ด้วยที่อยู่ใหม่

แผนบริการไม่ครอบคลุมการใช้งานนี้

AI agents & API (โทเค็น, แอปที่เชื่อมต่อ และเว็บฮุค) มีให้บริการในแผน Pro, Business และ Custom สำหรับแผน Free และ Starter หน้าดังกล่าวจะแสดงข้อความ "AI agents & API are included in Pro" พร้อมปุ่ม อัปเกรดเป็น Pro การอัปเกรดจะทำให้โทเค็น, แอป และเว็บฮุคที่มีอยู่กลับมาใช้งานได้อีกครั้ง โดยไม่มีข้อมูลใดถูกลบ

ข้อความ รหัส สาเหตุ วิธีแก้ไข
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) เวิร์กสเปซอยู่ในแผน Free หรือ Starter หรือถูกย้ายมายังแผนนี้ การเรียกใช้งานโทเค็นและแอปที่เชื่อมต่อทั้งหมดจะถูกปฏิเสธ อัปเกรดเป็น Pro โทเค็นที่ยังไม่หมดอายุจะกลับมาใช้งานได้อีกครั้ง
Claude หรือ ChatGPT แจ้งว่าไม่สามารถเชื่อมต่อได้ หรือเครื่องมือ Clevera ของแอปทำงานล้มเหลว plan_locked เบื้องหลัง การปฏิเสธเนื่องจากแผนบริการ ซึ่งแอปจะแสดงเป็นข้อผิดพลาดในการเชื่อมต่อทั่วไป อัปเกรดเวิร์กสเปซเป็น Pro แล้วลองใหม่อีกครั้งในแอป
"The API and agent access are not on your plan." — การสร้างโทเค็น หรือการคลิก อนุมัติ บนคำขอจากเอเจนต์ ในขณะที่ไม่ได้ใช้แผน Pro อัปเกรดเป็น Pro ปุ่ม ปฏิเสธ ยังคงใช้งานได้
"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." — การควบคุมที่ถูกล็อกไว้ในแผน Free หรือ Starter อัปเกรดเป็น Pro
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — การเชื่อมต่อ Claude หรือ ChatGPT กับเวิร์กสเปซที่ไม่ได้ใช้แผน Pro อัปเกรด หรือเลือกเวิร์กสเปซอื่นบนหน้าจอการเชื่อมต่อ
สร้างรหัสลับใหม่ เปิดหน้าต่างการอัปเกรด — ไม่สามารถสร้างรหัสลับใหม่ได้หากไม่ได้ใช้แผน Pro อัปเกรดเป็น Pro หรือเพิกถอนโทเค็น
"Webhooks are not on your plan." — ส่งเหตุการณ์ทดสอบ หรือ ส่งซ้ำ ในขณะที่ไม่ได้ใช้แผน Pro ไม่มีการส่งข้อมูลใดๆ และการรอส่งซ้ำจะสิ้นสุดลงด้วยความล้มเหลวพร้อม plan_locked อัปเกรดเป็น Pro
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked งานที่ต้องชำระเงินบนแผนที่ไม่รองรับ อัปเกรดเป็น Pro

โทเค็นไม่ได้รับอนุญาตให้

ข้อความ รหัส สาเหตุ วิธีแก้ไข
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability โทเค็นไม่มีสิทธิ์ที่จำเป็นสำหรับการเรียกใช้งานนี้ สร้างโทเค็นที่มีสิทธิ์นั้น ดู สิทธิ์ของ Agent
"The token owner's current role in this workspace does not allow ability." forbidden_role บทบาทของเจ้าของเปลี่ยนไปตั้งแต่สร้างโทเค็น โทเค็นแสดงสถานะ เกินบทบาท ให้ผู้ที่มีบทบาทเหมาะสมสร้างโทเค็น
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — การสร้างโทเค็นที่มีสิทธิ์เกินกว่าบทบาทของคุณ ยกเลิกการเลือกสิทธิ์เหล่านั้น หรือขอให้เจ้าของหรือผู้ดูแลระบบดำเนินการให้
"You can't do this in this workspace." forbidden บทบาทหรือการเข้าถึงของเจ้าของไม่อนุญาตให้ดำเนินการนี้กับรายการนี้ ตรวจสอบบทบาทของเจ้าของและการเข้าถึงคอลเลกชัน
"The token owner can view this article but not edit it (collection access)." forbidden_item รายการอยู่ในคอลเลกชันที่เจ้าของดูได้เท่านั้น ให้สิทธิ์แก้ไขคอลเลกชันแก่เจ้าของ
"No item with that id in this token's scope. List or search first and use a returned id." not_found รหัสผิด หรือรายการอยู่นอกเหนือไซต์ของโทเค็นหรือการเข้าถึงของเจ้าของ แสดงรายการหรือค้นหา แล้วใช้รหัสที่ได้รับกลับมา
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish การแก้ไข (หรือแปล) บทความบนไซต์เอกสารที่เผยแพร่อยู่โดยไม่มีสิทธิ์เผยแพร่ ให้สิทธิ์ site:publish แก่โทเค็น หรือปล่อยให้ส่งเพื่อตรวจสอบ
"This article is also shown on a site this token cannot change. …" shared_outside_scope บทความปรากฏบนไซต์ที่อยู่นอกเหนือไซต์ของโทเค็น ใช้โทเค็นที่ครอบคลุมทุกไซต์ที่แสดงบทความนั้น หรือทิ้งบันทึกการตรวจสอบไว้
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused ไซต์เอกสารถูกหยุดชั่วคราว เปิดใช้งานไซต์อีกครั้ง
ข้อความ รหัส สาเหตุ วิธีแก้ไข
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded ใบเสนอราคาไม่สอดคล้องกับขีดจำกัด ต่องาน, ต่อวัน หรือ ต่อเดือน ของโทเค็น รอวันหรือเดือนถัดไป หรือสร้างโทเค็นที่มีขีดจำกัดสูงขึ้น
ข้อความเกี่ยวกับเครดิตที่หมดลง insufficient_credits เวิร์กสเปซมีเครดิตไม่เพียงพอ ซื้อเครดิตเพิ่มหรือรอการจัดสรรเครดิต
"Your workspace cannot spend credits right now." plan_locked การเรียกเก็บเงินบล็อกการใช้จ่าย เช่น ถึงกำหนดชำระเงิน ตรวจสอบ การเรียกเก็บเงิน
"This quote has expired. Ask for a new quote." quote_expired ใบเสนอราคามีอายุ 15 นาที ขอใบเสนอราคาใหม่
"This quote was already used. Ask for a new quote." quote_used ใบเสนอราคาใช้เริ่มงานได้หนึ่งงาน ขอใบเสนอราคาใหม่
"This quote is for another kind of job." quote_mismatch ตัวอย่างเช่น มีการใช้ใบเสนอราคาสำหรับวิดีโอเพื่อเริ่มคลิป ใช้การเรียกเริ่มงานที่ตรงกัน
"Another start is being checked. Try again in a moment." busy มีการเริ่มงานสองรายการในเวลาเดียวกัน ลองใหม่อีกครั้งในอีกสักครู่
งานรออยู่พร้อม needs_input — กำลังรอการอนุมัติใน คำขอจากเอเจนต์ เจ้าของหรือผู้ดูแลระบบอนุมัติหรือปฏิเสธภายใน 24 ชั่วโมง
งานสิ้นสุดลง expired — ไม่มีใครตัดสินใจภายใน 24 ชั่วโมง เริ่มต้นใหม่อีกครั้งและอนุมัติ
"This job can no longer be canceled." not_cancelable งานเสร็จสิ้นแล้วหรือเกินจุดที่สามารถยกเลิกได้ —

ข้อความอินพุตทั่วไปเมื่อขอวิดีโอ: "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 คำขอต่อนาทีต่อโทเค็น
"This workspace is over its agent request rate. Wait and retry." rate_limited 1,200 คำขอต่อนาทีต่อเวิร์กสเปซ
"Too many writes from this token. Wait and retry." rate_limited 60 การเขียนต่อนาทีต่อโทเค็น
"This token reached its daily write limit. Try again tomorrow." rate_limited 2,000 การเขียนต่อวันต่อโทเค็น
"This token reached its hourly publish limit. Try again later." rate_limited 10 การเผยแพร่ต่อชั่วโมงต่อโทเค็น
"Too many uploads from this token. Wait and retry." rate_limited 30 การอัปโหลดต่อนาที
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB ต่อวันต่อโทเค็น
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited กิจกรรมผิดปกติ: การเขียนจะหยุดชั่วคราวเป็นเวลา 10 นาที
"Too many requests. Wait and retry." rate_limited 60 คำขอต่อนาทีต่อที่อยู่ IP โดยไม่มีโทเค็นที่ถูกต้อง

การเริ่มต้นแบบชำระเงินจะจำกัดไว้ที่ 20 ครั้งต่อชั่วโมงต่อโทเค็น และ 100 ครั้งต่อวันต่อพื้นที่ทำงาน ทุก 429 จะมีส่วนหัว Retry-After ให้รอตามระยะเวลานั้น

เนื้อหาและการลองใหม่

ข้อความ รหัส วิธีแก้ไข
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict เอเจนต์จะอ่านหน้าเว็บอีกครั้งและนำการเปลี่ยนแปลงไปใช้ใหม่
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused ใช้ Idempotency-Key ใหม่สำหรับคำขอใหม่
— idempotency_in_progress คำขอแรกที่ใช้คีย์นี้ยังคงทำงานอยู่ ให้รอสักครู่แล้วลองใหม่ด้วยคีย์เดิม

โทเค็นและหน้าเว็บ

สถานการณ์ สาเหตุ วิธีแก้ไข
โทเค็นใหม่ ถูกปิดใช้งาน "Your workspace has reached its limit of 50 active tokens. Revoke one first." เพิกถอนโทเค็นที่คุณไม่ได้ใช้งาน
ไม่มีตัวเลือก สร้างรหัสลับใหม่ เฉพาะผู้สร้างโทเค็นเท่านั้นที่สามารถสร้างรหัสลับใหม่ได้ และทำได้เพียงครั้งเดียวเท่านั้น "Only the person who created this token can regenerate it. You can revoke it." สร้างรหัสลับใหม่สำหรับโทเค็นที่ใหม่กว่า หรือสร้างโทเค็นขึ้นมาใหม่
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." รหัสลับถูกสร้างใหม่ไปก่อนหน้านี้แล้ว ใช้โทเค็นทดแทน
คุณไม่เห็นโทเค็นของเพื่อนร่วมงาน เฉพาะเจ้าของและผู้ดูแลระบบเท่านั้นที่เห็นโทเค็นทั้งหมด สอบถามเจ้าของหรือผู้ดูแลระบบ
คุณไม่สามารถอนุมัติคำขอได้: "An owner or admin decides" เฉพาะเจ้าของและผู้ดูแลระบบเท่านั้นที่อนุมัติการใช้จ่ายได้ สอบถามเจ้าของหรือผู้ดูแลระบบ
"Only owners and admins manage webhooks" บทบาทของคุณไม่สามารถจัดการเว็บฮุคได้ สอบถามเจ้าของหรือผู้ดูแลระบบ

การเชื่อมต่อ Claude หรือ ChatGPT

บนหน้าจอ วิธีแก้ไข
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" นำตัวเชื่อมต่อในแอปออกแล้วเพิ่มใหม่อีกครั้ง
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." อย่าเชื่อมต่อหากยังคงเกิดปัญหานี้อยู่
"Choose a workspace you are a member of." เลือกพื้นที่ทำงานที่คุณเป็นสมาชิกอยู่
"Revoked: token reuse detected" บนแอปที่เชื่อมต่อ การลงชื่อเข้าใช้ของแอปถูกนำไปใช้ซ้ำ Clevera จึงเพิกถอนการเชื่อมต่อ ให้เชื่อมต่อแอปใหม่อีกครั้ง

ยังคงติดปัญหา

ติดต่อฝ่ายสนับสนุนโดยระบุ request_id จากข้อผิดพลาด ชื่อของโทเค็น (ห้ามระบุตัวโทเค็นเอง) และเวลาที่ทำการเรียกใช้งาน

จัดการโทเค็น APIสาเหตุที่โทเค็นหยุดทำงานสิทธิ์ของเอเจนต์สิทธิ์ที่การเรียกใช้งานจำเป็นต้องใช้ควบคุมการใช้จ่ายและการอนุมัติของเอเจนต์ขีดจำกัด โควตา และการอนุมัติใช้ REST APIรูปแบบข้อผิดพลาดและขีดจำกัดอัตราการใช้งาน