Kullanım Dışa Aktarmaları

Harici analiz, raporlama ve uyumluluk için çalışma alanı kullanım analizlerini CSV'ye aktarın.

Kullanım aktarımları, çalışma alanı yöneticilerinin kullanımına açıktır ve kullanıcılar, aracılar, API anahtarları, projeler, modeller ve iş akışları genelinde 12 aya kadar geçmiş veriler sağlar.

Kullanım Dışa Aktarmalarına Erişim

Kullanımı ajan arayüzünde veya programlı olarak Usage Export API ile dışa aktarabilirsiniz.

Kullanıcı arayüzünden dışa aktarmak için çalışma alanı analiz sayfanıza gidin ve sağ üst köşedeki Dışa Aktar düğmesini tıklayın.

Analytics'i açın

Çalışma alanı ayarlarında workspace analytics page'inize gidin.

Dışa Aktar'a tıklayın

Sağ üst köşedeki Dışa Aktar düğmesini seçin

Dışa Aktarmayı Yapılandır

Dışa aktarma iletişim kutusunda veri türünüzü ve tarih aralığınızı seçin

CSV oluştur

Dışa aktarma dosyanızı oluşturup indirmek için CSV Oluştur'u tıklayın

Yapılandırmayı Dışa Aktarma

Veri Türleri

Hangi tür kullanım verilerinin dışa aktarılacağını seçin:

Kullanıcılar - Seçilen dönem boyunca bireysel kullanıcı etkinliği, mesaj sayıları ve özellik kullanımı
Aracılar - Aracı kullanım istatistikleri, etkileşim sayıları ve performans ölçümleri
API anahtarları - API kullanımı ve maliyeti, kişisel API anahtarları da dahil olmak üzere API anahtarına göre gruplandırılmıştır
Projeler - Proje düzeyinde kullanım verileri
Modeller - Model kullanım istatistikleri, istek sayıları ve BYOK token tüketim verileri
İş akışları - İş akışı maliyeti, çalıştırma sayıları ve aylık sınır kullanımı

Tarih Aralığı Seçenekleri

Önceden tanımlanmış aralıklar arasından seçim yapın veya özel bir dönem seçin:

Bu ay (ör. Temmuz 2025)
Geçen ay (ör. Haziran 2025)
Bu hafta (ör. 30 Temmuz - 2 Ağustos)
Geçen hafta (ör. 20 Temmuz - 26 Temmuz)
Özel aralık seçin - Belirli başlangıç ve bitiş tarihlerini seçin

Dışa Aktarma Sınırları

Kullanım dışa aktarmaları, 12 aya kadar geçmiş verileri içerir ve dışa aktarma başına en fazla 1.000.000 kullanım satırını tarayabilir.

Dışa aktarma işlemi satır sınırını aşarsa daha kısa bir tarih aralığı seçin ve CSV dosyalarını birleştirin.

Veri Yapısını Dışa Aktarma

Her dışa aktarma, seçilen dönem için varlık başına bir satır içeren bir CSV dosyası oluşturur.

Bazı sütunlar yalnızca Bring Your Own Key (BYOK) kullanan çalışma alanları için kullanılabilir. Bunlar Yalnızca BYOK çalışma alanları olarak işaretlenmiştir.

Kullanım Dışa Aktarmaları

Kullanıcıların dışa aktarımı, seçilen dönem boyunca bireysel kullanıcı etkinliği sağlar.

Kullanıcı düzeyindeki veriler ayarı, kullanıcı ayrıntısı sütunlarının eklenip eklenmeyeceğini kontrol eder. Devre dışı bırakıldığında, name ve email dahil olmak üzere aşağıda işaretlenen sütunlar atlanır.

Sütun Tanımları

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi (YYYY-AA-GG, UTC)
`period_end`	Raporun bitiş tarihi (YYYY-AA-GG, UTC)
`org_id`	Çalışma alanının kimliği
`user_id`	Kullanıcının kimliği; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`name`	Kullanıcının adı; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`email`	Kullanıcının e-postası; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`role`	Dışa aktarma sırasındaki kullanıcı rolü; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`joined_at`	Kullanıcının çalışma alanına katıldığı tarih; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`department`	Kullanıcı departmanı; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`company_name`	Kullanıcı şirket adı; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`license_type`	Mevcut kullanıcı lisansı katmanı; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`payg_limit_current`	Mevcut ekstra kullanım sınırı; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`payg_consumption_in_period`	Seçilen dönemdeki ekstra kullanım tüketimi; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`payg_utilization_pct_current`	`payg_consumption_in_period / payg_limit_current`; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`messages_total`	Kullanıcı tarafından gönderilen toplam mesaj
`messages_total_rank`	Toplam mesaja göre sıralama
`messages_chat`	Temsilci olmadan sohbetteki mesajlar
`messages_chat_rank`	Sohbet mesajlarına göre sıralama
`messages_assistants`	Temsilcilere gönderilen mesajlar
`messages_assistants_rank`	Temsilci mesajlarına göre sıralama
`assistants_messaged`	Mesaj gönderilen farklı temsilcilerin sayısı
`assistants_to_messages`	JSON, aracı kimliğini mesaj sayısıyla eşleştiriyor
`messages_projects`	Projelere gönderilen mesajlar
`messages_projects_rank`	Proje mesajlarına göre sıralama
`projects_messaged`	Mesaj gönderilen farklı projelerin sayısı
`projects_to_messages`	JSON, proje kimliğini mesaj sayısıyla eşliyor
`model_to_messages_total`	JSON, model adını mesaj sayısıyla eşliyor
`action_messages`	Eylemler tarafından oluşturulan mesajlar
`action_messaged`	Tetiklenen farklı eylemlerin sayısı
`action_to_messages`	JSON, eylem adını ileti sayısıyla eşliyor

BYOK Çalışma Alanları için Ek Sütunlar

Sütun	Açıklama
`total_input_tokens`	Kullanıcı tarafından tüketilen toplam girdi jetonları
`total_output_tokens`	Kullanıcı için oluşturulan toplam çıktı jetonları
`cached_prompt_tokens`	Önbellek okumalı giriş belirteçleri
`cache_creation_tokens`	Giriş belirteçlerini önbelleğe yazma
`no_cache_tokens`	Önbellekten sunulmayan giriş belirteçleri
`total_cost_usd`	USD cinsinden tahmini sağlayıcı maliyeti

Alt Grup Satırları

Dışa aktarma iletişim kutusunda, her kullanıcıyı kullandığı model başına bir satıra bölmek için Alt grup satırlarını kullanın. Kullanıcı başına bir satır tutmak için Gruplama yok'u seçin.

Model'e göre alt gruplandırıldığında, projects_messaged'de olduğu gibi sıralama, JSON dökümü ve eylem sütunları atlanır.

Aracıların dışa aktarımı, her aracının kullanım istatistiklerini gösterir.

Kullanıcı düzeyindeki verilerin devre dışı bırakıldığı çalışma alanları için, gizlilik uyumluluğunu sürdürmek amacıyla belirli tanımlayıcı sütunlar (kullanıcı e-postası ve adı gibi) dışa aktarmaların dışında bırakılır.

Sütun Tanımları

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi
`period_end`	Raporun bitiş tarihi
`org_id`	Çalışma alanının kimliği
`assistant_id`	Temsilcinin kimliği
`assistant_name`	Temsilcinin adı
`model`	Aracıda yapılandırılmış model; ayarlanmadığında boş
`assistant_description`	Temsilci açıklaması
`assistant_url`	Temsilciye bağlantı
`assistant_owner_id`	Temsilci sahibinin kimliği
`assistant_owner_email`	Temsilci sahibinin e-postası
`messages`	Temsilciye gönderilen kullanıcı mesajı sayısı
`unique_users`	Temsilciye mesaj gönderen kullanıcı sayısı
`active_users`	Temsilci analitiği KPI'sındaki aktif kullanıcı sayısı
`conversations`	Temsilci analitiği KPI'sından gelen görüşme sayısı
`messages_per_user`	Aktif kullanıcı başına ortalama mesaj

BYOK Çalışma Alanları için Ek Sütunlar

Sütun	Açıklama
`sum_prompt_tokens`	Toplam giriş jetonları
`avg_prompt_tokens`	İstek başına ortalama giriş jetonları
`min_prompt_tokens`	İstek başına minimum giriş belirteçleri
`max_prompt_tokens`	İstek başına maksimum giriş belirteci
`sum_completion_tokens`	Toplam çıkış jetonları
`avg_completion_tokens`	İstek başına ortalama çıktı jetonları
`min_completion_tokens`	İstek başına minimum çıktı belirteçleri
`max_completion_tokens`	İstek başına maksimum çıkış jetonu
`sum_cached_prompt_tokens`	Önbellek okumalı giriş belirteçleri
`sum_cache_creation_tokens`	Giriş belirteçlerini önbelleğe yazma
`sum_no_cache_tokens`	Önbellekten sunulmayan giriş belirteçleri

