Kullanıcı Kılavuzu

AI Agent

AI Agent

Kuika’nın AI Agents özelliği, uygulamalarınıza daha etkileşimli ve senaryo tabanlı yapay zeka deneyimleri entegre etmenizi sağlar. Bu özellik sayesinde farklı görevleri üstlenen, belirli rollere sahip ve kullanıcıdan gelen girdilere göre dinamik yanıtlar verebilen yapay zeka ajanları (agents) oluşturabilirsiniz.

AI Agent Oluşturma Adımları

  1. Kuika platformuna giriş yapın ve çalışmak istediğiniz projeyi açın.
  2. Datasources modülüne gidin.
  1. Sol panelde yer alan “AI Agents” bölümüne gidin.
  2. +” ikonuna tıklayarak yeni bir AI Agent oluşturun.

Açılan pencerede aşağıdaki bilgileri doldurmanız gerekecektir:

Agent İsmi

Agent’a tanımlayıcı bir isim verin (örneğin, “JobPostGeneratorAgent”).

Model Seçimi

  • İki farklı model tipi mevcuttur:
    • All: Çok yönlü, genel amaçlı görevler için kullanılır.
    • CrewAI: Birden fazla yapay zeka ajanının ekip olarak çalışmasını sağlayan gelişmiş bir senaryo altyapısı sunar.

AI Agent Chat ekranında Shift + Enter kombinasyonu ile alt satıra geçilebilir. Bu sayede, birden fazla satır içeren mesajları veya madde madde girdileri daha rahat oluşturabilir.

AI Agent Şablonları

Hazır şablonlar üzerinden agent oluşturabilir veya tamamen Custom seçeneğiyle sıfırdan bir yapı tanımlayabilirsiniz:

  1. Custom
    • Tanım: Sıfırdan kendi agent'ınızı oluşturmanıza olanak tanır.
    • Kullanım Senaryosu: Özgün görev tanımı, özel kullanıcı girdileri veya farklı AI modelleri kullanmak isteyen geliştiriciler içindir.
    • Özellikler: Role prompt, user prompt, model ve parametrelerin tamamı sizin kontrolünüzdedir.
    • Örnek Girdi: “Bir podcast bölümü için başlık ve açıklama üret.”
  2. Employee Researcher
    • Tanım: Belirli bir çalışan hakkında internet veya veritabanı üzerinden bilgi toplar.
    • Kullanım Senaryosu: İnsan kaynakları, iç iletişim ve yönetici dashboard'ları.
    • Veri Kaynağı: Genellikle Serper Tool ile desteklenir.
    • Girdi: Çalışan adı, pozisyon, e-posta.
    • Çıktı: Çalışanın geçmişi, yetkinlikleri, projeleri hakkında yapılandırılmış metin veya JSON.
  3. Company Researcher
    • Tanım: Belirtilen bir şirket hakkında çevrimiçi araştırma yapar ve özet bilgi sunar.
    • Kullanım Senaryosu: Rekabet analizi, yatırım araştırmaları, müşteri profili çıkarımı.
    • Veri Kaynağı: Serper Tool ile web aramaları.
    • Girdi: Şirket adı (örn: “Trendyol”)
    • Çıktı: Kuruluş yılı, sektör, son haberler, büyüklük, çalışan sayısı gibi bilgiler.
  4. Job Post Generator
    • Tanım: Belirli bir pozisyon için iş ilanı hazırlar.
    • Kullanım Senaryosu: İnsan kaynakları otomasyonları, iş ilanı oluşturma panelleri.
    • Girdi: Pozisyon adı, aranan beceriler, lokasyon, şirket bilgisi.
    • Çıktı: Başlık, açıklama, görev tanımı, aranan nitelikler.
  5. Candidate Selector
    • Tanım: Aday verilerine göre en uygun olanı seçer ya da sıralar.
    • Kullanım Senaryosu: Otomatik işe alım araçları, başvuru eleme süreçleri.
    • Girdi: Birden fazla adayın özgeçmiş bilgisi (metin/JSON formatında).
    • Çıktı: Önerilen aday(lar), güçlü yönleri, eşleşme skoru gibi yapılandırılmış çıktı.
  6. News Summarizer
    • Tanım: Güncel haberleri alır ve özetler.
    • Kullanım Senaryosu: Dashboard’larda hızlı haber akışı, sektör analiz panelleri.
    • Veri Kaynağı: Serper Tool ile gerçek zamanlı haber taraması.
    • Girdi: Konu veya haber başlığı (örn: "yapay zeka yatırımları").
    • Çıktı: Kısa özet, haber tarihi, kaynak bilgisi.
  7. Travel Planner 
    • Tanım: Seyahat planı oluşturur.
    • Kullanım Senaryosu: Tatil planlama, uçuş ve konaklama önerileri, rota çıkarma.
    • Girdi: Lokasyon, tarih, tercih edilen aktiviteler.
    • Çıktı: Önerilen seyahat planı, aktiviteler, alternatif seçenekler.
  8. Marketing Strategy Consultant 
    • Tanım: Pazarlama stratejileri geliştirir.
    • Kullanım Senaryosu: Kampanya planlama, sosyal medya içerik stratejisi, marka analizi.
    • Girdi: Hedef kitle, sektör, ürün/hizmet bilgisi.
    • Çıktı: Kampanya önerileri, kanal stratejisi, KPI önerileri.

