Düğümler

Düğüm kataloğu, paletin üç sekmesine yayılmış 36 düğüm türü içerir: Tetikleyiciler, Aksiyonlar (tasarım ve AI aksiyonları dahil) ve Kurallar (mantık, zamanlama ve akış kontrolü). Her düğüm tümüyle yapılandırılabilir ve tuvale yerleştirdiğin anda doğrulanır. Bazı aksiyon düğümleri gerçekten çalışır; birkaçı ise yürütücüsünden önce katalogda yer alır ve başarılıymış gibi davranmak yerine dürüstçe "henüz bağlı değil" adımını kaydeder, aşağıdaki Çalışma durumu sütununa bak.

Hızlı bakış

1. İhtiyacına uyan palet sekmesini aç: Tetikleyiciler, Aksiyonlar veya Kurallar.
2. Düğümü tuvale sürükle.
3. Alanlarını denetçide yapılandır.
4. Bir aksiyon düğümünün gerçek dünyadaki etkisine güvenmeden önce aşağıdaki tablolara bak.

Ayrıntılı başvuru

Tetikleyiciler

Bir grafiği tam olarak bir tetikleyici düğümü başlatır. Her birinin gerçekte nasıl tetiklendiğini görmek için bkz. Tetikleyiciler.

Düğüm	Bir çalışmayı ne başlatır
Manuel başlat	Sen, oluşturucunun Test düğmesinden
Zamanlanmış	Aralıklı, günlük veya haftalık bir ritim
Gelen webhook	Otomasyonun kendi URL'ine yapılan bir çağrı
Tasarım oluşturuldu	Yeni bir tasarım oluşturulur
Tasarım güncellendi	Bir tasarım kaydedilir
Tasarım paylaşıldı	Bir tasarım paylaşılır veya yayınlanır
Tasarım indirildi	Bir tasarım indirilir
Parça etiketlendi	Bir parçaya etiket eklenir, isteğe bağlı olarak tek bir etikete filtrelenir
Marka uygulandı	Bir tasarıma marka kiti uygulanır
Varlık yüklendi	Medya kütüphanesine bir dosya eklenir
AI üretimi bitti	Bir AI üretimi tamamlanır
Klasöre yeni iş	Seçilen bir klasöre bir proje eklenir

Tasarım aksiyonları

Düğüm	Ne yapar	Alanlar	Çalışma durumu
Parça seç	Bir proje, ardından içindeki bir parça seç (sayfa, çerçeve veya slayt); sonraki adımlar bunun üzerinde çalışır	Parça (parça seçiciyi açar)	Gerçekten çalışır
Durum / klasör ayarla	Tasarımın durumunu değiştir ve/veya onu bir klasöre taşı	Durum, Klasör	Gerçekten çalışır
Parçayı yayınla	Seçilen parçayı topluluk şablonu olarak yayınla	yok	Henüz bağlı değil
Tasarımı çoğalt	Seçilen tasarımın bir kopyasını oluştur	yok	Henüz bağlı değil
Kapak üret	Seçilen parça için bir kapak veya küçük resim üret	yok	Henüz bağlı değil

AI aksiyonları

Uygulamanın başka yerlerinde de kullanılan kendi AI sağlayıcı anahtarın üzerinden çalışır; bkz. Kendi AI anahtarını getir.

Düğüm	Ne yapar	Alanlar	Çalışma durumu
AI metin üret	Bir LLM ile metin yazar	AI ayarları (düğümden açılır)	Bağlı herhangi bir AI anahtarıyla gerçekten çalışır; yoksa atlanan bir adım kaydeder
AI görsel üret	Metinden görsel	AI ayarları (düğümden açılır)	OpenAI uyumlu bir anahtarla gerçekten çalışır; başka bir sağlayıcı ya da anahtar yoksa atlanan bir adım kaydeder
AI video üret	Metinden video	AI ayarları (düğümden açılır)	Bugün her zaman atlanan bir adım kaydeder; anahtar yapılandırılmış olsa bile video henüz bir sağlayıcıya bağlı değil
AI beceri çalıştır	Bir AI Studio becerisi çalıştırır	AI ayarları (düğümden açılır)	Görsel üreten bir beceri için AI görsel üret ile aynı; video üreten bir beceri her zaman atlanan bir adım kaydeder

