Bilgi ve Veri İşleme Düğümleri

4. Bilgi ve Veri İşleme Düğümleri​

Bilgi kategorisi, iş akışlarında veriyi okuma, dönüştürme, saklama ve sorgulama işlerini yapan düğümleri içerir. Düğüm kataloğunun Düğümler sekmesi altında BİLGİ başlığında yer alırlar ve en kalabalık kategoridir.

Bu düğümlerin çoğu kimlik bağlantısı gerektirmez; SkyStudio'nun kendi veri altyapısı üzerinde çalışırlar.

Düğümler​

Hangi Düğümü Ne Zaman Kullanmalı?​

Tablo İşlemleri​

Dosyadan Tabloya​

Yüklenen bir dosyayı (Excel, CSV) veritabanı tablosuna dönüştürür. Böylece veriyi sorgulanabilir ve tekrar kullanılabilir hale getirirsiniz.

Parametreler​

Kullanım Örneği​

Dosya Girişi → Dosyadan Tabloya → Query → Metin Çıktısı

Dosyadan Tabloya ayarları:

• File: Dosya Girişi çıktısı
• Tablo Adı: satislar_2026

Not: Tablo adında Türkçe karakter ve boşluk kullanmayın; alt çizgi ile ayırın.

JSON'dan Tabloya​

JSON formatındaki veriyi tabloya dönüştürür. API yanıtlarını sorgulanabilir hale getirmek için kullanılır.

Parametreler​

Kullanım Örneği​

HTTP Çağrısı → JSON'dan Tabloya → Veri Analizi

Kök Yol kullanımı: API yanıtı { "data": { "items": [...] } } biçimindeyse Kök Yol alanına data.items yazın.

Tablo Listele​

Veritabanınızdaki tüm tabloları listeler. Hangi tabloların mevcut olduğunu ve isimlerini öğrenmek için kullanılır.

Parametreler​

Örnek Çıktı​

{
  "tables": [
    { "name": "satislar_2026", "row_count": 1248, "created_at": "2026-08-01" },
    { "name": "musteriler", "row_count": 342, "created_at": "2026-07-15" }
  ]
}

Tablo Verisi​

Belirtilen tablodan veri çeker. Daha önce oluşturduğunuz tabloları akışta kullanmak için gereklidir.

Parametreler​

Not: Büyük tablolarda Limit parametresini kullanın; tüm tabloyu belleğe almak akışı yavaşlatır.

Query​

Koleksiyon veya tablo üzerinde filtreli sorgu çalıştırır. Tablo Verisi düğümünden farkı, koşullu filtreleme ve gruplama yapabilmesidir.

Parametreler​

Kullanım Örneği​

• Koleksiyon: satislar_2026
• Sorgu: tutar > 10000 AND bolge = 'Marmara'
• Sıralama: tutar DESC
• Limit: 20

Bilgi Bankası​

Knowledge Save​

Bir dosyayı çalışma alanının bilgi bankasına kaydeder. Kaydedilen dokümanlar ajanlarınız tarafından referans olarak kullanılabilir.

Parametreler​

Kullanım Örneği​

Gelen mail eklerini otomatik olarak bilgi bankasına ekleyen akış:

Mail Ara (Outlook) → Knowledge Save → Mesaj Gönder (Slack)

Not: Bilgi bankasına eklenen dokümanlar, Bölüm 04'te anlatılan ajan Bilgi bölümünden de yönetilebilir.

Knowledge Search​

Çalışma alanının bilgi bankasında yapay zeka destekli arama yapar. Sadece eşleşen metni değil, sorunuza verilen cevabı ve kaynak dokümanı birlikte döndürür.

Parametreler​

Kullanım Örneği​

Şirket içi politika sorularını yanıtlayan chatbot:

Metin Girişi → Knowledge Search → Anthropic API Çağrısı → Metin Çıktısı

Knowledge Search ayarları:

• Sorgu: / ile Metin Girişi çıktısı

Örnek Çıktı​

{
  "answer": "Yıllık izin hakkı 1-5 yıl kıdem için 14 gündür.",
  "sources": [
    { "document": "IK-Politikalari-2026.pdf", "page": 12, "score": 0.94 }
  ]
}