Custom Şablonu Kullanımı 

AI Agent’lar, özelleştirilebilir şablon yapısıyla farklı senaryolara uyarlanabilir. Girdi tanımları, kullanıcı etkileşimi ve arka plandaki araçlar sayesinde sistem esnek bir çözüm sunar.

Nasıl Kullanılır?

  1. Agent Inputs Tanımlayın:
    • Sağ üst köşede yer alan "Agent Inputs" butonuna tıklayın.
    • Gerekli girdileri tiplerine uygun şekilde tanımlayın:
      • String: Metin bilgileri (örneğin: aday adı, ürün adı)
      • Boolean: Doğru/Yanlış seçenekleri (örneğin: referans kontrolü yapıldı mı?)
      • Integer: Tam sayılar (örneğin: deneyim yılı)
      • Float: Ondalıklı sayılar (örneğin: beklenen maaş)
  2. Chatbot ile Etkileşime Geçin:
    • Tanımladığınız girdiler, chatbot arayüzünde aktif hale gelir.
    • Kullanıcı Chatbot’a doğal dil ile veri girer.
    • Örnek mesaj:
      “Aday adı: John Doe, Referans kontrolü yapıldı mı? Evet, Deneyim yılı: 6, Beklenen maaş: 85000.”
  3. AI Agent Cevabı Üretir:
    • Tanımlı girdilere göre otomatik yanıt oluşturur.
    • Gerekirse analiz, hesaplama veya veri sorgulama işlemleri yapılır.
    • Sonuçlar gerçek zamanlı olarak kullanıcıya sunulur.
  4. Tool’ları Kullanarak Eylem Gerçekleştirin:
    • Agent’a eklediğiniz araçlar (tool’lar) sayesinde dosya oluşturabilir, veri çekebilir, analiz yapabilirsiniz.

Örnek Senaryo: Aday Değerlendirme

Amaç: Aday bilgilerini alıp uygunluk değerlendirmesi yapmak, sonucu dosyaya kaydetmek.

Yapılacaklar:

  • Agent Inputs’tan şu girdileri tanımlayın:
    • candidateName (String)
    • hasReferenceChecked (Boolean)
    • yearsOfExperience (Integer)
    • expectedSalary (Float)
  • Chatbot’a şu şekilde yazın:
    • “Aday adı: John Doe, Referans kontrolü yapıldı mı? Evet, Deneyim yılı: 6, Beklenen maaş: 85000.”
  • Agent şu yanıtı üretir:
    • John Doe
    • Referans kontrolü tamamlanmış.
    • 6 yıllık deneyimiyle pozisyona uygun.
    •  Beklenen maaş: 85.000 TL – Bu değer, piyasa ortalaması ile uyumlu görünüyor.
    • Değerlendirme raporu oluşturuluyor…”
  • FileWriterTool devreye girerek john_doe_degerlendirme.txt adlı dosyayı oluşturur.

Agent Response Builder Nedir?

Agent’ın kullanıcıya ne tür yanıt vereceğini yapılandırmak için kullanılır. AI yanıtlarının dinamik, anlamlı ve yapılandırılmış biçimde oluşturulmasını sağlar. Bu yapı sayesinde:

  • Girdilere bağlı özel mesajlar yazılabilir,
  • Tool çıktıları yanıtın içine gömülebilir,
  • Koşullu ifadelerle esnek içerikler üretilebilir (örneğin referans kontrolü yapılmışsa göster, yapılmamışsa uyar).
  • Agent panelinde, görüntüleme ikonu (Response) tıklanarak ulaşılır.
  • Burada metin içinde input adı kullanarak tüm girdileri çağırabilir, jinja benzeri yapılarla koşullu ifadeler tanımlayabilirsiniz.

Desteklenen Tool Açıklamaları

MCP tabanlı entegrasyonların (Brave Search, Slack, Github, GoogleWorkspace, GoogleMaps, Youtube, Trello, Airbnb, Office365, Dropbox) ayarları Configuration Manager modülü üzerinden yapılır. Bu modülde ilgili MCP için API anahtarları, erişim izinleri ve bağlantı bilgileri tanımlandıktan sonra AI Agent içinde kullanılabilir hale gelir.

