Yapay Zeka Asistanı'nı bir firmada ilk kez devreye alırken baştan sona işaretlenecek liste. Her maddenin nasıl yapılacağı ve alanların anlamı Yapay Zeka Kurulumu ve Ön Koşullar sayfasındadır; bu sayfa yalnız sırayı ve denetlenecek noktaları verir. Sayfa yazdırılıp kurulum sırasında işaretlenebilir.

1. Ön koşullar

• ☐ Güncelleme aboneliği geçerli. Araçlar > Yapay Zeka Asistanı açılıyor, "Güncelleme Aboneliğinizin olması gerekli" uyarısı çıkmıyor.
• ☐ Veritabanı programın bu sürümüne yükseltilmiş. Yapay zeka için veritabanında elle nesne oluşturmak ya da yetki vermek gerekmez; gerekenler yükseltmeyle gelir.
• ☐ Yapay zeka sağlayıcısı hesabı ve API anahtarı hazır (OpenAI, Claude, Gemini, firmanın kendi ağ geçidi ya da yerel bir model sunucusu). Kullanım ücreti firmanın sağlayıcı hesabına yansır.
• ☐ NetsimSystemAgent güncel sürümle çalışıyor ve yardım havuzu yanında kurulu. Asistanın NETSİM yardımından cevap vermesi buna bağlıdır; firma belgeleri kullanılacaksa belge havuzu ajanda tanımlı. Ajanın kurulumu: NetsimSystemAgent Kurulumu.

2. Sağlayıcı tanımı

Netsim Konnektör Tanımları'nda yeni kayıt (alanların ayrıntısı: Yapay zeka sağlayıcısı tanımı):

• ☐ Connector türü AI Provider; Yapay Zeka sekmesi göründü.
• ☐ Connector kodu / adı dolu. Ad, kullanıcının asistanda seçeceği addır ("OpenAI", "Claude – yapıştırma" gibi).
• ☐ Connector sistemi seçili. OpenAI uyumlu bir ağ geçidi için OpenAi seçilip Servis bağlantı adresi dolduruldu.
• ☐ Api key girildi. Önerilen @OPENAI_API_KEY biçimidir: anahtar veritabanında değil bilgisayarın ortam değişkeninde durur. Bu durumda değişken asistanı kullanacak her bilgisayarda tanımlanmalıdır.
• ☐ Model seçildi ya da bilerek boş bırakıldı (boşsa sürücünün öndeğer modeli). Özet, brif, ajan işleri ve akıllı yapıştırma bu modeli kullanır.
• ☐ Kayıt Aktif ya da Onaylandı durumunda.
• ☐ (İsteğe bağlı) Akıllı yapıştırma için hızlı bir modelle ikinci kayıt, Akıllı yapıştırmada kullan işaretli.
• ☐ (İsteğe bağlı) Sesli konuşma için AI Realtime türünde ayrı kayıt; bkz. Sesli Konuşma.

3. Kullanıcılar ve yetki

• ☐ Asistanı kullanacak kullanıcılarda Kullanıcı Tanımları ekranında Yapay zeka kullanımı = Kullanabilir.
• ☐ Kullanmayacak kullanıcılarda Kullanamaz: asistan, akıllı yapıştırma ve özetler bu kullanıcılara kapanır.
• ☐ Yapay zeka tanım ekranlarının (hazır komutlar, uzak ajanlar, MCP sunucuları, ajan işleri) yetkisi yalnız yönetici grubuna verildi; olağan ekran yetkisiyle.
• ☐ Asistanın veriyi kullanıcının kendi yetkisiyle okuduğu bilindi: asistana ayrıca yetki verilmez, yetkisi olmayan modülde kullanıcı "bu veriye yetkiniz yok" cevabı alır.

4. Veri araçları

Araçlar NetsimSistem'de Tanımlar > Web Servis Uç Noktaları ekranında AI Function yöntemiyle tanımlıdır ve kurulumla gelir (hangi araçların olduğu: Asistana Veri Soruları: Veri Araçları).

