Temel kavramlar

Giriş

İş akışları temellerine hoş geldiniz. Bu rehber, tekil düğümlerden yürütme kalıplarına, sürümlemeye ve test stratejilerine kadar iş akışlarının nasıl çalıştığını anlamak için ihtiyacınız olan her şeyi kapsar.

İlk kez mi buradasınız? Bu sizin yol haritanız. Temel kavramları anlamak için okuyun, ardından ilk iş akışınızı oluşturmak için Başlarken rehberine bakın.

Düğüm nedir?

Düğüm, bir iş akışının temel yapı taşıdır. Bir tarifteki adım gibi düşünün—her düğüm bir iş yapar ve eksiksiz otomasyonunuzu oluşturmak için bunları zincirlersiniz.

Düğümler birçok şey yapabilir:

• İçerik analiz etmek veya üretmek için yapay zeka ajanları çalıştırma
• Harici API’lere HTTP istekleri gönderme
• Özel kodla veri dönüştürme
• Koşullara göre yürütmeyi yönlendirme
• Ekip üyelerine bildirim gönderme

Sürecinizi baştan sona otomatikleştiren eksiksiz bir iş akışı oluşturmak için düğümleri birbirine bağlarsınız.

Görsel programlama: İş akışları, düğümleri sürükleyip bırakıp bağladığınız görsel bir tuval kullanır. Kod yazmanız gerekmez (Kod düğümü kullanmak istemiyorsanız)!

Düğüm yapısını anlama

Her düğümün çalışmayı kolaylaştıran birkaç ortak öğesi vardır:

Düğüm başlığı

Düğüm türünü ve adını gösterir. Düğümü tek tek test etmek için buradaki oynat düğmesine tıklayın—ayıklama için çok yararlıdır!

Girdi ve çıktı sekmeleri

Bir düğüm çalıştıktan sonra üzerine tıklayarak şunları görebilirsiniz:

• Girdi sekmesi: Düğümün aldığı veri
• Çıktı sekmesi: Düğümün ürettiği veri

Bu veri, iş akışınızdaki sonraki düğümlere akar.

Yapılandırma paneli

Ayarlarını yan panelde açmak için herhangi bir düğüme tıklayın. Düğümün ne yapacağını yapılandırdığınız, yapay zeka modellerini seçtiğiniz, harici hizmetlere bağlantılar kurduğunuz yer burasıdır.

Değişkenlerle çalışma

Veri değişkenler üzerinden akar. Bir düğüm çalışmayı bitirdiğinde çıktısı, sonraki düğümlerde kullanabileceğiniz bir değişken olarak kullanılabilir hale gelir. Bilginin iş akışınızda bu şekilde hareket eder.

Temeller

Değişkenlere başvurmak için çift süslü ayraç kullanın:

{{form1.output.email}}
{{analyze_data.output.structured.summary}}
{{api_response.data.items[0].title}}

Alanları değişkenlerle yapılandırma

Her düğümün yapılandırılması gereken alanları vardır. Çoğu metin alanında değişken kullanabilir veya üç alan modundan birini seçebilirsiniz:

• Otomatik mod: İş akışının en iyi değeri otomatik belirlemesine izin verin
• Manuel mod: Tam değerler girin veya {{form1.output.email}} gibi değişkenler kullanın
• Yapay zeka istemi modu: Dinamik içerik üretmesi için yapay zekaya talimat verin
• Alan modlarını öğrenin — Otomatik, Manuel ve Yapay zeka istemi modlarını ve ne zaman kullanılacaklarını anlayın

💡 İpucu: Herhangi bir alana odaklandığınızda, bağlı tüm yukarı akış düğümlerini gösteren bir veri paneli görünür. Düğüm adlarını hemen görürsünüz; ancak gerçek çıktı verisi ve yapı yalnızca bu düğümleri en az bir kez çalıştırdıktan sonra görünür.

📁 Dosyalarla çalışma: Ajan düğümü istemlerinde, önceki düğümlerden gelen dosyaları (yüklenen belgeler veya üretilen görüntüler gibi) listeleyen bir Dosyalar sekmesi de görürsünüz. Bir başvuru eklemek için bir dosyaya tıklayın—isteminizde dosya türünü ve kaynak düğümü gösteren renkli bir hap olarak görünür.

