Yerelde Kurulum (On-Premises) Yapay Zeka Kurulum Kılavuzu

İleri Düzey Konular

Bu belge, kurulum aşamalarını profesyonel ve sistematik biçimde tamamlamanız için rehberlik eder. Kurulum sürecinde herhangi bir konuda yardımcı olmaya hazırız.

SaaS vs On-Premises

Yerinde Yapay Zeka Kurulum Kılavuzu

SaaS Karşısında Yerinde Kurulum

YapayZeka.Site, hem bulut (hosted) hem de kurum içi (on-premises) sürümlerini sunmaktadır. Bu kurulum kılavuzu, kendi sunucunuzda barındırılan, yani “self-hosted” on-premises sürüm içindir.

Bu kılavuz, Süper Yapay Zeka uygulamasının web tabanlı yardım masası yazılımının kurulumu ve işletimini temel alan bir rehberdir. Size, Süper Yapay Zeka Talepleme Sisteminin kurulumunu ve temel kullanımını adım adım anlatacağız.

Geçerli Sürüm

Bu kılavuz Süper Yapay Zeka 10 ve üzeri sürümler için hazırlanmıştır. Önceki sürümlere ait kılavuzlar farklıdır ve bu dokümanda yer almamaktadır.

Genel Bakış

Süper Yapay Zeka‘yı tercih ettiğiniz için teşekkür ederiz. Yazılım, müşteri destek ekiplerinin etkin ve etkili hizmet sunmasını sağlamak için tasarlanmış web tabanlı bir yardım masası uygulamasıdır. YapayZeka.Site, .NET 8 teknolojisi üzerine geliştirilmiş olup, kullanıcılar web tarayıcısı üzerinden erişim sağlayabilir.

Talepler ve Kategoriler

Talepler (taleps), “sorunlar”, “destek talepleri” veya “destek vakaları” olarak da anılır ve Yapay Zeka sistemindeki temel birimlerdir. Kullanıcılar tarafından oluşturulur ve işlem kolaylığı açısından kategorilere ayrılır.

Kullanıcı Roller

Süper Yapay Zeka’da 4 farklı kullanıcı rolü bulunmaktadır:

Normal Kullanıcı: Sisteme destek talepleri gönderen temel kullanıcıdır.
Yönetici Kullanıcı: Kendi şirketi içindeki diğer kullanıcıların taleplerini görebilen ve kapatabilen ek yetkilere sahip kullanıcıdır.
Temsilci (Temsilci / YapayZeka Agent): Yönetici tarafından en az bir kategori için talepleri yönetme yetkisi verilmiş kullanıcıdır. Katogorilerde yeni talep açıldığında bu kullanıcılar e-posta bildirimleri alır. Not: Bir kullanıcıyı Temsilci yapmak için, yönetici kategori düzenleme veya kullanıcı profili üzerinden yetki vermelidir.
Yönetici (Administrator): En yetkili roldür. Sistem ayarlarını değiştirir, kullanıcıları kategorilere atar (böylece Temsilci yapar), kategoriler oluşturur ve kullanıcı ekleme veya silme işlemleri yapar. Not: Yönetici, varsayılan olarak yeni taleplerden e-posta bildirimi almaz, ancak Temsilci olarak atandığı kategorilerde bildirim alır.

Sistem Gereksinimleri

Platformlar

Süper Yapay Zeka, aşağıdaki işletim sistemlerinden biri üzerinde çalışan sunuculara kurulabilir:

Microsoft Windows Server 2012 veya sonrası
Linux (Ubuntu, CentOS, WSL2, Debian test edilmiştir)
Docker

Yapay Zeka, web tabanlı olduğu için istemci (client) tarafında işletim sistemi bağımsızdır. Chrome, Firefox, MS Edge, Safari gibi yaygın web tarayıcıları kullanılarak erişilebilir.

Gerekli Yetkinlikler

Bir web uygulamasını sunucuya kurmak karmaşık olabilir. MS SQL Server yükleme ve yönetimi, veritabanı oluşturma ve SQL scriptleri çalıştırma bilgisi gerektirir. Ayrıca, Windows için IIS veya Linux için Nginx web sunucusu ayarları hakkında temel deneyim faydalı olacaktır.

