Sorun giderme

#Görevim çalışmıyor

Kart queued'da bekliyor, hiçbir şey olmuyor.

Sırayla kontrol edin.

1. Erişilebilir bir model var mı? Anahtar eklemediyseniz agent'lar Orbi'nin ortak havuzuyla çalışır. Arayüzde kalıcı bir bant görüyorsanız ne kendi anahtarınız ne ortak havuz erişilebilir demektir, o yüzden Ayarlar → API Anahtarları → Modeller ekranına bakın.
2. Anahtar gerçekten geçerli mi? Anahtar satırının menüsündeki Bağlantı testi'ni çalıştırın. Süresi dolmuş veya yetkisi kısıtlı bir anahtar, girilmiş görünür ama çalışmaz.
3. Krediniz bitti mi? Kredi tavanı dolduğunda yeni koşular başlamaz, o yüzden kalan krediyi Ayarlar → Plan'dan kontrol edin. Kendi anahtarınızı bağlamak krediyi çok daha yavaş tüketir.

Kart hiç queued'a geçmiyor.

Yürütmeyi tetikleyen tam olarak dört şey vardır. Kartı Queued'a taşımak, bir insan yorumunda @agent mention'ı, bir akış tetiklemesi ve bir gelen tetikleyiciye gelen HTTP POST. Kartı oluşturmak, düzenlemek veya bir koleksiyona yazmak yürütme başlatmaz.

#Görev Hata durumuna düştü

Kartı açın, hata sebebi drawer'ın üstünde kırmızı bir banner'da görünür. Aynı sebep yorum akışına da düşer, cycle özeti için İz sekmesine bakabilirsiniz. Ayrıntılı teşhis izi (exception stack trace) sunucuda tutulur ve arayüze taşınmaz, böylece sebep metni kullanıcıya okunabilir kalır.

Yaygın sebepler şunlardır.

Yorumda gördüğünüz	Anlamı
Bütçe tavanı aşıldı	Görev 10 cycle veya 30 agent çalıştırma sınırına vurdu. Tamamlanan adımlar korunur, requeue ile devam edin.
Model erişilemedi	API anahtarı geçersiz, kotası dolmuş veya sağlayıcı erişilemez durumda.
Araç hatası	Bir MCP sunucusu yanıt vermedi veya bir araç beklenmeyen girdi aldı.

Requeue görevi kaldığı yerden devam ettirir ve tamamlanmış checklist adımları tekrar yapılmaz.

Bir çalışma ortaya bir çıktı koyduysa ya da bir adımı tamamladıysa kart hata durumuna düşmez. İş Review'a gelir ve agent'ın not ettiği eksik (kullanamadığı bir araç ya da yarım kalan bir bölüm) cycle özetinde yazar. Hata durumu, o çalışmadan kullanılabilir hiçbir şey çıkmadığı anlamına gelir.

#Görev çalışırken kartı yeniden kuyruğa alırsam ne olur?

Yeni bir çalışma başlar ve kartın tek sahibi o olur. Geride kalan çalışma bir sonraki adımından önce bunu fark eder ve durur. Kartın durumuna, geçmişine ve hata mesajına yazmaz, yalnızca durduğunu bir yorumla belirtir. Yeni çalışma bu yorumu görür ve kaldığı yerden devam eder. O ana kadar harcanan kredi geri gelmez, bu yüzden takıldığını düşündüğünüz bir kartı hemen kuyruğa almayın. İz sekmesindeki adım listesi ilerliyorsa iş sürüyordur. Gerçekten duran bir çalışmayı Orbi kendisi fark edip kartı hata durumuna alır, sonrasında kuyruğa alabilirsiniz.

#Bütçe tavanına sürekli vuruyorsam

Bu genellikle görevin çok büyük olduğunun işaretidir. İki çözüm vardır.

• Görevi bölün. "10 rakibi analiz et" yerine iki görev açın, her biri beş rakip alsın.
• Orchestrator yerine doğrudan bir agent'a atayın. Planlama katmanı atlanır, cycle harcanmaz.

#Yüklediğim dosya pending durumunda kalıyor

