Kullanıcı kılavuzu
Kurulumdan ilk araştırmaya
Program kayıt olmadan kurulur; içtihat, mevzuat ve hukuk kütüphanesi hemen çalışır. UYAP, dosya analizi, dilekçe ve danışma için lisans ve bir yapay zekâ hesabı gerekir. Aşağıdaki sıra, en kısa yol.
01Kurulum
- AHGAsistan-win-Setup.exe dosyasını indirip çalıştırın (~90 MB).
- Kurulum kullanıcı hesabınıza yapılır; yönetici yetkisi istemez, masaüstüne ve Başlat menüsüne kısayol ekler.
- Windows 10 veya 11 yeterlidir. .NET, Python ya da başka bir bileşen kurmanız gerekmez; taranmış belgeler Windows'un kendi OCR'ıyla okunur.
02Lisans
Lisans yalnızca avukatlara verilir; kayıt formunu baro sicilinizle doldurun. Başvurunuz incelendikten sonra e-postanıza bir indirme bağlantısı gelir.
- Bağlantıdan .lisans dosyasını indirin.
- Programda Ayarlar → Lisans → Lisans dosyası yükle… ile dosyayı seçin.
- Sol altta adınız ve bitiş tarihi görünür; kilitli modüller açılır.
Aynı dosyayı büro ve ev bilgisayarınıza yükleyebilirsiniz. Lisans çevrimdışı doğrulanır: program parola sormaz, çalışmak için internete bağlı olmanızı gerektirmez.
03Yapay zekâ anahtarı
PDF Yapay zekâyı bağlama kılavuzu İki sayfa, adım adım: sağlayıcı seçimi, anahtar alma, Claude Code, dış uygulama bağlantısı ve sık karşılaşılan hatalar. Yazdırılabilir. 141 KBDosya analizi, dilekçe ve danışma modülleri metni sizin seçtiğiniz yapay zekâ sağlayıcısına gönderir. Anahtar sizde kalır, kullanım doğrudan kendi hesabınızdan işler; AHG Asistan aracı olmaz, üzerine ücret eklemez.
Programda sol menüden Yapay Zekâ Bağlantısı açılır. Bu sayfa iki sekmelidir ve açılışta doğru sekme zaten seçilidir: “AHG Asistan yapay zekâ kullansın”. Anahtar buraya girilir — sağlayıcıyı seçin, anahtarı yapıştırın, Bağlantıyı Sına deyip Kaydet'e basın. Model kutusunu boş bırakırsanız hesabınıza açık en uygun model kendiliğinden seçilir. Kaydettikten sonra anahtar kutusu boşalır; bu normaldir — kayıtlı anahtar güvenlik gereği bir daha gösterilmez, kutunun altında “Kayıtlı bir anahtar var” yazar.
Anthropic — Claude
- Hesap açın, Billing'den bakiye yükleyin (ön ödemeli).
- Create key ile anahtar üretin; sk-ant-… ile başlar.
- Anahtar yalnızca bir kez gösterilir — kopyalayıp programa yapıştırın.
OpenAI — ChatGPT (GPT)
- ChatGPT aboneliği ile API ayrıdır; Billing'den ödeme yöntemi tanımlayın.
- Create new secret key; anahtar sk-… ile başlar.
Google — Gemini
- Google hesabınızla girin, Create API key.
- Ücretsiz katman Pro modellere kapalıdır; program o durumda Flash modeline geçer.
Kendi sunucunuz (OpenAI uyumlu)
- Sağlayıcı olarak OpenAI uyumlu seçin, taban adresi yazın (ör. http://localhost:11434/v1).
- Yerel modellerde metin bilgisayarınızdan hiç çıkmaz; karşılığında hız ve kalite modelinize bağlıdır.
04Claude · Codex · Gemini bağlantısı
Kendi sohbet uygulamanızdan UYAP dosyalarınızı, evraklarınızı ve içtihat/mevzuat korpusunu sorabilirsiniz. Sol menüden Yapay Zekâ Bağlantısı açın ve ikinci sekmeye geçin: “Yapay zekâ uygulamam AHG Asistan'ı kullansın”. Bilgisayarınızda bulunan uygulamalar orada listelenir.
Bu, bölüm 03'teki anahtar ayarından farklı bir iştir: anahtar, programın kendi modüllerini (dosya analizi, dilekçe, danışma) çalıştırır; buradaki bağlantı ise sizin sohbet uygulamanızın programdaki verilere erişmesini sağlar. Bu bağlantı isteğe bağlıdır — programın kendi modülleri bunsuz da çalışır.
- Uygulamanın yanındaki Bağla'ya basın.
- O uygulamayı kapatıp yeniden açın. Claude Desktop'ta pencereyi kapatmak yetmez — sistem tepsisindeki simgeden çıkış yapın.
- Sohbette ahg-asistan araçları görünür. "2025/111 dosyamda son duruşma ne zamandı?" diye sorun.
Sayfada tanınan uygulamalar: Claude Desktop, Claude Code, ChatGPT · Codex, Google · Gemini CLI, Google · Antigravity (agy), Cursor, Windsurf ve VS Code · Copilot. Bunların dışında bir uygulama kullanıyorsanız sayfadaki Tanımı Kopyala düğmesiyle tanımı alıp o uygulamanın kendi MCP ayarına yapıştırın.
Gemini CLI kullanacaksanız: Google hesabıyla giriş Haziran 2026'da kapatıldı. aistudio.google.com/apikey adresinden ücretsiz API anahtarı alıp Gemini'de ikinci seçeneği (Use Gemini API Key) seçin. Google kullanıcıları yeni aracı Antigravity (agy)'ye yönlendiriyor; o da listede.
ChatGPT'nin masaüstü uygulaması bu bağlantıyı kabul etmiyor: yalnızca internet üzerinden erişilen bağlayıcılar ekliyor, bilgisayardaki bir programa bağlanamıyor. ChatGPT tarafında çalışan yol ChatGPT · Codex'tir.
Bağlantı yalnızca kendi bilgisayarınızın içindedir; UYAP verisi için AHG Asistan açık ve UYAP'a bağlı olmalıdır. Hiçbir araç UYAP'a yazmaz.
05UYAP bağlantısı
- Üst şeritteki UYAP'a Bağlan düğmesine basın.
- Açılan pencerede Avukat Portal'a kendi e-imzanızla her zamanki gibi girin.
- Gösterge yeşile dönünce dosya, evrak, duruşma ve sorgu işlemleri açılır.
Program kimlik bilgilerinizi saklamaz; oturum sizin bilgisayarınızda açılır, program kapanınca biter. Talepler UYAP'ın kendi ürettiği evrakla, kartınızdaki imzayla gönderilir.
06Tebligat ve süre takibi
Tebligat gelir, süre o anda işlemeye başlar. AHG Asistan UETS kutunuza bağlanır, tebligatı okur, yapılacak işi ve son günü belirler; ayın tamamını takvimde gösterir ve dosyanın belgeleriyle dilekçe taslağı hazırlar.
Asistan UETS'e de UYAP'a da hiçbir şey yazmaz; yalnızca okur.
Üretilen metin taslaktır, imza atılmaz ve hiçbir yere gönderilmez. Kaynağı olmayan bir şey
yazılmaz; belirlenemeyen alanlar [TAMAMLANACAK] diye işaretlenir.
Dilekçe hazırlama adımı lisans gerektirir.
07Adliye Rehberi
Beraat vekalet ücreti, CMK görevlendirmesi ve benzeri hâllerde Cumhuriyet Başsavcılığına serbest meslek makbuzu kesersiniz; makbuza yazılacak mükellef unvanı, vergi numarası ve vergi dairesi tek bir resmî yerde toplanmış değildir. Bu modül 81 ildeki 615 faal kurumun künyesini, adresini ve telefonunu bir araya getirir. Lisans gerektirmez ve künye programın içinde olduğu için internet bağlantısı istemez.
- Arama ve süzme: adliye adı, il, ilçe, CBS unvanı, vergi numarası ya da vergi dairesi yazabilirsiniz; ayrıca il ve ilçe kutularıyla daraltırsınız.
- Künye: CBS unvanı, vergi numarası ve vergi dairesi üstte; adres ve telefon altında. Bilgileri kopyala hepsini uyarılarıyla birlikte panoya alır.
- Adliyesi kapanan yerler: birleşen, kapanan ya da hiç kurulmamış 407 yer için hangi adliyenin baktığı yazılıdır. “Esenyurt” aradığınızda Büyükçekmece Adliyesi çıkar ve tek tıkla onun künyesine geçersiniz.
- Yeşil: resmî kaynakta ya da baro yayınında bulundu.
- Turuncu: aynı adlı bir vergi dairesi var ama kurumun ona bağlı olduğu doğrulanmadı — isim eşleşmesine dayalı öneridir.
- Kırmızı: kaynaklar farklı vergi numarası yayımlıyor. Biri seçilip öne çıkarılmaz; hepsi kaynağıyla birlikte gösterilir.
Künye yayımlanmış kaynaklardan derlendi; hiçbir değer kurumun kendisine sorularak teyit edilmedi ve program bunu saklamaz. Makbuzu kesmeden önce teyit sorumluluğu avukattadır.
08İlk araştırma
- İçtihat Araştırma: olayı bir cümleyle yazın ("kiracının depozitoyu geri alamaması"). Anlam bazlı arama, kelimeler kararda birebir geçmese de konuyla ilgili kararları getirir; daire şeridinden kaynak, künye alanlarından esas/karar/yıl daraltması yapabilirsiniz.
- Mevzuat: kanun adı ya da numarası (ör. 1136) yazın; maddeler listelenir, metin içinde arayabilirsiniz.
- Hukuk Kütüphanesi: temel kanunlara tek tıkla erişim, resmî kaynak bağlantıları ve kendi kitap/şablon klasörünüz.
- Dosya Analizi: UYAP'a bağlıyken dosya numarasını yazıp Evrakları Getir, sonra Seçilenleri Analiz Et. Özet, gelinen aşama ve içtihat önerileri çıkar; HTML rapor olarak dışa aktarılır.
- Dilekçe / Mütalaa: seçtiğiniz kararlar, mevzuat maddeleri ve dosya evrakları kaynak alınarak metin üretilir.
09Verileriniz
- Bilgisayarınızda kalan: UYAP sorgu sonuçları, indirilen evraklar, analizler, dilekçeler, sohbetler, lisans ve yapay zekâ anahtarınız (%LOCALAPPDATA%\AHG Asistan).
- Dışarı giden: yalnızca içtihat/mevzuat arama sorgunuz (kaydedilmez) ve analiz/dilekçe için sizin seçtiğiniz sağlayıcıya sizin anahtarınızla giden metin.
- Bize ulaşan: lisans seri numarası ve sürüm denetimi. Başka hiçbir şey.
Ayrıntı: gizlilik ve KVKK metni · kayıt aydınlatma metni.
10Sorun giderme
- Yapay zekâ "anahtar geçersiz" diyor: anahtarın başında/sonunda boşluk kalmış olabilir; ayrıca sağlayıcı hesabınızda bakiye/ödeme yöntemi tanımlı olmalı.
- Sohbette ahg-asistan araçları görünmüyor: uygulamayı tamamen kapatıp açın (Claude Desktop'ta sistem tepsisinden çıkış yapın). Sorun sürerse Yapay Zekâ Bağlantısı → “Yapay zekâ uygulamam AHG Asistan'ı kullansın” sekmesinde satır "eski kurulum yolu" diyorsa Yolu Güncelle'ye, bir şey değişmiyorsa MCP'yi Sına'ya basın.
- Gemini ya da Codex "komut bulunamadı" diyor: bu araçların komut satırı sürümleri Node.js ister. Aynı sayfanın altındaki Gerekli araçlar şeridinden Kur'a basın, sonra AHG Asistan'ı yeniden başlatın.
- UYAP göstergesi kırmızı: portal oturumu düşmüştür; UYAP'a Bağlan ile yeniden giriş yapın (UYAP oturumları bir süre sonra kendiliğinden kapanır).
- Evraklar okunamadı: belge taranmış olabilir; Dosya Analizi'nde Taranmışları OCR ile oku kutusunu işaretleyin.
- Lisans bağlantısının süresi doldu: bize yazın, yenisini gönderelim.
Çözemediğiniz bir durumda info@ahgasistan.com adresine yazın; sürüm numarasını (sol altta) eklerseniz daha hızlı yanıtlarız.