Önerimiz; eğer teknik bilgi ve deneyiminiz yoksa, YapayZeka.Site’nin bulut sürümünü kullanmanızdır. Sunucu sürümü, deneyimli kullanıcılar için uygundur.

Ön Koşullar

Windows

Sunucuda aşağıdaki bileşenler yüklü olmalıdır:

Microsoft .NET 8 Hosting Bundle
Internet Information Services (IIS) web sunucusu, ASP.NET özelliği etkinleştirilmiş olmalı.
- Özellikleri açmak için:
  1. Başlat menüsünden “Windows özelliklerini aç veya kapat” aratın
  2. “Internet Information Services” → “World Wide Web Services” → “Application Development Features”
  3. CGI hariç tüm bileşenleri etkinleştirin
  4. “Common HTTP Features” altında WebDAV ve Directory Browsing dışındaki tüm özellikleri açın
  5. Windows Entegre Kimlik Doğrulaması kullanacaksanız, IIS’de “Windows Authentication” rolü kurulmalıdır
Microsoft SQL Server 2012 veya daha yeni sürümü, hem Windows hem de SQL kimlik doğrulamasını destekleyen “Mixed Mode” olarak yapılandırılmış olmalı
- SQL Server Express ve Developer sürümleri ücretsizdir (Developer sürümünün lisans şartlarına dikkat edilmelidir)
- YapayZeka.Site, SQL kimlik doğrulamasını kullanır; bu yüzden Mixed Mode ve SA kullanıcısı için parola belirtilmiş olmalıdır.
Full-Text Search (tam metin arama) özelliği isteğe bağlıdır, fakat şiddetle tavsiye edilir. SQL Server’ın güncel sürümleri bunu varsayılan olarak içerir.

Microsoft .NET 8, IIS ve SQL Server Express ücretsiz olarak temin edilebilir.

Linux

Güncel bir Linux dağıtımı (örneğin Ubuntu 22.04)
Microsoft SQL Server kurulumu (Windows ya da Linux üzerinde olabilir). Bu kılavuzda, SQL Server aynı makineye kurulacaktır fakat ölçeklenebilirlik için ayrı sunucu önerilir. SQL Server Express sürümleri ile başlanabilir.
.NET Runtime 8 veya sonrası kurulu olmalı. Ubuntu’da aşağıdaki komut ile kurulabilir:

bash

sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-8.0

Docker

Herhangi bir Docker motoru yeterlidir. Docker Desktop en kullanışlı seçenektir.

Süper Yapay Zeka Kurulumu

Teknik açıdan, Süper Yapay Zeka iki temel bileşenden oluşur: web uygulaması ve SQL Server veritabanı.

Web uygulamasını sunucudaki bir klasöre açarsınız,
Veritabanını ise veritabanı sunucusuna kurarsınız.

Windows

Süper Yapay Zeka Kurulumu Yöntemleri

Süper Yapay Zeka, iki farklı şekilde kurulabilir:

Otomatik Kurulum:
- setup.exe kurulum dosyasını başlatarak yapılır.
- Yerel bir sunucuya kuruluyor ve fiziksel veya terminal erişiminiz varsa önerilir.
Manuel Kurulum:
- Sistem yöneticisi veya ileri düzey kullanıcılar için uygundur.
- Örneğin, yazılımı bir hosting ortamına yüklemek istediğinizde tercih edilir.

Setup.exe ile Kurulum

Öncelikle tüm ön koşulları yükleyin, özellikle .NET 8 Hosting Bundle
Dosyaları açın (unzip işlemi yapın)
install.bat dosyasını çalıştırın; bu dosya .NET 8’in yüklü olup olmadığını kontrol eder, ardından Setup.exe’yi başlatır
Kurulum talimatlarını takip edin

Veritabanı oluşturma aşamasında:

Kurulum, sizden SQL Server adını isteyecektir.
Eğer SQL Server Express Edition kullanıyorsanız, varsayılan olarak isimlendirilmiş örnek (named instance) olarak kurulur: SQLEXPRESS. Bu nedenle sunucu adı olarak (local)\SQLEXPRESS belirtmeniz gerekir.
Kurulum, belirtilen sunucuda “SuperYapayZeka” adlı veritabanını oluşturacaktır.
Ayrıca, “SuperYapayZekaUser” adında ve rastgele oluşturulmuş bir şifreye sahip SQL kullanıcısı yaratılacak (şifre appsettings.json dosyasına kaydedilir).

