Yapay Zeka Aracılığıyla Aksiyon Oluşturma

Create from a blank kartına tıkladığınızda Create an AI Action tanıtım ekranı açılır. Bu ekranda:

• Akışı özetleyen üç adımlı bir görsel şema yer alır.
• Start Building butonuna tıklayarak düzenleme ekranına geçilir.

Custom şablonu ile kişiselleştirilmiş AI aksiyonları oluşturabilirsiniz. İstenilen AI template açıklamasını yazdığınızda buna göre hızlıca bir template oluşturulur ve gerekli promptlar otomatik olarak yazılır.

Düzenleme Ekranı

Start Building sonrası (veya bir şablon EDIT ile açıldığında) açılan ekranda:

• Sol üstte geri dönüş oku, aksiyonun adı (açılır liste ile değiştirilebilir) ve yanında bir düzenleme (kalem) ikonu bulunur.
• Sağ üstte SAVE butonu (yanında ek seçenekler için açılır ok) yer alır.
• Sağ panelde AI Action başlığı altında Parameters ve Model Settings olmak üzere iki sekme bulunur; en sağ üstte Reset bağlantısı ile yapılan değişiklikler geri alınabilir.

Choose LLM Model

Ekranın en üstünde yer alır. Hangi modellerin dosya yükleme (file upload) desteklediği bir bilgi notu olarak gösterilir: "These models support file upload: Gemini 2.5 Flash, Gemini 2.5 Pro, GPT 5, GPT 5 Mini, GPT 5.1, GPT 5.2, GPT 5.4, GPT 5.4 Mini." Sağ tarafta model seçim açılır listesi bulunur (varsayılan: Gemini 2.5 Flash). AI Actions veri kaynağında GPT-5, GPT-5 Mini, GPT-5 Nano, GPT-5.1, GPT-5.2, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, Gemini 2.5 Flash, Gemini 2.5 Flash Image, Gemini 2.5 Flash Lite, Gemini 2.5 Pro, GPT Image 1 ve Veo 3.1 modelleri arasından seçim yapabilirsiniz.

User Prompt ve System Prompt

Bu iki alan yan yana (User Prompt solda, System Prompt sağda) konumlanır:

• User Prompt: Kullanıcıdan alınacak girdiyi temsil eder. Kullanıcının yapay zekaya ne sormak istediğini bu alanda belirtir. Örneğin:
  