Dosya yüklendikten sonra metin çıkarımı arka planda çalışır ve durum tamamlandıya geçer. pending'de takılı kalıyorsa üç ihtimal vardır.

• Dosya çok büyük olabilir. 500 sayfalık bir PDF veya çok sayfalı bir Excel dosyası zaman alır.
• Format desteklenmiyor olabilir. Desteklenen formatların listesi Dosyalar ve artifact'lar sayfasındadır.
• Taranmış PDF ise OCR adımı çalışır ve daha uzun sürer, ayrıca görüntü destekleyen bir model gerekir.

Durum no_text_layer gösteriyorsa dosyanın metin katmanı yoktur ve OCR da sonuç üretmemiştir. Belge büyük olasılıkla düşük çözünürlüklü bir taramadır.

#Agent dosyamı okumuyor ya da bulamıyor

• Mention adını kontrol edin. @file.<ad> mention'ı dosyanın adını kullanır, orijinal dosya adını değil. Adı Dosyalar sayfasından görebilir ve değiştirebilirsiniz.
• Dosya kapsamı doğru mu? Proje kapsamlı bir dosya, başka bir projedeki görevden görünmez.
• Dosya çöpte olabilir. Silinmiş dosya mention'la çözümlenmez.
• Dosyanın çok eski bir haline referans veriyorsanız içeriği temizlenmiş olabilir, çünkü geçmişte son 10 hal saklanır. Bu haller geçmiş listesinde işaretli görünür.

#Agent dosyamı güncellemiyor

Bu tasarım gereğidir, çünkü agent'lar sizin yüklediğiniz dosyaları güncelleyemez. Girdiler salt okunurdur ve agent sonucu yeni bir dosya olarak yazar. Böylece kaynağınız yerinde kalır.

Agent'ların yapamadığı diğer iki şey dosyayı yeniden adlandırmak ve kapsamını değiştirmektir. Bunlar sizin kararınızdır.

#Agent aynı veriyi tekrar yazıyor

Semantik duplicate önleme koleksiyona yazarken çalışır, ama agent force_write ile bilinçli olarak geçebilir. Kartın İz sekmesinden hangi araçların çağrıldığını görebilirsiniz.

Tekrar sürüyorsa sütunun kullanım amacını netleştirin (sütun başlığındaki kalem simgesi), çünkü agent oraya ne yazacağına karar verirken bu açıklamayı okur.

#Agent'ım geçen konuşmayı hatırlamıyor

Konuşmanın kendisi taşınmaz ve bu tasarım gereğidir, çünkü her koşu temiz başlar. Taşınan şey o konuşmadan damıtılan kalıcı derstir. Sohbette verdiğiniz kalıcı bir talimat hafıza notuna dönüşür ve sonraki koşuların başında agent'a hatırlatılır (Workspace hafızası). Yani "geçen sefer ne konuştuk" gelmez, "bundan sonra şöyle yap" gelir.

Kalıcı olması gereken bilgi dört yerden birine yazılır.

Yer	Ne için
Proje açıklaması	Her çalıştırmada geçerli kalıcı kurallar
Agent'ın görev tanımı	O agent'ın her zaman uyacağı davranış
Koleksiyon	Birikmesi ve sorgulanması gereken veri
Hafıza notu	Koşulardan öğrenilen kısa dersler ve tercihler

Ayrıntı: Hafıza ve bağlam.

#Zamanlanmış işim çalışmadı

• Çakışma nedeniyle atlanmış olabilir. Önceki çalışma hala sürerken yeni tetikleme gelirse atlanır. Log ekranından görebilirsiniz.
• Duraklatılmış olabilir. Akışlar sayfasında durumu kontrol edin.
• Saat dilimi kaymış olabilir. Cron, akışı kurarken seçtiğiniz zaman diliminde değerlendirilir.

Yeni bir akış kurarken Şimdi çalıştır düğmesiyle çıktısını hemen görün, cron'u beklemeyin.

#Agent yorumuma cevap vermedi

• Yorumu bir insan mı yazdı? Agent yorumları asla yeni bir koşu tetiklemez, çünkü sonsuz döngü koruması vardır. Tetikleme yalnızca insan yorumundan gelir.
• Mention doğru yazıldı mı? @agent.<ad> biçiminde olmalı ve agent adı tam yazılmalıdır.
• Her yorum en fazla bir kez işlenir, yani aynı yorumu düzenlemek yeniden çalıştırmaz.