Not: Yukarıdaki işlemler için Windows hesabınızda SQL yönetici yetkilerine sahip olmanız gerekir.

Manuel Kurulum

1. Web Uygulaması Kurulumu

Ön koşulları yükleyin, özellikle .NET 8 Hosting Bundle
Dosyaları açın (unzip)
“yapayzeka” klasörünün içeriğini web sunucusundaki sanal dizine kopyalayın (örneğin, c:\inetpub\wwwroot\YapayZeka) veya web hosting ortamınıza yükleyin
Oluşturulan klasörü IIS’de uygulama (application) olarak yapılandırın (inetmgr.exe ile)

2. Veritabanı Kurulumu

Aşağıdaki seçeneklerden birini kullanabilirsiniz:

Kurulum klasöründeki sql klasörünü bulun (c:\inetpub\wwwroot\YapayZeka\sql örnek yol). İçinde bulunan SQL scriptlerini kullanın:
1. CreateEmptyDB.sql scriptini çalıştırarak boş veritabanı oluşturun,
2. CreateTables.sql scriptini boş veritabanına uygulayın. Bu işlemi SQL Server Management Studio ile gerçekleştirebilirsiniz.
appsettings.json dosyasını herhangi bir metin editörü ile açarak bağlantı dizesini (connection string) uygun şekilde güncelleyin.
- Örneğin; (local) yerine IP adresi koyabilirsiniz.
- Dikkat: Dosyada atlama karakteri için ters eğik çizgiler (\) çift ters eğik çizgi (\\) ile escape edilmelidir.
- Güncellemeden önce doğrulayıcı (validator) kullanmanızı öneririz.

Linux Kurulumu

Bu bölüm, Süper Yapay Zeka’nın Linux sistemine kurulumunu ele almaktadır.

Önemli: Linux üzerinde Yapay Zeka çalıştırmak için ileri düzey Linux yönetimi bilgisine sahip olmalısınız. Eğer bu konuda deneyimli bir Linux yöneticiniz yoksa, bulut sürümünü tercih etmenizi veya Windows üzerinde kurulum yapmanızı öneririz.

Örnek Kurulum: Ubuntu

1. SQL Server Kurulumu

Bu örnekte SQL Server Linux üzerinde kurulacaktır.

Kurulum komutları:

bash

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/mssql-server-2019.list)"
sudo apt-get update
sudo apt-get install -y mssql-server
sudo /opt/mssql/bin/mssql-conf setup

Komutlar Ubuntu 20.04 içindir. Kendi dağıtımınız için Microsoft’un belgelerine bakınız.
Kurulum sırasında lisans kabulü isteyecek ve SQL admin kullanıcı “sa” için parola belirlemeniz istenecektir.
Kurulum sonrası SQL Server çalışıyor olmalıdır.

Komut satırı araçlarını yükleyin:

bash

curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.list
sudo apt-get update
sudo apt-get install mssql-tools unixodbc-dev

2. Veritabanını Oluşturma

En son YapayZeka.Site paketini indirip açın.
Açılan klasörde sql klasörünü bulun.
Aşağıdaki komutlarla sırasıyla veritabanını oluşturun ve tabloları yükleyin:

bash

/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'SA_PASSWORD' -i CreateEmptyDB.sql
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'SA_PASSWORD' -i CreateTables.sql

Not: Scriptler varsayılan bir YapayZeka SQL Kullanıcısı oluşturur, parolasını daha sonra değiştirip appsettings.json dosyasını güncellemeniz tavsiye edilir.

3. Süper Yapay Zeka’yı Çalıştırma

.NET Runtime 8 veya üstü yükleyin:

sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-8.0

Kurulumun başarılı olduğunu kontrol edin:

dotnet --list-runtimes

Çıktıda şöyle bir liste görmelisiniz:

Microsoft.AspNetCore.App 8.0.0 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App] Microsoft.NETCore.App 8.0.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App]

appsettings.json dosyasını açarak bağlantı dizesini şu şekilde güncelleyin:

json

"DBConnectionString": "user id=SuperYapayZekaUser;data source=localhost;initial catalog=SuperYapayZeka;password=HDPassword1"

Veritabanınız farklı bir sunucuda ise bağlantı adresini ona göre değiştirin.

Uygulamanın bulunduğu dizinde şu komutu çalıştırarak Süper Yapay Zeka’yı başlatın:

bash

 YapayZeka.dll

Başarı mesajı olarak Süper YapayZeka[2170]: YapayZeka app started. göreceksiniz.

Tarayıcıdan http://localhost:5000/ adresine giderek uygulamanın açıldığını kontrol edin.
Farklı portta çalıştırmak isterseniz:

bash

dotnet YapayZeka.dll --urls http://0.0.0.0:8080

4. Nginx Reverse Proxy Yapılandırması

Bu dokümanın kapsamı dışındadır. Ancak, bir web uygulamasını ters proxy arkasında çalıştırmak tavsiye edilir. Microsoft’un resmi belgesine bakabilirsiniz. Apache için de benzer bir rehber mevcuttur.

5. Sunucu Yeniden Başlatıldığında Otomatik Başlatma

Yardım masası uygulamasının sunucu yeniden başlatıldığında otomatik başlaması için bir servis oluşturmanız gerekir.

Servis dosyasını oluşturun:

bash

sudo nano /etc/systemd/system/yapayzeka.service

Dosyaya aşağıdaki içeriği yapıştırın:

ini

[Unit]
Description=YapayZeka

[Service]
WorkingDirectory=/path/to/app
ExecStart=/usr/bin/dotnet /path/to/app/YapayZeka.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=yapayzeka
User=MyUsername
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment="ASPNETCORE_URLS=http://127.0.0.1:5001"

[Install]
WantedBy=multi-user.target

Servisi etkinleştirin:

bash

sudo systemctl enable yapayzeka.service

Servisi başlatın:

bash

sudo systemctl start yapayzeka.service

Docker ile Kurulum

Docker ile Yapay Zeka Kurulumu ve Çalıştırma

Bu bölüm, Docker kullanarak Yapay Zeka’nın nasıl kurulacağı ve çalıştırılacağına ilişkin adımları detaylı olarak açıklar. Testlerimiz, Docker Desktop 4.20.1 sürümüyle yapılmıştır.

Yapay Zeka, resmi olarak Docker üzerinden barındırılmasını desteklemektedir.

🚨 Apple Silikon Chip Kullanıcıları İçin Önemli Not:
Mac cihazınızda x86/amd64 emülasyonu için “Use Rosetta for x86/amd64 emulation on Apple Silicon” ayarını etkinleştirmeniz gerekmektedir. Bu ayarı, Docker Desktop’ta Settings → Features in Development kısmından aktif hale getirebilirsiniz.

Kurulum Adımları

Yapay Zeka yazılımını YapayZeka.Site üzerinden indirin (deneme veya lisanslı sürüm).
İndirdiğiniz dosyayı, çalıştırmak istediğiniz bir klasöre çıkarın ve içeri girin: YapayZeka klasörüne.
Klasör içindeyken terminalde aşağıdaki komutu çalıştırın:
```
docker compose up --build
```
✅ Arka planda çalıştırmanız isterseniz:
docker compose up --build -d
Tüm konteynerler başarıyla başladığında, tarayıcınızdan şu adresi açabilirsiniz:
http://localhost

💡 Tüm Yapay Zeka sürümleri, docker-compose.yml dosyasını içermektedir. Deneyimli kullanıcılar için bu dosya özelleştirilebilir. Örneğin, ters proxy kullanacaksanız port numarasını 80’den farklı bir değere değiştirebilirsiniz.

İlk Giriş

Yapay Zeka başarıyla kurulduktan sonra, tarayıcınızdan aşağıdaki adreslere erişerek giriş yapabilirsiniz:

Windows: http://myserver/YapayZeka
Linux: http://localhost:5000/

⚠️ Varsayılan Kullanıcı Bilgileri (İlk Giriş İçin):

admin / şifre: admin

client / şifre: client