Project & Management

  • Trello Boards
    • Amaç: Trello panolarına erişmek ve kartlar üzerinde işlem yapmak.
    • Kullanım: Panolardaki görevler okunabilir, kart detayları alınabilir.
    • Örnek Kullanımlar:
      • Bir panodaki tüm kartları listelemek
      • Belirli bir görev hakkında bilgi almak
  • Jira Tasks 
    • Amaç: Jira üzerindeki task ve ticket’ları yönetmek.
    • Kullanım: Issue’lar listelenebilir, detayları incelenebilir.
    • Örnek Kullanımlar:
      • Açık ticket’ları listelemek
      • Bir issue’nun durumunu kontrol etmek

File & Storage

  • Dropbox Files
    • Amaç: Dropbox dosyalarına erişmek.
    • Kullanım: Dosyalar listelenebilir, içerikleri okunabilir.
  • Google Workspace
    • Amaç: Google Drive, Docs ve Sheets belgeleriyle çalışmak.
    • Kullanım: Belgeler açılabilir, aranabilir.
  • Open File
    • Amaç: Yüklenen dosyaları açmak.
  • Save File
    • Amaç: Oluşturulan içeriği dosya olarak kaydetmek.
  • Read Excel 
    • Amaç: Excel dosyalarını okuyup analiz etmek.
    • Örnek Kullanımlar:
      • Satış raporlarını analiz etmek
      • Liste karşılaştırmaları yapmak

Collaboration & Communication

  • Slack Messages
    • Amaç: Slack kanallarından veri almak.
    • Kullanım:
      • Mesajları okumak
      • Konuşmaları özetlemek
  • Github Repos
    • Amaç: Repository ve commit’leri incelemek.
    • Kullanım:
      • Son değişiklikleri görmek
      • Açık issue’ları peşine düşmek
  • Youtube Content
    • Amaç: YouTube videolarına erişmek.
    • Kullanım:
      • Video aramak
      • Açıklama bilgisi almak
  • Airbnb Data
    • Amaç: Airbnb üzerinden konaklama bilgisi almak.
    • Kullanım:
      • Tarihe göre arama
      • Fiyata göre filtreleme
  • Office365
    • Amaç: Outlook, OneDrive ve Office belgeleriyle entegrasyon.
    • Kullanım:
      • E-posta okumak
      • Dosya analizi yapmak

Data & Analytics

  • Web Scraper Tool
    • Amaç: Statik web sitelerinden veri çekmek.
  • Dynamic Website Scraper (Firecrawl MCP)
    • Amaç: Dinamik web sitelerini taramak.
  • Code Runner
    • Amaç: Python kodu çalıştırmak ve analiz yapmak.
  • Serper Dev Tool
    • Amaç: Google üzerinden web araması yapmak.

Search & Maps

  • Web Search (Brave)
    • Amaç: İnternet üzerinde arama yapmak.
  • Google Maps 
    • Amaç: Konum ve mekan bilgisi almak.

İpuçları

  • Girdilerde yapılan her değişiklik, AI yanıtını otomatik olarak günceller.
  • Tool kombinasyonları, farklı kullanım senaryoları yaratmanıza olanak tanır.
  • Prompt içinde tanımlı her input, {{inputAdı}} şeklinde doğrudan kullanılabilir.

Serper Tool Settings Ayarları Nasıl Yapılır?

1. Uygulamaya Konfigürasyon Ekleyin

  • Kuika platformuna giriş yapın.
  • Apps ekranından çalışacağınız projeyi açın.
  • Configuration Manager modülüne tıklayın.
  • Açılan ekranda konfigürasyona bir isim verin ve CREATE butonuna tıklayın.

2. Serper Tool Ayarlarını Yapılandırın

  • Yeni bir konfigürasyon oluşturduktan sonra App Settings ekranını açın.
  • AI Settings bölümüne gidin.
  • Açılır menüden Serper Tool seçeneğine tıklayın. 
  • ADD NEW butonuna tıklayın.
  • Açılan pop-up penceresinde aşağıdaki ayarları yapılandırın:
    • Name: Yapılandırmaya verilecek isim.
    • API Key: Serper API üzerinden aldığınız erişim anahtarı.

Serper Tool, Agent tarafından kullanılabilir hale geldikten sonra, AI Agent konfigürasyonlarında otomatik olarak algılanır ve dış veri kaynaklı görevlerde aktif olarak kullanılır.

AI Agent'ı Kullanma

  1. UI Design modülüne gidin.
  2. Agent’ı eklemek istediğiniz ekranı açın.
  3. +ADD ACTION > AI Agents sekmesine tıklayın ve oluşturduğunuz Agent’ı seçin.
  4. İlgili kullanıcı girdilerini bağlayın ve yapay zeka destekli senaryoları devreye alın.
No items found.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar