AI Ekosistemi

Pirivision platformu, kullanıcıların veriyi daha hızlı sorgulamasını ve dashboard üzerinde içgörüye ulaşmasını kolaylaştırmak için iki ayrı yapay zeka asistanı sunar. Her iki asistan da pirivision-langflow-api servisi (port 7870) üzerinden Langflow flow'larına bağlanır; ancak bağlam ve kullanım amaçları farklıdır.

flowchart LR
    A[Compass<br/>Sorgu Editörü] -->|Tablo + Prompt| M[Makinist]
    B[Horizon<br/>Board] -->|Snapshot + XLSX + Prompt| K[CaptainAI]
    M --> L[Langflow API]
    K --> L
    L --> M
    L --> K

Backend Bağımlılığı

Her iki asistanın çalışması için pirivision-langflow-api servisinin ayakta olması gerekir. Servis erişilemez olduğunda Makinist sohbet penceresi yanıt üretemez, CaptainAI ise mesaj typing... durumunda kalır.

Makinist — Compass SQL Asistanı

Makinist, Compass'ta SQL sorgu editörünün yanında açılan AI sohbet panelidir. Kullanıcı, veri kaynağındaki tabloları seçip doğal dilde soru sorduğunda Makinist çalıştırılabilir SQL üretir ve tek tıkla editöre aktarır.

Özellik	Açıklama
Bulunduğu Modül	Compass — SQL Sorgu Yazma ekranı
Bağlam	Seçili veri kaynağı + seçili tablolar + sohbet geçmişi
Çıktı	SQL kod bloğu (Markdown formatında)
Önemli Buton	`SQL Kullan` — üretilen sorguyu editöre aktarır
Oturum Yönetimi	Veri kaynağı bazında, kullanıcı için ayrı oturum geçmişi
Backend	`pirivision-langflow-api` (action: `ask_agent`)

→ Makinist — Detaylı Rehber

CaptainAI — Horizon Board Asistanı

CaptainAI (Türkçe arayüzde Kaptan AI), Horizon board'unun sağ alt köşesinde yer alan yüzen butona tıklandığında açılan sohbet diyaloğudur. Operatör, board'un canlı görüntüsünü ve içerdiği widget verilerini doğal dil ile yorumlatabilir; örneğin "vardiya 2'de duruşların nedeni nedir?" gibi sorular sorulabilir.

Özellik	Açıklama
Bulunduğu Modül	Horizon — Board ekranı
Bağlam	Board PNG snapshot + tüm widget XLSX verisi + soru metni
Çıktı	Doğal dil yanıt (Markdown + LaTeX destekli)
Önemli Özellik	Board görüntüsünü yorumlayabilir ("üstteki gauge", "bu chart")
Oturum Yönetimi	Board bazında `KaptanSessionItem`
Backend	`pirivision-langflow-api`

→ CaptainAI — Detaylı Rehber

Hangi Asistanı Ne Zaman Kullanmalıyım?

Senaryo	Önerilen Asistan
Bilmediğim veritabanından bir SQL yazmam gerek	Makinist
Board üzerindeki anomaliyi yorumlatmak istiyorum	CaptainAI
Vardiya özeti / hızlı yorum istiyorum	CaptainAI
Tablolar arası JOIN gereken bir analiz yapmak istiyorum	Makinist
Hangi widget'ta hangi parametre tepe yapmış?	CaptainAI
Sorguyu kaydedip Cartography'de chart'a dönüştürmek istiyorum	Makinist

İki Aşamalı Akış

Çoğu durumda iki asistan birbirini tamamlar:

Makinist ile Compass'ta sorguyu yaz → Cartography'de widget'a dönüştür
CaptainAI ile Horizon board'da o widget'lar üzerinde sohbet et

Ortak Davranışlar

Her iki asistan da Langflow API üzerinden çalıştığı için ortak bazı davranışlara sahiptir:

Davranış	Açıklama
`typing...` Yer Tutucusu	İstek gönderildiğinde mesaj listesine geçici "typing..." satırı eklenir, yanıt geldiğinde kaldırılır.
İptal	Yanıt beklenirken aynı buton stop ikonuna döner; tıklandığında HTTP isteği iptal edilir ve `typing...` kaldırılır.
Hata İşleme	Servis hata döndürürse SnackBar ile bildirilir. Hata kalıcı sohbete kaydedilmez.
Markdown	Yanıtlar Markdown olarak render edilir (kod blokları, başlıklar, listeler).

Hassas Veri

Her iki asistan da kullanıcı sorgusunu ve bağlamı (tablolar / board snapshot / XLSX) Langflow servisine gönderir. Hassas veri içeren tablolarda veya board'larda hangi bağlamın dışarı aktarıldığına dikkat edin.

Sonraki Adım

→ Makinist — Compass SQL Asistanı → CaptainAI — Horizon Board Asistanı → Port — Veri Kaynakları → Automation — Kural Tabanlı Uyarılar