Bu hesaplar sadece ilk giriş için kullanılmalıdır. Güvenlik nedeniyle, kullanım öncesi şifreleri mutlaka değiştirin.

ℹ️ Uygulamanın çoğu sayfasının alt kısmında “bu sayfa için yardım al” bağlantısı bulunur. Bu bağlantı, o sayfaya özel detaylı bilgi sağlar.

Sık Karşılaşılan Sorunların Çözümü

Tarayıcıda Yapay Zeka açılırken hata alıyorsanız, lütfen SuperYapayZeka’ya başvurmadan önce aşağıdaki kontrolleri yapın:

✅ Windows Sunucuları İçin:

ASP.NET Core Hosting Bundle yüklü olmalı (doğrudan indirme)
IIS’te Anonymous Authentication modülü etkinleştirilmeli. Aksi takdirde API ve diğer bileşenlerde sorun yaşanabilir.
Kullanılan kimlik doğrulama türüne göre:
- Windows Integrated Auth kullanıyorsanız → Windows Authentication modülü açık olmalı.
- Forms Auth kullanıyorsanız → Forms Authentication modülü açık olmalı.
❗ Diğer tüm kimlik doğrulama modülleri (Anonymous hariç) devre dışı bırakılmalıdır.

✅ Mobil Uygulamalar İçin:

API’nin düzgün çalışıp çalışmadığını test etmek için şu aracı kullanın:
http://full_yapayzeka_url/api/test

Yapay Zeka Güncelleme Yöntemleri

Windows Sistemlerde Güncelleme

🔄 Otomatik Güncelleme (Önerilen):
Uygulama klasöründeki Setup.exe dosyasını çalıştırın. Lisanslı kullanıcılar, önce şifre girmeleri istenebilir. Güncellemeler otomatik olarak indirilir, dosyalar ve veritabanı şeması güncellenir.

⚠️ Kaynak kodlarında değişiklik yaptıysanız, bu değişiklikler kaybolabilir.

📌 Adım adım video rehberi hazırlanmaktadır.

Manuel Güncelleme (Otomatik Güncelleme Başarısız Olursa)

Mevcut indirme şifrenizi kullanarak güncellemeyi indirin (lisanslı kullanıcılar için). Deneme sürümü indirmek isterseniz, deneme versiyonunu seçin.
Geçici bir klasöre çıkarın. Ardından:
- Basit yöntem: Setup.exe’yi çalıştırın.
- Veya manuel güncelleme yapmak istiyorsanız, aşağıdaki adımlara devam edin.
Yapay Zeka uygulamasının kurulu olduğu klasörü yedekleyin.
appsettings.json hariç tüm dosyaları silin.
⚠️ Dosyaların kullanımda olduğunu belirten hata alırsanız:
- Windows: Application Pool’u durdurun.
- Linux: dotnet sürecini sonlandırın.
Yeni dosyaları, mevcut uygulama dizinine çıkartın.
Veritabanını güncelleyin:
- Setup.exe’yi çalıştırın, ya da
- /sql/UpgradeFromOlderVersions.sql betiğini SQL Server Management Studio üzerinden çalıştırın.
  
  Bağlantı: SuperYapayZeka veritabanına (varsayılan isim).

Linux Sistemlerde Güncelleme

Güncelleme işlemi, deneme sürümünden lisanslı sürüme geçiş veya en son sürüme yükseltme için aynıdır.

En son sürümü indirip çıkarın.
Veritabanını güncellemek için:
bash
```
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P 'YOUR PASSWORD' -i sql/UpgradeFromOlderVersions.sql
```
🔁 SQL Server başka bir sunucuda ise, betiği orada manuel olarak çalıştırın.
appsettings.json hariç tüm yerel dosyaları yeni dosyalarla değiştirin.
Uygulamayı yeniden başlatın.

Docker Üzerinden Güncelleme

Paketi YapayZeka.Site üzerinden indirip çıkarın.
Eski dosyaları yeni dosyalarla değiştirin.

⚠️ Değişiklik yaptığınız appsettings.json dosyasını koruyun.
Terminalde:
bash
```
docker compose stop
docker compose up --build
```
🔄 Bu işlem, veritabanı şemasını otomatik olarak güncelleyecektir.

Önemli Sürüm Geçişleri

