Nuve AI

Genel Bakış

Nuve AI ("Nuve Guru"), BOM analizi, mühendislik soruları ve şartname/gereksinim çıkarımı için Claude tabanlı bir yapay zeka asistanıdır. Uygulamanın her yerinden açılabilen yüzen bir sohbet paneli olarak çalışır ve açıldığı anda BOM Intelligence, Change Management (ECR/ECO/ECN), Gereksinimler, DPP ve PDM Vault modüllerinden canlı bir durum özeti (context) çeker — yani genel bir sohbet botu değil, o an oturumdaki gerçek verilere göre yanıt verir.

Temel Kavramlar

• Aktif Analiz Bağlamı — panel her açıldığında modüller arası canlı bir özet (/api/ai/guru/context) toplanır: açık ECR/ECO sayısı, gereksinim izlenebilirlik kapsamı, DPP uyarıları, PDM Vault dosya/kilit sayıları. Asistan bu verilerle konuşur, genel bir yazılımın arayüzünü tarif etmez.
• Aksiyon Önerisi (Guru Action) — asistanın doğrudan veri değiştirmesi yerine önerdiği, kullanıcının onaylamasını bekleyen kart. Sadece iki tür önerebilir: yeni bir görev açma (propose_create_task) veya bir issue'yu "Aksiyona Bağlandı"/"Devam Ediyor" durumuna taşıma (propose_patch_issue_status). Model hiçbir zaman bir issue'yu "Çözüldü" veya "Kabul Edildi" olarak kapatamaz — bu karar insana aittir.
• BOM Expert (Nuve Chat) — BOM Intelligence ekranı içindeki, o an yüklü BOM tablosu ve bağlıysa ERP ürün listesiyle konuşan ayrı, dar kapsamlı bir sohbet asistanı.
• Sağlayıcı Zinciri — yanıtlar sırasıyla Anthropic (Claude) → Groq (ücretsiz katman, OpenAI uyumlu) → kural tabanlı fallback öncelik sırasıyla üretilir; API anahtarı yoksa bile asistan gerçek analiz verisinden hesaplanan bir cevap döner, boş kalmaz.

Tipik Kullanım Akışı

1. Uygulamanın herhangi bir ekranında sağ alttaki sohbet başlatıcıyı açın (Nuve AI).
2. Bir soru sorun (örn. "En kritik 3 konu ne?", "Yerlilik oranımız neden düşük?", "Bu ECO'nun etkisi ne?") — asistan aktif analiz bağlamını kullanarak yanıtlar.
3. Gerekirse bir aksiyon hedefi (issue) seçin ve asistandan bir görev açmasını veya issue durumunu güncellemesini isteyin.
4. Asistan bir aksiyon önerisi kartı gösterir (önizleme metniyle); Onayla veya İptal ile karar sizde kalır.
5. Onaylanan aksiyon, insan arayüzünün kullandığı aynı servis fonksiyonuyla ve sizin rol/yetkinizle uygulanır.
6. Şartname metninden gereksinim adayı çıkarmak için AI Çıkarım akışını (Kickoff Paketi / Spec2Action bağlamı) kullanın.

Özellik Referansı

• Modüller arası canlı bağlam toplama (/api/ai/guru/context): Change Management, Action Hub, Gereksinimler, DPP uyarıları, PDM Vault
• Sohbet (/api/ai/guru/chat) — sohbet geçmişi + canlı bağlamla yanıt üretir
• Aksiyon önerisi akışı: öneri oluşturma, onaylama (/api/ai/guru/actions/{id}/confirm) ve iptal etme (/api/ai/guru/actions/{id}/cancel) — öneriler 10 dakika sonra kendiliğinden geçersiz olur
• BOM Expert sohbeti (/api/ai/bom-expert/chat) — BOM Intelligence'a özel, o anki BOM/ERP verisiyle sınırlı sohbet
• Şartname çıkarımı (/api/ai/specification/extract) ve gereksinim yeniden yazımı (/api/ai/requirements/rewrite)
• Issue'lardan aksiyon önerisi üretme (/api/ai/issues/recommend-actions)
• Kickoff paketi oluşturma (/api/ai/kickoff-package): şartname metninden gereksinim adayları çıkarıp bir başlangıç paketine dönüştürür
• Anthropic → Groq → kural tabanlı fallback sağlayıcı zinciri; API anahtarı olmadan da çalışır

Kısıtlar / Bilinen Sınırlar

• Asistan yalnızca iki, insan onayı gerektiren ve geri döndürülebilir nitelikte aksiyon önerebilir; issue kapatma, ECR/ECO/ECN işlemleri ve maliyet simülasyonu kasıtlı olarak kapsam dışıdır — bu kararlar çok adımlı onay zinciri gerektirir.
• API anahtarı tanımlı değilse yanıtlar kural tabanlı (deterministik) fallback'e düşer; bu durumda serbest metin üretimi değil, önceden tanımlı kalıplar kullanılır.
• Yanıtlar öneridir; kritik kararlarda (durum kapatma, değişiklik onayı) insan doğrulaması olmadan uygulanmaz.