İş akışları nasıl yürütülür?

Yürütmeyi anlamak kritiktir. İş akışları düğümleri sırayla (birbiri ardına) veya paralel (eşzamanlı) çalıştırabilir. Yürütmenin nasıl çalıştığını bilmek, daha hızlı ve daha verimli otomasyonlar kurmanıza yardımcı olur.

Sıralı yürütme

Varsayılan olarak iş akışınız, çizdiğiniz bağlantıları izleyerek düğümleri birbiri ardına çalıştırır. Her düğüm, başlamadan önce öncekinin tamamlanmasını bekler. Basit ve öngörülebilir!

Paralel yürütme

Birden fazla düğümü tek bir kaynak düğüme bağladığınızda aynı anda çalışabilirler. Bu, düğümler birbirine bağımlı olmadığında iş akışınızı hızlandırır.

Örneğin:

              → Send Email →
Trigger →    → Create Ticket →    → Continue
              → Update Database →

Tetikleyiciden sonraki üç düğüm bağımsız oldukları için paralel çalışabilir.

Hata işleme

Bir şey ters gittiğinde ne olacağını siz kontrol edersiniz. Her düğüm için şunları seçebilirsiniz:

• İş akışını durdur: Her şeyi durdurun ve çalıştırmayı başarısız olarak işaretleyin (kritik adımlar için uygundur)
• Devam et (hata çıktısını kullanarak): Devam edin ve hatayı düğümün çıktısı olarak iletin (kritik olmayan aksiyonlar için uygundur)
• Hata geri çağrısı ekle: Kırmızı hata tutamacıyla hatada farklı düğümlere yönlendirin (yedek mantık için uygundur)

Düğüm ayarlarını kullanarak her düğüm için hata işlemeyi ayrı ayrı yapılandırabilirsiniz.

İş akışı sürümleri

İş akışları için sürüm kontrolü. İş akışlarının, kod için Git’e benzer sürümleri vardır. Taslak modunda güvenle değişiklik yaparken üretimi kararlı tutar.

Taslak sürüm (v0)

Bu sizin kumhavuzunuzdur. Üretimdeki hiçbir şeyi etkilemeden değişiklik yapın, test edin ve deneyin. Taslak sürüm her zaman v0 olarak etiketlenir.

Yayımlanmış sürümler

Değişikliklerinizden memnun olduğunuzda yayımlayarak yeni bir sürüm oluşturursunuz (v1.0.0, v1.1.0 vb.). Yayımlanmış sürümler:

• Değiştirilemez: Değiştirilemezler; bu da üretimi kararlı tutar
• Tetikleyiciler için etkinleştirilir: Yalnızca etkin yayımlanmış sürümler gerçek tetikleyicilere yanıt verir
• Belgelenir: Her biri neyin değiştiğine dair bir açıklama içerir
• Geri alma hazır: Gerekirse daha eski bir sürümü yeniden etkinleştirebilirsiniz

Yayımlarken artırma türünü seçersiniz:

• Patch (1.0.0 → 1.0.1): Hata düzeltmeleri ve küçük dokunuşlar
• Minor (1.0.0 → 1.1.0): Yeni özellikler veya düğümler
• Major (1.0.0 → 2.0.0): Kırıcı değişiklikler

İş akışı şablonları

İş akışı şablonları, tek bir taslak olarak kaydedilen yeniden kullanılabilir başlangıç noktalarıdır. Sürüm olarak yayımlanmazlar ve etkinleştirilemez, üretimde çalıştırılamaz veya gerçek tetikleyicilere yanıt veremezler. Bir şablondaki değişiklikler otomatik kaydedilir ve yalnızca şablonu günceller.

Bir şablonun otomasyonunu üretimde kullanmak için şablondan düzenli bir iş akışı oluşturun, kopyayı yapılandırın, bir sürüm yayımlayın ve açın. Kopyalanan iş akışı ardından normal taslak, yayımlanmış ve durum yaşam döngüsünü kullanır.

Yayımlamadan önce iş akışlarını taslak sürümünde test edin. Üretim tetikleyicilerini etkilemeden tam iş akışı testleri çalıştırabilirsiniz.

İş akışınızı test etme

Erken ve sık test edin. İş akışınız tamamlanana kadar test etmeyi beklemeyin. Sorunları erken yakalamak için her düğümü oluştururken test edin.

