> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pratikportal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Yapay Zeka Bağlantıları (Yönetici)

> Yapay zeka modellerini bağlantı profili olarak ekleme, test etme, özelliklere atama ve kullanımı izleme.

Pratik Portal'daki yapay zeka özellikleri ([föy ve belge özeti](https://docs.pratikportal.com/yapay-zeka/foy-ve-belge-ozeti.md)) büronuzun seçtiği modelle çalışır. Hangi modelin kullanılacağını büro yöneticisi **Pratik AI → Yapay Zeka Bağlantıları** ekranından belirler. Kurum içinde çalışan bir sunucu da, büronun bulut hesabı da eklenebilir.

Ekranda üç sekme vardır:

| Sekme | Ne yapılır? |
| - | - |
| **Bağlantı profilleri** | Modelleri ekleme, test etme, pasifleştirme ve silme |
| **Özellik atamaları** | Her yapay zeka özelliğinin hangi profille çalışacağını seçme |
| **Kullanım ve kayıtlar** | İstek, token, tahmini maliyet ve çağrı kayıtları |

> [!NOTE]
>
> Yapay zeka yetkileri **Pratik AI** modülüne aittir. Rol ekranında yalnızca büronuzun lisansı olan modüllerin yetkileri listelenir; Pratik AI lisansı yoksa bu yetkileri kimseye veremezsiniz. **Lisanslarım** ekranında yapay zeka modülü lisanslarının satırında süre uzatma ve düzenleme düğmeleri bulunmaz. Ayrıntılar: [Lisanslar](https://docs.pratikportal.com/buro-yonetimi/lisanslar.md)

## Kısaca kurulum

**1. Profil ekleyin**

**Bağlantı profilleri** sekmesinde **Profil ekle** ile modelinizi tanımlayın ve test edin.

**2. Özelliğe atayın**

**Özellik atamaları** sekmesinde her özellik için bu profili seçin.

**3. Kullanıcılara yetki verin**

Özelliği kullanacak kullanıcıların rolüne `AiOzellikKullan` yetkisini ekleyin ([Roller](https://docs.pratikportal.com/buro-yonetimi/roller-ve-yetkiler.md)).

Bu üç adımdan biri eksikse kullanıcılar yapay zeka düğmelerini hiç görmez.

## Bağlantı profilleri

Her profil, bir modele nasıl bağlanılacağını tanımlar. Listede her profilin adı, sağlayıcısı ve modeli, verinin nereye gittiği, test sonrası belirlenen yetenekleri ve durumu görünür.

| Durum | Anlamı |
| - | - |
| **Test edildi** | Son test başarılı; profil özelliklere atanabilir |
| **Test edilmedi** | Profil hiç test edilmemiş; özelliğe atanamaz |
| **Hata** | Son test başarısız; yanında hata nedeni yazar |
| **Pasif** | Profil kapatılmış; kullanılmaz |

Listenin üstündeki **Tümü**, **Kurum içi**, **Kurum dışı** ve **Pasif** düğmeleriyle profilleri süzebilirsiniz.

### Profil ekleme

**Profil ekle** düğmesine tıklayın. Üç adımlı bir pencere açılır.

**1. Tür: Model nerede çalışıyor**

Sağlayıcıyı seçin. Seçenekler iki grupta listelenir:

**Kurum içinde çalışanlar** *(Bankalar için önerilen)*: Belgeler ve borçlu bilgileri kurumun ağından çıkmaz.

| Sağlayıcı | Açıklama |
| - | - |
| **Kurum içi sunucu** | vLLM, LiteLLM, kurum içi LLM ağ geçidi ya da OpenAI API'si sunan herhangi bir sunucu |
| **Ollama** | Kendi sunucunuzda açık modelleri çalıştırır. Kurulumu en kolay kurum içi seçenek. |
| **LM Studio** | Bir masaüstü ya da iş istasyonunda model çalıştırır. Deneme ve küçük kurulumlar için. |

**Bulut sağlayıcıları**: İstekler sağlayıcının sunucularına gider. Hassas işler bu profillere atanamaz; kişisel veriler varsayılan olarak maskelenir.

| Sağlayıcı | Açıklama |
| - | - |
| **Azure OpenAI** | Kurumun kendi Azure aboneliğindeki OpenAI kaynağı |
| **AWS Bedrock** | Kurumun AWS hesabındaki Bedrock modelleri |
| **Google Gemini** | Google AI Studio'dan alınan API anahtarıyla Gemini modelleri |
| **Google Vertex AI** | Kurumun Google Cloud projesindeki Vertex AI |
| **Anthropic Claude** | Anthropic API üzerinden Claude modelleri. Embedding sunmaz. |
| **OpenAI** | OpenAI API üzerinden GPT ve embedding modelleri |

**2. Bağlantı: Adres, anahtar, model**

Bağlantı bilgilerini ve ayarları girin (aşağıdaki tablolara bakın). Model adını bilmiyorsanız **Modelleri getir** düğmesine tıklayın; sunucudaki modeller listelenir, birini seçin ya da elle yazın. **Türü değiştir** ile ilk adıma dönebilirsiniz. Ardından **Devam: Test**'e tıklayın.

**3. Test: Yetenekleri doğrula**

Bu adıma geçince **Bağlantı testi** kendiliğinden başlar. Modele kısa istekler gönderilir ve dört yetenek tek tek denenir: **Sohbet**, **JSON çıktı**, **Araç çağırma** ve **Embedding**. Her biri için **Destekleniyor**, **Desteklenmiyor**, **Hata** veya **Denenmedi** yazar. Testi tekrarlamak için **Yeniden test et**'e tıklayın.

Sonuç uygunsa **Profili kaydet**'e tıklayın. *"Profil eklendi."* mesajı çıkar.

> [!NOTE]
>
> Kurum içi modeller ilk istekte modeli belleğe yüklediği için test bir iki dakika sürebilir.

> [!WARNING]
>
> Test edilmeden kaydedilen profil **Test edilmedi** durumunda kalır ve bir özelliğe atanamaz. Test başarısız olsa da profili kaydedebilirsiniz; ancak bu profil de özelliklere atanamaz.

#### Bağlantı bilgileri

Sağlayıcıya göre şu alanlar çıkar (\* zorunlu):

| Alan | Hangi sağlayıcıda? | Not |
| - | - | - |
| **Profil adı** \* | Tümü | Özellik atamalarında bu adla görünür. Aynı adla iki profil olamaz. |
| **Sunucu adresi** \* | Kurum içi sunucu, Ollama, LM Studio | `http://` veya `https://` ile başlamalı. Kurum içi sunucuda genellikle `/v1` ile biter; Ollama'da `/v1` eklemenize gerek yoktur. |
| **Uç nokta** \* | Azure OpenAI | Azure portalında kaynağın Keys and Endpoint sayfasında yazar |
| **API anahtarı** | Tümü (kurum içi sağlayıcılarda isteğe bağlı) | Kurum içi sunucularda çoğunlukla gerekmez |
| **Erişim anahtarı kimliği** ve **Gizli erişim anahtarı** | AWS Bedrock | İki alan da boşsa sunucunun IAM rolü kullanılır |
| **Hizmet hesabı anahtarı (JSON)** \* | Google Vertex AI | İndirilen JSON dosyasının tüm içeriği yapıştırılır |
| **Bölge** \* | AWS Bedrock, Google Vertex AI | Modelin açık olduğu bölge |
| **Proje kimliği** | Google Vertex AI | Boş bırakılırsa anahtardaki proje kullanılır |
| **API sürümü** | Azure OpenAI | Boş bırakılırsa 2024-10-21 kullanılır |
| **Model** \* | Tümü | Azure'da model adı değil, **Deployment adı** yazılır. Bedrock'ta alanın adı **Model ya da çıkarım profili**'dir. |

> [!NOTE]
>
> Modele bağlantıyı kullanıcının bilgisayarı değil, Pratik Portal sunucusu kurar. Kurum içi bir modelin adresi bu sunucudan erişilebilir olmalıdır.

#### Veri konumu ve maskeleme

| Ayar | Açıklama |
| - | - |
| **Kurum içi** | Model kurumun ağında. Hassas işlere atanabilir. |
| **Kurum dışı** | Veri sağlayıcıya gider. Yalnız düşük ve orta hassasiyetli işler. |
| **Kişisel veri maskeleme** | TC kimlik no, IBAN, telefon ve ad soyad modele gönderilmeden önce gizlenir |

Veri konumu adrese göre önerilir: bulut sağlayıcıları her zaman **Kurum dışı**; `localhost`, `10.x`, `192.168.x` gibi özel ağ adresleri **Kurum içi** önerilir. Önerilenden farklı seçerseniz *"Adrese göre önerilen konumdan farklı seçtiniz. Bu değişiklik işlem geçmişine yazılır."* uyarısı çıkar.

**Kurum dışı** seçildiğinde maskeleme kendiliğinden açılır. İsterseniz kapatabilirsiniz.

#### Sınırlar ve maliyet

| Alan | Açıklama |
| - | - |
| **Zaman aşımı (sn)** \* | 5 ile 600 saniye arasında. Kurum içi sağlayıcılarda varsayılan 300, bulut sağlayıcılarında 120 saniyedir. Yerel modeller yavaş olabileceği için yüksek tutun. |
| **Eşzamanlı istek** | *(Kurum içi sağlayıcılarda)* Modele aynı anda gönderilecek en fazla istek. Varsayılan 2. Tek GPU'lu sunucuda 1–2 önerilir. Boş bırakılırsa sınırsız. |
| **Günlük token limiti** | *(Bulut sağlayıcılarında)* Maliyet tavanıdır; dolunca istekler ertesi güne kadar durur. Boş bırakılırsa sınırsız. |
| **Gelişmiş** | **Bağlam penceresi**, **Maks. çıktı** ve **Sıcaklık**. Boş bırakılırsa model varsayılanı kullanılır. |
| **Giriş, 1 milyon token** / **Çıkış, 1 milyon token** / **Para birimi** | Sağlayıcının fiyat sayfasındaki 1 milyon token fiyatı (USD, EUR veya TRY). Kullanım ekranındaki maliyet bu fiyatlarla tahmin edilir; fatura yerine geçmez. Kurum içi modelde ücret yoksa boş bırakın. |

### API anahtarlarının güvenliği

* API anahtarları ve hizmet hesabı anahtarları Pratik Portal sunucusunda **şifrelenerek** saklanır.
* Kaydedildikten sonra anahtar bir daha gösterilmez. Düzenleme penceresinde **Tanımlı** ve anahtarın son dört karakteri görünür.
* Anahtarı yenilemek için **Değiştir**'e tıklayıp yenisini girin. Vazgeçerseniz **Mevcut anahtarı kullan**'a tıklayın.
* Anahtarın zorunlu olmadığı sağlayıcılarda **Kaldır** ile anahtarı silebilirsiniz; *"Kaydedince anahtar silinecek."* yazar.

### Profil işlemleri

Profil adına tıklamak düzenleme penceresini açar. Satırın sonundaki üç nokta menüsünde şunlar bulunur:

| Menü öğesi | Ne yapar? |
| - | - |
| **Düzenle** | Profili düzenler. Pencere doğrudan **Bağlantı** adımında açılır. |
| **Yeniden test et** | Kayıtlı bilgilerle bağlantıyı yeniden test eder. Başarılıysa *"Bağlantı çalışıyor; yetenekler profile yazıldı."* yazar. |
| **Pasifleştir** / **Etkinleştir** | Profili kapatır veya yeniden açar. Pasif profil hiçbir özellikte kullanılmaz. |
| **Sil** | *"… profili silinsin mi? Bu profili kullanan özellik kalmaz."* onayından sonra siler |

## Özellik atamaları

Bu sekmede yapay zeka özellikleri listelenir. Her özellik bir bağlantı profiliyle çalışır. Profil seçilmeyen özelliğin düğmesi kullanıcılara görünmez.

| Özellik | Modül | Ne yapar? |
| - | - | - |
| **İcra föyü özeti** | Pratik İcra | Föyün durumunu, tahsilatı, hacizleri ve tebligatları özetler; dikkat edilmesi gerekenleri ve sonraki adımları önerir. |
| **Dava föyü özeti** | Pratik Dava | Davanın aşamasını, duruşmaları ve yapılacakları özetler; yaklaşan süreleri ve eksikleri uyarır. |
| **Belge özeti ve süre çıkarma** | Belge Arşivi / UETS | Tebligat ve arşiv belgelerini özetler (ne istendi, kim lehine, sonraki adım); kesin süreleri bulup Ajanda'ya görev önerir. |

Her özelliğin altında gerektirdiği yetenekler (şu an üçü için de **Sohbet** ve **JSON çıktı**) ve hassasiyet düzeyi yazar.

**1. Profil seçin**

**Profil** listesinden bir profil seçin. İlk kez profil seçtiğinizde özellik kendiliğinden açılır. *"…: atama kaydedildi."* mesajı çıkar.

**2. İsterseniz yedek profil seçin**

**Yedek profil**, birincil profil hata verdiğinde kullanılır. Birincil profilden farklı olmalıdır.

**3. Özelliği açın veya kapatın**

Satırın sağındaki anahtarla özelliği kapatabilir veya yeniden açabilirsiniz. Profil seçilmeden özellik açılamaz.

Satırın sağında özelliğin durumu yazar:

| Durum | Anlamı |
| - | - |
| **Kullanımda** | Özellik açık ve çalışan bir profili var |
| **Çalışmıyor** | Özellik açık ama birincil ve yedek profil kullanılamıyor; altında nedeni yazar |
| **Kapalı** | Özellik kapalı |

### Hangi profil seçilebilir?

Listede uygun olmayan profiller soluk görünür ve yanında nedeni yazar:

| Neden | Açıklama |
| - | - |
| **Pasif** | Profil pasifleştirilmiş |
| **Test edilmedi ya da testi başarısız** | Profili test edip başarılı olmasını sağlayın |
| **Gereken yetenek yok** | Model, özelliğin gerektirdiği yeteneği (ör. JSON çıktı) testte gösterememiş |
| **Yüksek hassasiyet: yalnız kurum içi** | Yüksek hassasiyetli özellikler yalnızca **Kurum içi** profillere atanabilir |
| **Birincil kurum içi; yedek dışarı çıkamaz** | *(Yedek profilde)* Birincil profil kurum içiyse yedek profil kurum dışı olamaz |

Özelliklerin hassasiyeti **Düşük hassasiyet**, **Orta hassasiyet** veya **Yüksek hassasiyet** olabilir. Yüksek hassasiyetli bir özellik kurum dışı profille çalıştırılmak istenirse *"Yüksek hassasiyetli özellik yalnız kurum içi profille çalışır."* hatası alınır. Şu an listedeki üç özellik de **Orta hassasiyet** düzeyindedir; kurum içi veya kurum dışı profile atanabilir.

> [!WARNING]
>
> Birincil profil kurum içiyken kurum dışı bir yedek seçilemez: *"Birincil profil kurum içi iken yedek profil kurum dışı olamaz; aksi halde veri hata anında dışarı çıkar."* Böylece birincil model hata verdiğinde veriler kendiliğinden buluta gönderilmez.

## Kullanım ve kayıtlar

Bu sekmede yapay zeka kullanımını izlersiniz. Dönemi **Bugün**, **Son 7 gün**, **Son 30 gün**, **Bu ay** veya **Geçen ay** olarak seçin.

Üstteki kutularda seçilen dönemin özeti görünür:

| Kutu | Anlamı |
| - | - |
| **İstek** | Toplam istek sayısı ve hatalı istek oranı |
| **Token** | Toplam token, giriş ve çıkış olarak |
| **Tahmini maliyet** | Profillere girilen fiyatlarla hesaplanan maliyet. Fiyatı girilmemiş profiller hesaba katılmaz. |
| **Ortalama süre** | İstek başına ortalama süre |
| **Maskelenen kişisel veri** | Kurum dışına gönderilmeden önce gizlenen kişisel veri sayısı |

Altında günlük kullanım grafiği bulunur. **Kırılım** tablosu kullanımı **Profil / model**, **Özellik** veya **Kullanıcı** bazında gösterir (istek, hata, giriş/çıkış token, ortalama süre, tahmini maliyet).

**Çağrı kayıtları** tablosunda her çağrının **Tarih**, **Kullanıcı**, **Özellik**, **Profil**, **Süre**, **Token (giriş / çıkış)**, **Maliyet** ve **Sonuç** bilgisi listelenir. Yalnızca hataları görmek için **Yalnız hatalı çağrılar** anahtarını açın.

> [!NOTE]
>
> Her çağrının yalnızca üst verisi tutulur; gönderilen metin ve modelin cevabı kaydedilmez.

## Gerekli yetkiler

| İşlem | Yetki adı | Rol ekranındaki açıklaması |
| - | - | - |
| Ekranı görüntüleme, atamalar ve kullanım | `AiProfilDefault` | Yapay zeka bağlantı profillerini görüntüleyebilir. |
| Profil ekleme | `AiProfilCreate` | Yapay zeka bağlantı profili ekleyebilir. |
| Profil düzenleme, test, pasifleştirme ve özellik atama | `AiProfilUpdate` | Yapay zeka bağlantı profilini düzenleyebilir, test edebilir ve pasifleştirebilir. |
| Profil silme | `AiProfilDelete` | Yapay zeka bağlantı profilini silebilir. |
| Özellikleri kullanma (AI özet vb.) | `AiOzellikKullan` | Yapay zeka özelliklerini (föy özeti vb.) kullanabilir. |

Yetkileri büro yöneticisi [Roller](https://docs.pratikportal.com/buro-yonetimi/roller-ve-yetkiler.md) ekranından verir.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.