Bildirim aksiyonları

Düğüm	Ne yapar	Alanlar	Çalışma durumu
Uygulama içi bildirim	Çalışma alanında bir bildirim oluşturur	Mesaj	Gerçekten çalışır
Webhook gönder	Bir URL'e POST isteği gönderir	URL	Gerçekten çalışır
Slack / Discord	Gelen bir webhook aracılığıyla mesaj paylaşır	Webhook URL, Mesaj	Gerçekten çalışır
Denetim kaydı	Denetim günlüğüne bir satır ekler	yok	Gerçekten çalışır
E-posta gönder	Bir e-posta gönderir	Alıcı, Konu, İçerik	Çalışma alanında yapılandırılmış SMTP bağlantısı üzerinden gerçekten çalışır; bağlantı yoksa atlanan bir adım kaydeder
Takvime ekle	Çalışma alanı takvimine bir etkinlik ekler	Başlık	Gerçekten çalışır; portal takviminin etkinlik akışına düşer

Kurallar ve mantık

Buradaki her düğüm doğrudan çekirdek motor tarafından işlenir, bu yüzden hepsi gerçekten çalışır.

Düğüm	Ne yapar	Alanlar
Koşul (Evet/Hayır)	Bir koşula göre akışı iki dala böler	Koşullar
Filtrele	Bir koşul karşılanmazsa akışı durdurur	Koşullar
Zaman gecikmesi	Devam etmeden önce bekler	Miktar, Birim (dakika, saat, gün)
Tarihe kadar bekle	Belirli bir tarih ve saate kadar bekler	Tarih
Değişken ayarla	Sonraki adımlar için çalışmanın bağlamına bir değer yazar	Anahtar, Değer
İfade / şablon	Önceki çıktılardan bir değer oluşturur	Şablon
HTTP isteği	Bir URL'i çağırır ve yanıtı saklar	URL, Yöntem, Gövde
Boş adım	Hiçbir şey yapmaz; akışı ilerleten bir geçiş adımı	yok
Çıkış	Otomasyonu sonlandırır	yok

Şablonlar ve koşullar

Çoğu metin ve metin alanı, İfade / şablon düğümü ve çeşitli bildirim alanları çift süslü parantezli yer tutucuları kabul eder; {{ context.someKey }} biçiminde yazılan bu yer tutucular, önceki düğümlerin çalışmaya yazdığı verilerden, örneğin seçtiğin parçadan veya bir AI ile üretilmiş metin bloğundan değer çeker.

Koşul (Evet/Hayır) ve Filtrele ise bunun yerine yapılandırılmış bir kural oluşturur: bir alan, bir karşılaştırma (eşittir, içerir, ile başlar, büyüktür, boştur ve alanın veri türüne göre daha fazlası) ve bir değer seç. Kuralın her iki tarafı da çalışmanın bağlamına aynı şekilde başvurabilir, örneğin {{ context.status }} değerini approved gibi sabit bir değerle karşılaştırabilirsin. Boş bir kural her zaman geçer, bu yüzden yepyeni bir Koşul veya Filtrele düğümü, sen yapılandırana kadar her şeyi geçirir.

Nasıl kullanılır

Adım adım: bir HTTP isteği adımını yapılandır

1. Kurallar sekmesinden HTTP isteği düğümünü tuvale sürükle ve göndermen gereken veriyi üreten düğümün ardına bağla.
2. Yöntem (GET, POST, PUT, PATCH veya DELETE) ve URL değerlerini ayarla; URL alanı, herhangi bir metin alanı gibi {{ context.x }} kabul eder.
3. Kimlik doğrulamayı seç: Yok, Bearer token, Basic (user:pass) veya özel bir başlık, sonra beliren ilgili değer alanını doldur.
4. Gövde taşıyan bir yöntem için bir Gövde türü (JSON, form veya ham metin) seç ve gerektiğinde yer tutucularla birlikte Gövdeyi yaz.
5. Yanıt değişkenini varsayılan __http olarak bırak ya da yeniden adlandır, sonra sonucu akışın ilerisinde kullan, örneğin {{ context.__http.status }} ya da {{ context.__http.body }} içine gömülü bir değer.