Tekil düğümleri test etme

Yalnızca o parçayı test etmek için herhangi bir düğümdeki oynat düğmesine tıklayın. Şunlar için idealdir:

• İş akışının geri kalanını kurmadan önce bir ajanın çıktısını doğrulama
• Bir API çağrısının beklenen veriyi döndürüp döndürmediğini kontrol etme
• Belirli düğümlerdeki sorunları ayıklama

Eksiksiz iş akışlarını test etme

Örnek veriyle tüm iş akışını yürütmek için tetikleyici düğümündeki "Test çalıştırması" düğmesini kullanın. Bu tüm düğümlerden geçer ancak olayları işlenmiş olarak işaretlemez; böylece güvenle test edebilirsiniz.

Önceki olayları yeniden oynatma

Olayları yeniden oynatma, örnek veriyi elle girmek yerine önceki bir form gönderimi, webhook isteği veya entegrasyon olayındaki veriyle bir iş akışını test etmenizi sağlar. Test çalıştırması panelini açın ve Olayları yeniden oynat’ı seçin.

Sonuçları görüntüleme

Herhangi bir test çalıştırmasından sonra düğümlere tıklayarak şunları görün:

• Girdi: Düğümün aldığı veri
• Çıktı: Ürettiği çıktı
• Mesajlar: Ajan düğümleri için tam yapay zeka konuşması
• Günlükler: Kod düğümleri için konsol çıktısı
• Kullanım: Kaç yapay zeka kredisi tüketildiği

Düğümler arasındaki bağlantılar

Bağlantılar akışı tanımlar. Düğümler arasındaki çizgiler yalnızca görsel değildir—yürütme sırasını ve verinin iş akışınızda nasıl aktığını belirlerler.

Bağlantı tutamaçları

Düğümlerin yanlarında bağlantı noktaları (tutamaçlar) vardır:

• Sol taraf (girdi): Yürütmenin girdiği yer
• Sağ taraf (çıktı): Yürütmenin çıktığı yer
• Birden fazla çıktı: Koşul düğümlerinin her koşul için bir çıktısı vardır
• Kırmızı tutamaç: Özel hata çıktısı (hata işleme etkinleştirildiğinde görünür)

Bağlantı çizme

Bir çıktı tutamacından bir girdi tutamacına tıklayıp sürükleyin. Çizgi yürütme akışını gösterir. İş akışları bu bağlantılarla tanımlanan sırada yürütülür.

İş akışı durumu

Aşağıdaki üç durum yalnızca iş akışları için geçerlidir; iş akışı şablonları için değil:

Hâlâ oluşturuluyor—otomatik tetikleyiciler ateşlenmez. Değişiklik yapmak ve test etmek için güvenlidir.

Yayımlanmış ve tetikleyicilere otomatik yanıt veriyor. Bu üretim modudur.

Var ancak geçici olarak devre dışı. İş akışını silmeden bakım veya ayıklama için uygundur.

İş akışı şablonları bu durum yaşam döngüsüne girmez.

İnsan denetimi

Finansal işlemler veya veri silme gibi hassas aksiyonlar için devam etmeden önce manuel onay zorunlu kılabilirsiniz:

• İnsan onayı — İnsan denetimi gerektiren önemli aksiyonlar için manuel onay adımları ekleyin

En iyi uygulamalar

• Düğümlere net adlar verin: "Agent 1" değil "Geri bildirimi analiz et"
• İş akışlarını odaklı tutun: Bir iş akışı, bir amaç
• Erken ve sık test edin: Her düğümü oluştururken test edin
• Yorum ekleyin: Karmaşık mantığı belgelemek için herhangi bir düğümdeki üç nokta menüsüne tıklayıp "Yorum ekle"yi seçin

Sonraki adımlar

Temelleri anladığınıza göre belirli konulara daha derinlemesine bakın:

• Alan modları — Düğüm alanlarını Otomatik, Manuel ve Yapay zeka istemi modlarıyla yapılandırın
• İnsan onayı — Hassas aksiyonlar için manuel onay ekleyin
• Başlarken — İlk iş akışınızı adım adım oluşturun
• Düğüm türleri — Kullanılabilir tüm tetikleyicileri ve düğümleri keşfedin