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

# Özellikler, API anahtarları ve veri denetimleri

> Çalışma alanınızın bir kişide neleri sakladığını tanımlayın, kendi sistemlerinize bir anahtar verin ve ham yüklemeleri silin.

Bu sayfanın arkasında üç ayar sekmesi vardır: **Özellikler (Attributes)**,
**API** ve **Veri denetimleri (Data controls)**. Bunlar üç soruyu yanıtlar. Bu
çalışma alanı neleri kaydeder? Bir betik neler yapabilir? Kai neleri tutar ve
bunları nasıl silersiniz?

## Çalışma alanı özellikleri

Özellik, çalışma alanınızın her kişide tuttuğu bir alandır. Her kişi
profilinde, gelen kutusunun yan sütununda ve API'de görünür. Yeni bir özellik
eklemek için sürüm çıkmasını beklemeniz gerekmez.

<Frame caption="Ayarlar, Özellikler: bu çalışma alanının bir kişide tuttuğu alanlar.">
  <img src="https://mintcdn.com/kai-support/RaOwCZDRMIUnRjWu/images/tr/settings-attributes.png?fit=max&auto=format&n=RaOwCZDRMIUnRjWu&q=85&s=de462178a3ccd6dd064cb8e84057ef6c" alt="Ayarlar, Özellikler" width="2880" height="2000" data-path="images/tr/settings-attributes.png" />
</Frame>

<Steps>
  <Step title="Özellik ekle seçeneğini seçin">
    **Ayarlar (Settings) → Özellikler (Attributes)** bölümünü açın ve
    **Özellik ekle (Add attribute)** seçeneğini seçin.
  </Step>

  <Step title="Adı yazın">
    Ad, bir ekip arkadaşının okuduğu metindir, örneğin `Paket`. Bir adı
    istediğiniz zaman değiştirebilirsiniz.
  </Step>

  <Step title="API adını denetleyin">
    API adı, bir betiğin gönderdiği anahtardır, örneğin `package`. Kai bu adı
    addan türetir ve burada düzenleyebilirsiniz. Sonradan değiştirilemez, bu
    yüzden adı değişen bir özellik gecelik eşitlemenizi hiçbir zaman bozmaz.
  </Step>

  <Step title="Türü seçin">
    Metin, Sayı, Evet / hayır, Tarih, Seçim, Bağlantı, E-posta veya Telefon.
    Bir **Seçim (Choice)** özelliği ayrıca virgülle ayrılmış seçeneklerini de
    alır.
  </Step>
</Steps>

Özellikleri dört kural yönetir ve her biri, diğer davranışın veri kaybettirmesi
yüzünden vardır.

**Alanı doldurmadan önce tanımlayın.** Kai, çalışma alanının tanımlamadığı bir
özellik için gelen değeri kabul etmez.

**Bilinmeyen bir anahtar geri çevrilir, sessizce atılmaz.** Önemsediğiniz tek
alanı sessizce atan 3000 kişilik bir gönderim, aylarca kimsenin fark etmediği
bir hatadır. Kai hata döndürür ve anahtarın adını verir.

**Bir tür asla değişmez.** Kayıtlı her değer kendi tanımına göre okunamaz hale
gelirdi ve hiçbir dönüştürme hepsi için doğru olmaz. Farklı bir tür saklamak
için özelliği arşivleyin ve yeni bir API adıyla başka bir özellik oluşturun.

**Silmek arşivlemek demektir.** **Arşivle (Archive)**, Kai'nin özelliği
sunmasını durdurur ve ona yeni yazma işlemlerini kabul etmez. Kişilerde zaten
bulunan her değer kalır ve profil bu değeri göstermeyi sürdürür. **Geri yükle
(Restore)** özelliği yeniden yazılabilir yapar.

<Note>
  Kai bir özellik değerini kendi başına bir müşteriye göndermez. Özellikler
  ekibinizi ve kendi sistemlerinizi bilgilendirir.
</Note>

Her türün kabul ettiği girdi ve ilgili API çağrıları için
[Çalışma alanı özellikleri](/tr/concepts/attributes) sayfasını okuyun.

## API anahtarları

Bir API anahtarı, kendi sistemlerinizin kişileri göndermesini, güncellemesini,
atamasını ve dışa aktarmasını sağlar. **Ayarlar (Settings) → API** bölümünü
açın.

<Frame caption="Ayarlar, API: bu çalışma alanının tuttuğu anahtarlar.">
  <img src="https://mintcdn.com/kai-support/RaOwCZDRMIUnRjWu/images/tr/settings-api.png?fit=max&auto=format&n=RaOwCZDRMIUnRjWu&q=85&s=eea1088e37ddc1b8dc88c50dc368dd77" alt="Ayarlar, API" width="2880" height="2000" data-path="images/tr/settings-api.png" />
</Frame>

Bir anahtar şöyle görünür:

```
kai_live_<id>_<secret>
```

`kai_` işareti, bir gizli bilgi tarayıcısının eşleştirdiği parçadır. Kimlik,
arama için kullanılan koddur ve bir anahtarı tanıyabilmeniz için listede
gösterilir. Gizli bölüm 32 rastgele bayttır.

<Warning>
  Kai tam anahtarı yalnızca bir kez gösterir. Kai anahtarın yalnızca gizli
  yarısının özetini saklar, bu yüzden anahtarı kimse bir daha okuyamaz, Kai
  destek ekibi bile okuyamaz. Paneli kapatmadan önce anahtarı kopyalayın. Bir
  anahtarı kaybederseniz yenisini oluşturun ve eskisini iptal edin.