Not: Bu düğüm, kurum içi soru-cevap akışlarının temelidir. Bilgi bankası boşsa sonuç dönmez — önce Knowledge Save ile veya Ayarlar → Bilgi Bankası ekranından doküman ekleyin.

Veri Dönüştürme​

Text2data​

Serbest metinden yapılandırılmış veri çıkarır. Mail içeriği, form yanıtı veya not gibi düz metinleri alan-değer çiftlerine dönüştürür.

Parametreler​

Şema Örneği​

{
  "firma_adi": "string",
  "fatura_no": "string",
  "tutar": "number",
  "tarih": "date"
}

Kullanım Örneği​

Gelen fatura mailinden bilgileri çıkarıp muhasebeye kaydeden akış:

Mail Ara (Outlook) → Text2data → Alış Faturası Oluştur (Paraşüt)

Not: Şemada alan adlarını açık yazın; belirsiz adlar (örn. x, deger) çıkarma doğruluğunu düşürür.

Transform​

Veriyi bir formattan diğerine dönüştürür. Alan adlarını değiştirmek, birleştirmek veya yeniden yapılandırmak için kullanılır.

Parametreler​

Kullanım Örneği​

Excel'deki sütun adlarını CRM alan adlarına eşlemek için:

Ne Zaman Kullanılır​

• İki düğüm arasında alan adları uyuşmadığında
• Tarih veya sayı formatını değiştirmek gerektiğinde
• Birden fazla alanı tek alanda birleştirmek gerektiğinde

Formula​

Hesaplama ve formül işlemleri yapar. Toplama, oran, yüzde ve koşullu hesaplamalar için kullanılır.

Parametreler​

Formül Örnekleri​

Parameter​

Akış içinde kullanılacak sabit bir değişken tanımlar. Aynı değeri birden fazla düğümde kullanacağınızda tek yerden yönetmenizi sağlar.

Parametreler​

Kullanım Örneği​

Akışın birçok yerinde kullanılan bir Jira proje anahtarını tek yerden yönetmek için:

• Parametre Adı: jira_proje
• Değer: ENG

Sonraki düğümlerde / ile bu parametreyi seçersiniz. Proje değiştiğinde yalnızca bu düğümü güncellemeniz yeterli olur.

Save Data​

Akışta üretilen veriyi kalıcı olarak saklar. Sonraki çalıştırmalarda erişilebilir hale getirir.

Parametreler​

Kullanım Örneği​

Her gün çalışan bir akışta önceki günün sonucunu saklayıp karşılaştırma yapmak için kullanılır.

SkyData​

SkyStudio'nun veri servisine erişir. Platform içinde tanımlı veri kaynaklarını sorgulamak için kullanılır.

Parametreler​

Form Builder​

Kullanıcıdan yapılandırılmış girdi toplamak için form üretir. Serbest metin yerine belirli alanların doldurulmasını istediğinizde kullanılır.

Parametreler​

Alan Tipleri​

Loop​

Loop node'u, bir diziyi (ya da sayı aralığını) tek tek gezerek her eleman için başka bir iş akışını çağırmanızı sağlar. Çok sayıda kaydı — örneğin yüzlerce sipariş, müşteri veya satırı — tek tek bir alt iş akışından geçirmek için kullanılır.

Node, her elemanı bir işlem kuyruğuna alır ve anında bir toplu iş kimliği (batchId) döndürür; işlemler arka planda yürütülür. Böylece uzun süren toplu işler iş akışını bekletmez. İlerlemeyi ve sonuçları batchId ile istediğiniz zaman sorgulayabilirsiniz.

Node kataloğunda Düğümler sekmesi altında, Bilgi kategorisinde yer alır.

Bağlantı Kurulumu ve Yönetimi​

Loop node'u, her eleman için çağıracağı hedef iş akışına ait bir çağrı token'ı kullanır. Bu token, çalıştırılacak alt iş akışını belirler.

Başlamadan Önce​

