AHGAHG Asistan

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

  1. AHGAsistan-win-Setup.exe dosyasını indirip çalıştırın (~90 MB).
  2. 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.
  3. 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.
Windows ya da antivirüs uyarısı: Kurulum dosyası henüz kod imzalama sertifikasıyla imzalanmadığı için Windows "bilgisayarınızı korudu" diyebilir, bazı antivirüs programları da tereddüt edebilir. Dosyada zararlı bir şey bulunduğu anlamına gelmez; program yeni olduğu için henüz "tanınmıyor". Daha fazla bilgi → Yine de çalıştır ile devam edin. Dosyayı yalnızca bu siteden indirin; doğrulamak isterseniz SHA-256 özeti kurulum sayfasında. Sertifika tamamlandığında bu uyarılar kendiliğinden kalkacak.

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.

  1. Bağlantıdan .lisans dosyasını indirin.
  2. Programda Ayarlar → Lisans → Lisans dosyası yükle… ile dosyayı seçin.
  3. 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 KB

Dosya 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.

İkinci sekme başka bir iş. “Yapay zekâ uygulamam AHG Asistan'ı kullansın” sekmesi, kendi sohbet uygulamanızı programa bağlamak içindir (bölüm 04). Bu sayfadaki anahtar ayarı programın kendi modüllerini çalıştırır; o sekme ise ters yöndeki bağlantıdır. İkisi birbirinin yerine geçmez.

Anthropic — Claude

console.anthropic.com → Settings → API keys
  1. Hesap açın, Billing'den bakiye yükleyin (ön ödemeli).
  2. Create key ile anahtar üretin; sk-ant-… ile başlar.
  3. Anahtar yalnızca bir kez gösterilir — kopyalayıp programa yapıştırın.

OpenAI — ChatGPT (GPT)

platform.openai.com → API keys
  1. ChatGPT aboneliği ile API ayrıdır; Billing'den ödeme yöntemi tanımlayın.
  2. Create new secret key; anahtar sk-… ile başlar.

Google — Gemini

aistudio.google.com → Get API key
  1. Google hesabınızla girin, Create API key.
  2. Ücretsiz katman Pro modellere kapalıdır; program o durumda Flash modeline geçer.

Kendi sunucunuz (OpenAI uyumlu)

Ollama · LM Studio · Azure OpenAI · OpenRouter
  1. Sağlayıcı olarak OpenAI uyumlu seçin, taban adresi yazın (ör. http://localhost:11434/v1).
  2. Yerel modellerde metin bilgisayarınızdan hiç çıkmaz; karşılığında hız ve kalite modelinize bağlıdır.
Anahtar nerede saklanıyor? Yalnızca bu bilgisayarda, Windows hesabınıza bağlı olarak şifrelenmiş (DPAPI) biçimde. İkinci bilgisayarda yeniden girmeniz gerekir; dosya olarak taşınamaz.

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.

  1. Uygulamanın yanındaki Bağla'ya basın.
  2. O uygulamayı kapatıp yeniden açın. Claude Desktop'ta pencereyi kapatmak yetmez — sistem tepsisindeki simgeden çıkış yapın.
  3. 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.

Gerekli araçlar şeridi. Sayfanın altında, bağlanmak istediğiniz uygulamanın ihtiyaç duyduğu araçlar listelenir. Bugün tek madde Node.js: Gemini ve ChatGPT·Codex'in komut satırı sürümleri için gerekir, Claude Desktop ve AHG Asistan'ın kendisi için gerekmez. Kurulu değilse Kur düğmesi kurulumu başlatır; bittikten sonra AHG Asistan'ı yeniden başlatı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ı

  1. Üst şeritteki UYAP'a Bağlan düğmesine basın.
  2. Açılan pencerede Avukat Portal'a kendi e-imzanızla her zamanki gibi girin.
  3. 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.

Tebligatlar ekranı: UETS'e bağlanma ve gelen tebligatların listelenmesi
1 · Bağlanın ve listeleyin. Tebligatlar ekranında UETS'e Bağlan'a basın; giriş PTT'nin kendi e-imza uygulamasıyla yapılır. Tarih aralığını seçip Getir deyin. Daha önce incelenen tebligat barkodundan tanınır, ikinci kez işlenmez.
Tebligatın okunması: belge türü, yargı kolu, metindeki süre ve temsil sıfatı
2 · Tebligat okunur, iş çıkarılır. Ekteki belge ve mazbata metni incelenir: belgenin türü, yargı kolu, metinde yazan özel süre ve temsil sıfatı belirlenir. Belge tanınamazsa tahmin edilmez; iş "inceleyin" olarak işaretlenir.
Süre hesap kartı: tebliğ tarihi, dayanak madde, sürenin dolduğu gün ve adli tatil
3 · Süre hesaplanır, hesap gösterilir. Tebliğ tarihi UETS'in delil kaydından alınır, hesaplanmaz. Hangi maddeye dayanıldığı ve adli tatilin nasıl uygulandığı adım adım yazılır. Bilgi eksikse son gün verilmez.
Ceza kanun yolu süreleri: 7499 sayılı Kanun'a göre uygulanır — CMK m.273 (istinaf) ve m.291 (temyiz) için iki hafta, 1.6.2024 ve sonrasında verilen kararlarda. Daha eski kararlarda eski süreler geçerlidir ve karar tarihi okunamıyorsa program son gün hesaplamaz. Cezada adli tatil uzaması CMK m.331/4 uyarınca HMK'dan ayrı hesaplanır.
Süre Ajandası: ay takvimi, işi olan günlerde renkli noktalar ve seçili günün işleri
4 · Süre Ajandası. İşi olan günde nokta vardır; rengi aciliyeti söyler (geçmiş, bugün, ileride, tamamlandı). Güne tıklayınca o günün işleri sağda açılır. Son günü hesaplanamayan işler takvimde görünmez; sayıları alt satırda yazar.
Dilekçe taslağı: okunan dosya belgeleri ve üretilen taslak
5 · Dilekçe taslağı. Asistan UYAP'taki dosyayı mahkeme ve esas numarasıyla bulur; dilekçe teatisini, tutanakları ve raporları okuyup tebliğ edilen işlemle karşılaştırır. Tebligat, mazbata, vekâlet ve ödeme evrakı indirilmeden elenir.

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.
Her değer ne kadar güvenilir olduğunu söyler.
  • 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.