# 🧠 YZ Kullanım Logları

**Üst sayfa:** Orkestratör › Yönetici **Hedef kitle:** Sistem Yöneticileri, RPA Operasyon Ekipleri **Ön koşullar:** Yönetici rolü


---

## Genel Bakış

**Yönetici › YZ Kullanım Logları** ekranı, Orkestratör üzerinden yapay zeka sağlayıcısına giden her çağrının kaydını listeler: hangi YZ bağlantısı ve model kullanıldı, çağrı hangi aktiviteden, hangi süreçten ve kaynaktan geldi, kaç token harcandı, ne kadar sürdü ve başarılı oldu mu. Token tüketimini izlemek ve başarısız çağrıların nedenini bulmak için kullanılır.

Kayıtları sistem yazar; ekranda kayıt eklenmez, değiştirilmez ve silinmez. İstek ve yanıt metni (prompt ve sonuç) saklanmaz; ekranda maliyet hesaplanmaz.

Bu sayfada öğrenecekleriniz:

* Kaydın ne zaman yazıldığı ve hangi bağlantının kullanıldığı
* Liste, filtreler ve kayıt detayı
* Başarısız çağrılarda görülen mesajlar
* Kayıtların ne kadar süre tutulduğu


---

## Kayıt Ne Zaman Yazılır

Yapay zeka sağlayıcısına giden her çağrı, başarılı ya da başarısız, bir kayıt yazar.

| Çağrının kaynağı | Aktivite sütunu |
|------------------|-----------------|
| PAW Robot aktivitesi **Metin Üret** | Metin Üret      |
| PAW Robot aktivitesi **Veri Çıkar** | Veri Çıkar      |
| PAW Robot aktivitesi **Metni Sınıflandır** | Metni Sınıflandır |
| PAW Robot aktivitesi **Ajan Çalıştır** | Ajan Çalıştır   |
| Orkestratör'de YZ ajanının detayındaki **Ajanı Test Et** | Ajan Çalıştır (Süreç, Kaynak, Kaynak Adı ve Kullanıcı Adı boş kalır) |

YZ bağlantısındaki **Bağlantı Test Et** kayıt yazmaz. Aktivitede zorunlu bir alan boşsa (ör. prompt, metin ya da kategoriler) çağrı sağlayıcıya gitmez ve kayıt yazılmaz.

**Hangi bağlantı kullanılır:** Aktivitede bağlantı adı (**Name**) boşsa şirketin **Varsayılan YZ Bağlantısı** kullanılır; bu ayar [Şirketler](/doc/sirketler-v8P7zqW00Q) ekranındadır. Model adı (**Model Name**) boşsa bağlantının varsayılan modeli kullanılır. Ajanlarda bağlantı ve model ajanın kendi ayarından gelir.


---