Sürüm Öncesi → .NET 8’e Geçiş

Windows: .NET 8 Hosting Bundle yükleyin.
Linux: .NET 8 SDK yükleyin.

❗ .NET 5/6’ya ihtiyaç yoktur. Kaldırmanıza gerek yoktur.

Sürüm Öncesi → .NET Core’a Geçiş

Önce Microsoft .NET 8 Hosting Bundle’ı yükleyin.
Ardından Setup.exe’yi çalıştırın. Otomatik olarak geçiş yapılacaktır.

⚙️ Manuel güncelleme yapmak isterseniz:

web.config dosyasındaki ayarları appsettings.json dosyasına taşıyın.

Veritabanı bağlantı dizesi, Windows kimlik doğrulaması ve diğer ayarlar bu dosyada tanımlanmalıdır.

✅ Tavsiye: Manuel güncelleme yerine Setup.exe kullanımı önerilir.

Gelişmiş Özellikler

appsettings.json Dosyasını Düzenleme

Bazı gelişmiş özellikler, kök dizindeki appsettings.json dosyasında saklanır. Herhangi bir metin düzenleyici ile açabilirsiniz. Değişikliklerin etkin olması için IIS’yi yeniden başlatmanız gerekir.

⚠️ JSON formatına dikkat edin. Yanlış yazılmış bir satır, uygulamanın çökmesine neden olabilir.
✅ Değişiklik yapmadan önce bir JSON validator kullanın.

Tam Metin Arama (Full-Text Search)

Varsayılan olarak, arama yalnızca talep konusu ve metni üzerinde yapılır. Talep yanıtlarını (yorumları) da aramaya dahil etmek ve performansı artırmak için SQL Server’da Full-Text Search bileşenlerini yüklemeniz gerekir.

🔍 Kurulu olup olmadığını kontrol etmek için:

sql

SELECT FULLTEXTSERVICEPROPERTY('IsFullTextInstalled')

Sonuç 1 ise → Kurulu.
Sonuç 0 ise → Kurulum gereklidir.

Kurulum Adımları:

SQL Server’da Full-Text Search bileşenlerini yükleyin.
SQL Server Express kullanıyorsanız, SQL Server Express with Advanced Services sürümünü indirin.
Veritabanınızda en son Yapay Zeka sürümünün yükseltme betiklerini çalıştırın.
IIS’te Yapay Zeka uygulama havuzunu yeniden başlatın.

💡 Full-Text bileşenleri zorunlu değildir ancak arama hızını ve kalitesini önemli ölçüde artırır.

Otomatik Giriş Özelliği (Autologin)

Yapay Zeka, kullanıcıların ana web siteniz üzerinden önceden kimlik doğrulanmış olarak otomatik giriş yapmasına olanak tanır. Özellikle geliştiriciler ve sistem yöneticileri için tasarlanmıştır.

Nasıl Çalışır?

Kullanıcı zaten ana sitede kimlik doğrulandıysa, aşağıdaki URL formatını kullanabilirsiniz:

http://YapayZeka_Url/User/AutoLogin?username=xxx&email=yyy&userHash=HASH

YapayZeka_Url: Tam Yapay Zeka URL’si
username: Kullanıcı adı
email: E-posta adresi
HASH: MD5(name + email + shared-secret + day + month)

🔐 Shared Secret: Yönetici panelinde belirlenmelidir. En az 10 karakterli güçlü bir anahtar seçin.
📅 Day & Month: İki haneli format (örneğin, 1 Ocak → 0101)

Ek Parametreler:

FirstName=xxx, LastName=xxx → Yeni kullanıcıya isim ve soyisim atar.
CompanyName=xxx → Şirket bilgisi ekler.
&new_talep=1 → Kullanıcıyı “Yeni Talep” sayfasına yönlendirir.

📌 Bu özelliğin güncel bilgileri için: YapayZeka.Site Autologin Dokümantasyonu

Yapay Zeka URL Ayarı

⚙️ Sürüm sonrası için:
Yönetim → Genel Ayarlar → Yapay Zeka URL kısmında ayarlanabilir.

Talep olaylarına ilişkin e-posta bildirimlerinde, talebe bağlantı verilir. Bu bağlantı, uygulamanın ilk başlatıldığında ilk isteğin yapıldığı URL’ye göre belirlenir.

