AI (Claude / OpenAI / Gemini)
AppArch’ta AI tüm kurulum için bir kez, kurulum operatörü tarafından yapılandırılır. Çalışma alanları kendi anahtarlarını ekleyemez; Entegrasyonlar altında AI girişi yoktur.
Yapılandırma
Bölüm başlığı “Yapılandırma”Yönetim → Ayarlar → Asistan (/management/settings/assistant) sayfasını açıp şunları ayarlayın:
- Sağlayıcı - Anthropic (Claude), OpenAI veya Google (Gemini). Aynı anda tek sağlayıcı.
- API anahtarı - operatörün kendi anahtarı; kullanım ücretini sağlayıcı bu hesaba faturalar.
- Sunulan modeller - bu kurulumun kullanabileceği tüm modeller. İlki varsayılandır. Birden fazla model listelenirse kullanıcılar Archito’nun Sor sekmesinde her soru için seçer.
- Asistanı kullanıcılara sun - Archito’nun Sor sekmesini açar.
- Bulgularda çözüm önerisine izin ver - ayrı bir anahtardır, çünkü her öneri sağlayıcıya bir bulgu gönderir.
- Jeton bütçeleri - isteğe bağlı günlük ve haftalık tavanlar; çalışma alanı başına ve tüm kurulum için.
Her şey varsayılan olarak kapalıdır. Operatör aynı sayfadaki AI işleme sözleşmesini kabul etmeden ne asistan ne de çözüm önerileri açılabilir.
API anahtarı kurulumun ana anahtarıyla şifrelenir. Kaydedildikten sonra bir daha gösterilmez; yalnızca son dört karakteri görünür.
Neler kullanır?
Bölüm başlığı “Neler kullanır?”| Özellik | Kim açar | Sağlayıcıya ne gönderilir |
|---|---|---|
| ArchPilot ve ArchScan bulgularında çözüm önerisi | Operatör: Bulgularda çözüm önerisine izin ver | Kural anahtarı, önem derecesi, dosya yolu ve satır, bulgu mesajı ve analizörün kendi önerisi |
| Archito → Sor sekmesi | Operatör: Asistanı kullanıcılara sun | Soru ve yanıtlamak için kullanılan rakamlar (proje adları, bulgu sayıları, tarama toplamları) |
| İnceleme yorumlarında AI kararı (MR yorumları) | Çalışma alanı: ArchPilot ayarları, isteğe bağlı; operatörün iki anahtarından biri açık olmalı | Sınıflandırılan, henüz değerlendirilmemiş inceleme yorumları |
| MD üretici, AI modu | Operatör: Bulgularda çözüm önerisine izin ver | Proje bilgileri, üretilen şablon taslağı ve deponun sığ bir kesiti: açıklama, konu etiketleri, kök dizin listesi, birkaç manifest dosyası (ör. package.json, *.csproj, go.mod, kısaltılmış) ve mevcut README |
Hiçbiri depoyu bütünüyle göndermez. Asistanın kullanıcı tarafı: Archito, asistan.
Çözüm önerileri
Bölüm başlığı “Çözüm önerileri”- Yanıt, okuyanın panel dilinde (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, Rusça, Arapça, Azerbaycanca; diğerleri İngilizceye düşer) ve varsayılan modelle yazılır.
- Her yanıt bulguyla birlikte; sağlayıcı, model, girdi ve çıktı jeton sayıları ve dil bilgisiyle saklanır. Aynı bulguyu sonra açan kişi saklanan yanıtı görür, yeniden jeton harcanmaz. Yeniden üretmek bilinçli bir işlemdir.
MD üretici
Bölüm başlığı “MD üretici”AI olmadan MD üretici şablon modunda çalışır (yalnızca İngilizce). Bkz. MD üretici.
Sınırlar
Bölüm başlığı “Sınırlar”- Hız sınırı: tüm özellikler toplamında çalışma alanı başına dakikada en fazla 30 AI çağrısı. Sayaç Redis’te tutulur; Redis’e ulaşılamazsa sınır uygulanmaz.
- Jeton bütçeleri: çalışma alanı başına günlük ve haftalık, kurulum için günlük ve haftalık.
0sınırsız demektir. Gün UTC gece yarısı, hafta pazartesi sıfırlanır. Kurulum tavanı her zaman önceliklidir. Bütçeler Sor sekmesini ve inceleme yorumu sınıflandırmasını sayar.
Api sağlayıcıyı doğrudan çağırır:
https://api.anthropic.comhttps://api.openai.comhttps://generativelanguage.googleapis.com
AppArch’ın barındırdığı bir aracı (relay) yoktur. İnternetsiz bir ağda AI’ı kapalı bırakın; ulaşacağı bir yer yoktur.