</Warning>

<Steps>
  <Step title="API anahtarı oluştur seçeneğini seçin">
    Anahtarı yalnızca bir hesap sahibi veya yönetici oluşturabilir.
  </Step>

  <Step title="Anahtara işine göre isim verin">
    Örneğin `Nightly CRM sync`. İptalden sonra da isim listede kalır, böylece
    denetim kaydı eksiksiz olur.
  </Step>

  <Step title="İzinlerini seçin">
    `contacts:read`, `contacts:write`, `attributes:read`, `attributes:write`,
    `members:read`. Bir anahtara işinin gerektirdiği en küçük izin kümesini
    verin. Yazma izni kendi okuma iznini de kapsar.
  </Step>

  <Step title="Anahtarı kopyalayın">
    Anahtarı gizli bilgi deponuza koyun. Bir anahtarı çalışmaz hale getirmek
    için yanındaki **İptal et (Revoke)** seçeneğini seçin; o anahtarla yapılan
    sonraki istek 401 döndürür.
  </Step>
</Steps>

**Bir anahtarın izinleri, kişilerin taşıdığı roller değildir.** Bunlar ayrı ve
daha kısa bir listedir. Bir makinenin rolü ve çalışma alanında yeri yoktur; iki
listeyi birleştirmek, bir API iznini bir insan rolünün kendisine verebileceği
bir şey haline getirirdi. İnsan listesi için
[Ekip ve izinler](/tr/product/team) sayfasına bakın.

<CardGroup cols={2}>
  <Card title="Kimlik doğrulama" icon="key" href="/tr/authentication">
    Başlık, hatalar ve bir anahtarın nasıl iptal edildiği.
  </Card>

  <Card title="Hızlı başlangıç" icon="rocket" href="/tr/quickstart">
    Bir anahtar oluşturun ve ilk kişinizi gönderin.
  </Card>
</CardGroup>

## Veri denetimleri

**Ayarlar (Settings) → Veri denetimleri (Data controls)** bölümünü açın.

<Frame caption="Ayarlar, Veri denetimleri: Kai neleri tutar ve ham yüklemeler nasıl silinir.">
  <img src="https://mintcdn.com/kai-support/RaOwCZDRMIUnRjWu/images/tr/settings-data.png?fit=max&auto=format&n=RaOwCZDRMIUnRjWu&q=85&s=155ea8c0e5f16b5e742fb475ed133d7a" alt="Ayarlar, Veri denetimleri" width="2880" height="2000" data-path="images/tr/settings-data.png" />
</Frame>

### Kai neleri saklar

Kai üç tür veri tutar.

* **Ham yüklemeler.** Sohbet dışa aktarım dosyalarının tam olarak
  gönderdiğiniz hali ve maskelemelerini geri çeviren eşleme.
* **Derlenmiş Bilgi Merkezi.** Yanıt kütüphanesi, görüşme akışları, insana
  devretme kuralları, iletişim kuralları, marka üslubu ve güncel bilgiler.
  Kişisel veri içermez.
* **Canlı görüşmeler.** Kanallarınızın ilettiği mesajlar, arkalarındaki kişiler
  ve Kai'nin yaptığı her işlem ile gerekçesi.

### Kişisel veri yer tutucuya dönüşür

Kai; her telefon numarasını, e-posta adresini ve ödeme referansını bir modele
ulaşmadan önce bir yer tutucuyla değiştirir. Bu işlem içe aktarma sırasında,
ilk model çağrısından önce olur.

Aynı değer her zaman aynı yer tutucuya dönüşür, böylece Kai değeri tutmadan
kalıbı öğrenir. Yer tutucuları geri çeviren eşleme kendi sunucunuzda kalır.

### Ham yüklemeleri silin

**Ham yüklemeleri sil (Erase raw uploads)** seçeneğini seçin, sonra onaylayın.
Kai özgün dışa aktarım dosyalarını ve maskelemelerini geri çeviren eşlemeyi
siler.

| Silme neleri kaldırır              | Silme neleri korur                               |
| ---------------------------------- | ------------------------------------------------ |
| Yüklenen dışa aktarım dosyaları    | Derlenmiş Bilgi Merkezi ve yayımlanmış her sürüm |
| Yer tutucuları geri çeviren eşleme | Canlı görüşmeleriniz ve kişileriniz              |

<Warning>
  Silme işlemi geri alınamaz. Silinen yüklemeler geri gelmez ve hiçbir yeniden
  eğitim onları bir daha okuyamaz.
</Warning>

Silme işlemini yalnızca bir yönetici yapabilir. Bir
[yeniden eğitim](/tr/product/how-it-works) etiketleri yeniden kullanmak için
önceki yüklemeleri okur, bu yüzden ilk yeniden eğitiminizden önce değil,
geçmişe artık ihtiyacınız kalmadığında silin.

## Sırada ne var

<CardGroup cols={2}>
  <Card title="Ekip ve izinler" icon="users" href="/tr/product/team">
    Bir anahtarı kimin oluşturabileceği ve kimin silebileceği.
  </Card>

  <Card title="İyi uygulamalar" icon="lightbulb" href="/tr/product/best-practices">
    Bir Bilgi Merkezini güvenilir tutan kurallar.
  </Card>
</CardGroup>