🔁 Örneğin, ilk istek http://localhost/yapayzekaise, tüm e-postalarda bu URL kullanılacaktır. Uygulama havuzunu yeniden başlatana kadar değişmez.

✅ İstediğiniz URL’yi sabitlemek için, yukarıda belirtildiği gibi ayar yapabilirsiniz.

Dosyaları Disk Üzerinde Saklama

Varsayılan olarak, ek dosyalar veritabanında saklanır. Ancak, disk üzerine depolamayı tercih edebilirsiniz:

Diskte bir klasör oluşturun (örneğin: C:\hdfiles)
IIS Management Console’da YapayZeka uygulama havuzunu bulun.
Sağ tıklayıp Advanced Settings → Identity özelliğini kontrol edin.
Bu kullanıcıya, oluşturduğunuz klasöre tam erişim izni verin.
appsettings.json dosyasını Notepad ile açın.
Aşağıdaki satırı bulun ve değiştirin:
json
```
"AttachmentsPath": "C:\\path\\to\\folder"
```
⚠️ JSON formatı nedeniyle ters slash (\) karakterleri \\ olarak kaçırılmalıdır.
Uygulama havuzunu yeniden başlatın.

Windows Entegre Kimlik Doğrulama

Yapay Zeka, Active Directory entegrasyonunu destekler. Aktif etmek için:

appsettings.json dosyasında şu satırı açın:
json
```
"Auth": "Windows"
```
IIS’te YapayZeka dizininin Windows Authentication modülünün aktif olduğundan emin olun.
Değişiklik sonrası IIS’yi yeniden başlatın.

⚙️ IIS üzerinde Windows kimlik doğrulaması kullanacaksanız, Windows Authentication Role Service yüklü olmalıdır.

🛡️ Not: Bir kullanıcı ilk kez giriş yaptığında, otomatik olarak veritabanına eklenir. Ayrıca, Active Directory’dan e-posta bilgileri de otomatik olarak çekilir.

Windows Kullanıcı Yöneticisi Ekleme

Setup.exe ile kurulum yaparken, yönetici olarak eklenecek Windows kullanıcı adı istenebilir. Eğer böyle bir seçenek yoksa:

json

"WindowsAdminUsername": "DOMAIN\\User"

⚠️ Kullanıcı adı büyük/küçük harfe duyarlıdır. Doğru yazımı öğrenmek için cmd.exe’de whoami komutunu çalıştırın.
📝 JSON içindeki ters slash (\) karakterleri \\ olarak kaçırılmalıdır.

API ve E-posta API

YapayZeka, diğer uygulamalarla entegrasyon için RESTful API sunmaktadır.

API Adresi: http://servername/yapayzeka/api/
API Dokümantasyonu: YapayZeka.Site API Dokümanı
E-posta API Kılavuzu: YapayZeka.Site Email API

appsettings.json Doğrulayıcı

Yapılan hatalar uygulamayı çökebilir. Bu nedenle, değişiklik yapmadan önce JSON Validator kullanmanız önerilir.

🧪 Doğrulayıcı: YapayZeka.Site JSON Validator

Gelişmiş appsettings.json Ayarları

Aşağıdaki ayarlar, ileri düzey kullanıcılar için предназначены. Dikkatli kullanın.

json

"WindowsAdminUsername": "DOMAIN\\User",
"LogErrors": true,
"EmailErrorTo": "admin-ali@test.com, admin-sema@test.com",
"DisallowChangingAvatars": "false",
"AttachmentsPath": "c:\\hdfiles",
"DisableMailChecker": "true",
"AllowedFileExtensions": ".png,.pdf",
"ProxyIP": "192.168.1.1",
"MailPswEncryptKey": "18d6fg81"

⚠️ MailPswEncryptKey:

8 karakterli, Latin harf/rakam içermelidir.

Anahtarı mutlaka yedekleyin ve hiç değiştirmeyin. Aksi takdirde veritabanındaki e-posta şifreleri kaybedilir.

Herhangi bir sorunuz veya teknik desteğe ihtiyacınız varsa, SuperYapayZeka ekibine ulaşmaktan çekinmeyin.