Alt Grup Satırları

Dışa aktarma iletişim kutusunda, her aracıyı o aracı tarafından kullanılan model başına bir satıra bölmek için Alt grup satırlarını kullanın. Temsilci başına bir satır tutmak için Gruplama yok'u seçin.

Model'e göre alt gruplandırıldığında, model, aracıda yapılandırılan model değil, kullanılan modeldir. Temsilci düzeyinde KPI alanları (active_users, conversations, messages_per_user) atlanır.

API Anahtarlarının dışa aktarımı, API anahtarına göre kullanımı ve maliyeti gösterir.

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi
`period_end`	Raporun bitiş tarihi
`org_id`	Çalışma alanının kimliği
`api_key_id`	API anahtarının kimliği
`api_key_name`	API anahtarının adı
`requests`	API isteklerinin sayısı
`total_cost_usd`	ABD Doları cinsinden API kullanım maliyeti

BYOK Çalışma Alanları için Ek Sütunlar

Sütun	Açıklama
`sum_prompt_tokens`	Toplam giriş jetonları
`sum_completion_tokens`	Toplam çıkış jetonları
`cached_prompt_tokens`	Önbellek okumalı giriş belirteçleri
`cache_creation_tokens`	Giriş belirteçlerini önbelleğe yazma
`no_cache_tokens`	Önbellekten sunulmayan giriş belirteçleri

Alt Grup Satırları

Dışa aktarma iletişim kutusunda, her API anahtarını o anahtar aracılığıyla kullanılan model başına bir satıra bölmek için Alt grup satırlarını kullanın. API anahtarı başına bir satır tutmak için Gruplama yok'u seçin.

Projelerin dışa aktarımı, çalışma alanınızdaki ortak projelere ilişkin kullanım verilerini gösterir.

Kullanıcı düzeyindeki verilerin devre dışı bırakıldığı çalışma alanları için, gizlilik uyumluluğunu sürdürmek amacıyla belirli tanımlayıcı sütunlar (kullanıcı e-postası ve adı gibi) dışa aktarmaların dışında bırakılır.

Sütun Tanımları

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi
`period_end`	Raporun bitiş tarihi
`org_id`	Çalışma alanının kimliği
`project_id`	Projenin kimliği
`project_name`	Projenin Adı
`project_owner_id`	Proje sahibinin kimliği
`project_owner_email`	Proje sahibinin e-postası
`messages`	Proje sohbetlerindeki mesaj sayısı

Modellerin dışa aktarımı, çalışma alanınızda kullanılan her yapay zeka modeli için kullanım istatistikleri sağlar.

Sütun Tanımları

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi
`period_end`	Raporun bitiş tarihi
`org_id`	Çalışma alanının kimliği
`name`	Normalleştirilmiş model adı
`provider`	Model sağlayıcı
`bring_your_keys`	Kullanımın BYOK modelinden gelip gelmediği
`requests`	İstek sayısı

BYOK Çalışma Alanları için Ek Sütunlar

Sütun	Açıklama
`sum_prompt_tokens`	Toplam giriş jetonları
`sum_completion_tokens`	Toplam çıkış jetonları
`sum_cached_prompt_tokens`	Önbellek okumalı giriş belirteçleri
`sum_cache_creation_tokens`	Giriş belirteçlerini önbelleğe yazma
`no_cache_tokens`	Önbellekten sunulmayan giriş belirteçleri
`total_cost_usd`	USD cinsinden tahmini sağlayıcı maliyeti

Alt Grup Satırları

Dışa aktarma iletişim kutusunda, model kullanımını daha ayrıntılı satırlara bölmek için Alt grup satırlarını kullanın. Normalleştirilmiş model adı, sağlayıcı ve BYOK durumu başına bir satır tutmak için Gruplama yok'u seçin.

Mevcut alt grup seçenekleri:

Kaynak - model ve kaynak başına bir satır, örneğin WEB veya MOBILE
Dağıtım - model ve dağıtım başına bir satır; yalnızca BYOK çalışma alanlarında kullanılabilir

