2. Ana Düğümler

Ana düğümler, SkyStudio iş akışlarının yapı taşlarıdır. Girdi almak, çıktı vermek, akışı dallandırmak, dış servislere istek göndermek ve akışı tetiklemek için kullanılırlar. Bu düğümlerin çoğu kimlik bağlantısı gerektirmez — doğrudan akışın içinde çalışırlar.

Düğüm kataloğunda Düğümler sekmesi altında yer alırlar.

Ortak Panel Yapısı​

Bütün ana düğümlerin sağ paneli aynı düzendedir:

Not: Düğümleri canvas'ta sürükleyerek bağlayabileceğiniz gibi, panelin altındaki Sonraki düğüme yönlendir açılır menüsünden de hedef düğümü seçebilirsiniz.

Parametre Alanlarına Veri Aktarma​

Parametre alanlarının sağında "/ ile parametre ekleyin" yazısını gördüğünüz her yerde, alana tıklayıp / tuşuna basarak önceki düğümlerin çıktısını seçebilirsiniz.

Referanslar şu biçimde yazılır:

{{düğüm-id.output.field}}
{{output.field}}

Girdiler​

Metin Girişi​

Akışı başlatan ve kullanıcıdan metin alan düğümdür. Çoğu iş akışının ilk adımıdır.

Parametreler​

Kullanım Örneği​

Bir toplantı notu özetleme akışında ilk adım olarak eklenir. Kullanıcı akışı çalıştırdığında bu düğüme metin yapıştırır.

Örnek Çıktı​

{
  "text": "Toplantıda Q3 bütçesi görüşüldü. Pazarlama bütçesi %15 artırıldı."
}

Not: Panelde girdiğiniz metin test amaçlıdır. Akış yayınlanıp çalıştırıldığında kullanıcının girdiği değer kullanılır.

Dosya Girişi​

Kullanıcıdan dosya alarak akışı başlatır. PDF, Excel, görsel gibi dosyaları işleyen akışların ilk adımıdır.

Parametreler​

Kullanım Örneği​

Dosya Girişi → Excel Oku → Veri Analizi → Metin Çıktısı

Örnek Çıktı​

{
  "file_name": "satislar-agustos.xlsx",
  "file_size": 48213,
  "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "content": "<base64-icerik>"
}

Not: Dosya içeriğini okumak için bu düğümün çıktısını Excel Oku, Dosyadan Tabloya veya Veri Analizi gibi bir işleme düğümüne bağlamanız gerekir.

Çıktılar​

Metin Çıktısı​

Akışın sonucunu kullanıcıya döndürür. Akıştaki veriden hangi kısmın gösterileceğini siz seçersiniz.

Parametreler​

Kullanım Örneği​

Sadece LLM'in ürettiği özeti göstermek için:

• Çıktı Metni: Alana tıklayıp / tuşuna basın ve LLM düğümünün çıktısını seçin

Sabit metinle birleştirmek için:

Analiz tamamlandı. Sonuç: {{output.answer}}

Not: Bir akışta birden fazla Metin Çıktısı kullanabilirsiniz. If-Else ile dallanan akışlarda her dalın sonuna ayrı bir çıktı düğümü koymak yaygın bir yöntemdir.

Tetikleyiciler​

Webhook​

Dış bir sistemden gelen HTTP çağrısıyla akışı otomatik olarak başlatır. Kullanıcı müdahalesi olmadan çalışan otomasyonların başlangıç noktasıdır.

Parametreler​

Nasıl Kullanılır​

1. Akışa Webhook düğümünü ekleyin ve akışı Yayınla ile canlıya alın.
2. Düğüm panelinde görünen Webhook URL değerini kopyalayın.
3. Bu adresi tetikleyecek sisteme (Jira otomasyonu, form servisi, kendi uygulamanız) verin.
4. O sistem adrese istek gönderdiğinde akış otomatik çalışır.

Gelen Veriye Erişim​

Webhook'a gönderilen JSON gövdesine sonraki düğümlerde / ile erişirsiniz:

{{webhook.body.customer_name}}
{{webhook.body.order_id}}

Not: Webhook URL'i yalnızca akış yayınlandıktan sonra çalışır. Taslak durumundaki akışlar dışarıdan tetiklenemez.

Mantık​

If-Else Koşulu​

Bir koşula göre akışı iki farklı yola ayırır. Koşul sağlanırsa yeşil (True), sağlanmazsa kırmızı (False) çıkışından devam eder.

Parametreler​

Kullanılabilir Operatörler​

Çıkış Portları​

Her iki porta da ayrı düğümler bağlayarak farklı işlemler yaptırabilirsiniz.

