Lewati ke konten
Pusat Bantuan Clevera

Memperbaiki error agen AI dan API

Setiap pesan yang mungkin dilihat oleh agen AI, skrip, atau orang dengan API, server MCP, dan halaman agen AI & API Clevera, dikelompokkan berdasarkan penyebabnya: token, paket, izin, pekerjaan berbayar, batas kecepatan, konflik, dan aplikasi yang terhubung, beserta cara memperbaikinya.

Diperbarui 9 mnt baca

Saat Clevera menolak panggilan agen, agen akan mendapatkan kode dan pesan yang menjelaskan apa yang harus dilakukan. Artikel ini mencantumkan setiap pesan yang mungkin dilihat oleh agen, skrip, atau orang dengan agen AI & API, apa penyebabnya, dan cara memperbaikinya. Melalui REST API, kodenya ada di error.code; melalui MCP, pesan yang sama muncul sebagai error alat.

Token tidak diterima

Pesan Kode Penyebab Perbaikan
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Tidak ada token yang dikirim. Kirim Authorization: Bearer <token>. Periksa apakah CLEVERA_TOKEN sudah diatur di tempat agen berjalan.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated Nilai salah ketik, terpotong, atau bukan token Clevera. Tempel seluruh token lagi.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera tidak mengenali token ini. Buat token baru.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated Login aplikasi yang terhubung digunakan pada REST API. Gunakan token API untuk REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Masa berlakunya habis. Buat token baru.
"This token was revoked." token_revoked Seseorang mencabutnya, token dibuat ulang, pemiliknya keluar, atau Clevera mencabutnya. Lihat mengapa token berhenti berfungsi.
"The account that owns this token is suspended." token_revoked Akun pemilik ditangguhkan. Hubungi dukungan.
"This token can't be used from this IP address." ip_not_allowed Panggilan berasal dari luar daftar IP yang diizinkan token. Jalankan agen dari alamat yang diizinkan, atau buat token dengan alamat baru.

Paket tidak menyertakannya

Agen AI & API (token, aplikasi terhubung, dan webhook) tersedia pada paket Pro, Business, dan Custom. Pada paket Free dan Starter, halaman tersebut menampilkan "AI agents & API are included in Pro" dengan Tingkatkan ke Pro. Melakukan peningkatan akan membuat token, aplikasi, dan webhook yang ada berfungsi kembali; tidak ada yang dihapus.

Pesan Kode Penyebab Perbaikan
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) Ruang kerja menggunakan paket Free atau Starter, atau berpindah ke paket tersebut. Setiap panggilan token dan aplikasi terhubung ditolak. Tingkatkan ke Pro. Token yang belum kedaluwarsa akan berfungsi kembali.
Claude atau ChatGPT hanya mengatakan tidak dapat terhubung, atau alat Clevera-nya gagal plan_locked di latar belakang Penolakan paket yang sama, ditampilkan oleh aplikasi sebagai error koneksi umum. Tingkatkan ruang kerja ke Pro, lalu coba lagi di aplikasi.
"The API and agent access are not on your plan." — Membuat token, atau mengeklik Setujui pada permintaan agen, di luar paket Pro. Tingkatkan ke Pro. Tolak tetap berfungsi.
"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." — Kontrol terkunci pada paket Free atau Starter. Tingkatkan ke Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Menghubungkan Claude atau ChatGPT ke ruang kerja di luar paket Pro. Tingkatkan, atau pilih ruang kerja lain di layar hubungkan.
Buat ulang rahasia membuka dialog peningkatan — Rahasia tidak dapat dibuat ulang di luar paket Pro. Tingkatkan ke Pro, atau cabut token.
"Webhooks are not on your plan." — Kirim acara tes atau Kirim ulang di luar paket Pro. Tidak ada yang dikirim; percobaan ulang yang menunggu berakhir sebagai gagal dengan plan_locked. Tingkatkan ke Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Pekerjaan berbayar pada paket yang tidak mendukungnya. Tingkatkan ke Pro.

Token tidak diizinkan untuk