Adım adım: bir Slack veya Discord kanalına bildir

1. Hedef uygulamada, mesaj paylaşmak istediğin kanal için gelen bir webhook oluştur ve URL'ini kopyala.
2. Slack / Discord düğümünü tuvale sürükle (Aksiyonlar > Bildirim) ve o URL'i Webhook URL alanına yapıştır.
3. Mesajı yaz; önceki düğümlerin ürettiği herhangi bir şeyi eklemek için {{ context.x }} kullan.
4. İsteğe bağlı olarak Kullanıcı adı ve İkon emoji ayarla; böylece otomatik mesajlar yoğun bir kanalda kolayca ayırt edilir.
5. Otomasyonu bir kez test et; başarısız bir gönderim, sessiz bir boş işlem olarak değil, HTTP durumu eklenmiş bir error adımı olarak görünür.

Sık yapılan işler

• Her hafta içi sabahı tetikle. Bir Zamanlanmış tetikleyicide Sıklık'ı Cron'a, ifadeyi 0 9 * * 1-5 değerine ve saat dilimini örneğin Europe/Istanbul olarak ayarla. Cron modu bir telafi işaretçisi tutar, böylece kaçırılan bir dakika (bir dağıtım, soğuk başlangıç) sessizce kaybolmak yerine, işaretçi ona ulaşır ulaşmaz yine de bir kez tetiklenir.
• Yalnızca imzalı webhook çağrılarını kabul et. Gelen webhook tetikleyicisinin HMAC gizli anahtarını doldur; çağıran taraf bunun üzerine ham gövdeye göre hesaplanan bir X-Signature: sha256=... başlığı göndermelidir, aksi halde hiçbir şey çalışmadan önce çağrı 401 ile reddedilir.
• Onaydan sonra bir parçayı incelemeye taşı. Parça seç düğümünü Durum / klasör ayarla düğümüne zincirle, Durum'u "İncelemede" olarak ayarla; bu, editörün kendi durum kontrolünün kullandığı güncelleme yolunu çağırır.
• Bir başlık veya özet taslağı hazırla. Bir AI metin üret düğümünün istemi, önceki bağlama doğrudan başvurabilir, örneğin başka bir AI adımının ardından zincirlenmiş Bunu tek cümlede özetle: {{ context.__aiText }}.
• Harici bir API'yi çağır ve yanıta göre hareket et. Bir HTTP isteği düğümü (Kurallar sekmesi) Bearer/Basic/özel başlık kimlik doğrulaması ayarlayabilir, yanıtını bir değişkene yazabilir (varsayılan __http) ve hemen ardındaki bir Filtrele düğümü bu yanıta göre kapı görevi görebilir, örneğin yalnızca çağrı başarılı olduğunda devam edebilir.
• Giden bir webhook'u imzala. Webhook gönder aksiyonunun Gizli anahtar alanı doldurulursa istek gövdesini HMAC-SHA256 ile imzalar ve İmza başlığı (varsayılan X-Signature) adlı başlıkta gönderir, böylece alıcı taraf çağrının gerçekten senin otomasyonundan geldiğini doğrulayabilir.
• Birkaç bağlam değerini tek bir dizeye birleştir. Birden çok Değişken ayarla düğümü yerine İfade / şablon kullan, örneğin Şablon alanına bir kez yazılan {{ context.name }} <{{ context.email }}>, sonra sonucu akışın ilerisinde {{ context.__expr }} olarak kullan.
• Bir bildirimi ilgili işe bağla. Uygulama içi bildirim düğümünün Bağlantı alanı /works/<id> gibi bir yol kabul eder, böylece çalışma alanında bildirime tıklamak ekibini doğrudan ilgili projeye götürür.
• Bir çalışmayı, başarısızlık sayılmadan erken durdur. Düşürmek istediğin durumlarda yanlış olan bir kurala sahip bir Filtrele düğümü zincirle; filtrelenen bir çalışma, Çalışmalar'da Başarısız değil Çıkıldı olarak görünür ve filtreden sonrası çalışmaz.

Sorun giderme

• Bir düğümün adımı Aktivite'de skipped gösteriyor. Bu ya kasıtlı bir filtredir (koşulu başarısız olan bir Filtrele düğümü), ya yürütücüsü gerçekten henüz bağlı olmayan bir düğümdür (yukarıdaki "Çalışma durumu" sütunlarına bak), ya da henüz üzerinde çalışacağı bir şey olmayan bir aksiyondur (SMTP bağlantısı olmayan e-posta, uygun anahtarı olmayan AI). Bunların hiçbiri bir hata değildir; çalışma yine de kendisinden sonra gelene devam eder.
• Bir aksiyon düğümü aynı adımda sürekli başarısız oluyor. Denetçisinin Ayarlar sekmesini aç ve bir yeniden deneme sayısı ve bekleme süresi ayarla ya da Hata durumunda seçeneğini Devam et olarak değiştir; böylece grafiğin geri kalanı yine de çalışır; bkz. İş akışı oluşturma.
• Koşulum bir türlü geçmiyor (ya da bir türlü başarısız olmuyor). Okuduğu alanın gerçekten bir şeye çözümlendiğini kontrol et: bir {{ context.x }} yolundaki yazım hatası ya da kendisi atlanmış bir üst düğüm, ikisi de değeri boş bırakır ve "boştur" dışındaki çoğu karşılaştırma boş bir değere karşı başarısız olur.
• Bir çalışma hiç başlamadı. Bu düğüm düzeyinde değil, tetikleyici düzeyinde bir sorudur; bekleme, sessiz saatler ve Aktif durum tuzakları için bkz. Tetikleyiciler.
• Durum / klasör ayarla "önce bir parça seç" kaydeder ve atlar. Bu düğüm, aynı çalışmada daha önce bir Parça seç düğümünün seçtiği parça üzerinde çalışır. Grafikte kendisinden önce böyle bir düğüm yoksa üzerinde çalışacağı bir şey olmaz, bu yüzden her zaman o mesajla atlar.
• "Parçayı yayınla", "Tasarımı çoğalt" veya "Kapak üret" bir türlü bir şey yapmıyor gibi. Bu üç tasarım aksiyonu hâlâ yürütücülerinin önündedir; tıpkı bağımlılığı yapılandırılmamış bir AI veya e-posta düğümü gibi her zaman atlanan bir adım kaydeder ve geçer. Bunlar üzerinde yapılandırdığın hiçbir şey bugün bunu değiştirmez.
• Bir Slack gönderisi ya da giden bir webhook sessizce ulaşmadı. Önce Son adım kayıtlarındaki girişini kontrol et. Bozuk veya süresi dolmuş bir gelen webhook URL'i ya da 2xx dışı bir durum döndüren bir hedef, gizli bir başarısızlık olarak değil, mesajında yanıt durumu bulunan bir error adımı olarak görünür.

İpuçları

Atlanmış bozuk demek değildir

"Henüz bağlı değil" olarak işaretlenen bir düğüm bir hata değildir. Çalışma yine de içinden geçer, dürüst bir "skipped" adımı kaydeder ve bir sonraki düğüme devam eder, böylece o düğümün yürütücüsünü beklerken grafiğinin geri kalanı çalışmaya devam eder.

Koşul ile filtreyi birleştir

İki farklı yola ihtiyacın olduğunda (evet ve hayır) Koşul kullan; sadece uygun olmayan bir çalışmayı durdurmak istediğinde Filtrele kullan.

İlgili

• İş akışı oluşturma
• Tetikleyiciler
• Çalıştırma ve izleme
• Kendi AI anahtarını getir