İçeriğe atla
Clevera Yardım Merkezi

AI temsilcisi ve API hatalarını düzeltme

Bir AI temsilcisinin, betiğin veya kişinin Clevera'nın API'si, MCP sunucusu ve AI temsilcileri & API sayfası ile görebileceği her mesaj; nedenlerine göre gruplandırılmıştır: belirteçler, plan, izinler, ücretli işler, hız sınırları, çakışmalar ve bağlanan uygulamalar ile birlikte çözüm yolları.

Güncellenme 9 dk okuma

Clevera bir temsilcinin çağrısını reddettiğinde, temsilci bir kod ve ne yapması gerektiğini söyleyen bir mesaj alır. Bu makale, bir temsilcinin, betiğin veya kişinin AI temsilcileri & API ile görebileceği her mesajı, nedenini ve nasıl düzeltileceğini listeler. REST API üzerinden kod error.code içindedir; MCP üzerinden ise aynı mesaj bir araç hatası olarak geri döner.

Belirteç kabul edilmiyor

Mesaj Kod Neden Çözüm
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Belirteç gönderilmedi. Authorization: Bearer <token> gönderin. Temsilcinin çalıştığı yerde CLEVERA_TOKEN ayarlandığından emin olun.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated Değer yanlış yazılmış, kesilmiş veya bir Clevera belirteci değil. Belirtecin tamamını tekrar yapıştırın.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera bu belirteci tanımıyor. Yeni bir belirteç oluşturun.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated Bağlı bir uygulamanın oturum açma bilgileri REST API'de kullanıldı. REST için bir API belirteci kullanın.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Kullanım ömrü doldu. Yeni bir belirteç oluşturun.
"This token was revoked." token_revoked Birisi iptal etti, yeniden oluşturuldu, sahibi ayrıldı veya Clevera iptal etti. Belirtecin neden çalışmayı durdurduğuna bakın.
"The account that owns this token is suspended." token_revoked Belirtecin sahibi olan hesap askıya alındı. Destek ekibiyle iletişime geçin.
"This token can't be used from this IP address." ip_not_allowed Çağrı, belirtecin IP izin listesinin dışından geldi. Temsilciyi izin verilen bir adresten çalıştırın veya yeni adresle bir belirteç oluşturun.

Plan bunu içermiyor

AI temsilcileri & API (belirteçler, bağlı uygulamalar ve web kancaları) Pro, Business ve Custom planlarında bulunur. Free ve Starter planlarında sayfa "AI temsilcileri & API, Pro'ya dahildir" mesajını ve Pro'ya yükselt düğmesini gösterir. Yükseltme yapmak, mevcut belirteçlerin, uygulamaların ve web kancalarının tekrar çalışmasını sağlar; hiçbir şey silinmez.

Mesaj Kod Neden Çözüm
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) Çalışma alanı Free veya Starter planında veya bu planlardan birine taşındı. Her belirteç ve bağlı uygulama çağrısı reddedilir. Pro'ya yükseltin. Süresi dolmamış belirteçler tekrar çalışır.
Claude veya ChatGPT sadece bağlanamadığını söylüyor veya Clevera araçları başarısız oluyor plan_locked arka planda Aynı plan reddi, uygulama tarafından genel bir bağlantı hatası olarak gösterilir. Çalışma alanını Pro'ya yükseltin, ardından uygulamada tekrar deneyin.
"The API and agent access are not on your plan." — Pro dışında bir planda belirteç oluşturmak veya bir temsilci isteğinde Onayla düğmesine tıklamak. Pro'ya yükseltin. Reddet hala çalışır.
"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 veya Starter'da kilitli bir kontrol. Pro'ya yükseltin.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Claude veya ChatGPT'yi Pro dışındaki bir çalışma alanına bağlamak. Yükseltin veya bağlantı ekranında başka bir çalışma alanı seçin.
Regenerate secret opens the upgrade dialog — Gizli anahtarlar Pro dışında yeniden oluşturulamaz. Pro'ya yükseltin veya belirteci iptal edin.
"Webhooks are not on your plan." — Pro dışında Test etkinliği gönder veya Yeniden teslim et işlemi. Hiçbir şey gönderilmez; bekleyen yeniden denemeler plan_locked ile başarısız olur. Pro'ya yükseltin.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Plan dahilinde olmayan ücretli iş. Pro'ya yükseltin.

Belirtecin buna izni yok

Mesaj Kod Neden Çözüm
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Belirteç, bu çağrının ihtiyaç duyduğu izne sahip değil. Bu izne sahip bir belirteç oluşturun. Temsilci izinlerine bakın.
"The token owner's current role in this workspace does not allow ability." forbidden_role Belirteç oluşturulduğundan beri sahibinin rolü değişti. Belirteç Rolü aşıyor durumunu gösterir. Doğru role sahip biri belirteci oluşturur.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Rolünüzün ötesinde izinlere sahip bir belirteç oluşturmak. İzinlerin işaretini kaldırın veya bir sahip ya da yöneticiden isteyin.
"You can't do this in this workspace." forbidden Sahibinin rolü veya erişimi, bu öğe üzerinde bu işleme izin vermiyor. Sahibinin rolünü ve koleksiyon erişimini kontrol edin.
"The token owner can view this article but not edit it (collection access)." forbidden_item Öğe, sahibinin sadece görüntüleyebildiği bir koleksiyonda. Sahibine koleksiyon için düzenleme erişimi verin.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Yanlış kimlik veya öğe, belirtecin sitelerinin veya sahibinin erişiminin dışında. Listeleyin veya arayın, ardından döndürülen bir kimliği kullanın.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Yayınlama hakları olmadan canlı bir doküman sitesi makalesini düzenlemek (veya çevirmek). Belirtece site:publish verin veya inceleme için gönderilmesine izin verin.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Makale, belirtecin sitelerinin dışında bir sitede görünüyor. Onu gösteren her siteyi kapsayan bir belirteç kullanın veya bir inceleme notu bırakın.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Doküman sitesi duraklatılmış. Siteyi yeniden etkinleştirin.
Mesaj Kod Neden Çözüm
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Teklif, belirtecin İş başına, Günlük veya Aylık sınırına uymuyor. Bir sonraki günü veya ayı bekleyin ya da daha yüksek sınırlara sahip bir belirteç oluşturun.
Kredilerin tükendiğine dair bir mesaj insufficient_credits Çalışma alanında yeterli kredi yok. Kredi satın alın veya tahsisatın yenilenmesini bekleyin.
"Your workspace cannot spend credits right now." plan_locked Faturalandırma harcamayı engelliyor, örneğin ödeme vadesi gelmiş. Faturalandırma kısmını kontrol edin.
"This quote has expired. Ask for a new quote." quote_expired Teklifler 15 dakika geçerlidir. Yeni bir teklif isteyin.
"This quote was already used. Ask for a new quote." quote_used Bir teklif bir işi başlatır. Yeni bir teklif isteyin.
"This quote is for another kind of job." quote_mismatch Örneğin, bir video teklifi bir klip başlatmak için kullanıldı. Eşleşen başlatma çağrısını kullanın.
"Another start is being checked. Try again in a moment." busy Aynı anda iki başlatma isteği. Bir saniye sonra tekrar deneyin.
İş needs_input ile bekliyor — Temsilci istekleri kısmında onay bekliyor. Bir sahip veya yönetici 24 saat içinde onaylar veya reddeder.
İş expired ile sona eriyor — 24 saat içinde kimse karar vermedi. Yeniden başlatın ve onaylayın.
"This job can no longer be canceled." not_cancelable İş zaten bitti veya iptal edilemeyecek bir aşamada. —