#Davet ettim ama e-posta gitmedi

Davet oluşmuştur ve bekleyen davetler listesinde görürsünüz. Davet e-postası arka planda gönderilir ve geçici bir sunucu (SMTP) arızasında gönderim artan aralıklarla otomatik yeniden denenir. Beklemek istemezseniz modal davet linkini her zaman gösterir. Kopyalayıp kişiye kendiniz iletin, link aynı şekilde çalışır. Ayrıntı: Roller, davet ve oturum.

Aynısı kayıt için de geçerlidir. Doğrulama e-postası da aynı kuyruktan gönderilir ve gecikmiş olabilir, o yüzden tekrar kayıt olmayı denemeyin. Hesap durduğu için "bu e-posta zaten kayıtlı" hatası alırsınız. E-posta birkaç dakika içinde gelmezse spam klasörünü kontrol edin.

#Şifremi unuttum

Giriş ekranındaki "Şifreni mi unuttun?" bağlantısına tıklayın ve e-posta adresinizi girin. Gelen linkle yeni şifrenizi belirlersiniz. Link 1 saat geçerlidir, süresi dolduysa aynı yerden yenisini isteyin. Sıfırlama sonrası güvenlik gereği tüm cihazlardaki oturumlarınız kapanır ve yeni şifrenizle tekrar giriş yaparsınız. Google ya da GitHub ile açılmış (şifresiz) bir hesaba şifre eklemenin yolu da aynı akıştır. Ayrıntı: Roller, davet ve oturum.

#Sürekli giriş yapmam gerekiyor

Normalde oturumunuz haftalarca açık kalır. Uygulama arka planda sessizce tazeler ve giriş ekranını görmezsiniz. Günde birkaç kez giriş isteniyorsa Profil → Güvenlik → Aktif oturumlar listesine bakın.

• Listede tanımadığınız bir cihaz varsa şifrenizi değiştirin, çünkü şifre değişimi diğer tüm cihazları düşürür.
• Cihazlar birbirini düşürmez. Her cihaz kendi oturumunu ayrı taşır ve bir cihazdaki oturumun kapanması diğerlerine dokunmaz. Bütün cihazlarınız aynı anda düşüyorsa hesabın tamamını kapatan üç işlemden biri yapılmış demektir, yani şifre değiştirme, şifre sıfırlama ya da Profil → Güvenlik sekmesindeki Tüm oturumları kapat. Bunları siz yapmadıysanız şifrenizi değiştirin.

Ayrıntı: Roller, davet ve oturum.

#Bir şey göremiyorum ya da düğme yok

Rolünüzü kontrol edin. Viewer yalnızca okur. Proje yönetimi, üye daveti, workspace-geneli MCP ve koleksiyonu ekrana dönüştürme yalnızca Admin yetkisindedir. Ayrıntı: Roller, davet ve oturum.

#Agent eklediğim MCP aracını göremiyor

En yaygın sebep şudur. Bağlantıyı eklemek yetmez, agent'a erişim vermeniz gerekir.