## Liste

 ![Yönetici › YZ Kullanım Logları](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/a406920a-3878-4f5f-8f8b-7593ba62e617/41a691a0-d04f-40e6-896d-cd27892d45a7/yz-kullanim-loglari-liste.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261122T174500Z&X-Amz-Expires=86400&X-Amz-Signature=9bde62908a5b7bd445c3cea967e0f35ec31135d961af2a70e30c40520fc277f4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =3840x1618")

Liste en son yazılan kayıt en üstte gelir; sayfa başına 50 kayıt gösterilir.

| Öğe | Açıklama |
|-----|----------|
| Dışarı Aktar | **Seçili Kayıtlar**, **Aktif Sayfa** ya da **Aktif Filtre** kayıtlarını Excel (XLSX, XLS), Open Document (ODS) ya da Text (CSV) olarak indirir; en çok 10.000 kayıt. |
| Detayları | Satırın detay penceresini açar. |
| Bilgi (⋮) | Kaydı oluşturan kullanıcıyı ve tarihi gösterir. Ajan testlerinde testi yapan kullanıcı buradan görülür. |

Sütunlar: Oluşturulma Tarihi, YZ Bağlantısı, Model, YZ Ajanı, YZ Sağlayıcısı (Anthropic, OpenAI, Google Gemini, Özel), API Model Adı, Aktivite, Süreç, Kaynak, Girdi Token, Çıktı Token, Toplam Token, Süre (ms), Başarılı Mı. Yalnızca Oluşturulma Tarihi sütununa tıklanarak sıralanır. Hata mesajı detay penceresindeki **Mesaj** alanında görünür.

### Filtreler

**Filtreler** ile **YZ Kullanım Logu Filtreleri** penceresi açılır.

 ![YZ Kullanım Logu Filtreleri — Ajan Çalıştır çağrıları](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/a406920a-3878-4f5f-8f8b-7593ba62e617/ff39c139-b416-4e65-8d1f-619e723bf8b4/yz-kullanim-loglari-filtre.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261122T174500Z&X-Amz-Expires=86400&X-Amz-Signature=facd9111db3dcec10d396265a5f6487ac40193165e894ec7dcb1c008ab596fa3&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =2520x1176")

| Alan | Açıklama |
|------|----------|
| YZ Bağlantısı | Kullanıcının görebildiği YZ bağlantılarından biri. |
| YZ Sağlayıcısı | Anthropic, OpenAI, Google Gemini ya da Özel. |
| YZ Ajanı | Seçilen ajanla yapılan çağrılar. |
| API Model Adı | Girilen metinle başlayan model adları. |
| Aktivite | Metin Üret, Veri Çıkar, Metni Sınıflandır ya da Ajan Çalıştır. |
| Süreç | Seçilen süreçten gelen çağrılar. |
| Başarılı Mı | Evet ya da Hayır. Başarısız çağrıları görmek için **Hayır** seçin. |
| Mesaj | Girilen metinle başlayan mesajlar. |
| Oluşturulma Tarihi Başlangıç / Bitiş | Tarih aralığı. |


---

## Kayıt Detayı

Listede **Detayları**'na tıklandığında **YZ Kullanım Logu Detayları** penceresi açılır. Üstte yalnızca **Önceki**, **İleri** ve **Kapat** butonları vardır.

 ![YZ Kullanım Logu Detayları — Metni Sınıflandır çağrısı](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/a406920a-3878-4f5f-8f8b-7593ba62e617/3b85fb70-207c-4940-84df-2212469adbcf/yz-kullanim-logu-detay.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20261122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261122T174500Z&X-Amz-Expires=86400&X-Amz-Signature=c10ad62d16a50a35ac7c09bbf4aca4076e2ee1cdf9b86cd9a947ec16cde0ddbe&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =2520x1158")

| Alan | Açıklama |
|------|----------|
| Oluşturulma Tarihi | Çağrının yapıldığı zaman. |
| YZ Bağlantısı | Kullanılan YZ bağlantısı. |
| Model (ilk) | Bağlantıda tanımlı model kaydının adı. |
| YZ Ajanı | Ajan Çalıştır ve ajan testlerinde ajanın adı. |
| YZ Sağlayıcısı | Bağlantının sağlayıcısı. |
| Model (ikinci) | Sağlayıcının modeli (ör. Claude Haiku 5.5). |
| API Model Adı | Sağlayıcıya gönderilen model adı; Özel sağlayıcıda bağlantıdaki serbest ad. |
| Aktivite | Çağrıyı yapan aktivite. |
| Süreç, Kaynak | Çağrıyı yapan robotun çalıştırdığı süreç ve kaynak kaydı. |
| Kaynak Adı | Robotun çalıştığı makinenin bilgisayar adı. |
| Kullanıcı Adı | PAW Kaynak'a giriş yapan kullanıcı. |
| Girdi Token, Çıktı Token, Önbellekten Okunan Token, Önbelleğe Yazılan Token, Düşünme Token, Toplam Token | Sağlayıcının bildirdiği token sayıları. Hesaplama sağlayıcıya göre değişebilir; ör. Anthropic'te Girdi Token önbellekten okunan tokenları içermez. |
| Süre (ms) | Yalnızca sağlayıcı çağrısının süresi. Çağrı sağlayıcıya gitmeden hata aldıysa 0. |
| Başarılı Mı | Sağlayıcı yanıt verdi ve yanıt reddedilmedi, kesilmedi, boş değilse Evet. |
| Bitiş Nedeni | Sağlayıcının yanıtı neden bitirdiği (ör. `end_turn`). |
| Sağlayıcı İstek Id | Sağlayıcı tarafındaki istek kimliği; sağlayıcı desteğiyle konuşurken kullanılır. |
| Mesaj | Başarısız çağrıda hata mesajı; başarılıda boş. |

### Başarısız çağrılarda sık görülen mesajlar

| Mesaj | Ne yapılır |
|-------|------------|
| Şirketin varsayılan yapay zeka bağlantısı tanımlanmamış. … | Aktivitede **Name** alanını girin ya da Şirketler ekranında **Varsayılan YZ Bağlantısı** seçin. |
| Yapay zeka bağlantısı bulunamadı ya da izin yok. / Yapay zeka bağlantısı pasif. | Bağlantı adını, bağlantının aktif olduğunu ve süreç izinlerini kontrol edin. |
| Yapay zeka bağlantısının varsayılan modeli tanımlanmamış. … / Model, yapay zeka bağlantısında bulunamadı ya da pasif. | Aktivitede **Model Name** girin ya da bağlantıda varsayılan model seçin. |
| Yapay zeka sağlayıcısı zamanında yanıt vermedi. | Sağlayıcı 4 dakika içinde yanıt vermedi; tekrar deneyin ya da girdiyi küçültün. |
| Yapay zeka yanıtı en fazla token sınırına ulaştığı için kesildi. … | Modelin **En Fazla Token** değerini artırın. |
| Yapay zeka sağlayıcısı hata döndü: … / Yapay zeka sağlayıcısına bağlanılamadı: … | Sağlayıcının döndürdüğü hata ya da ağ hatası; API anahtarını ve erişimi kontrol edin. |
| Yapay zeka sağlayıcısı isteği yanıtlamayı reddetti. | Sağlayıcı içerik nedeniyle yanıt vermedi. |


---

## Kayıtlar Ne Kadar Tutulur

Kayıtlar, şirkette bir silme kuralı tanımlı değilse süresiz tutulur. Yönetici, [Şirketler](/doc/sirketler-v8P7zqW00Q) detayındaki **Geçici Silme** bölümünde YZ kullanım logları (`AiUsageLog`) için bir süre tanımlarsa bu süreden eski kayıtlar her gece silinir.

### Roller

* Ekran yalnızca **Yönetici** rolüne açıktır. YZ bağlantıları ve ajanlarıyla çalışan Geliştirici ve Süreç Yöneticisi rolleri bu ekranı görmez.
* Kayıtlar şubeye göre süzülmez; şirketteki bütün çağrılar görünür.