Save Action Source aksiyonu, Kuika platformunda bir aksiyon sonucunda üretilen veriyi (Action Result) Qdrant vektör veri koleksiyonuna kaydetmek için kullanılır. Özellikle Save Source aksiyonu ile yüklenen dokümanlar veya farklı aksiyon çıktıları üzerinden üretilen verilerin kalıcı olarak saklanması ve güncellenmesi senaryolarında tercih edilir.

Bu aksiyon sayesinde:

• Action Result içindeki veriler vektör olarak indekslenebilir,
• Mevcut kayıtlar güncellenebilir,
• Koleksiyonlar temizlenerek yeniden oluşturulabilir,
• Belirli alanlar Primary Key olarak belirlenerek veri bütünlüğü sağlanabilir.

Bu aksiyon hem web hem de mobil uygulamalarda kullanılabilir.

Teknik Özellikler

• Action Result Tabanlı Kayıt: Başka bir aksiyonun çıktısını doğrudan veri kaynağı olarak kullanır.
• Update Strategy Desteği: Clean & Insert veya Insert or Update stratejileri ile veri güncelleme kontrolü sağlar.
• Vector Field Seçimi: Vektörleştirilecek alanlar manuel olarak seçilebilir.
• Primary Key Tanımı: Veri tekrarını önlemek için bir veya birden fazla alan Primary Key olarak belirlenebilir.
• Opsiyonel Koleksiyon Yönetimi: collectionName ve Metadata Fields parametreleri ile gelişmiş kontrol sağlanır.

Save Action Source Aksiyonu Uygulama Adımları

Aksiyonu Ekleme

1. Kuika platformuna giriş yapın ve projenizi açın.
2. UI Design modülüne geçin.
3. Sağ kenardaki Properties panelini açın.

• ADD ACTION menüsünden ilgili tetikleyiciyi seçin (örneğin: OnClick veya Initial Action).

4. VectorSearch → Save Action Source aksiyonunu seçin.

Parametreleri Yapılandırma

Select Action (Zorunlu)

Kaydedilecek verinin üretildiği aksiyonu seçin. Örneğin:

• SaveSource
• Search
• GetSource
• Başka bir özel aksiyon sonucu

Seçilen aksiyonun Action Result çıktısı veri kaynağı olarak kullanılır.

Update Strategy

İki farklı strateji bulunmaktadır:

Clean & Insert

• Mevcut koleksiyonu temizler.
• Yeni veriyi baştan yükler.
• Tam senkronizasyon senaryolarında önerilir.

Insert or Update

• Primary Key’e göre kontrol yapar.
• Mevcut kayıt varsa günceller.
• Yoksa yeni kayıt ekler.
• Sürekli veri akışı olan sistemlerde önerilir.

Vector Fields

Vektörleştirilerek Qdrant’a kaydedilecek alanları belirler.

Örneğin:

• Message
• Source
• Description
• Content

Bu alanlar embedding işlemine tabi tutulur ve arama altyapısında kullanılır.

Primary Keys

Veri tekrarını önlemek için benzersiz alanları seçmenizi sağlar.

Örneğin:

• Source
• Id
• DocumentId

Insert or Update stratejisi kullanıldığında özellikle önemlidir.

Opsiyonel Parametreler

+ ADD OPTIONAL PARAMETER butonu ile aşağıdaki alanlar eklenebilir:

• collectionName: Verinin kaydedileceği koleksiyon adını belirler. Belirtilmezse varsayılan koleksiyon kullanılır.
• Metadata Fields: Embedding dışındaki alanların metadata olarak saklanmasını sağlar.

Kullanım Senaryosu: Action Result’ı Kalıcı Hale Getirme

Bir kullanıcı, Save Source aksiyonu ile Google Drive’daki dokümanları sisteme yüklemiştir. Bu dokümanların:

• Vektör alanlarını belirlemek,
• Primary Key’e göre güncellemek,
• Belirli koleksiyon altında tutmak

istediğinde Save Action Source aksiyonu kullanılır.

Örneğin:

• Select Action → SaveSource
• Update Strategy → Insert or Update
• Vector Fields → Message, Source
• Primary Keys → Source
• collectionName → googledrive1

Bu yapı sayesinde dokümanlar tekrar yüklenirken mükerrer kayıt oluşmaz.

Aksiyon Sonrası Davranış

Aksiyon çalıştırıldığında:

• Seçilen Action Result alınır,
• Belirlenen alanlar embedding işlemine gönderilir,
• Qdrant koleksiyonuna kaydedilir veya güncellenir,
• Sistem log kayıtları oluşturulur.

Teknik Riskler 

• Yanlış Primary Key Tanımı: Duplicate kayıt oluşabilir.
• Clean & Insert Kullanımı: Mevcut koleksiyondaki tüm veriler silinir.
• Boş Vector Field: Embedding işlemi başarısız olabilir.
• Yanlış Collection Name: Veri farklı koleksiyonlara dağılabilir.