Düğüm türleri

Genel bakış

Düğümler iş akışlarının yapı taşlarıdır. Her düğüm türü belirli bir amaca hizmet eder—iş akışınızı tetiklemeden veriyi yapay zeka ile işlemeye, harici API’leri çağırmaya veya yürütme akışını kontrol etmeye kadar.

Bu referans, kategorilere göre düzenlenmiş her kullanılabilir düğüm türünü kapsar. Her düğümün ne yaptığını ve iş akışlarınızda ne zaman kullanılacağını anlamak için kullanın.

İş akışlarına yeni misiniz? Düğümlerin birlikte nasıl çalıştığını anlamak için Temel kavramlar ile başlayın, ardından oluştururken bu referansa dönün.

Tetikleyici düğümleri

Her iş akışı tam olarak bir tetikleyiciyle başlar. Tetikleyici, iş akışınızın ne zaman ve nasıl yürütüleceğini belirler—zamanlamayla, form gönderimiyle, API çağrısıyla veya bir entegrasyon olayıyla.

• Manuel tetikleyici — Düğmeye tıklayarak iş akışlarını isteğe bağlı çalıştırın
• Form tetikleyicisi — Özel form gönderimlerinden iş akışları başlatın
• Webhook tetikleyicisi — İş akışlarını tetiklemek için HTTP istekleri alın
• Zamanlanmış tetikleyici — İş akışlarını yinelenen bir zamanlamada çalıştırın
• Entegrasyon tetikleyicisi — Bağlı uygulamalardaki olaylardan başlatın

Manuel tetikleyici

İş akışını düğmeye tıklayarak manuel çalıştırın.

Kullanım senaryoları:

• İsteğe bağlı veri işleme
• İş akışlarını test etme ve ayıklama
• Arayüzünüzdeki kullanıcılar tarafından tetiklenen iş akışları

Yapılandırma:

• Yapılandırma gerekmez
• İsteğe bağlı girdi verisi kabul edebilir

Form tetikleyicisi

Kullanıcı özel bir form gönderdiğinde iş akışını başlatın.

Kullanım senaryoları:

• Alım formları (müşteri talepleri, geri bildirim, başvurular)
• Veri toplama iş akışları
• Self-servis otomasyon talepleri

Yapılandırma:

• Form alanlarını tanımlayın (metin, sayı, e-posta, açılır liste vb.)
• Zorunlu/isteğe bağlı alanları ayarlayın
• Formu herkese açık veya yalnızca iç yapın
• Form başlığını ve açıklamasını özelleştirin

Form özellikleri:

• Formunuz için benzersiz bir URL üretin
• İş akışı başlamadan önce girdiyi doğrulayın
• Form gönderimleri kuyruğa alınır ve güvenilir biçimde işlenir

Herkese açık formlar: Müşterilerin veya iş ortaklarının ajan hesabı olmadan gönderebilmesi için formları herkese açık hale getirebilirsiniz.

Webhook tetikleyicisi

İş akışını tetiklemek için HTTP POST istekleri alın.

Kullanım senaryoları:

• Harici sistemlerle entegrasyon
• Gerçek zamanlı olay işleme
• Webhook destekleyen hizmetlere bağlanma

Yapılandırma:

• Benzersiz bir webhook URL’si alın
• URL’yi kopyalayın veya üretilen curl snippet’ini kullanın

Webhook özellikleri:

• JSON yükleri alır
• Anında yanıt döner
• İstekleri asenkron işler

Zamanlanmış tetikleyici

İş akışını yinelenen bir zamanlamada çalıştırın.

Kullanım senaryoları:

• Günlük raporlar ve özetler
• Periyodik veri senkronizasyonu
• Zamanlanmış bakım görevleri
• Yinelenen veri analizi

Yapılandırma:

• Önceden tanımlı zamanlamalardan seçin (her saat, her gün 09:00, hafta içi vb.)
• Veya doğal dil açıklaması yazın; yapay zeka cron ifadesini üretir
• Zamanlamalar UTC’de çalışır (yerel saat diliminiz referans için gösterilir)

Zamanlama örnekleri:

• Her gün saat 09:00
• Her Pazartesi saat 08:30
• Her ayın ilk günü
• Her 6 saatte bir

Entegrasyon tetikleyicisi

Bağlı uygulamalarda olaylar gerçekleştiğinde iş akışını başlatın.

Kullanım senaryoları:

• Bir kanalda yeni Slack veya Microsoft Teams mesajı
• Gmail veya Outlook gelen kutusunda alınan e-posta
• Oluşturulan veya yakında başlayan takvim etkinliği
• Google Drive’a eklenen yeni dosya veya klasör
• Salesforce’ta yeni lead veya HubSpot’ta yeni fırsat
• Jira veya GitHub’da yeni issue veya pull request

Yapılandırma:

• Entegrasyonu seçin
• Tetikleyici olay türünü seçin
• Tetikleyici parametrelerini yapılandırın (kanal, klasör vb.)
• Hesabınızı bağlayın

Kullanılabilir entegrasyonlar:

Kullanılabilir tetikleyiciler, çalışma alanınızda etkinleştirdiğiniz entegrasyonlara bağlıdır.

Entegrasyon tetikleyicilerini test etme: Test panelini açmak için tetikleyici düğümündeki oynat düğmesine tıklayın. Şunları yapabilirsiniz: * Olay bul: Bağlı entegrasyonunuzdan son olaylara göz atın (yeni e-postalar, Slack mesajları vb.) * Olay bekle: Gerçek zamanlı olarak sonraki gelen olayı dinleyin * İş akışınızı o gerçek veriyle test etmek için herhangi bir olayı seçin

Yapay zeka ajan düğümleri

Akıllı otomasyonun gücü. Ajan düğümleri veriyi analiz etmek, karar vermek, içerik üretmek veya bilgi çıkarmak için yapay zeka kullanır. Bunlar iş akışlarınızı gerçekten akıllı kılan düğümlerdir.

Ajan düğümü

Doğal dil talimatlarıyla veriyi işlemek için bir yapay zeka ajanı yürütün.

Kullanım senaryoları:

• İçeriği analiz etme ve kategorizasyon
• Metinden yapılandırılmış veri çıkarma
• Özet veya rapor üretme
• Ölçütlere göre karar verme
• Veri hakkında soruları yanıtlama

Yapılandırma:

• Ajan seç: Mevcut bir ajanı seçin veya yeni bir ajan oluşturun
• Talimatlar: Bağlam ve talimatlar sağlayın
• Girdi değişkenleri: Önceki düğümlerden veri iletin
• Model seçimi: Yapay zeka modelini seçin
• Araçlar: Web araması, kod yürütme veya entegrasyonları etkinleştirin
• Çıktı şeması: Yapılandırılmış çıktı biçimini tanımlayın (JSON)

Ajan özellikleri:

• Tüm ajanlarınıza erişim
• Entegre araçları ve aksiyonları kullanabilir
• Güvenilir veri çıkarma için yapılandırılmış çıktılar
• Mesajlar sekmesinde tam konuşmayı görüntüleyin

Örnek ajan talimatları:

Analyze the customer feedback in {{trigger.output.message}} and categorize it as:
- Product issue
- Feature request
- Billing question
- General inquiry

Also extract the sentiment (positive, neutral, negative) and provide a brief summary.

İpucu: Sonraki düğümlerde kolayca kullanabileceğiniz güvenilir JSON verisi almak için yapılandırılmış çıktılar kullanın.

Aksiyon düğümleri

Araçlarınıza bağlanın. Aksiyon düğümleri bağlı uygulamalarda işlemler yürütür—e-posta gönderin, talep oluşturun, veritabanlarını güncelleyin, Slack’e gönderin ve daha fazlası.