• Orbi (Orchestrator) tüm workspace bağlantılarını otomatik kullanır. Orbi çalışıyor ama diğer agent'lar çalışmıyorsa sebep neredeyse kesinlikle budur.
• Agent'lar sayfasında agent'ın detayını açın, Çalışma sekmesine geçin, oradaki "Bağlantı erişimi" bölümünden ilgili bağlantıyı işaretleyin ve kaydedin.
• Bu bölümü göremiyorsanız agent'ın çalışma yeri "dışarıdan bağlanır"dır. Orada bu ayar yoktur ve olmaması doğrudur, çünkü o agent'ı Orbi çalıştırmaz, araçlarını kendi ortamınızdaki istemci taşır (Agent'lar).

Erişimi verdiyseniz sırayla şunlara bakın, çünkü sorun neredeyse her zaman bunlardan biridir.

Belirti	Sebep	Çözüm
Bağlantı "yetki bekliyor" diyor	OAuth tamamlanmamış	Ayarlar → MCP → Yetkilendir
Sohbette çalışıyor, görevde çalışmıyor	Bağlantı kişisel ve görevi başka biri (ya da bir agent) kuyruğa aldı	Ekip kullanacaksa workspace kapsamına alın
Akış koşusunda çalışmıyor	Kişisel bağlantı eklenirken "Zamanlanmış görevlerde de kullanılsın" işaretlenmemiş, ya da akışı başkası düzenlemiş	Bağlantıyı bu seçenek işaretli olarak ekleyin, akışı sahibi düzenlesin
Hiçbir aracı görünmüyor	Bağlantı başka bir workspace'te olabilir, çünkü MCP bağlantıları workspace'e aittir	Bağlantıyı kullanacağınız workspace'e ekleyin
Agent bir bağlantının aracını kullanamadığını söylüyor	Araç o agent'a verilmemiş ya da bağlantıda kapatılmış; agent sebebi yazar	Agent sayfasında bağlantının araçlarını ya da Ayarlar → Açılacak araçlar'ı kontrol edin
Araç listesi hiç gelmiyor	Sunucu erişilemez olabilir	Ayarlar → Entegrasyonlar'da "Araçları gör" düğmesine basın, liste geliyorsa sunucu sağlamdır
Araç çağrısı zaman aşımına uğruyor	Uzun süren üretim işi	Ayarlar → Araç çağrısı zaman aşımı'nı yükseltin
"Ürettim" diyor ama dosya yok	Görsel ya da video üretimi sürüyordu, sonuç agent yanıtını yazarken henüz hazır değildi	Birkaç saniye sonra tekrar sorun, hazır olan sonucu getirir

Bir bağlantının erişilememesi görevi durdurmaz, o araçlar sessizce atlanır.

#Avatarım görünmüyor

• Yükleme reddedildiyse sebep formatta olabilir, çünkü yalnızca PNG, JPG, WebP ve GIF kabul edilir. SVG bilinçli olarak reddedilir, çünkü betik taşıyabilen bir görsel biçimidir.
• Uzantısı değiştirilmiş dosya reddedilir, yani içerik gerçekten o formatta olmalıdır.
• 5 MB üstü dosyalar reddedilir.
• Yükleme başarılı ama görsel çıkmıyorsa görsel işleme servisi yapılandırılmamış olabilir. Bu durumda arayüz adınıza bağlı çizilmiş avatara düşer ve kırık görsel göstermez. Kendi kurulumunuzu yönetiyorsanız yöneticinize IMGPROXY_KEY ve IMGPROXY_SALT ayarlarını sorun.

#Aradığımı bulamıyorum

• Dosya arama dosya adında değil, dosyanın içeriğinde arar. Bir PDF'in içindeki cümleyi aramayı deneyin.
• Klasörü hatırlamanız gerekmez, çünkü dosyalar tür, kaynak ve etiket facet'leriyle daraltılır ve arama bulunduğunuz klasörle sınırlanmaz.
• Bu Yardım Merkezi'nde / tuşuna basıp arama yapabilirsiniz.

#Bize ulaşın

Bu sayfadaki hiçbir madde belirtinize uymuyorsa ya da bir şeyin neden böyle çalıştığını anlamadıysanız yazın. İki yol da aynı kutuya düşer:

• İletişim formu — orbiwork.space/contact. Formu doldurmak için hesabınıza giriş yapmanız gerekmez, o yüzden giriş yapamadığınız durumlarda da işe yarar.
• Doğrudan e-posta — platform@orbiwork.space.
• Randevu ya da demo — konuyu yazışmak yerine konuşmak istiyorsanız orbiwork.space/booking adresinden size uyan saatleri bırakın. Onay e-postayla gelir ve saat sonradan iki taraf için de değiştirilebilir.

Yanıt, yazdığınız adrese gelir. Yazarken ne yapmaya çalıştığınızı ve ne olduğunu ayrı ayrı söylemek en çok zaman kazandıran şeydir; bir görevle ilgiliyse görev numarasını da ekleyin. Şifre, API anahtarı ya da erişim token'ı göndermeyin — hiçbir zaman gerekmez.