Birden Fazla Koşul​

+ Koşul Ekle butonuyla ek koşullar tanımlayabilirsiniz. Tüm koşullar birlikte değerlendirilir.

Kullanım Örneği​

Sadece acil destek taleplerini yöneticiye bildirmek için:

• Koşullar: / ile Freshdesk düğümünün priority çıktısını seçin
• Operatör: Eşittir
• Değer: 4

True dalına Slack mesajı, False dalına normal kayıt düğümü bağlayın.

Not: Uzun metinler veya {{...}} ifadeleri Değer alanında satır kırarak görünür. Alanın sağ alt köşesinden dikey boyutu artırabilirsiniz.

Eylemler​

HTTP Çağrısı​

Herhangi bir API'ye HTTP isteği gönderir ve yanıtı akışa aktarır. SkyStudio'da hazır düğümü olmayan servislere tek seferlik istek göndermenin en hızlı yoludur.

Parametreler​

URL'de Değişken Kullanma​

URL içinde önceki düğümlerden gelen değerleri kullanabilirsiniz:

https://api.example.com/users/{{userID}}/data?workspace={{workspaceID}}

Headers Örneği​

{
  "Content-Type": "application/json",
  "Authorization": "Bearer {{token}}"
}

Body Örneği​

{
  "user_id": "{{userID}}",
  "workspace": "{{workspaceName}}",
  "name": "{{output.name}}"
}

Metot Seçimi​

Not: Sistem koruması gereği yanıtlar 500 KB ile sınırlandırılmıştır. Daha büyük yanıt döndüren API'lerde sayfalama parametrelerini kullanarak veriyi parçalayın.

HTTP Çağrısı mı, REST API (Generic) mi?​

Site Haritalayıcı​

Bir web sitesinden içerik çıkarır ve yapılandırılmış veri olarak döndürür. Rakip takibi, fiyat izleme ve içerik toplama senaryolarında kullanılır.

Parametreler​

Kullanım Örneği​

Rakip fiyat sayfasını izlemek için:

• URL: https://rakip.com/fiyatlar
• Derinlik: 1
• Maksimum Sayfa: 10

Not: Yalnızca herkese açık sayfalar taranabilir. Giriş gerektiren sayfalar için önce HTTP Çağrısı ile oturum açmanız gerekir.

Veri Analizi​

Arka planda kod çalıştırarak veriyi analiz eder. İstatistik hesaplama, gruplama ve özetleme işlemleri yapar.

Parametreler​

Kullanım Örneği​

Dosya Girişi → Excel Oku → Veri Analizi → Metin Çıktısı

Analiz Talimatı: Ürün grubuna göre toplam satışı hesapla ve en çok satan 5 ürünü listele

Not: Daha gelişmiş analiz, tahmin ve makine öğrenmesi için Python düğümünü kullanın.

Araçlar​

Not​

Canvas üzerine açıklama notu ekler. Akışı çalıştırmaz; yalnızca görsel bir açıklamadır.

Parametreler​

Ne İçin Kullanılır​

• Akışın hangi işi yaptığını açıklamak
• Bir düğüm grubunun ne yaptığını belirtmek
• Ekip arkadaşlarınıza uyarı veya hatırlatma bırakmak
• Geçici olarak devre dışı bıraktığınız bölümleri işaretlemek

Not: Not düğümünü alt araç çubuğundaki sayfa ikonuna tıklayarak da hızlıca ekleyebilirsiniz.

Sık Karşılaşılan Hatalar​

Notlar​

• Ana düğümlerin çoğu kimlik bağlantısı gerektirmez; doğrudan akışın içinde çalışırlar.
• Her düğümün panelinde en altta Düğüm ID görünür; hata ayıklarken ve {{düğüm-id.output.field}} referansı yazarken işinize yarar.
• Metin Girişi panelindeki metin test amaçlıdır; yayınlanan akışta kullanıcının girdiği değer kullanılır.
• Webhook düğümü yalnızca akış yayınlandıktan sonra dışarıdan tetiklenebilir.
• If-Else düğümünün iki çıkışı vardır; her ikisine de düğüm bağlamayı unutmayın, aksi halde bir dal sonuçsuz kalır.
• HTTP Çağrısı yanıtları 500 KB ile sınırlıdır; büyük veri setlerinde sayfalama kullanın.
• Not düğümü akışın çalışmasını etkilemez; karmaşık akışlarda belgeleme için kullanın.
• Düğümleri anlamlı adlarla isimlendirmek, / menüsünde doğru çıktıyı bulmayı kolaylaştırır.