Aksiyon düğümü

Görev oluşturma, e-posta gönderme veya kayıt güncelleme gibi bağlı uygulamalarda aksiyonlar gerçekleştirin.

Kullanım senaryoları:

• Destek sistemlerinde talep oluşturma
• Slack veya Teams’te mesaj gönderme
• Elektronik tablolara satır ekleme
• Takvim etkinlikleri oluşturma
• CRM kayıtlarını güncelleme
• E-posta gönderme

Yapılandırma:

• Entegrasyonu seçin
• Aksiyon türünü seçin
• Bağlantınızı seçin (kimlik doğrulama gerektiren entegrasyonlar için zorunlu)
• Önceki düğümlerden girdi alanlarını eşleyin
• Aksiyona özel ayarları yapılandırın

Kullanılabilir aksiyonlar:

Aksiyonlar etkin entegrasyonlarınıza bağlıdır. Yaygın aksiyonlar:

• Slack: Mesaj gönder, kanal oluştur
• Google Sheets: Satır ekle, hücre güncelle
• Gmail: E-posta gönder
• Notion: Sayfa oluştur, veritabanı güncelle
• Jira: Issue oluştur, durum güncelle

Alan eşleme:

Aksiyon alanlarını doldurmak için değişkenleri kullanın:

Title:
{{trigger.output.subject}}
Description: Summary:
{{agent.output.structured.summary}}

Priority:
{{condition.output.priority_level}}

Mantık düğümleri

Akışı kontrol edin. Mantık düğümleri iş akışlarınıza dallanma, döngü ve koşullu yürütme ekler. Gelişmiş, karar odaklı otomasyonlar kurmak için gereklidirler.

Koşul düğümü

Koşullara göre yürütmeyi farklı yollara yönlendirin.

Kullanım senaryoları:

• Onay iş akışları (öncelik yüksekse yöneticiyi bilgilendir)
• Veri yönlendirme (kategoriye göre farklı ekiplere yönlendir)
• Doğrulama (zorunlu verinin mevcut olup olmadığını kontrol et)
• Çok yollu iş akışları

Yapılandırma:

• Birden fazla koşul tanımlayın
• Her koşul true/false olarak değerlendirilir
• Yürütme ilk eşleşen koşulu izler
• Eşleşmeyen durumlar için bir "varsayılan" koşul ekleyin

Koşul modları:

• Manuel: Bir koşul ifadesi yazın
• Yapay zeka destekli: Bir ajanın koşulu doğal dille değerlendirmesine izin verin

Manuel koşul örnekleri:

{{trigger.output.amount > 1000 }}
{{agent.output.sentiment === "negative" }}
{{trigger.output.role === "admin" && trigger.output.urgent === true }}

Yapay zeka destekli koşullar:

Determine if this customer message requires urgent attention based on:
- Mentioned keywords like "urgent", "emergency", "asap"
- Angry or frustrated tone
- High-value customer status

Birden fazla koşul: Varsayılan olarak koşullar sırayla değerlendirilir ve iş akışı eşleşen ilk koşulu izler. Tüm eşleşen yolları eşzamanlı yürütmek için "Birden fazla koşula izin ver"i etkinleştirin.

Döngü düğümü

Bir dizi üzerinde yineleyin ve her öğe için düğümleri yürütün.

Kullanım senaryoları:

• Bir listeden birden fazla öğeyi işleme
• Kayıtlarda toplu işlemler
• Her öğe için bireysel raporlar üretme

Yapılandırma:

• Girdi dizisi: Üzerinde yineleme yapılacak dizi (ör. {{trigger.output.items }} veya [1, 2, 3])
• Paralel yürütme: Tüm yinelemeleri sıralı yerine eşzamanlı çalıştırmak için etkinleştirin
• Maks. yineleme: Kontrolden çıkan döngüleri önlemek için güvenlik limiti (varsayılan: 200, maks: 2000)

