AI Shop Chat Robot - Kapsamli Analiz

Tarih: 2025-11-21 | Tenant: ixtif.com (ID: 2) | Sistem: Node-based Workflow Engine V2

Yonetici Ozeti

14
Workflow Node
3
AI Provider
8
API Endpoint
V2
Sistem Versiyonu

Sistem Durumu: Aktif

AI Shop Chat robotu Node-based Workflow Engine V2 uzerinde calisiyor. Sistem, kullanici mesajlarini isleyip urun aramalari yaparak akilli yanit uretiyor.

Ana Ozellikler: Meilisearch ile hibrit arama, fallback AI provider zinciri (OpenAI → Claude → DeepSeek), conversation history yonetimi, tenant-specific kurallar.

Sistem Mimarisi

Kullanici Mesaji ↓ ┌─────────────────────────────────────┐ │ PublicAIController │ │ POST /api/ai/v1/shop-assistant/chat │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ shopAssistantChatV2() │ │ → Session yonetimi │ │ → Conversation olusturma │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ ConversationFlowEngine │ │ → Flow yukleme (tenant-specific) │ │ → Node execution loop (max 20) │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ WORKFLOW NODES (Sirasıyla) │ │ 1. CategoryDetectionNode │ │ 2. ProductSearchNode (Meilisearch) │ │ 3. StockSorterNode │ │ 4. ContextBuilderNode │ │ 5. AIResponseNode → OpenAI API │ │ 6. MessageSaverNode │ │ 7. EndNode │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ API Response │ │ { success, message, session_id } │ └─────────────────────────────────────┘

Frontend Yapisi

Floating Widget Component

Dosya: resources/views/components/ai/floating-widget.blade.php

Teknolojiler:

Alpine.js State Management
Tailwind CSS Styling
marked.js Markdown Render

Mevcut UI Ozellikleri

  • Auto-open: Desktop'ta 10 saniye sonra otomatik acilma (mobilde kapali)
  • Animated Bubble: Donen mesajlar ile dikkat cekme
  • Quick Actions: Transpalet, Forklift, Istif Makinesi vb. hizli butonlar
  • Dark Mode: Sistem tercihi destegi
  • Typing Indicator: AI yazarken animasyon
  • Unread Badge: Okunmamis mesaj sayaci
  • Disclaimer Modal: AI hakkinda bilgilendirme

JavaScript Store (ai-chat.js)

Dosya: public/assets/js/ai-chat.js

  • sessionStorage: Her sekme icin ayri session (tab isolation)
  • Conversation History: Mesaj gecmisi yukleme
  • Markdown Renderer: AI yanitlarini formatli gosterme
  • Auto-scroll: Yeni mesajda asagi kayma

Backend Yapisi

Workflow Engine V2

Sistem, node-based workflow mimarisi kullaniyor. Her node bagimsiz bir gorev yapar ve sonraki node'a gecis yapar.

Mevcut Node'lar

Node Tipi Gorev Dosya
CategoryDetectionNode Kullanici mesajindan kategori tespit etme Workflow/Nodes/CategoryDetectionNode.php
ProductSearchNode Meilisearch ile urun arama Workflow/Nodes/ProductSearchNode.php
StockSorterNode Urunleri stok durumuna gore siralama Workflow/Nodes/StockSorterNode.php
ContextBuilderNode AI icin context hazirlama Workflow/Nodes/ContextBuilderNode.php
AIResponseNode OpenAI/Claude ile yanit uretme Workflow/Nodes/AIResponseNode.php
MessageSaverNode Mesajlari veritabanina kaydetme Workflow/Nodes/MessageSaverNode.php

Tenant-Specific Servisler

Dosya: Modules/AI/app/Services/Tenant/Tenant2ProductSearchService.php

  • Kategori Detection: Forklift, Transpalet, Istif Makinesi, Reach Truck, Otonom
  • Keyword Extraction: ton, akulu, elektrikli, li-ion, manuel vb.
  • Custom Prompts: Fiyat/stok politikalari, urun onceliklendirme
  • Hybrid Search: Meilisearch + Vector search kombinasyonu

AI Provider Fallback Zinciri

OpenAI (gpt-4o-mini) ↓ Rate Limit/Hata Claude (claude-3-haiku) ↓ Hata DeepSeek (deepseek-chat) ↓ Hata Hata Mesaji: "AI servisleri gecici olarak kullanilamiyor"

API Endpoint'leri

Shop Assistant API

Method Endpoint Aciklama
POST /api/ai/v1/shop-assistant/chat Ana chat endpoint (rate limit YOK)
POST /api/ai/v1/shop-assistant/chat-stream Streaming yanit (SSE)
GET /api/ai/v1/shop-assistant/history Konusma gecmisi
DELETE /api/ai/v1/conversation/{id} Konusmayi silme

Mevcut Ozellikler

Calisanlar

  • Meilisearch ile hizli urun arama
  • Conversation history ile baglam koruma
  • Markdown formatinda AI yanitlari
  • Urun linkleri ile direkt yonlendirme
  • Fiyat sorgulari (en ucuz/en pahali)
  • Kategori bazli filtreleme
  • Fallback AI provider zinciri
  • Session bazli izolasyon

Iyilestirme Gerektiren Alanlar

  • Streaming: SSE streaming tamamen aktif degil
  • Response Time: Bazi sorgularda 5+ saniye bekleme
  • Prompt Length: Cok uzun system prompt'lar (token maliyeti)
  • Error Handling: Kullaniciya daha anlasilir hata mesajlari
  • Analytics: Kullanici davranisi analizi eksik
  • Caching: Benzer sorgular icin cache mekanizmasi

Gelistirme Onerileri

1. Performans Iyilestirmeleri Yuksek

  • Streaming Aktivasyonu: SSE ile parcali yanit gosterimi
  • Prompt Optimization: System prompt'u kisaltma (1500 → 800 token)
  • Response Caching: Benzer sorgular icin Redis cache
  • Parallel Node Execution: Bagimsiz node'lari paralel calistirma

2. UX Iyilestirmeleri Yuksek

  • Quick Reply Buttons: AI yanitinda tiklanabilir secenekler
  • Product Cards: Urunleri gorsel kartlar olarak gosterme
  • Voice Input: Sesli mesaj destegi
  • File Upload: Gorsel ile urun arama
  • Typing Animation: Gercekci karakter karakter yazma

3. Akilli Ozellikler Orta

  • Intent Detection: Kullanici niyetini anlama (satis, bilgi, sikayet)
  • Sentiment Analysis: Kullanici ruh halini algilama
  • Proactive Suggestions: Sayfa icerigine gore otomatik oneri
  • Comparison Mode: Urunleri yan yana karsilastirma
  • Lead Capture: Akilli iletisim bilgisi toplama

4. Admin Panel Ozellikleri Orta

  • Conversation Dashboard: Tum konusmalari izleme
  • Analytics: Populer sorular, conversion rate
  • A/B Testing: Farkli prompt'lari test etme
  • Directive Editor: System prompt'u panelden duzenleme
  • Training Data: Yanlis yanitlari duzeltme

5. Entegrasyonlar Dusuk

  • WhatsApp: WhatsApp Business API entegrasyonu
  • CRM: Musterileri CRM'e aktarma
  • Email: Konusma ozetini mail ile gonderme
  • Calendar: Randevu planlama

Dosya Yapisi

Modules/AI/ ├── app/ │ ├── Http/ │ │ └── Controllers/Api/ │ │ └── PublicAIController.php # Ana API controller │ └── Services/ │ ├── AIService.php # Temel AI servisi │ ├── Chat/ │ │ └── ChatServiceV2.php # Chat session yonetimi │ ├── Tenant/ │ │ └── Tenant2ProductSearchService.php # iXtif ozel arama │ └── Workflow/ │ ├── FlowExecutor.php # Flow calistirici │ ├── NodeExecutor.php # Node calistirici │ └── Nodes/ │ ├── AIResponseNode.php # AI yanit uretimi │ ├── CategoryDetectionNode.php │ ├── ProductSearchNode.php │ ├── StockSorterNode.php │ ├── ContextBuilderNode.php │ ├── MessageSaverNode.php │ └── EndNode.php ├── routes/ │ └── api.php # API route'lari └── config/ └── ai.php # AI konfigurasyonu resources/views/components/ai/ ├── floating-widget.blade.php # Ana chat widget ├── chat-store.blade.php # Alpine store └── inline-widget.blade.php # Sayfa ici widget public/assets/js/ └── ai-chat.js # Frontend JS

Sonraki Adimlar

Gelistirme Oncelikleri

  1. Streaming aktivasyonu - Kullanici deneyimini aninda iyilestirir
  2. Quick reply butonlari - Kullanici etkilesimini artirir
  3. Urun kartlari - Gorsel zenginlik saglar
  4. Response caching - Maliyet ve hiz optimizasyonu
  5. Analytics dashboard - Veri odakli iyilestirme

Hazir Altyapi

Sistem guclü bir altyapiya sahip:

  • Modular node-based architecture → Yeni ozellikler kolayca eklenebilir
  • Tenant-aware design → Her tenant icin ozel kurallar tanimlanabilir
  • Fallback chain → Yuksek kullanilabilirlik
  • Conversation persistence → Kullanici baglami korunuyor