AI Analistine sorun

AI Analisti, kendi veriniz üzerinde bir sohbettir. Soruyu kendi sözcüklerinizle sorarsınız; yerel bir model yanıtı salt okunur araçlarla arar, bulduğu satırları bir tablo olarak çizer ve hangi aramaları yaptığını gösterir. Rakamlarını bir aramaya kadar geri izleyemediği bir yanıt hiç gösterilmez.

Analistin veritabanı bağlantı dizesi ve ağ geçidi kimlik bilgisi yoktur. Yalnızca SELECT yetkili bir rolle oturum açan, on dokuz adlandırılmış araç sunan ve hiç SQL aracı bulundurmayan cid-mcp-server üzerinden okur. Hiçbir şey yazmaz: konuşmalarınızı analist değil, ağ geçidi saklar.

Neyin çalışıyor olması gerekir

Analist ve MCP sunucusu varsayılan olarak kapalıdır — llm-analyst compose profili altındaki tek iki servistir:

docker compose --profile llm-analyst up -d mcp-server risk-analyst

mcp-server, postgres servisinin sağlıklı olmasını gerektirir ve yoğun arama dizinini oluşturana kadar /healthz üzerinde 503 starting yanıtı verir; bu, her iki başvuru derlemi için CPU üzerinde yaklaşık 80 saniye sürer ve sağlık denetimi 180 saniyeye izin verir. risk-analyst, mcp-server sağlıklı olana kadar bekler ve kendisi için 120 saniyeye izin verir. Compose, MCP sunucusu için 1 GB ayırır ve analisti 3 GB ile 2 CPU'ya sınırlar. Hiçbiri açılışta bir şey indirmez: gömme ağırlıkları iki imaja da gömülüdür.

Model bunlardan biri değildir. cid-risk-analyst tek bir sözleşme konuşur — OpenAI şemasındaki tools ile POST {LLM_BASE_URL}/chat/completions — ve motoru siz seçersiniz:

ollama pull qwen3:14b
OLLAMA_CONTEXT_LENGTH=32768 OLLAMA_KEEP_ALIVE=-1 ollama serve

Bir soru sorun

Neye bakabilir, neye bakamaz

Her arama MCP sunucusunun on dokuz tipli aracından geçer. SQL aracı yoktur; bu yüzden model, araçların sunmadığı bir sorguyu ifade edemez.

Kapsam hesabınızı izler. Bir superadmin'in soruları filo genelinde çalışır; grup kapsamlı bir admin_user, okuyabildiği kiracılara sabitlenmiş aynı araçları alır ve bu kümenin dışındaki bir tanımlayıcı, hiçbir şey okunmadan adıyla reddedilir.

Bir yanıt ne zaman verilmez

Analist, siz görmeden önce kendi yanıtı üzerinde belirlenimci bir doğrulayıcı çalıştırır ve belirteçler doğrulama geçene kadar arabellekte tutulur — akmış bir yanıt zaten gösterilmiştir.

Bir başarısızlık, tam olarak neyin yanlış gittiğini adlandıran bir düzeltme turu alır. İkinci başarısızlık turu karantinaya alır: size hiçbir şeyin doğrulanamadığı söylenir ve yanıtın kendisi bir çekinceyle gösterilmek yerine atılır. Kanıt varken tablo karantinadan sağ çıkar; çünkü satırları araç sonucundan gelmiştir ve ret onları hiçbir zaman sorgulamamıştır.

Biten her yanıt Verified ya da Unverified olarak etiketlenir ve ardından süresi, belirteç sayıları ve tur sayısı gelir. Fiyat yoktur: model yereldir, dolayısıyla bir maliyet rakamı uydurma olurdu.

Konuşmaları yönetin

Alan başvurusu

Doğrulama

1. curl -f http://localhost:8020/healthz degraded olmayan bir durumla yanıt verir. HTTP 503 ile gelen degraded bir yanıt, veritabanı rolünün salt okunur ayarlarını yitirdiği anlamına gelir.
2. curl -f http://localhost:8019/health llm_reachable ve mcp_connected değerlerini true ve sıfırdan büyük bir araç sayısı bildirir.
3. Which input filters fired most often in the last 7 days? diye sorun. Yanıt; çizilmiş bir tablo, bir Verified etiketi ve sıfırdan büyük satır sayısıyla get_filter_config ya da aggregate_detection_stats adını veren bir araç iziyle gelir.
4. Sayfayı yeniden yükleyin. Konuşma hâlâ oradadır, tablosu yeniden çizilmiş ve göstergesi geri gelmiştir — turun tarayıcıda tutulmak yerine ağ geçidi tarafından saklandığının kanıtı.
5. Bu sayfa kendine ait hiçbir olay günlüğü satırı yazmaz. Analistin otomatik incelemeleri yazar; bkz. Risk Analizi.

Başarısız olursa

• This feature (risk.llm_review) is not included in the installed license tier. Contact your CID representative to upgrade. — FEATURE_NOT_LICENSED kodlu bir 403. Bu bir Enterprise anahtarıdır; daha düşük bir katmanda kenar çubuğu girdisi gizlenir ve URL reddedilir. Bkz. Lisans.
• connect ECONNREFUSED ya da Risk analyst is unavailable. yazan bir hata balonu — ağ geçidi analiste erişemedi. Profil ayakta değildir ya da RISK_ANALYST_SERVICE_URL yanlıştır. Tur yine de yanıtın yerine arızayla birlikte saklanır.
• Yanıt bir rettir ve tur Unverified etiketlidir — doğrulayıcı rakamları izleyemedi. Soruyu daraltın ya da pencereyi açıkça belirtin; analistin bir yanıtı vermemesi bir arıza değil, kuralın çalışmasıdır.
• Her soru birkaç düzyazı turundan sonra araç izinde hiçbir şey olmadan başarısız oluyor — model uç noktası tool_calls üretmiyor. Analisti suçlamadan önce onu doğrudan sınayın: vLLM'de --enable-auto-tool-choice --tool-call-parser hermes ya da llama-server üzerinde --jinja olmadan tools tamamen yok sayılır.
• Yanıtlar aşırı yavaş ve izde uzun boşluklar var — motor ANALYST_CONTEXT_WINDOW değerinden küçük bir bağlam sunuyordur ya da ağırlıklar sorular arasında bellekten çıkmıştır. Sunulan bağlam kısa olduğunda analist açılışta bir hata günlüğe yazar.
• mcp-server hiç sağlıklı duruma gelmiyor — cid_mcp_ro rolünün parolası yok. MCP_DB_PASSWORD değerini uygulayın ya da elle ALTER ROLE cid_mcp_ro PASSWORD '<secret>' ile ayarlayın.
• Bir araç, bir akış ya da bir search sütunu adlandırarak not_supported yanıtı veriyor — o yetki bu makinede uygulanmamış. Desteklenmeyen parametre olmadan yapılan çağrı yine çalışır.
• This is a read-only demo account (viewer role) — actions and changes are disabled. — bir READ_ONLY_ROLE reddi. Bir viewer bu sayfayı açıp saklanan konuşmaları okuyabilir ama soru sormak bir POST'tur ve reddedilir.

Sonraki adımlar

• Risk Analizi — aynı analistin otomatik tarafı: tekrarlanan jailbreak denemeleri hakkında ne karar verdiği ve kimi kilitlediği.
• Tüm Tespitler — analistin okuduğu akış ve bir soruda ona verebileceğiniz filtreler.
• Lisans — risk.llm_review yeteneğini hangi katmanın taşıdığı.