Çağırmak istediğiniz alt iş akışının yayınlanmış olması ve çağrı token'ının alınmış olması gerekir. Token'ı, hedef iş akışının tetikleme (trigger) ayarlarından alın.

Not: Token, çağrılan alt iş akışını belirler. Farklı alt akışları çağıran döngüler için ayrı bağlantılar tanımlayın; bağlantı adında hedefi belirtmek ("Sipariş Döngüsü", "Rapor Döngüsü") karışıklığı önler.

SkyStudio'ya Bağlantı Ekleme​

1. İş akışı canvas'ının alt araç çubuğundaki zincir ikonuna (Uygulama Bağlantıları) tıklayın.
2. + Yeni bağlantı butonuna tıklayın.
3. Sağlayıcı listesinden Loop seçin (Diğer kategorisi altındadır; arama kutusuna loop yazarak da bulabilirsiniz).
4. Aşağıdaki alanları doldurun:

5. Bağlantı ekleyin butonuna tıklayın.

Not: Tüm alanları tek tek doldurmak yerine Ham JSON olarak düzenleyin butonuna tıklayarak yapılandırmayı JSON olarak yapıştırabilirsiniz.

Bağlantıyı Node'a Atama​

Loop node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Alternatif olarak panelde Connection bölümünü açıp Ad ve Workflow Token (Bearer) alanlarını node üzerinde doğrudan doldurabilirsiniz. Bu yöntem test için pratiktir; kalıcı kullanımda kayıtlı bağlantı tercih edilmelidir.

Not: Kuyruk Durumu operasyonu bağlantı gerektirmez. Yalnızca iki "Kuyruğa Al" operasyonunda kimlik bağlantısı seçilmesi gerekir.

Operasyonlar​

Loop node'u 3 operasyon sunmaktadır:

Kuyruğa Al (Dizi)​

Bir diziyi gezer; her eleman için bir işlem başlatır ve anında bir batchId döndürür. Her eleman, alt iş akışına query olarak geçirilir.

Parametreler​

Not: Items ve Payload alanlarının sağında "/ ile parametre ekleyin" yazar. Alana tıklayıp / tuşuna basarak önceki node'ların çıktısını seçebilirsiniz.

Alt İş Akışına Giden Veri​

Her eleman için alt akışa gönderilen gövde şu biçimdedir:

{ "query": <o anki eleman>, ...payload }

Kullanım Örneği​

Items:

[
  { "id": "ORD-001", "musteri": "Eti Gıda", "tutar": 12500 },
  { "id": "ORD-002", "musteri": "Ülker", "tutar": 8300 }
]

Payload:

{ "kaynak": "loop" }

Örnek Çıktı​

{
  "batchId": "batch-ab12-cd34",
  "enqueued": 2,
  "status": "queued"
}

Not: Değişen her veri query içinde olmalıdır; Payload sabit bağlam içindir. Her elemana özel veriyi Payload'a değil, dizinin elemanlarına yazın; alt akışta query'den okunur.

Kuyruğa Al (Sayı Aralığı)​

Bir sayı aralığını (başlangıçtan bitişe, verilen adımla) gezer ve her sayı için alt iş akışını çağırır. Sayfalama (pagination) veya sabit sayıda tekrar için kullanılır.

Parametreler​

Kullanım Örneği​

Başlangıç 1, Bitiş 5, Adım 1 verildiğinde alt akışa sırayla şu gövdeler gönderilir:

{ "query": 1 }
{ "query": 2 }
{ "query": 3 }
{ "query": 4 }
{ "query": 5 }

Sayfalama Örneği​

100 sayfalık bir API'yi gezmek için:

Alt akış, gelen query değerini sayfa numarası olarak kullanır.

Not: Büyük aralıklarda Max Eleman sınırını bilinçli ayarlayın; aralık bu sınırı aşarsa fazlası işleme alınmaz ve çıktıda truncated: true döner.

Kuyruk Durumu​

Bir batchId için toplu işin ilerlemesini ve (istenirse) tek tek sonuçlarını döndürür. Döngünün tamamlanıp tamamlanmadığını izlemek veya sonuçları toplamak için kullanılır.