Bir low-code geliştirme ortamında (Kuika) çalışan bir AI Action asistanısın. Görevin, kullanıcıdan gelen fiş/fatura görselini analiz ederek belirli alanları çıkarmak ve yapılandırılmış (JSON) formatta döndürmektir.Görev Türü: Bilgi Çıkarımı (Information Extraction) — Görsel tabanlı yapılandırılmış veri çıkarma‍Girdi:* {{receipt_image}} — Kullanıcının yüklediği fiş/fatura görseli (base64 veya dosya referansı)Çıkarılacak Alanlar:* tax_amount — Fişte belirtilen toplam vergi/KDV tutarı (yalnızca sayısal değer, para birimi sembolü olmadan)* serial_number — Fişin seri numarası, fatura numarası veya fiş üzerindeki mali belge numarası* total_amount — Ödenen nihai toplam tutar (yalnızca sayısal değer, para birimi sembolü olmadan)Kurallar:* Yalnızca geçerli bir JSON nesnesi döndür; açıklama, giriş cümlesi veya markdown biçimlendirmesi (```json gibi) ekleme.* Bir alan fişte bulunamıyorsa değerini null olarak ayarla.* tax_amount ve total_amount alanlarını sayı (string değil) olarak, en fazla 2 ondalık basamakla döndür.* serial_number alanını, fişte yazıldığı şekliyle (harfler, tireler, başındaki sıfırlar dahil) string olarak döndür.* Fişte birden fazla vergi satırı varsa (örn. farklı KDV oranları), bunları tek bir tax_amount değerinde topla; ancak zaten birleşik bir "Toplam Vergi" satırı varsa doğrudan o değeri kullan.* Tahmin veya varsayım yapma. Okunamayan veya eksik alanlarda null kullan.Çıktı Formatı:{  "tax_amount": <sayı veya null>,  "serial_number": "<string veya null>",  "total_amount": <sayı veya null>}‍Örnek Çıktı:{  "tax_amount": 18.45,  "serial_number": "FS-2026-004821",  "total_amount": 205.00}Girdi/Çıktı Formatı Açıklaması:* Girdi: Tek bir fiş/fatura görseli (JPEG, PNG veya PDF sayfası olarak).* Çıktı: Üç alan içeren tek seviyeli bir JSON nesnesi (tax_amount, serial_number, total_amount). Ek alan, metin veya açıklama içermez; doğrudan bir sonraki AI Action adımına veya veri kaynağına aktarılmaya hazırdır.

• System Prompt: Yapay zekaya verilecek arka plan talimatıdır. Bu alan, modelin nasıl davranması gerektiğini tanımlar (örneğin: "Sen bir hukuk uzmanısın." gibi). Yani yapay zekânın rolünü belirler. Örneğin: "Extract specific information from an image of a receipt. The required fields are tax amount, serial number, and total amount. Return the extracted data as a valid JSON object following specific formatting rules."
  
  

Sample Output Data

"Choose how the AI should return its response. Either as plain text or select JSON to design your own structured data for detailed results." açıklamasıyla, çıktı formatı JSON veya Text sekmeleri arasından seçilir:

• JSON: Yapay zekâdan yapılandırılmış veri bekleniyorsa seçilir. Bu seçenek kullanıldığında, satır numaralı bir kod editörü açılır ve beklenen JSON yapısı ile alanları önceden tanımlanabilir (örn. tax_amount: 5.00, serial_number: "INV-00012345", total_amount: 50.00), böylece model çıktıyı belirlenen şemaya uygun şekilde üretir. Editörün sağ üstünde geri al/ileri al ve ayarlar ikonları bulunur.
• Text: Serbest metin (doğal dil) çıktılar için kullanılır.

Sağ Panel — Parameters Sekmesi

Seçilen modele göre otomatik olarak gelen parametreler burada listelenir:

• GeminiFileParameter: Dosya bazlı girdi sağlamak için kullanılır. Veri tipi açılır listeden seçilir (örn. String). "Allow file upload" aktif olduğunda, bir cihazdan görsel veya dosya yüklenebilir ve bu dosya Binary (Bytea) formatında modele iletilir. Pasif durumdayken yalnızca metin tabanlı (String) parametreler kullanılır.
• Unknown: Bilinmeyen veya tanımsız veri tipi.
• Boolean: Doğru/yanlış (true/false) değeri.
• Bytea: Binary veri (örneğin resim, dosya vs.).
• Byte: 0–255 arası tamsayı değeri.
• DateTimeOffset: Tarih ve saat bilgisi.
• Decimal: Ondalıklı sayı.
• Double: Daha büyük ondalıklı sayı.
• Guid: Benzersiz kimlik (UUID).
• Int16: Küçük tamsayı değeri.
• Int32: Orta boy tamsayı.
• Int64: Büyük tamsayı.
• Single: Küçük ondalıklı sayı.
• String: Metin (yazı) değeri.

Sağ Panel — Model Settings Sekmesi

• Temperature: Yapay zekanın üretkenliğini belirleyin (0 = tutarlı, 1 = rastgele yanıtlar).
• Maksimum Uzunluk: Yapay zekanın oluşturacağı içeriğin uzunluğunu token bazında belirleyin.
• Durma Dizileri: Yanıtın belirli bir noktada durmasını sağlayacak kelime veya kelime dizisi ekleyin.
• Top P: Modelin çıktı üretirken kullanacağı kelime havuzunun genişliğini kontrol eder. 0 ile 1 arasında bir değer alır. Düşük değerler, modelin yalnızca en olası ve mantıklı kelimeler arasından seçim yapmasını sağlar; yüksek değerler ise daha geniş ve çeşitli bir kelime havuzundan seçim yapılmasına olanak tanır.
• Frequency Penalty: Tekrar eden kelimeleri azaltmak için kullanılır.
• Presence Penalty: Yeni içerik oluşturmayı teşvik eder.
• Reset to Defaults: Değişiklik yapılan parametrelerde aksiyonun ilk oluşturulmuş parametrelere dönmesini sağlar.

Son olarak, sol üstteki SAVE butonuna tıklayın ve AI aksiyonunuzu oluşturun.