Video talep ederken karşılaşılan yaygın giriş mesajları: "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."

Çok fazla istek

Mesaj Kod Sınır
"This token is over its request rate. Wait and retry." rate_limited Belirteç başına dakikada 300 istek
"This workspace is over its agent request rate. Wait and retry." rate_limited Çalışma alanı başına dakikada 1.200 istek
"Too many writes from this token. Wait and retry." rate_limited Belirteç başına dakikada 60 yazma
"This token reached its daily write limit. Try again tomorrow." rate_limited Belirteç başına günde 2.000 yazma
"This token reached its hourly publish limit. Try again later." rate_limited Belirteç başına saatte 10 yayınlama
"Too many uploads from this token. Wait and retry." rate_limited Dakikada 30 yükleme
"This token reached its daily upload volume. Try again tomorrow." rate_limited Belirteç başına günde 500 MB
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Olağandışı etkinlik: yazma işlemleri 10 dakika duraklatılır
"Too many requests. Wait and retry." rate_limited Geçerli bir belirteç olmadan IP adresi başına dakikada 60 istek

Ücretli başlatmalar ayrıca token başına saatte 20 ve çalışma alanı başına günde 100 ile sınırlandırılmıştır. Her 429 bir Retry-After başlığına sahiptir; o kadar süre bekleyin.

İçerik ve yeniden denemeler

İleti Kod Çözüm
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict Ajan sayfayı tekrar okur ve değişikliğini yeniden uygular.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Yeni bir istek için yeni bir Idempotency-Key kullanın.
— idempotency_in_progress Bu anahtarla yapılan ilk istek hala çalışıyor. Bekleyin, ardından aynı anahtarla tekrar deneyin.

Tokenlar ve sayfa

Durum Neden Çözüm
Yeni token devre dışı "Your workspace has reached its limit of 50 active tokens. Revoke one first." Kullanmadığınız bir tokenı iptal edin.
Gizli anahtarı yeniden oluştur seçeneği yok Tokenı yalnızca oluşturan kişi yeniden oluşturabilir ve bu işlem yalnızca bir kez yapılabilir. "Only the person who created this token can regenerate it. You can revoke it." Daha yeni olan tokenı yeniden oluşturun veya yeni bir tane oluşturun.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Gizli anahtar daha önce yeniden oluşturulmuş. Yedek tokenı kullanın.
Bir iş arkadaşınızın tokenını göremiyorsunuz Sadece sahipler ve yöneticiler her tokenı görür. Bir sahip veya yöneticiden isteyin.
Bir isteği onaylayamıyorsunuz: "An owner or admin decides" Harcamaları sadece sahipler ve yöneticiler onaylar. Bir sahip veya yöneticiden isteyin.
"Only owners and admins manage webhooks" Rolünüz webhook'ları yönetemez. Bir sahip veya yöneticiden isteyin.

Claude veya ChatGPT'yi bağlama

Ekranda Çözüm
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Uygulamadaki bağlayıcıyı kaldırın ve tekrar ekleyin.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Eğer bu durum tekrarlanırsa bağlanmayın.
"Choose a workspace you are a member of." Çalışma alanlarınızdan birini seçin.
"Revoked: token reuse detected" (bağlı bir uygulamada) Uygulamanın oturum açma bilgisi yeniden kullanıldı, bu yüzden Clevera bunu iptal etti. Uygulamayı tekrar bağlayın.

Hala takıldınız mı

Hata mesajındaki request_id, tokenın adı (asla tokenın kendisi değil) ve çağrının yapıldığı zaman ile destek ekibiyle iletişime geçin.

API tokenlarını yönetmeBir token neden çalışmayı durdurur.Ajan izinleriBir çağrının hangi izne ihtiyacı var.Ajan harcamalarını ve onaylarını kontrol etmeLimitler, kotalar ve onaylar.REST API'yi kullanmaHata formatı ve hız sınırları.