Döngünün içinde:

Döngü düğümünün slug’ı değişken adınız olur. Geçerli öğeye ve yineleme bilgisine erişin:

{{ my_loop.output.currentItem }}        // The current item being processed
{{ my_loop.output.currentItem.name }}   // Access properties on the item
{{ my_loop.output.currentIndex }}       // Current iteration index (0-based)
{{ my_loop.output.total }}              // Total number of items

Döngü örneği:

Bir tetikleyiciden müşteri kayıtları diziniz varsa:

[
  { "name": "Alice", "email": "alice@example.com" },
  { "name": "Bob", "email": "bob@example.com" }
]

customer adlı bir döngü düğümüyle alanlara şöyle erişin:

{{ customer.output.currentItem.name }}
{{ customer.output.currentItem.email }}

Maliyet yönetimi: Döngüler, birçok öğeyi yapay zeka ajanlarıyla işlerken önemli miktarda kredi tüketebilir. Uygun yineleme limitleri ayarlayın ve bağımsız işlemler için paralel yürütmeyi etkinleştirmeyi düşünün.

Yardımcı düğümler

Ek yetenekler. Yardımcı düğümler iş akışlarınızı kod yürütme, web aramaları, HTTP istekleri ve bildirimlerle genişletir. Bunları özel dönüşümler ve uzmanlaşmış görevler için kullanın.

Çıktı düğümü

Bir değeri iş akışı çalıştırmasının nihai sonucu olarak saklayın.

Kullanım senaryoları:

• Özet veya yapılandırılmış veri döndürme
• Önceki düğümlerden değer yakalama
• İş akışı sohbetten başladığında sohbette sonuç döndürme
• Çıktı — İş akışı çıktıları için tam yapılandırma rehberi

Kod düğümü

Veri dönüşümü için özel JavaScript veya Python kodu yürütün.

Kullanım senaryoları:

• Karmaşık veri dönüşümleri
• Matematiksel hesaplamalar
• Özel iş mantığı
• Veri biçimlendirme ve temizleme

Yapılandırma:

• Kodunuzu JavaScript veya Python’da yazın
• Kodunuzda başvurulmuş yukarı akış düğümlerinin çıktılarına erişin
• return ifadesiyle veri döndürün

Örnek:

// Access data from previous nodes
const email = trigger.output.email;
const items = api_response.output.items || [];

// Transform data
const total = items.reduce((sum, item) => sum + item.price, 0);

return {
  customer_email: email,
  total_amount: total,
  item_count: items.length,
};

Kullanılabilir değişkenler:

Kod düğümleri yalnızca slug’ları kodunuzda geçen yukarı akış düğümlerinin çıktılarını yükler. Bunlara düğüm slug’ı ile erişin:

trigger.output          // Trigger node output
agent.output            // Agent node output
api_response.output     // HTTP Request node output

Web araması düğümü

Web’de arama yapın ve ilgili bilgiyi alın.

Kullanım senaryoları:

• Doğrulama ve teyit
• Pazar araştırması
• Güncel olaylar ve haberler
• Belirli bilgi bulma

Yapılandırma:

• Sorgu: Arama sorgusunu tanımlayın
• Mod: Otomatik (yapay zeka sorgu üretir) veya Manuel (siz belirtirsiniz)
• Sonuç sayısı: Döndürülecek sonuç sayısı

Sorgu modları:

• Otomatik: Yapay zeka bağlama göre arama sorgusu üretir
• Manuel: Tam arama terimlerini siz belirtirsiniz
• İstem: Sorguyu üretmesi için yapay zekaya talimat yazın

Çıktı:

Şunlarla arama sonuçları döndürür:

• Başlık ve URL
• Parça/açıklama
• İlgililik puanı

HTTP isteği düğümü