Bu operasyon kimlik bağlantısı gerektirmez.

Parametreler​

Örnek Çıktı​

{
  "batchId": "batch-ab12-cd34",
  "total": 5,
  "counts": { "done": 4, "failed": 1 },
  "complete": true,
  "results": [
    { "index": 0, "item": { "id": "ORD-001" }, "ok": true, "result": { "ok": true } },
    { "index": 1, "item": { "id": "ORD-002" }, "ok": false, "error": "..." }
  ]
}

Çıktı Alanları​

Not: complete: true olana kadar bu operasyonu belirli aralıklarla çağırarak toplu işin bitmesini bekleyebilirsiniz. Alt iş akışlarınız sonucu kendileri bir yere kaydediyorsa, sonuçları burada ayrıca toplamanıza gerek kalmaz.

Güvenilirlik​

Not: Toplu işin toplam süresi, çağrılan alt iş akışının her bir eleman için harcadığı süreye bağlıdır; Loop node'u bu işi iş akışını bekletmeden arka planda yürütür.

Hızlı Başlangıç Örnekleri​

Örnek 1: Siparişleri Tek Tek İşleme​

Bir tablodaki siparişleri alt akıştan geçiren workflow:

Metin Girişi → Tablo Verisi → Kuyruğa Al (Dizi) → Metin Çıktısı

Kuyruğa Al (Dizi) ayarları:

• Items: / ile Tablo Verisi çıktısını seçin
• Payload: { "kaynak": "gunluk-siparis" }
• Max Eleman: 500

Örnek 2: Sayfalı API'yi Gezme​

100 sayfalık bir API'yi sayfa sayfa çeken workflow:

Webhook → Kuyruğa Al (Sayı Aralığı) → Metin Çıktısı

Kuyruğa Al (Sayı Aralığı) ayarları:

• Başlangıç: 1
• Bitiş (dahil): 100
• Adım: 1

Alt akış, gelen query değerini sayfa numarası olarak kullanarak HTTP Çağrısı yapar.

Örnek 3: Toplu İşi Bekleyip Raporlama​

Döngüyü başlatıp bitmesini bekleyen ve sonucu bildiren workflow:

Kuyruğa Al (Dizi) → Kuyruk Durumu → If-Else Koşulu ─┬─ (True)  → Mesaj Gönder (Slack)
                                                     └─ (False) → Kuyruk Durumu

Kuyruk Durumu ayarları:

• Batch ID: / ile Kuyruğa Al çıktısının batchId alanını seçin
• Sonuçları Dahil Et: Açık

If-Else ayarları:

• Koşullar: / ile complete alanını seçin
• Operatör: Eşittir
• Değer: true

Örnek 4: Hatalı Kayıtları Raporlama​

Toplu iş bittikten sonra başarısız elemanları listeleyen workflow:

Kuyruk Durumu → LLM (hataları özetle) → Mail Gönder (Outlook)

Kuyruk Durumu ayarları:

• Sonuçları Dahil Et: Açık

LLM node'u, results dizisinde ok: false olan kayıtları özetler.

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

Notlar​

• Loop node'u, katalogda Düğümler › Bilgi kategorisinde yer alır; bağlantı sağlayıcısı ise Diğer kategorisindedir.
• Kuyruğa Al operasyonları anında batchId döndürür ve iş akışını bekletmez; işlemler arka planda yürür.
• Kuyruk Durumu operasyonu kimlik bağlantısı gerektirmez.
• Alt iş akışına giden gövdede değişen veri daima query alanındadır; Payload döngü boyunca sabittir.
• Bitiş (dahil) değeri aralığa dahildir: 1–5 aralığı 5 iterasyon üretir.
• Max Eleman varsayılanı 10000'dir; üretim ortamında bilinçli bir sınır belirlemeniz önerilir.
• Farklı alt akışları çağıran döngüler için ayrı Loop bağlantıları tanımlayın; tek bağlantı yalnızca tek bir hedef iş akışını çağırır.
• Döngünün bitmesini beklemek için Kuyruk Durumu + If-Else Koşulu kombinasyonunu kullanabilirsiniz.