Pesan Kode Penyebab Perbaikan
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Token tidak memiliki izin yang dibutuhkan panggilan ini. Buat token dengan izin tersebut. Lihat Izin agen.
"The token owner's current role in this workspace does not allow ability." forbidden_role Peran pemilik berubah sejak token dibuat. Token menunjukkan Melebihi peran. Seseorang dengan peran yang tepat membuat token tersebut.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Membuat token dengan izin di luar peran kamu. Hapus centang, atau minta pemilik atau admin.
"You can't do this in this workspace." forbidden Peran atau akses pemilik tidak mengizinkan tindakan ini pada item ini. Periksa peran pemilik dan akses koleksi.
"The token owner can view this article but not edit it (collection access)." forbidden_item Item berada dalam koleksi yang hanya bisa dilihat oleh pemilik. Berikan akses edit kepada pemilik ke koleksi tersebut.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Id salah, atau item berada di luar situs token atau akses pemilik. Daftar atau cari, lalu gunakan id yang dikembalikan.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Mengedit (atau menerjemahkan) artikel situs dokumen langsung tanpa hak publikasi. Berikan token site:publish, atau biarkan ia mengirimkan untuk ditinjau.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Artikel muncul di situs di luar situs token. Gunakan token yang mencakup setiap situs yang menampilkannya, atau tinggalkan catatan tinjauan.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Situs dokumen dijeda. Aktifkan kembali situs tersebut.
Pesan Kode Penyebab Perbaikan
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Penawaran tidak sesuai dengan batas Per tugas, Per hari, atau Per bulan token. Tunggu hari atau bulan berikutnya, atau buat token dengan batas lebih tinggi.
Pesan tentang kredit yang habis insufficient_credits Ruang kerja tidak memiliki cukup kredit. Beli kredit atau tunggu jatah berikutnya.
"Your workspace cannot spend credits right now." plan_locked Penagihan memblokir pengeluaran, misalnya pembayaran jatuh tempo. Periksa Penagihan.
"This quote has expired. Ask for a new quote." quote_expired Penawaran berlaku selama 15 menit. Minta penawaran baru.
"This quote was already used. Ask for a new quote." quote_used Satu penawaran memulai satu tugas. Minta penawaran baru.
"This quote is for another kind of job." quote_mismatch Penawaran video digunakan untuk memulai klip, misalnya. Gunakan panggilan mulai yang cocok.
"Another start is being checked. Try again in a moment." busy Dua kali mulai pada saat yang sama. Coba lagi setelah beberapa saat.
Tugas menunggu dengan needs_input — Menunggu persetujuan pada Permintaan agen. Pemilik atau admin menyetujui atau menolaknya dalam waktu 24 jam.
Tugas berakhir expired — Tidak ada yang memutuskan dalam waktu 24 jam. Mulai lagi dan setujui.
"This job can no longer be canceled." not_cancelable Tugas sudah selesai atau sudah melewati titik pembatalan. —

Pesan input umum saat meminta 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."

Terlalu banyak permintaan

Pesan Kode Batas
"This token is over its request rate. Wait and retry." rate_limited 300 permintaan per menit per token
"This workspace is over its agent request rate. Wait and retry." rate_limited 1.200 per menit per ruang kerja
"Too many writes from this token. Wait and retry." rate_limited 60 penulisan per menit per token
"This token reached its daily write limit. Try again tomorrow." rate_limited 2.000 penulisan per hari per token
"This token reached its hourly publish limit. Try again later." rate_limited 10 publikasi per jam per token
"Too many uploads from this token. Wait and retry." rate_limited 30 unggahan per menit
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB per hari per token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Aktivitas tidak biasa: penulisan dijeda selama 10 menit
"Too many requests. Wait and retry." rate_limited 60 per menit per alamat IP tanpa token yang valid

Memulai berbayar juga dibatasi hingga 20 per jam per token dan 100 per hari per ruang kerja. Setiap 429 memiliki header Retry-After; tunggu selama itu.

Konten dan percobaan ulang

Pesan Kode Perbaikan
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict Agen membaca ulang halaman dan menerapkan kembali perubahannya.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Gunakan Idempotency-Key baru untuk permintaan baru.
— idempotency_in_progress Permintaan pertama dengan kunci ini masih berjalan. Tunggu, lalu coba lagi dengan kunci yang sama.

Token dan halaman

Situasi Penyebab Perbaikan
Token baru dinonaktifkan "Your workspace has reached its limit of 50 active tokens. Revoke one first." Cabut token yang tidak kamu gunakan.
Tidak ada opsi Buat ulang rahasia Hanya pembuat token yang dapat membuatnya ulang, dan hanya sekali. "Only the person who created this token can regenerate it. You can revoke it." Buat ulang token yang lebih baru, atau buat yang baru.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Rahasia sudah dibuat ulang sebelumnya. Gunakan token pengganti.
Kamu tidak melihat token rekan kerja Hanya pemilik dan admin yang melihat setiap token. Tanyakan kepada pemilik atau admin.
Kamu tidak dapat menyetujui permintaan: "An owner or admin decides" Hanya pemilik dan admin yang menyetujui pengeluaran. Tanyakan kepada pemilik atau admin.
"Only owners and admins manage webhooks" Peranmu tidak dapat mengelola webhook. Tanyakan kepada pemilik atau admin.

Menghubungkan Claude atau ChatGPT

Di layar Perbaikan
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Hapus konektor di aplikasi dan tambahkan lagi.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Jangan hubungkan jika ini terus terjadi.
"Choose a workspace you are a member of." Pilih salah satu ruang kerjamu.
"Revoked: token reuse detected" pada aplikasi yang terhubung Masuk aplikasi digunakan kembali, jadi Clevera mencabutnya. Hubungkan kembali aplikasi tersebut.

Masih terkendala

Hubungi dukungan dengan request_id dari kesalahan tersebut, nama token (jangan pernah token itu sendiri), dan waktu panggilan.

Kelola token APIMengapa token berhenti berfungsi.Izin agenIzin apa yang dibutuhkan panggilan.Kontrol pengeluaran dan persetujuan agenBatas, kuota, dan persetujuan.Gunakan REST APIFormat kesalahan dan batas laju.