Sorun giderme
Gördüğünüz mesajı ya da fark ettiğiniz davranışı bulun ve çözümü uygulayın. Mesajlar Peki panelinin, web sitesi sohbetinin, Telegram'ın ya da API'nin gösterdiği şekliyle alıntılanmıştır: Türkçe karşılığı olan arayüz mesajları Türkçe, yalnızca API'den İngilizce dönen mesajlar İngilizce verilmiştir. Bir API çağrısı hata döndürdüğünde HTTP durum kodu da yazılıdır.
API hataları nasıl görünür
API hataları statusCode ve message içeren JSON olarak döner. Kredi hataları ayrıca bir code (credits_exhausted ya da plan_required), dosya hataları da file_size gibi bir dosya code'u taşır. Doğrulama hataları (400) alanı belirten issues ya da errors ekler. message'ı okuyun: genellikle neyi değiştirmeniz gerektiğini tam olarak söyler.
Giriş
| Belirti | Neden | Çözüm |
|---|---|---|
| "Bu bağlantı geçersiz ya da süresi dolmuş." | Giriş bağlantısı zaten kullanılmış ya da 15 dakikadan fazla geçmiş. (API: 401 "Sign-in link is invalid or expired") | Girişe dön'e tıklayıp yeni bir bağlantı isteyin. Mümkünse aynı tarayıcıda açın. |
"Too many sign-in links requested, try again later" (429) | Bu e-posta için saatte 5'ten, ağınızdan saatte 20'den fazla bağlantı istendi. | Saatin dolmasını bekleyin ya da Google ile giriş yapın. |
| Giriş e-postası gelmiyor | Adreste yazım hatası, spam filtresi ya da şirket e-posta filtresi. | Spam klasörüne bakın, adresi düzeltmek için Başka bir e-posta kullan'ı kullanın ya da Google ile giriş yapın. |
"Email sign-in is not available yet. Continue with Google." (503) | E-postayla giriş kapalı. | Google düğmesini kullanın. |
"Use the email sign-in link for this address" (409) | Google bu e-posta adresinin kendisine ait olduğunu doğrulayamadı. | E-posta bağlantısıyla giriş yapın. |
"This email is linked to a different Google account" (409) | Peki hesabınız aynı e-postaya sahip başka bir Google hesabına bağlı. | İlk Google hesabıyla ya da e-posta bağlantısıyla giriş yapın. |
| Peki paneli yerine "Teşekkürler" sayfası görünüyor | Erken erişim: bekleme listesindesiniz. | E-postamızı bekleyin, sonra aynı hesapla giriş yapın. Beklememek için bir ekip arkadaşınızdan sizi davet etmesini isteyin. |
| Davet edildiniz ama çalışma alanını görmüyorsunuz | Davet edilenden farklı bir e-postayla giriş yaptınız. | Çıkış yapıp davet edilen adresle giriş yapın ya da bir yöneticiden kullandığınız e-postayı davet etmesini isteyin. |
| Beklenmedik şekilde oturumunuz kapandı | Oturumunuz 30 gün kullanılmayınca sona erdi ya da bu tarayıcıda çıkış yaptınız. | Yeniden giriş yapın. |
Roller ve erişim
| Belirti | Neden | Çözüm |
|---|---|---|
| "Yalnızca okuma — bu agent'ı düzenleyiciler değiştirebilir" | Rolünüz İzleyici ya da Operatör. | Bir yöneticiden Ayarlar → Üyeler altında rolünüzü değiştirmesini isteyin. |
| "Çalışma alanı ayarlarını yalnızca yöneticiler değiştirebilir." | Çalışma alanı ayarları Yönetici ya da Sahip gerektirir. | Bir yöneticiye ya da sahibe başvurun. |
"Requires editor role" ya da "Requires admin role" (403) | Rolünüz ya da API anahtarınızın erişimi, işlemin gerektirdiğinin altında. | Doğru role sahip bir üyeyle ya da Okuma ve yazma erişimli bir API anahtarıyla deneyin. |
"Not a member of this workspace" (403) | Çıkarıldınız ya da uygulama üyesi olmadığınız bir çalışma alanını gösteriyor. | Peki panelini yeniden yükleyin ve Değiştir ile bir çalışma alanı seçin. Gerekirse bir yöneticiden sizi yeniden davet etmesini isteyin. |
| "Your role no longer allows this" | Siz çalışırken rolünüz değişti. | Yeniden yükleyin. Eski rol gerekiyorsa bir yöneticiye başvurun. |
| "Only owners can add owners", "Only owners can change owners", "Only owners can remove owners" | Sahip değişiklikleri bir sahip gerektirir. | Bir sahibe başvurun. |
| "A workspace needs at least one owner" | Son sahibi çıkarmaya ya da rolünü düşürmeye çalıştınız. | Önce başka birini sahip yapın. |
| "Already a member or invited" | Bu e-posta çalışma alanının üye listesinde zaten var. | Yeniden davet etmek yerine rolünü değiştirin. |
Kredi ve planlar
| Belirti | Neden | Çözüm |
|---|---|---|
"Krediniz bitti." (402, code: credits_exhausted) | Çalışma alanının bakiyesi 0 ya da altında. Copilot, testler, otomasyonlar ve yeni Knowledge durur. | Ayarlar → Plan ve kredi'yi açın ve kredi eklemek için bize ulaşın. Kurduğunuz hiçbir şey kaybolmaz. |
"Yayınlamak için paket gerekiyor." (402, code: plan_required) | Çalışma alanı ücretsiz planda. Yayınla düğmesinde kilit görünür. | Paketler yakında. Hemen yayına almak için Ayarlar → Plan ve kredi üzerinden bize ulaşın. |
| Copilot kurulumun ortasında duruyor | Tur kalan krediyi bitirecekti, bu yüzden bir sonraki model çağrısından önce durdu. | Kredi ekleyin, sonra Devam et'e tıklayın. |
| "Paused: the workspace is out of credits. Add credits in Settings → Plan & credits, then resume." | Bir automation kredi bulamadı. | Kredi ekleyin, sonra automation'ı yeniden başlatın. |
| Kenar çubuğundaki kredi satırı düşük görünüyor | Bakiye 50 kredinin altında. | Önceden plan yapın: sıfıra inmeden bize ulaşın. |
Kurma ve yayınlama
| Belirti | Neden | Çözüm |
|---|---|---|
| "Taslağın kaydedilmesi için her blokta başlık ve metin olmalı." | Bir prompt bloğu boş ya da başlıksız. | Eksik bloğu doldurun ya da silin. |
| "Test etmeden önce eksik blokları tamamlayın." | Aynı durum, Test panelinde. | Aynı çözüm. |
"An agent needs at least one instruction block" (400) | Son bloğu silmeye çalıştınız. | En az bir blok bırakın. |
| "Taslak değişti (Copilot ya da bir ekip arkadaşı); yeniden yüklendi." | Siz düzenlerken başka biri ya da Copilot taslağı kaydetti. | Yeniden yüklenen taslağı kontrol edin, gerekirse değişikliğinizi tekrar yapın. |
"The draft changed while editing; try again" (409) | İki kayıt aynı anda oldu. | Tekrar deneyin. |
"Draft was already published" ya da "Agent changed during publish" (409) | Biri aynı anda yayınladı ya da agent'ı değiştirdi. | Instructions'ı yeniden yükleyin; hâlâ değişiklik varsa tekrar yayınlayın. |
| "Ad henüz yayınlanmadı: bu ajandan önce onu yayınlayın." | Bir ekip üyesi agent hiç yayınlanmamış. | Önce o agent'ı, sonra bunu yayınlayın. |
| "Bu ajan silindi: yayınlamadan önce kaldırın." | Bir ekip üyesi agent artık yok. | Instructions → Ekip altından kaldırın. |
| "Yayınlamadan önce neyde iyi olduğunu yazın." | Bir ekip üyesinin açıklaması yok. | O üye için Neyde iyi alanını doldurun. |
| "Bir ajan kendi ekibinde olamaz." | Agent'ı kendi ekibine eklediniz. | Başka bir agent seçin. |
| Müşteriler hâlâ eski davranışı görüyor | Değişiklikleriniz taslakta. | Yayınla'ya tıklayın. Yayınlamadan uygulanan tek şeyler kanal ayarları, Knowledge ve değişkenlerdir. |
"This agent has no published version yet" ya da "Publish the agent first" (409) | Bir şey canlı sürüme ihtiyaç duyuyor, örneğin bir automation ya da gerçek bir çalışma. | Agent'ı yayınlayın. |
| "Real runs use the published agent; dry-run the draft" | Taslağa karşı gerçek bir çalışma denediniz. | Taslağı denemek için deneme çalışması kullanın ya da önce yayınlayın. |
Test
| Belirti | Neden | Çözüm |
|---|---|---|
| "Agent yanıt veremedi. Modeli kontrol edip tekrar deneyin." | Model hata verdi ve yedek yanıt yok. | Instructions → Model'i kontrol edin. Bir yedek model ve bir Yedek yanıt ekleyin. |
| "Yedek yanıt — model yanıt veremedi." | İki model de hata verdi ya da zaman aşımına uğradı; yedek yanıt gönderildi. | Tekrar deneyin. Tekrarlarsa başka bir birincil model seçin ya da agent'ın cevap başına daha az tool çağırmasını sağlayın. |
"Only editors can test" (403) | Test etmek Düzenleyici rolü gerektirir. | Bir yöneticiden Düzenleyici rolü isteyin. |
| Test cevabı "müşterinin vip etiketi var" gibi bir koşulu yok sayıyor | Test müşterisinde bu etiket yok. | Etiketi Test panelinde ayarlayın. Gerçek müşteriler etiketlerini Inbox'ta alır. |
| Çalışma saatlerine bağlı bir blok hiç uygulanmıyor | "Çalışma saatleri henüz ayarlanmadı, bu blok hiç gönderilmez." | Saatleri Ayarlar → Çalışma saatleri altında ayarlayın. |
Copilot
| Belirti | Neden | Çözüm |
|---|---|---|
| "Copilot bu sohbette hâlâ çalışıyor. Bitmesini bekleyin ya da Durdur’a basın." | Bir tur hâlâ çalışıyor. | Bekleyin ya da Durdur'a tıklayın, sonra mesajınızı gönderin. |
| "Kart az önce yanıtlandı, bu yüzden mesajınız gönderilmedi. Copilot bitince yeniden gönderin." | Bir kartı yanıtladınız ve aynı anda mesaj gönderdiniz. | Copilot bitince mesajı yeniden gönderin. |
| "Önce karttaki soruyu yanıtla (ya da Durdur'a bas), sonra dosyaları gönder." | Copilot bir kartı bekliyor. | Kartı yanıtlayın ya da Durdur'a tıklayın. |
| "Copilot bir hatayla durdu." | Bir model ya da araç hatası turu sonlandırdı. | Devam et'e tıklayın. Tekrarlarsa Copilot modelini değiştirin. |
| "Tool call limit (40) reached for this turn" | İstek tek turda 40'tan fazla adım gerektirdi. | Devam et'e tıklayın ya da isteği daha küçük parçalara bölün. |
| "The turn took too long and was stopped" | Bir tur 20 dakikayla sınırlıdır. | Devam et'e tıklayın. |
| "The Copilot stopped unexpectedly; send your message again" | Tur kesildi. | Mesajınızı yeniden gönderin. |
| "The person behind this chat is no longer a member of this workspace" | Bu Copilot sohbetini başlatan üye çıkarıldı. | Mevcut bir düzenleyici kendi oturumunda devam eder. |
| "Mesajınızdaki bir anahtar (····1234) çıkarıldı…" | Anahtara benzeyen bir şey yapıştırdınız. Peki onu model görmeden çıkardı. | Mesaj anahtarın kaydedildiğini söylüyorsa işlem tamam. Değilse anahtar kartını kullanın, anahtarın tek sitesini belirtin ya da bir düzenleyiciye başvurun. |
| "This turn changed nothing; there is nothing to undo" ya da "This turn has not ended yet" | Geri alma yalnızca bitmiş ve bir şey değiştirmiş turlar içindir. | Turun bitmesini bekleyin ya da başka bir turu geri alın. |
| "Bu turdan sonra alanlar değişti…" ve Yine de geri al | Siz ya da bir ekip arkadaşınız bu turdan sonra aynı şeyleri değiştirdi. | Listeyi okuyun. Yine de geri al sonraki değişiklikleri de kaybettirir. |
| "Tur geri alındı. Yayındaki agent'lar kullandığı için tutulanlar: …" | Bazı değişiklikleri yayındaki sürüm kullandığı için geri alma onları tuttu. | Hâlâ kaldırmak istiyorsanız bu parçaları elle değiştirip yayınlayın. |
"Undo needs the editor role" ya da "Saving a key needs the editor role" (403) | Rolünüz Düzenleyicinin altında. | Bir yöneticiden Düzenleyici rolü isteyin. |
| "This card names no section; ask the Copilot again" ya da "This key card has no valid sites; ask the Copilot again" | Kart eksik. | Copilot'tan kartı yeniden göstermesini isteyin. |
| "Choose a model from the Copilot's list" | Seçilen model listede yok. | Mesaj kutusunun üstündeki model seçiciden bir model seçin. |
Tool'lar ve anahtarlar
| Belirti | Neden | Çözüm |
|---|---|---|
| "This API key may only be sent to site" | Tool'un URL'si, anahtarın izin verilmediği bir sitede. | Tool'un URL'sini düzeltin ya da siteyi Ayarlar → Gizli anahtarlar altında anahtara ekleyin. |
| "This API key has no allowed sites yet: an admin can set them in Settings → Secrets" | Anahtarın site listesi yok. | Bir yönetici siteyi Ayarlar → Gizli anahtarlar altında ekler. |
| "This API key is not assigned to an agent yet…" | Anahtar, anahtarlar agent'lara bağlanmadan önce kaydedilmiş; Atanmamış altında duruyor. | Bir yönetici Ayarlar → Gizli anahtarlar altında Ata…'yı kullanır. |
| "This API key belongs to another agent" | Her anahtar tek bir agent'a aittir. | Anahtarı bu agent için yeniden kaydedin. |
| "The API key for this tool was deleted" | Gizli anahtar kaldırıldı. | Tool için başka bir anahtar seçin ya da yenisini ekleyin. |
| "This key is a webhook signing key…" | İmzalama anahtarı yalnızca gelen imzaları kontrol eder; hiçbir yere gönderilmez. | Tool için normal bir anahtar kullanın. |
"A key with this name already exists" (409) | Anahtar adları benzersizdir. | Başka bir ad seçin ya da mevcut anahtarı güncelleyin. |
"A key is 4 to 4000 characters" (400) | Değer çok kısa ya da çok uzun. | Anahtarın tamamını yapıştırın. |
Tool HTTP 401 ya da HTTP 403 döndürüyor | API anahtarı reddetti. | Anahtarı, kimlik doğrulama türünü (Bearer ya da header adı) ve izinlerini API sağlayıcısında kontrol edin. |
Tool HTTP 404 döndürüyor | Yanlış URL ya da girdi. | Tool düzenleyicide URL'yi ve girdileri kontrol edin; gerçek bir girdiyle deneyin. |
localhost'u ya da özel bir IP'yi çağıran tool başarısız oluyor | Özel ağ adresleri engellidir. | API'niz için herkese açık bir adres kullanın. |
| Tool'un cevabı kesik görünüyor | Yanıtlar tool'un yanıt boyutunda (varsayılan 4.000 karakter) kesilir. | Boyutu artırın (en fazla 20.000) ya da daha az yanıt alanı saklayın. |
Fonksiyonlar
| Belirti | Neden | Çözüm |
|---|---|---|
| "host is not in this function's hosts (…): add it to the function's hosts" | Fonksiyon listesinde olmayan bir siteye ulaşmaya çalıştı. | Siteyi Fonksiyonun İzin verilen siteler listesine ekleyin. |
| "The secret name is not in this function's secrets" | Kod, Fonksiyonun listelemediği bir anahtarın adını veriyor. | Anahtarı Fonksiyonun anahtarlarına ekleyin. |
| "The secret name may only be sent to …" ya da "…is only sent over https" | Anahtara bu URL için izin verilmemiş ya da URL https değil. | İzin verilen bir https URL'si kullanın ya da siteyi anahtara ekleyin. |
| "Timed out after 5000 ms" | Çalışma zaman aşımından uzun sürdü. | Zaman aşımını artırın (en fazla 10 saniye) ya da daha az ya da daha hızlı çağrı yapın. |
| "Memory limit exceeded…" ya da "CPU limit exceeded…" | Çalışma fazla bellek ya da CPU kullandı. | Aynı anda daha az veri işleyin; yalnızca gereken alanları tutun. |
| "Result is … KB; the limit is 16 KB" | Dönen değer çok büyük. | Yalnızca agent'ın ihtiyacı olanı döndürün. |
| "Output exceeded 64 KB; the function was stopped" | Çok fazla yazdırılan çıktı. | Daha az log yazın. |
| "A function run may make at most 20 requests" | Tek çalışmada çok fazla web isteği. | İstekleri birleştirin ya da işi bölün. |
| "The table key can't be read by the agent (Records → Table settings → Agent access)" | ctx.records okuma erişimi olmayan bir tabloyu okumaya çalıştı. | Verisi için güvenliyse o tablonun Ajan erişimi ayarında okumayı açın. |
| "The function runner is busy…" ya da "…is unreachable" | Fonksiyonlar geçici olarak kullanılamıyor. | Kısa süre sonra tekrar deneyin. |
| "A Function named name already exists…" | Adlar agent içinde benzersizdir. | Başka bir ad seçin ya da mevcut olanı değiştirin. |
| Agent için bir çalışma reddediliyor | Agent dakikada 60 çalışmaya, günde 3.600 saniyeye ya da aynı anda 4 çalışmaya ulaştı. | Automation zamanlamalarını yayın ya da çalışmaları kısaltın. |
Knowledge
| Belirti | Neden | Çözüm |
|---|---|---|
| "Bu kaynak okunamadı." | Metin içermeyen taranmış bir PDF, boş ya da yalnızca script içeren bir sayfa ya da okuyucuları engelleyen bir site. | Seçilebilir metni olan bir PDF yükleyin, metni yapıştırın ya da başka bir sayfa ekleyin. |
| "Use a PDF, TXT, Markdown or CSV file" | DOCX gibi desteklenmeyen bir dosya türü. | PDF olarak kaydedin ya da metni yapıştırın. |
| Yükleme boyut nedeniyle reddediliyor | Dosyalar 10 MB ile sınırlıdır. | Dosyayı bölün. |
| Agent bir kaynağı kullanmıyor | Soru içerikten çok uzak ya da kaynak okunamadı. | Kaynağın durumunu kontrol edin. O soruyu sade bir dille cevaplayan bir kaynak ekleyin. |
| Kaynak eklemek "Krediniz bitti." ile başarısız oluyor | Kaynakları okumak kredi harcar. | Kredi ekleyin. |
Web sitesi sohbeti
| Belirti | Neden | Çözüm |
|---|---|---|
| Sohbet sitenizde görünmüyor | Widget kapalı, kod eksik ya da siteniz izinli değil. | Sohbeti web sitenizde göster'i açın, Kaydet'e tıklayın, Yerleştirme kodu'nu </body> etiketinden önce yapıştırın ve sitenizin tam adresini İzin verilen web siteleri'ne ekleyin. |
| "Bu sohbet şu anda kullanılamıyor." | Widget kapalı ya da koddaki anahtar yanlış. (API: 404 "This chat is not available") | Widget'ı açın ya da Yerleştirme kodu'nu yeniden kopyalayın. |
Tarayıcı konsolu 403 "This website may not use this chat" gösteriyor | Sayfanın adresi İzin verilen web siteleri listesinde değil. | https:// ve doğru alt alan adıyla birebir ekleyin; ikisini de kullanıyorsanız örneğin hem https://magaza.example.com hem https://www.magaza.example.com. |
| "This assistant is not available yet" | Agent hiç yayınlanmamış. | Agent'ı yayınlayın. |
| "You are sending messages too fast." | Tek bir ziyaretçiden dakikada 20'den fazla mesaj. | Biraz bekleyin. |
| "This chat is very busy right now. Please try again in a minute." | Bu widget'ta dakikada 120'den fazla mesaj. | Bir dakika bekleyin. |
| "Too many messages from this network…" ya da "Too many new chats from this network…" | Tek bir ağın arkasında çok sayıda ziyaretçi (bir ofis, bir test betiği). | Saatin dolmasını bekleyin. |
| "This assistant is very busy right now. Please try again later." | Çalışma alanı günlük 2.000 canlı cevaba ulaştı. | Cevaplar UTC gece yarısından sonra devam eder. Daha fazlası gerekiyorsa bize ulaşın. |
| "Gönderilemedi. Lütfen tekrar deneyin." | Ağ ya da sunucu hatası. | Tekrar deneyin. |
| Dene ile yapılan konuşmalar Analiz'de görünüyor | Bunlar yayındaki agent'la "Widget tester" olarak yapılan gerçek konuşmalardır. | Beklenen durum. Sayılmayan konuşmalar için Test panelini kullanın. |
Telegram
| Belirti | Neden | Çözüm |
|---|---|---|
| "That does not look like a bot token. Copy it again from @BotFather." | Yapıştırılan metin bir bot token'ı değil. | Token'ın tamamını @BotFather'dan kopyalayın. |
| "Telegram didn't accept this token… Copy it again from @BotFather." | Token yanlış ya da iptal edilmiş. | Güncel token'ı @BotFather'dan alın. |
| "Bu bot agent ajanına bağlı. Buraya taşınsın mı?" | Bot başka bir agent'a ait. | Buraya taşı'ya tıklayın ya da başka bir bot kullanın. |
| "Bu bot başka bir yerde de kullanılıyor (başka bir sunucu ya da uygulama)…" | Başka bir sistem aynı botun mesajlarını okuyor. | Diğer sistemi durdurun. Sizin değilse BotFather'da token'ı yenileyin (/revoke) ve yenisini bağlayın. |
| "This bot changed hands just now; try again" ya da "This bot was just connected to another agent; try again" | İki bağlantı aynı anda oldu. | Tekrar deneyin. |
| "Connect a bot first" ya da "Connect Telegram first" | İşlem bağlı bir bot gerektiriyor. | Botu Channels altında bağlayın. |
| "Not a chat of this agent's bot: … Send the bot a message from that chat first" | Bir automation, botun görmediği bir Telegram sohbetini belirtiyor. | O sohbetten bota /start gönderin, sonra yeniden kaydedin. |
| Bot "Bu asistan henüz kullanılamıyor." diye cevap veriyor | Agent yayınlanmamış. | Agent'ı yayınlayın. |
| Bot "Şu anda çok yoğunuz. Lütfen biraz sonra tekrar yazın." diye cevap veriyor | Günlük canlı cevap limitine ulaşıldı. | Cevaplar UTC gece yarısından sonra devam eder. |
| Bot mesajları yok sayıyor | Bu bota gelen mesajları yanıtla kapalı ya da müşteri bir dakikada 20'den fazla mesaj gönderdi. | Channels altında açın; müşteriden biraz beklemesini isteyin. |
| "Bu tür dosyaları henüz açamıyorum…" | Sesli mesajlar, çıkartmalar ve benzerleri desteklenmez. | Fotoğraf, PDF ya da metin dosyası gönderin veya mesajı yazın. |
| "Bu dosya çok büyük: dosyalar en fazla 10 MB olabilir." | Dosya 10 MB'tan büyük. | Daha küçük bir dosya gönderin. |
| "Bu konuşmada zaten 30 dosya var. Yeni bir konuşma başlatmak için /new yazın." | Konuşma başına 30 dosya sınırı. | /new gönderin. |
| "Bu dosyayı indiremedim. Lütfen tekrar gönderin." | Telegram dosyayı üç kez veremedi. | Yeniden gönderin. |
Inbox
| Belirti | Neden | Çözüm |
|---|---|---|
"Kendiniz yanıtlamak için devralın" / "Take over the conversation to reply" (409) | Yanıtlamadan önce devralmanız gerekir. | Devral'a tıklayın. |
"Take over the conversation to send files" (409) | Ekler için de aynısı. | Devral'a tıklayın. |
"Ad has already taken over" (409) | Bir ekip arkadaşı önce devraldı. | Onunla anlaşın ya da geri vermesini bekleyin. |
"Nobody has taken over this conversation" (409) | Kimsenin devralmadığı bir konuşmayı geri vermeye çalıştınız. | Yapılacak bir şey yok. |
| Devredilen bir konuşma Sizi bekliyor altında değil | Bir ekip arkadaşı devraldı (Devralınan'a bakın) ya da çözüldü. | Devralınan ve Tümü'ye bakın. |
Dosyalar
Bu kodlar her kanaldan ve API'den döner.
| Kod | Mesaj | Çözüm |
|---|---|---|
file_type | "Fotoğraf (JPEG, PNG, WebP, GIF), PDF ya da metin dosyası (TXT, MD, CSV) gönderebilirsiniz." | Desteklenen bir tür kullanın. Tür dosyanın kendisinden kontrol edilir; adını değiştirmek işe yaramaz. SVG ve HTML asla kabul edilmez. |
file_size | "Dosyalar en fazla 10 MB olabilir." | Daha küçük bir dosya gönderin. |
file_count | "Bir mesajda en fazla 5 dosya." | Kalanları başka bir mesajda gönderin. |
conversation_full | "Bu konuşma 30 dosya sınırına ulaştı. Daha fazlası için yeni bir konuşma başlatın." | Yeni bir konuşma başlatın. |
file_rate | "Aynı anda çok fazla dosya. Lütfen daha sonra tekrar deneyin." | Bekleyip tekrar deneyin. |
file_taken | "Bu dosya zaten gönderildi. Lütfen yeniden ekleyin." | Dosyayı yeniden ekleyin. |
file_missing | "Bu dosyaya artık ulaşılamıyor. Lütfen yeniden ekleyin." | Yeniden ekleyin. 24 saat içinde gönderilmeyen yüklemeler silinir. |
| — | Agent fotoğrafı göremediğini söylüyor | Model görsel okumuyor. Birincil model olarak Görsel okur işaretli bir model seçin. |
| — | Agent bir PDF'i okuyamıyor | PDF metin katmanı olmayan bir tarama. Metinli bir PDF ya da fotoğraf isteyin. |
Records
| Belirti | Neden | Çözüm |
|---|---|---|
| "A record holds at most 32 KB; shorten long fields" | Kayıt çok büyük. | Uzun metin alanlarını kısaltın. |
| "An agent has at most 20 tables" | Tablo limiti. | Tabloları birleştirin ya da kullanılmayanları kaldırın. |
| "Bu başlık alanı: silmek için önce başka bir başlık seçin." | Her tablonun bir başlık alanı olmalı. | Önce başka bir başlık alanı seçin. |
| "The CSV file is empty", "A CSV file can have at most 5000 rows", "A CSV file can be at most 2 MB" | İçe aktarma limitleri. | Dosyayı bölün. |
| "Not saved: a matching record exists now; this request was to add a new one" | Aynı eşleştirme değerleriyle başka bir kayıt önce yapıldı. | Mevcut kaydı açıp güncelleyin. |
| Agent kayıtlara bakamıyor | Tablonun Ajan erişimi okumaya izin vermiyor. Kişi tablolarında bu bilerek kapalıdır. | Okumayı yalnızca kendi ürünlerinizin tablolarında açın, kişi tablolarında asla. |
| Elle düzenlediğiniz bir alan doldurmadan sonra değişmedi | Konuşmadan doldurma, elle değiştirilen bir alanın üzerine asla yazmaz. | Alanı kendiniz düzenleyin. |
Onaylar
| Belirti | Neden | Çözüm |
|---|---|---|
| "Süresi doldu: 24 saat içinde kimse karar vermedi." | İsteklerin süresi 24 saat sonra dolar. | Müşteriye yeniden sorun ya da yeni istekler için Telegram bildirimlerini açın. |
| "Bu işlem artık agent'ta yok; onaylamak başarısız olur. Bunun yerine reddedin." | Tool ya da Fonksiyon istekten sonra kaldırıldı. | Reddet'e tıklayın. |
| "İşlem changed since this was requested: review the values and approve again" | İşlem istekten sonra değişti. | Değerleri gözden geçirip yeniden onaylayın. |
"Your role does not allow approving this" (403) | Rolünüz işlemin gerektirdiğinin altında. | Bir düzenleyiciye ya da yöneticiye başvurun. |
| "… onayladı · …, ama başarısız oldu" | İşlem çalıştı ve hedef sistem hata döndürdü. | Sonucu açın, nedeni (anahtar, URL, değerler) düzeltin ve müşteriden tekrar denemesini isteyin. |
Automations
| Belirti | Neden | Çözüm |
|---|---|---|
| Günlük bir limitle "Otomatik duraklatıldı: …" | Günlük çalışma ya da Günlük model maliyeti limitine ulaştı. | Limiti artır'a tıklayın ya da daha seyrek çalıştırın, sonra yeniden başlatın. |
| "Paused after 5 failed runs in a row. Last error: …" | Art arda beş başarısızlık. | Çalışmalar sekmesinde son hatayı okuyun, düzeltin, deneme çalışması yapın, sonra yeniden başlatın. |
| Kullandığı bir tool yazmaya başladığı için duraklatıldı | Kullandığı bir tool artık veri değiştiriyor; yazmaları yeniden onay gerektiriyor. | Yazmaları gözden geçirip onaylayın, sonra yeniden başlatın. |
| "Atlandı — önceki çalışma sürüyor" | Önceki çalışma bitmemişti. | Çalışmayı kısaltın ya da daha seyrek zamanlayın. |
| "Bekletildi — sessiz saatler" | Sessiz saatlerde mesajlar bekletilir. | Beklenen durum. Gerekirse Sessiz saatler'i değiştirin. |
"A run of this automation is still in progress; wait for it to finish" (409) | Bir çalışma sürerken Bir kez çalıştır'ı başlattınız. | Bekleyip tekrar deneyin. |
"Saved, but its schedule could not be updated right now; it is repaired automatically within 10 minutes" (503) | Zamanlama o anda güncellenemedi. | Yapılacak bir şey yok; 10 dakika içinde kendiliğinden düzelir. |
"The automation changed while you were saving (it may have been paused automatically); reload and try again" (409) | Siz kaydederken değişti. | Yeniden yükleyip tekrar kaydedin. |
| "Önce agent'ı yayınlayın: açık bir automation yayındaki sürümü çalıştırır." | Agent yayınlanmamış. | Agent'ı yayınlayın. |
"Ne needs the editor role (the role that may publish this agent); you are …" (403) | Automation oluşturmak ve yazmalarını onaylamak yayınlama yetkisi olan rolü gerektirir. | Bir düzenleyiciye başvurun. |
| "Not sent: sending took longer than 30 s" | Telegram mesajı zamanında kabul etmedi. | Çalışmaya kaydedilir; bir sonraki çalışma yeniden dener. |
| "Telegram is not connected to this agent" | Teslim, agent'ın botunu gerektirir. | Telegram'ı Channels altında bağlayın. |
"Only webhook automations have a URL" (400) | Zamanlanmış ya da olay tabanlı bir automation için URL istediniz. | Tetikleyicisini webhook yapın. |
"The sample payload is larger than 256 KB" (400) | Bir kez çalıştır örneği çok büyük. | Daha küçük bir örnek kullanın. |
Diğer sistemlerden gelen webhook çağrıları
| Yanıt | Neden | Çözüm |
|---|---|---|
404 {"error":"Not found"} | URL yanlış, yenilenmiş ya da iptal edilmiş veya automation duraklatılmış ya da kapalı. | Güncel URL'yi automation'dan kopyalayın. URL'yi yenile eski URL'yi hemen durdurur. |
401 "Invalid signature" | İmza kontrolü başarısız oldu. | Gönderen sistemin imzalama anahtarını yeniden kaydedin; sağlayıcının (Stripe, Shopify, GitHub ya da HMAC-SHA256) eşleştiğinden emin olun. |
401 "Invalid signature" ve İstekler "The signing key name is missing" gösteriyor | İmzalama anahtarı silinmiş. | İmzalama anahtarını aynı adla yeniden kaydedin. |
413 "Payload too large" | Gövde 256 KB'tan büyük. | Daha az veri gönderin ya da yalnızca Fonksiyonun sorgulayabileceği bir id gönderin. |
429 "Too many requests" | Bu URL'ye dakikada 60'tan, bir IP'den dakikada 600'den fazla çağrı ya da bekleyen 100 çalışma. | Göndereni yavaşlatın; genellikle yeniden dener. |
200 {"duplicate":true} | Aynı teslim son 24 saat içinde zaten geldi; iki kez çalışmaz. | Beklenen durum: gönderenler yeniden dener, Peki her teslimi bir kez çalıştırır. |
503 {"error":"Try again shortly"} | Çalışma o anda kuyruğa alınamadı. | Gönderenin yeniden denemesi geçer; hiçbir şey kaybolmaz. |
202 {"accepted":true,"id":"..."} | Başarılı: çalışma kuyruğa alındı. | Sonuç için Çalışmalar sekmesine bakın. |
API
| Belirti | Neden | Çözüm |
|---|---|---|
401 "Sign in required" | Authorization: Bearer … header'ı yok. | API anahtarınızı Bearer token olarak gönderin. |
401 "Invalid API key" | Anahtar yanlış ya da iptal edilmiş. | Ayarlar → API anahtarları altında yeni bir anahtar oluşturun. |
403 "Requires editor role" | Yalnızca okuma anahtarı, mesaj göndermek gibi yazma işlemi denedi. | Okuma ve yazma erişimli bir anahtar kullanın. |
403 "Not available to API keys" | Bu uç nokta, üye ya da anahtar yönetimi gibi yalnızca giriş yapmış kişiler içindir. | İşlemi Peki panelinde yapın. |
403 "API key belongs to another workspace" | Başka bir çalışma alanı için x-workspace-id header'ı gönderdiniz. | Header'ı kaldırın; API anahtarı çalışma alanını zaten bilir. |
400 "Invalid body" ve issues | Bir alan eksik ya da geçersiz. | issues'u okuyun: her biri alanı ve sorunu belirtir. |
400 "Write a message or attach a file" | Mesaj boş. | text ya da attachments gönderin. |
409 "Only sessions started through the API take messages here" | Web sitesi sohbeti, Telegram ya da test konuşmasına gönderdiniz. | Sessions API ile bir oturum başlatıp ona gönderin. |
409 "This agent has no published version yet" | Agent yayında değil. | Agent'ı yayınlayın. |
404 "Session not found" ya da "Agent not found" | Yanlış id ya da başka bir çalışma alanına ait. | Id'yi kontrol edin. |
503 "Could not accept the message right now. Please try again." | Geçici bir sorun. | Kısa bir beklemeyle yeniden deneyin. |
Akışlı cevap {"type":"done","timedOut":true} ile bitiyor | Akış 120 saniye sonra kapanır. | Cevabı sonra oturumun mesajlarından okuyun. |
429 "This assistant is very busy right now. Please try again later." | Çalışma alanının günlük canlı cevap limiti. | UTC gece yarısından sonra yeniden deneyin. |
Kullanım raporları
| Belirti | Neden | Çözüm |
|---|---|---|
| "At most 92 days at a time" ya da "At most 366 days at a time" | Tarih aralığı çok uzun. | Daha kısa bir aralık seçin. |
"from must be on or before to" | Tarihler ters. | Yerlerini değiştirin. |
| Eski agent cevaplarında maliyet görünmüyor | "Müşteri cevaplarının maliyeti Ekim 2026'dan beri kaydediliyor; önceki cevaplarda maliyet görünmez." | Beklenen durum. |
Hâlâ çözülmedi mi?
Kesin sayılar için Limitler ve SSS sayfalarına bakın. Inbox'ta bir cevabın altındaki Neden? bağlantısı, cevabın hangi blokları, tool'ları, skill'leri ve Knowledge'ı kullandığını gösterir; şaşırtıcı cevapların çoğunu bu açıklar.