İş akışı editörü

Bu rehberde: İş akışı editörünü tanırsınız: üstteki Kurulum listesi, palet, tuval ve denetçi. Kutu ekler, bağlar, ayarlar; kaydeder, dener ve etkinleştirirsiniz. Editör her adımda size ne yapmanız gerektiğini söyler.

⏱ 20 dakika

Editörün üç bölümü#

Bir iş akışını açtığınızda editör gelir (app.orqlabs.com/app/<organizasyon>/workflows/<id>).

• ① Palet: eklenebilecek tüm kutular (node'lar), kategorilere ayrılmış.
• ② Tuval: iş akışının çizimi. Kutular ve aralarındaki bağlantı çizgileri. Tuvalin üstünde Kurulum listesi durur.
• ③ Denetçi: seçili kutunun ayarları.
• ④ Araç çubuğu: ad, durum rozeti, Doğrula, Ayarlar, Sürümler, Deneme çalıştır, Etkinleştir / Duraklat, Kaydet.
• ⑤ Çalıştırma paneli: çalıştırmanın özeti, kutuların durumu ve çıktısı.

Kurulum listesi: şu an ne yapmalıyım?#

Tuvalin üstündeki Kurulum listesi bir iş akışını çalışır hâle getirmek için gereken yedi adımı gösterir. Her adımın durumu canlı güncellenir. Şu an yapmanız gereken satırı sıradaki adımı ve tek tıklık düğmesini gösterir.

• ① başlığa tıklayarak listeyi daraltıp açarsınız. Tercihiniz her iş akışı için ayrı hatırlanır. Telefonda liste daraltılmış başlar.
• Yedi adım tamamlanınca liste kaybolur; yerinde küçük bir Kurulum tamam etiketi kalır. Etikete tıklayınca liste yeniden açılır.

Boş tuval: nasıl başlarsınız?#

Yeni ve boş bir iş akışı açtığınızda tuvalde Nasıl başlamak istersiniz? kartları çıkar.

1. ②'deki kartlardan birini seçin: Her gün (her gün 09:00), Her hafta (pazartesi 09:00), Mesaj geldiğinde veya Elle başlat. Tetikleyici tuvale eklenir ve denetçide açılır. Saati sonra değiştirebilirsiniz.
2. Hazır bir akış isterseniz ③ Şablondan başla'ya tıklayın. Bkz. Şablonlar.
3. Webhook, form veya platform olayı gerekiyorsa Diğer başlangıçlar bağlantısı paleti yalnızca tetikleyicilerle açar.

④'teki şema her akışın üç parçasını özetler: Başlangıç (ne zaman?) → Adımlar (ne yapılacak?) → Sonuç (ne olacak?).

Palet: kutu eklemek#

1. ①'deki arama kutusuna ne aradığınızı yazın. Örneğin "onay".
2. Kutuyu tuvale sürükleyip bırakın. Ya da tuvalde boş bir yere çift tıklayıp arayın.
3. Kutu tuvale eklenir ve seçili hâle gelir; sağda denetçi açılır.

②'deki kategoriler:

Tuval: kutuları bağlamak#

+ Sonraki adım#

Çıkışı hiçbir yere bağlı olmayan her kutunun sağında + Sonraki adım düğmesi durur.

1. ① + Sonraki adım düğmesine tıklayın.
2. ②'deki önerilerden birini seçin. Öneriler kutunun türüne göre değişir. Örneğin tetikleyiciden sonra İçerik Üretici ve diğer ajanlar; İçerik Üretici'den sonra Onay iste, Gönderi yayınla, Görsel üret; Onay iste'den sonra Gönderi yayınla ve Ekibe bildir gelir.
3. Yeni kutu sağa eklenir ve otomatik bağlanır; denetçide açılır.
4. Aradığınız öneride yoksa ③ Tümünü gör paleti açar. Paletten seçtiğiniz kutu da aynı kutuya bağlanır.

Kutu kartları#

• Kartın üst satırı kutunun Türkçe adıdır. Alt satırda önemli ayarların özeti yazar; örneğin X · 2 gönderi veya Her gün saat 09:00.
• Bağlantısı olmayan kutunun üstünde sarı Bağlı değil etiketi çıkar. Böyle bir kutu hiç çalışmaz. Etikete tıklarsanız editör kutuyu uygun önceki adıma bağlar.
• Kutunun kullanacağı hesapta sorun varsa adın yanında kırmızı bir uyarı noktası görünür. Üzerine gelince sebebi yazar; örneğin "X API krediniz bitmiş".

Elle bağlamak#

• Bir kutunun çıkış noktasından diğerinin giriş noktasına sürükleyerek bağlantı çizin.
• Bazı kutuların birden fazla çıkışı vardır. Örneğin Eğer kutusunda true ve false; Onay kutusunda approved ve rejected. Her çıkışın etiketi vardır.
• Birleştir kutusunun iki girişi vardır; ikincisi input2 etiketlidir.
• Kutuyu seçip Delete ile silin. Ctrl/Cmd+D ile kopyalayın. Sağ tık menüsünden Devre dışı bırak yapın; devre dışı kutu veriyi değiştirmeden geçirir.
• Her kutunun adı iş akışında benzersiz olmalıdır. İfadeler bu ada göre çalışır: {{ $node["Content Creator"].json.body }}. Adı değiştirirseniz editör ifadeleri günceller; yalnızca Kod kutusundaki metinleri elle düzeltmeniz gerekir.
• Çalıştırma sonrası her kutunun üstünde öğe sayısı ve süre görünür. Tıklayınca Çıktı sekmesi açılır.

Denetçi: kutuyu ayarlamak#

Seçili kutu için üç sekme vardır: Parametreler, Ayarlar, Çıktı.

Parametreler sekmesi#

Kutunun ne yapacağını belirleyen alanlar. Alan türüne göre farklı kontroller görürsünüz:

Bazı alanlar yalnızca belirli durumlarda görünür. Örneğin WhatsApp şablon adı yalnızca kanal WhatsApp seçilince çıkar.

④'teki Gelişmiş bölümü katlıdır. İçinde model, düşünme derinliği, maks. adım, bütçe ve zaman aşımı bulunur.

fx düğmesi ②'deki listeyi açar: önceki kutuların gerçek çıktıları. Bir alana tıklayınca ifade otomatik yazılır. Ayrıntı: İfade sözdizimi.

Ayarlar sekmesi#

Çıktı sekmesi#

Son çalıştırmanın öğeleri (JSON veya tablo görünümü) ve loglar. Bir öğeye tıklayıp İfade olarak kopyala dediğinizde {{ $node["Ad"].json.alan }} panoya gelir.

İş akışı ayarları#

Araç çubuğundaki Ayarlar düğmesi iş akışının geneline ait ayarları açar.

④ Değişkenler sekmesi, ifadelerde {{ $vars.ad }} ile kullanılan sabitleri tutar. Şablonlar bazı değişkenleri hazır getirir; örneğin müşteri adayı şablonunda icp ve offer.

Geliştirici notu: Ayarlar WorkflowSettings nesnesidir: timezone, maxRunDurationMs, concurrency, errorWorkflowId, budgetUsd, defaultModelId, variables.

Kaydetme ve sürümler#

1. Kaydet düğmesine basın (Ctrl/Cmd+S). Tanım doğrulanır ve yeni bir sürüm oluşur.
2. Sürümler düğmesi geçmiş sürümleri listeler. Bir sürümü seçip Geri yükle dediğinizde tanım tuvale gelir; kaydettiğinizde yeni sürüm olarak eklenir. Eski sürümler silinmez.
3. Etkin bir iş akışını kaydettiğinizde o an çalışan çalıştırmalar başladıkları sürümle biter. Sonraki tetiklemeler yeni sürümü kullanır.
4. Çoğalt ile aynı tanımda Taslak bir kopya oluşturursunuz.

Ad, açıklama veya etiket değişikliği sürüm oluşturmaz.

Doğrulama ve anlaşılır hata mesajları#

Doğrula düğmesi iş akışını kontrol eder ve hataları kutuların üstünde kırmızı işaretle gösterir. Sorun varsa düğmeye tıklayınca Düzeltilmesi gerekenler listesi açılır.

• Her sorun kısa bir Türkçe cümledir ve kutunun ve alanın Türkçe adını söyler. Örneğin: "“İçerik Üretici” adımında “Platformlar” alanı boş."
• Düzelt düğmesi ilgili kutuyu seçer, denetçide alanı açar ve imleci alana koyar. Bağlantı sorunlarında Otomatik bağla, başlangıç eksikse Başlangıç ekle yazar.
• Asıl sistem mesajını görmek isterseniz Teknik ayrıntı satırını açın.
• Aynı cümleler çalıştırma panelinde, çalıştırma sayfasında ve bildirimlerde de kullanılır. Hesap sorunları için yol da gösterilir; örneğin "X API krediniz bitmiş. developer.x.com → Billing bölümünden kredi yükleyin."

Kontroller:

• Tam olarak bir tetikleyici var mı? Tetikleyiciye giren bağlantı yok mu?
• Zorunlu alanlar dolu mu?
• Hesap gerektiren kutuda hesap seçili mi? Hesap uygun sağlayıcıda mı?
• İfadelerde bilinmeyen kutu adı veya yazım hatası var mı?
• Bağlantılar geçerli çıkışlara mı bağlı?
• Döngü yalnızca Döngü kutusuyla mı kurulmuş?
• Seçilen model planınızda izinli mi?

Hatalar giderilmeden iş akışı etkinleştirilemez; Etkinleştir penceresi sorunları listeler.

Deneme ve gerçek çalıştırma#

Araç çubuğundaki Deneme çalıştır düğmesi (Ctrl/Cmd+Enter) çalıştırma penceresini açar. Pencerede iki seçenek vardır.

• ③ Gelişmiş: örnek girdi başlangıca verilecek JSON'u içerir. Çoğu akışta boş bırakabilirsiniz. Manuel tetikleyicinin Örnek girdi alanı buraya otomatik gelir.
• Gerçek çalıştır'ı seçip Devam dediğinizde bir onay ekranı açılır. Ekran, gerçekten yapılacak işleri tek tek yazar; örneğin "X hesabınızda 2 gönderi yayınlanacak." Kullanılacak hesapta sorun varsa (kredi bitmiş, süresi dolmuş) burada da uyarı görürsünüz.

Dikkat: Deneme yayın yapmaz ama yapay zekâ maliyeti gerçektir. İlk denemelerde ekonomi model seçin.

Çalıştırma sonucu: Özet#

Çalıştırma bitince alttaki çalıştırma paneli Özet sekmesinde açılır. Aynı özet çalıştırmanın ayrıntı sayfasında Ne oldu? kartında da vardır.

• ① Üst satırda durum, Deneme veya Gerçek rozeti, süre ve maliyet yazar.
• ② Deneme çalıştırmalarında mavi bir not, yayın ve mesaj adımlarının gerçekten gönderim yapmadığını hatırlatır.
• ③ Her adım için bir cümle vardır. Örneğin İçerik Üretici için "2 gönderi yazdı (X) → İçerik sayfasında onayınızı bekliyor." Ajanın yazdığı gönderiler İçerik sayfasına taslak olarak kaydedilir; bağlantıdan gidip onaylayabilirsiniz.
• ④ Denemede çalışan yayın adımında Deneme modu – yayın yapılmadı rozeti çıkar. Gerçek çalıştırmada bunun yerine Gönderiyi aç bağlantısı gelir.
• Hata varsa adım satırında hatanın Türkçe açıklaması ve Düzelt düğmesi görünür.
• Düğümler, Günlükler ve Son çalıştırmalar sekmeleri ayrıntılı veriyi gösterir.

• Onay veya bekleme kutusunda gerçek çalıştırma Bekliyor olur. Onayı verdiğinizde aynı çalıştırma devam eder.

Etkinleştirme kontrolü#

Etkinleştir düğmesi akışı hemen açmaz; önce bir kontrol penceresi gösterir.

1. ① Ne zaman çalışacak? zamanlamayı düz cümleyle yazar ("Her gün saat 09:00 (İstanbul)") ve sonraki üç çalışma zamanını listeler.
2. ② Her çalışmada ne olacak? dışarıya yapılacak işleri sayar; örneğin "X hesabınızda 2 gönderi yayınlanacak."
3. ③ Kullanılacak hesapta hata varsa uyarı çıkar. Örneğin X API krediniz bitmişse yayın başarısız olur; Entegrasyonlar düğmesiyle hesaba gidin.
4. ④ Yayın veya mesaj adımından önce bir onay adımı yoksa "Gönderiler onayınız olmadan yayınlanacak" uyarısı çıkar. Onay adımı ekle düğmesi yayın adımının önüne bir Onay iste kutusu ekler ve bağlar.
5. Doğrulama hatası varsa pencere bunları listeler ve etkinleştirmeye izin vermez. Uyarılar ise engel değildir; ⑤ Yine de etkinleştir ile devam edebilirsiniz. Kaydedilmemiş değişiklikler etkinleştirmeden önce kaydedilir.

Etkin bir iş akışında araç çubuğunun altında yeşil bir şerit durur: "Bu akış etkin – sonraki çalışma: 30 Eylül Çarşamba 09:00". Zamanlama dışındaki tetikleyicilerde şerit ne zaman çalışacağını yazar; örneğin "Webhook adresine bir istek geldiğinde çalışır."

Etkinleştirme ve durumlar#

Etkinleştir plan limitini kontrol eder: FREE 1, STARTER 5, PRO 40 aktif iş akışı. Duraklat sürüyor olan çalıştırmaları kesmez.

Çalıştırmalar sayfası#

İş Akışları → iş akışınız → Çalıştırmalar sekmesi geçmişi listeler. Her satırda durum, tetikleyici türü (Manuel, Zamanlama, Webhook, Olay, API, Sohbet), süre ve maliyet vardır.

Ayrıntı sayfasında her kutunun durumu (Bekliyor, Çalışıyor, Başarılı, Hatalı, Atlandı, Bekliyor) ve öğeleri görünür. Eylemler: İptal ve Yeniden dene (başarısız kutudan devam eder).

Klavye kısayolları#

Sık sorulan sorular#

Bir kutuyu silersem bağlantıları ne olur? Kutuya bağlı tüm bağlantılar da silinir. Geri almak için Ctrl/Cmd+Z.

İki kutuyu aynı kutuya bağlayabilir miyim? Doğrudan bağlarsanız hedef kutu iki dalın da bitmesini bekler ve boş dal onu "atlandı" yapar. İki dalı birleştirmek için Birleştir kutusunu kullanın.

Deneme başarılı oldu ama hiçbir şey paylaşılmadı. Neden? Deneme çalıştırması yayın ve mesaj adımlarını bilerek çalıştırmaz. Özet'te bu adımda Deneme modu – yayın yapılmadı rozeti görünür. Gerçekten paylaşmak için Gerçek çalıştır'ı seçin veya akışı etkinleştirin.

İçerik Üretici'nin yazdığı gönderiler nerede? İçerik sayfasında, onayınızı bekleyen taslaklar olarak durur. Özet'teki İçerik sayfasında gör bağlantısı sizi oraya götürür.

Kaydetmeden çıkarsam ne olur? Araç çubuğunda "kaydedilmemiş değişiklikler" uyarısı görürsünüz. Çıkmadan önce kaydedin.

Etkin bir iş akışını düzenlersem hemen etkilenir mi? Kaydettiğiniz anda sonraki tetiklemeler yeni sürümü kullanır. O an çalışan çalıştırma eski sürümle biter.

Sonraki adım#

• İfade sözdizimi
• Tetikleyiciler ve zamanlamalar
• Onaylar ve insan denetimi
• Hata yönetimi, yeniden deneme ve bütçeler
• Şablonlar