Bu rehberde: Bir şey ters gittiğinde ne olduğunu öğrenirsiniz. Kutuların otomatik yeniden denemesini ayarlarsınız, hataları bir kenara yönlendirirsiniz ve bütçelerle harcamayı sınırlarsınız.
⏱ 15 dakika
Hatalar nerede olur?
Bir iş akışı dış servislere bağlıdır: sosyal medya, yapay zekâ sağlayıcıları, e-posta sunucuları. Bunlar zaman zaman hata verir. OrqLabs hatayı üç seviyede yönetir:
- Kutu seviyesi: yeniden deneme ve "hata durumunda ne yapılsın" ayarı.
- Çalıştırma seviyesi: durum, hata iş akışı, bütçe.
- Organizasyon seviyesi: aylık bütçe, plan limitleri.
Hatalı kutu ①'deki zaman çizelgesinde kırmızı görünür. Üstüne tıklayınca hata mesajını okursunuz.
Hata türleri
| Kaynak | Örnek | Yeniden denenir mi? |
|---|---|---|
AUTH | İzin süresi dolmuş, izin kaldırılmış | Hayır; yeniden yetkilendirme gerekir |
RATE_LIMIT | Sağlayıcı "çok hızlı istek" dedi (429) | Evet; bekleyip tekrar |
INVALID | Yanlış kimlik, eksik görsel, 280 karakter aşımı | Hayır; veri düzeltilmeli |
UPSTREAM | Sağlayıcı geçici olarak çöktü (5xx) | Evet |
| Yapay zekâ hataları | 529 aşırı yük, 429 hız sınırı, 400 geçersiz parametre | 529/429 evet; 400 hayır |
| İfade hataları | Zorunlu alan boş çözümlendi | Hayır |
| Bütçe | Ajan veya çalıştırma bütçesi aşıldı | Hayır |
| Zaman aşımı | Kutu veya çalıştırma süresi doldu | Duruma göre |
Kutu seviyesinde yeniden deneme
Denetçi panelinde Ayarlar sekmesini açın.
| Alan | Açıklama |
|---|---|
| Yeniden deneme sayısı | 1-10 (1 = yeniden deneme yok) |
| Bekleme (ms) | İlk bekleme süresi. Her denemede ikiye katlanır; en fazla 5 dakika |
| Zaman aşımı (ms) | Bu kutu için süre tavanı. Aşımı bir deneme sayılır |
Sistem yalnızca "yeniden denenebilir" hataları tekrar dener. AUTH ve INVALID ilk denemede hata verir.
Önerilen değerler:
| Kutu türü | Deneme | Bekleme (ms) |
|---|---|---|
| Sosyal yayın, mesaj gönder | 3 | 30000 |
| HTTP, sayfa oku, web araması | 3 | 5000 |
| Yapay zekâ ve ajan kutuları | 2 | 15000 |
| GA4 raporu | 2 | 60000 |
| Webhook gönder | 5 | 10000 |
Hata durumunda ne yapılsın?
Ayarlar → Hata durumunda alanı üç seçenek sunar:
| Seçenek | Davranış |
|---|---|
| Çalıştırmayı durdur (varsayılan) | Denemeler bitince çalıştırma hata ile biter; sonraki kutular çalışmaz |
| Devam et | Kutu hatalı işaretlenir ama öğeler değişmeden ana çıkıştan geçer; json.error alanı eklenir |
| Hata çıkışına yönlendir | Başarısız öğeler kutunun error çıkışına gider; başarılılar ana çıkıştan devam eder |
"Hata çıkışına yönlendir", error çıkışı olan kutularda anlamlıdır: sosyal yayın, mesaj gönder, e-posta gönder, HTTP, webhook gönder. Tipik kullanım:
Sosyal yayın
ana çıkış → Bildir "Yayınlandı"
error → Bildir "Yayın hatası: {{ $json.error.code }} – {{ $json.error.message }}"
→ Bekle (30 dk) → Sosyal yayın (tekrar)
Hata öğesinin json.error alanı: { code, message, provider, retryable, attempt }.
Çalıştırma seviyesinde
- Durumlar: Sırada → Çalışıyor → Başarılı | Hatalı | İptal; aralarda Bekliyor.
- Yeniden dene düğmesi başarısız kutudan itibaren devam eder. Önceki kutuların çıktıları yeniden hesaplanmaz; ajan maliyeti tekrar oluşmaz.
- İptal çalışan kutuya sinyal gönderir; ajanlar mevcut adımı bitirip durur.
- Maks. çalıştırma süresi aşılırsa çalıştırma hata ile biter.
- Hata iş akışı: çalıştırma hata verdiğinde belirtilen iş akışı
{ runId, workflowId, workflowName, error, failedNodeId, failedNodeName, items }verisiyle tetiklenir.
İpucu: Ortak bir "hata bildirimi" iş akışı yapın (Manuel tetikleyici → Bildir, Slack kanalı) ve tüm iş akışlarınızın Hata iş akışı alanında onu seçin.
Boş dallar ve "Atlandı"
Bir kutuya hiç öğe gelmezse (Eğer bir dala hiçbir şey yönlendirmedi, Süz hepsini eledi) sonraki kutu Atlandı olur. Bu bir hata değildir. Birleştir kutusu istisnadır: diğer daldan gelen öğelerle çalışır.
Bütçeler
| Katman | Ayar | Aşılınca |
|---|---|---|
| Ajan çalıştırması | Kutu veya form → Çalıştırma başına bütçe (varsayılan 2 $) | Ajan durur; kısmi çıktı, özet ve rapor kaydedilir; kutu başarılı sayılır, öğede budgetExceeded: true |
| İş akışı çalıştırması | ② Çalıştırma başına bütçe | Her kutu bitişinde toplam kontrol edilir; aşımda sonraki kutular çalışmaz, çalıştırma hata verir |
| Organizasyon aylık | Ayarlar → Genel → Aylık LLM bütçesi (plan tavanını aşamaz) | %80'de uyarı; %100'de yeni yapay zekâ çağrıları reddedilir; yapay zekâ kullanmayan iş akışları çalışır |
| Plan kotaları | Aylık çalıştırma, ajan çalıştırması, token | Kota dolunca tetikleyiciler kuyruğa almaz; bildirim gelir |
Maliyet her kutunun kullanım bilgisinden toplanır ve çalıştırma ayrıntısında (③) görünür. Katalog fiyatları kullanılır; kendi anahtarınızda da aynı hesap yapılır.
Bütçe tasarımı
- İş akışı bütçesini beklenen maliyetin 2-3 katı yapın. Şablonlar böyle gelir: günlük içerik 3 $, chatbot 0.5 $, müşteri adayı araştırma 8 $, analitik 4 $, SEO 6 $, yorum yanıtı 1 $.
- Ajan bütçesini işin türüne göre daraltın: chatbot 0.1 $, sınıflandırma 0.05 $, araştırma 3-5 $.
- Bütçe uyarısı olayına bağlı bir iş akışıyla ekibi Slack'ten uyarın.
- Döngü riski olan tasarımlarda (Döngü kutusu, kendini çağıran İş akışı çalıştır) bütçe tavanı tek güvenlik ağıdır. Mutlaka ayarlayın.
Zaman aşımı değerleri
| Konu | Varsayılan |
|---|---|
| HTTP kutusu | 15 saniye |
| Kod kutusu | 5 saniye |
| Bekle / Onay kutusu | 72 saat |
| Ajan yapay zekâ çağrısı | Modele göre; uzun çıktılar akış hâlinde alınır |
| Webhook tetikleyici "son kutu ile yanıtla" | Maks. çalıştırma süresi; aşımda 504 |
Kaçınılması gereken kalıplar
- Devam et ile ajan hatasını yutup boş çıktıyı yayın kutusuna göndermek. Boş metin
INVALIDverir. Araya Süz ({{ !!$json.body }}) koyun. AUTHhataları için yeniden deneme beklemek. Yeniden bağlanma gerekir; entegrasyon hatası bildirimini izleyin.- Tüm iş akışında tek büyük ajan bütçesi. Kutu bazlı bütçe koyun; hangi adımın pahalı olduğunu görürsünüz.
- Test modunu atlamak. Test modu yayın kutularını kuru çalıştırır ama yapay zekâ maliyeti gerçektir; ilk denemede ekonomi model seçin.
Hata olaylarını izleme
| Olay | Ne zaman |
|---|---|
workflow.run.failed | Çalıştırma hata ile bitti |
post.failed | Yayın kuyruğu gönderiyi yayınlayamadı |
integration.error | Entegrasyon AUTH/UPSTREAM hatası verdi |
budget.warning, budget.exceeded | Bütçe eşikleri |
agent.run.finished | Durum alanı failed, budget_exceeded veya max_steps olabilir |
Bu olayları Platform olayı tetikleyicisiyle (yalnızca post.failed ve budget.warning seçilebilir) veya giden webhook'larla (tam liste) yakalayın. Bkz. Giden webhook'lar, Sık karşılaşılan hatalar.
Sık sorulan sorular
Bir çalıştırma hata verdi. Baştan mı başlar? Hayır. Yeniden dene başarısız kutudan devam eder. Önceki kutuların sonuçları korunur; ajan maliyeti tekrar oluşmaz.
Ajan "bütçe aşıldı" dedi. Verim kayboldu mu? Hayır. O ana kadarki çıktı ve rapor kaydedilir. Bütçeyi veya maks. adımı artırın ya da görevi daraltın.
Aylık bütçe dolunca her şey durur mu? Yalnızca yapay zekâ çağrıları durur. Yapay zekâ kullanmayan kutular (CRM'e yazma, bildirim) çalışmaya devam eder.
Hataları nereden takip ederim? Çalıştırmalar sayfası, zil bildirimleri ve isterseniz Slack (bildirim kutusu veya giden webhook ile).