1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Üst menüden AI Functions modülüne gidin.

AI Functions ekranına girdiğinizde şu öğelerle karşılaşırsınız:

• Create an AI Action kartı: Yeni bir AI aksiyonu oluşturmaya başlamanızı sağlar.
• Daha önce oluşturulmuş aksiyonlar, kartın altındaki tabloda listelenir. Bu tablo Recently modified ve All Functions olmak üzere iki görünümden oluşur; sağdaki arama kutusuyla (Search by name...) aksiyon adına göre arama yapılabilir, All types açılır listesiyle tür bazında filtrelenebilir ve New folder butonuyla aksiyonları organize etmek için klasör oluşturulabilir.
• Tablo sütunları: Name (aksiyon adı ve giriş/çıkış özeti, örn. "0 inputs → AI_Action1Result"), Type (örn. AI Action), Status (örn. Published), Model (kullanılan AI modeli), Created (oluşturan kişi ve zaman), Last modified (son güncelleyen kişi ve zaman).

Create an AI Action kartına tıkladığınızda Add AI Action ekranı açılır:

• En üstte Create from a blank kartı yer alır. Sıfırdan özel bir aksiyon oluşturmanızı sağlar.
• Altında Templates ve Recents olmak üzere iki sekme, bir arama kutusu ve sağda All models filtresi bulunur.
• Şablonlar, kategori etiketleriyle filtrelenebilir: All, Business, Product & Marketing, Vision, Summarization & Insight Extraction, Text & Language, Document OCR & Parsing, HR & People Operations, Legal, Compliance & Policy, Coding Tools, Education & Learning, Productivity & Workflow Automation, Audio & Speech, Health & Safety. Her kategorinin yanında o kategoride kaç şablon bulunduğu sayı olarak gösterilir.
• Her şablon kartında; kullandığı AI modeli (örn. Gemini 2.5 Flash, GPT Image 1, TTS 1, Whisper 1, GPT 5.4), görsel bir simge, şablonun adı ve kısa açıklaması yer alır.

Add AI Action ekranındaki hazır şablonları kullanarak işlemlerinizi hızlı bir şekilde gerçekleştirebilirsiniz:

• Speech To Text English: İngilizce konuşmayı metne dönüştürme.
• Taxi Receipt: Taksi fişlerini okuma ve işleme.
• Sensitive Content: Hassas içerikleri tespit etme.
• Receipt Reader Multiple: Farklı türde fişleri okuma.
• Capture Image From Camera: Cihaz kamerasıyla fotoğraf çekme.
• Detect Object Count From Image: Görseldeki nesneleri sayma.
• Split Image: Görseli parçalara ayırma.
• Fashion Labeling: Moda ürünlerini etiketleme.
• Analyze Security Camera Footage: Güvenlik kamerası görüntülerini analiz etme.
• Custom: Belirli bir ihtiyaca göre yapılandırılabilir.
• CV Reader: Özgeçmişlerdeki bilgileri okuma ve anlamlandırma.
• Create Image: Yapay zeka destekli görsel oluşturma.
• Text to Speech: Yazılı metni sesli konuşmaya dönüştürme.
• Speech to Text: Konuşmayı metne çevirme.
• Grammar Corrector: Dil bilgisi hatalarını düzeltme.
• Sentiment Analysis: Metindeki duygusal tonları analiz etme.
• Text Summary: Uzun metinleri özetleme.
• Text Extractor: Görseller veya PDF'lerden metin çıkarma.
• Image Analyzer: Görselleri analiz ederek içeriği hakkında bilgi verme.
• Article Writer: Belirli konular hakkında makaleler oluşturma.
• Brand Generator: Marka isimleri veya konsept önerileri oluşturma.
• Exam Creator: Sınav soruları ve cevapları tasarlama.
• Survey Creator: Anketler oluşturma.
• Text Translator: Metinleri farklı dillere çevirme.
• PDF Translator: PDF dosyalarını farklı dillere çevirme.
• Receipt Reader: Fişlerdeki bilgileri okuma ve analiz etme.
• Edit Image: Yüklenen görseller üzerinde düzenleme, düzeltme veya görsel efekt uygulama.
• Generate Video: Metin, görsel veya şablonlardan yapay zeka destekli video içerikleri oluşturma.
• Product Description Generator: Ürün açıklamalarını hedef kitleye uygun biçimde otomatik oluşturur.
• Customer Feedback Analyzer: Müşteri geri bildirimlerini analiz ederek eğilimleri ve sorunları tespit eder.
• Executive Summary Generator: Uzun raporları veya belgeleri yöneticiler için özetler.
• Refund Policy Explainer: İade politikalarını basitleştirip kullanıcı dostu şekilde açıklar.
• Meeting Availability Summarizer: Toplantı tarihleri ve uygunluk bilgilerini özetler.
• Emotional Tone Detector: Metinlerdeki duygusal tonu tespit eder.
• Table Data Cleaner: Tablo verilerindeki hataları temizler ve biçimlendirir.
• Gift Recommender: Alıcı özelliklerine göre hediye önerileri sunar.
• Conflict Resolution Advisor: Çatışma durumlarında yapıcı çözüm önerileri sunar.
• Legal Clause Simplifier: Hukuki metinleri sadeleştirir.
• Code Bug Explainer: Hatalı kod parçalarını analiz eder ve sorunun nedenini açıklar.
• Visual Prompt Booster: Görsel oluşturma promptlarını geliştirir.
• Persona Tone Styler: Hedef persona'ya uygun tonlama önerileri sunar.
• Text Tag Suggester: Metinler için uygun etiketler önerir.
• Auto Section Namer: İçerik bölümlerine uygun başlıklar üretir.
• User Feedback Categorizer: Kullanıcı geri bildirimlerini kategorilere ayırır.
• Question Rephraser: Soruları daha net ve etkili biçimde yeniden yazar.
• Content Expander: Kısa metinleri detaylı biçimde genişletir.
• Performance Review Interpreter: Performans değerlendirme metinlerini yorumlar.
• Intent Classifier: Kullanıcı niyetini sınıflandırır.
• Symptom to Prediagnosis: Belirtileri analiz ederek ön tanı önerisi sunar.
• Policy Document Simplifier: Politika belgelerini sadeleştirir.
• Financial Briefing Generator: Finansal rapor özetleri oluşturur.
• Text Summarizer: Uzun metinleri kısa ve anlamlı biçimde özetler.
• Task Brief to Checklist: Görev tanımlarını yapılacaklar listesine dönüştürür.
• Tone Analyzer and Suggester: Metnin tonunu analiz eder ve geliştirme önerileri sunar.
• Knowledge Base Answer Generator: Bilgi tabanına uygun yanıtlar üretir.
• Instruction Generator: Adım adım yönergeler oluşturur.
• Form Auto Filler: Form alanlarını içerik analizine göre otomatik doldurur.
• Product Review Analyzer: Ürün yorumlarını analiz eder ve özet çıkarır.
• Blog Post Outline Creator: Blog yazıları için başlık ve alt başlık önerileri oluşturur.
• Resume Bullet Point Optimizer: Özgeçmişteki madde başlıklarını profesyonelce optimize eder.
• Data Insight Summary Generator: Veri analizlerinden kısa özetler üretir.
• Competitor Analysis Summary: Rakip analizlerini özetler.
• Social Post Sentiment Forecaster: Sosyal medya gönderilerinin duygusal etkisini tahmin eder.
• Feature Priority Ranker: Ürün özelliklerini önem sırasına göre sıralar.
• Code Complexity Analyzer: Kod karmaşıklığını ölçer ve basitleştirme önerileri sunar.
• Sustainability Action Advisor: Sürdürülebilirlik odaklı strateji önerileri oluşturur.
• Event Marketing Idea Generator: Etkinlik pazarlama kampanyaları için yaratıcı fikirler üretir.
• Code Optimization Advisor: Kod performansını artırmak için öneriler sunar.
• Brand Voice Translator: İçerikleri markanın ses tonuna uyumlu hale getirir.
• Product Bundle Suggester: Birlikte satılabilecek ürün kombinasyonları önerir.
• Investment Portfolio Advisor: Yatırım portföyleri için analiz ve öneri sunar.
• SEO Product Description Generator: SEO odaklı ürün açıklamaları oluşturur.
• Task Checklist Generator: Görev açıklamalarını eyleme dönüştürülebilir kontrol listelerine çevirir.
• Pharmacode Scanner: Görseldeki ilaç barkodlarını okur ve Pharmacode değerlerini çözer.
• Inspect Box and Hologram: Kutulardan GTIN/Seri/Son kullanma tarihi/Lot bilgilerini ve güvenlik hologramını tespit eder.
• Inspect Blister Front Face: Tablet sayısını, rengini, şeklini ve blister paket üzerindeki hasarı tespit eder.
• Inspect Blister Expiry: Blister paket üzerindeki son kullanma tarihini okur.
• Inspect Blister Back Face: Üretim blister arka yüzünü bir referans tasarımla karşılaştırır.

Bir şablon kartına tıkladığınızda (veya View Detail alanına tıkladığınızda) "Continue With This Template" başlıklı bir önizleme penceresi açılır. Bu pencerede şablonun kullandığı AI modeli, kısa açıklaması, Parameters (giriş parametreleri ve veri tipleri) ile Return Type (çıktı veri yapısı ve alanları) görüntülenebilir.

• EDIT butonuyla şablonu özelleştirerek düzenleme ekranına geçebilirsiniz.
• START WITH THIS TEMPLATE butonuyla şablonu olduğu gibi kullanmaya başlayabilirsiniz.

Örneğin CV Reader şablonunda:

• Parametre: pdfBase64 (String) — CV dosyası Base64 formatında iletilir.
• Return Type: AI_CvResult — Name (String), ContactInformation (Object), Education (Object, List), Experience (Object, List), Projects (Object, List), Skills (Object) alanlarından oluşan yapılandırılmış bir çıktı döner.

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.

1. UI Design modülünü açın.
2. Aksiyonu eklemek istediğiniz ekranı seçin.
3. Properties panelinde +ADD ACTION aracılığıyla Custom kategorisinde yer alan AI Actions aksiyonunu ekleyin.

Bu adımları tamamladıktan sonra, Kuika AI Functions ile yapay zeka destekli işlemleri uygulamalarınıza entegre edebilirsiniz.