• ☐ Kurulumla gelen araçlar aktif (cari, stok, belge, finans, muhasebe, üretim, insan kaynakları, kalite).
• ☐ Firmanın kullanmadığı modüllerin araçları kapatıldı: kayıt durumu Aktif / Onaylandı dışına alındı. Her soruda modele gönderilen araç listesi kısalır, maliyet düşer.
• ☐ Serbest sorgu aracı kapalı kaldı. Gerekirse yalnız yöneticiye ayrılmış bir sağlayıcı tanımında İzinli araçlar listesiyle açılır.
• ☐ Gerekiyorsa sağlayıcı tanımında İzinli araçlar / Yasak araçlar dolduruldu.
• ☐ Kullanıcılara asistanda Araç kullanımı = Onay İle Kullan önerildi. Onay Beklemeden Kullan seçilirse mesaj gönderme ve görev oluşturma da onay sorulmadan çalışır.

5. Hazır komutlar

Yapay Zeka Hazır Komut Tanımları ekranında:

• ☐ Kurulumla gelen 22 örnek komut listede (/cari-ozet … /yz-kullanim, /araclar, /rehber).
• ☐ Kullanılmayan modüllerin komutları pasife çekildi.
• ☐ (İsteğe bağlı) Firmaya özgü komutlar ya da talimatlar eklendi; talimatların Açıklama alanı dolu.

6. Deneme

Bir kullanıcı bilgisayarında, Kullanabilir yetkili bir kullanıcıyla:

• ☐ Asistan açılıyor; Sağlayıcı listesinde tanımlanan ad görünüyor.
• ☐ "Merhaba" yazınca cevap geliyor (anahtar ve adres doğru).
• ☐ /vade-bugun ya da "Kritik stokta olan ürünler hangileri?" sorusunun cevabında araç rozeti görünüyor ve sonuç programdaki veriyle uyuşuyor.
• ☐ Bir giriş ekranı açıkken bir metin kopyalanıp Araçlar > Akıllı Yapıştır (Ctrl+Shift+V) çalıştırıldığında alanlar doluyor ve kayıt kaydedilmiyor.
• ☐ /yz-kullanim komutunda az önceki çağrılar model, gün ve kullanıcı toplamlarında görünüyor (kullanım günlüğü yazılıyor).
• ☐ Kullanamaz yetkili bir kullanıcıyla asistan açılmıyor, "yapay zekâ kullanma yetkisi yok" uyarısı geliyor.
• ☐ "Cari kart nasıl açılır?" sorusuna yardımdan cevap ve yardım sayfası bağlantısı geliyor (sistem ajanı ve yardım havuzu çalışıyor).

7. Sık kurulum hataları

Belirti	Neden ve çözüm
Sağlayıcı listesi boş	Tanımın türü AI Provider değil ya da kayıt Aktif / Onaylandı değil.
"API key" hatası	Anahtar boş; @AD biçimi kullanılmışsa ortam değişkeni o bilgisayarda yok. Değişken tanımlandıktan sonra program yeniden açılır.
Bağlantı hatası, zaman aşımı	Servis adresi yanlış; vekil sunucu ya da güvenlik duvarı sağlayıcıya çıkışı kapatıyor.
Cevap geliyor ama araç rozeti hiç yok	Asistanda Araç kullanımı = Kullanma; araçlar kapalı; seçili model araç çağrısını desteklemiyor; izinli/yasak araç listeleri aracı dışarıda bırakıyor.
Veri sorusuna "yetkiniz yok" cevabı	Beklenen davranıştır: kullanıcının o modülde yetkisi yoktur.
Yardım soruları cevaplanmıyor	Sistem ajanı çalışmıyor, sürümü eski ya da yardım havuzu kurulu değil.
Sesli konuşma hata veriyor	AI Realtime türünde aktif tanım yok; Parametreler'de sürücünün tanımadığı bir ayar var; Windows mikrofon izni kapalı.
Akıllı yapıştırma "önce bir giriş ekranı açın" diyor	Önde bir giriş ekranı yok; doldurulacak alanların bulunduğu sekme önde olmalıdır.

Diğer belirtiler için bkz. Bilinen Sınırlar ve Sorun Giderme.