Harici API’lere HTTP istekleri yapın.

Kullanım senaryoları:

• Kendi API’lerinizden veri getirme
• Yerel entegrasyonu olmayan hizmetlerle entegre olma
• Özel webhook’lar ve API çağrıları

Yapılandırma:

• Yöntem: GET, POST, PUT, DELETE, PATCH
• URL: Uç nokta URL’si (değişken içerebilir)
• Başlıklar: Özel başlıklar ekleyin (kimlik doğrulama, content-type)
• Sorgu parametreleri: URL parametreleri ekleyin
• Gövde: POST/PUT için istek yükü (JSON)

Kimlik doğrulama:

Kimlik doğrulama başlıkları ekleyin:

Authorization: Bearer {{ your_api_token }}

Değişkenli URL:

https://api.example.com/users/{{trigger.output.user_id}}/orders

İstek gövdesi örneği:

{
  "title": "{{agent.output.summary }}",
  "description": "{{trigger.output.content }}",
  "status": "open"
}

Bildirim gönder düğümü

ajan gelen kutunuza uygulama içi bildirimler gönderin.

Kullanım senaryoları:

• İş akışı tamamlanma bildirimleri
• Dikkat gerektiren hata uyarıları
• Durum güncellemeleri ve özetler
• Otomatik iş akışlarından kişisel hatırlatmalar

Alıcılar:

• Manuel/Form tetiklemeli iş akışları → İş akışını tetikleyen kullanıcı
• Zamanlanmış/Webhook/Entegrasyon tetiklemeli iş akışları → İş akışı sahibi

Yapılandırma:

• Mesaj: Bildirim içeriği (değişkenler ve markdown destekler)

Mesaj örneği:

New high-priority support ticket received: Customer:
{{trigger.output.customer_name}}
Issue:
{{agent.output.structured.category}}
Summary:
{{agent.output.structured.summary}}

View ticket:
{{action.output.ticket_url}}

Görüntü üretimi düğümü

Yapay zeka modelleriyle metin istemlerinden görüntüler üretin.

Kullanım senaryoları:

• Pazarlama görseli oluşturma
• Ürün görüntüsü üretimi
• Dinamik içerik görselleri
• Rapor görselleri
• Görüntü üretimi — Yapay zeka görüntü üretimi için tam yapılandırma rehberi

Guardrail'ler düğümü

Otomatik güvenlik kontrolleriyle yapay zeka çıktılarını ve iş akışı verisini doğrulayın.

Kullanım senaryoları:

• İçerik moderasyonu
• PII tespiti
• Halüsinasyon tespiti
• Jailbreak önleme
• Özel doğrulama kuralları
• Guardrail'ler — İçerik doğrulama için tam yapılandırma rehberi

Dosya arama düğümü

İlgili bilgiyi almak için klasörlerinizde arama yapın.

Kullanım senaryoları:

• Bilgi merkezi sorguları
• RAG (Retrieval Augmented Generation)
• Belge arama
• Bağlam zenginleştirme
• Dosya arama — Klasör araması için tam yapılandırma rehberi

Gecikme düğümü

İş akışı yürütmesini belirtilen süre boyunca duraklatın.

Kullanım senaryoları:

• API hız sınırlama
• Geri çekilmeli yoklama
• Harici süreçleri bekleme
• Yeniden deneme gecikmeleri
• Gecikme — İş akışı gecikmeleri için tam yapılandırma rehberi

Hızlı başvuru

Sonraki adımlar

Kullanılabilir tüm düğümleri anladığınıza göre oluşturmaya başlayın:

• Başlarken rehberi — İlk iş akışınızı 15 dakikada oluşturun
• Kullanım senaryoları — Gerçek dünya iş akışı örneklerini görün
• Başlarken — İlk iş akışınızı oluşturun
• Temel kavramlar — Düğümlerin birlikte nasıl çalıştığını öğrenin