İş Akışları dışa aktarımı, seçilen dönemde çalıştırmaları veya maliyeti olan her iş akışı için maliyeti, çalıştırma sayılarını ve aylık sınır kullanımını gösterir. Şablon iş akışları hariçtir. Dışa aktarma iletişim kutusu bu tür için Alt grup satırları sunmaz.

Kullanıcı düzeyindeki veriler ayarı, sahip sütunlarının dahil edilip edilmeyeceğini kontrol eder. Devre dışı bırakıldığında, workflow_owner_id ve workflow_owner_email atlanır ve yalnızca sahibin özel iş akışları hariç tutulur.

Sütun Tanımları

Sütun	Açıklama
`period_start`	Raporun başlangıç tarihi
`period_end`	Raporun bitiş tarihi
`org_id`	Çalışma alanının kimliği
`workflow_id`	İş akışının kimliği
`workflow_name`	İş akışının adı
`status`	`ACTIVE`, `INACTIVE` veya `NOT_DEPLOYED`
`runs`	Seçilen dönemdeki iş akışı çalıştırma sayısı
`total_cost_usd`	Seçilen dönem için USD cinsinden maliyet
`monthly_limit_usd`	İş akışı için geçerli aylık USD sınırı; `null` sınır ayarlanmadığında
`current_month_cost_usd`	Geçerli takvim ayı için USD cinsinden maliyet
`monthly_utilization_pct_current`	`current_month_cost_usd / monthly_limit_usd`; `null` sınır ayarlanmadığında
`workflow_owner_id`	İş akışı sahibinin kimliği; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir
`workflow_owner_email`	İş akışı sahibinin e-postası; yalnızca Kullanıcı düzeyindeki veriler etkinleştirildiğinde dahil edilir

monthly_limit_usd, current_month_cost_usd ve monthly_utilization_pct_current iş akışı aylık ABD doları sınırını ve mevcut takvim ayı harcamasını kullanır. Bunlar, Kullanıcıların dışa aktarımındaki ekstra kullanım alanları değildir.

BYOK Çalışma Alanları için Ek Sütunlar

Sütun	Açıklama
`sum_input_tokens`	Toplam giriş jetonları
`sum_cached_input_tokens`	Önbellek okumalı giriş belirteçleri
`sum_cache_creation_tokens`	Giriş belirteçlerini önbelleğe yazma
`sum_output_tokens`	Toplam çıkış jetonları

Kullanıcı Dışa Aktarma İşleminde Referans Verilen Eylemler

Kullanıcı aktarımının action_to_messages sütununda aşağıdaki eylemler görünebilir:

Yapılandırılmış bir arayüzde belgeleri ve kodları düzenlemek için kullanılır. Mesajlar, Canvas etkileşimlerini (oluşturma, sorgulama, silme) tetikleyen kullanıcı istemlerini temsil eder.

Gerçek zamanlı bilgi için harici web kaynaklarını aramak için kullanılır. Mesajlar, web arama işlevini tetikleyen kullanıcı istemlerini temsil eder.

Yüklenen belgeleri, e-tabloları ve diğer dosya türlerini analiz etmek için kullanılır. Mesajlar, dosya işlemeyi ve analizi tetikleyen kullanıcı istemlerini temsil eder.

Çeşitli programlama dillerinde kodu çalıştırmak ve test etmek için kullanılır. Mesajlar, kod yürütme isteklerini tetikleyen kullanıcı istemlerini temsil eder.

Bağlı entegrasyonlardan gelen eylemler (örn. Hubspot_create_contact, Slack_send_message). Mesajlar, ajan entegrasyonları aracılığıyla harici hizmetlere API çağrılarını tetikleyen kullanıcı istemlerini temsil eder.

Veri İşleme ve Gizlilik

Boş Değerler

Boş veya kullanılamayan veri alanları aşağıdaki şekilde işlenir:

Sayısal alanlar: 0 olarak veya boş olarak görüntülenir
Metin alanları: Boş dizeler olarak görüntüle
JSON nesneleri: Boş nesneler olarak görüntüle {}

Veri Saklama

12 aya kadar geçmiş veriler mevcuttur
İhracat verileri ihracat anındaki durumu yansıtır
Kullanıcı rolleri, adları ve diğer özellikler dönem bitiş tarihi itibarıyla değerleri gösterir