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

# Bilgi Bankası Yönetimi — Doküman Yükleme ve Kullanım

> AI Agent için bilgi bankası oluşturun, DOCX/TXT/CSV dosyaları yükleyin ve agent ile ilişkilendirin. Doküman yönetimi ve bilgi bankası yapılandırma rehberi.

## Genel Bakış

Bilgi Bankası, AI Agent'larınızın müşterilere doğru ve tutarlı bilgi vermesi için kullandığı doküman ve dosya koleksiyonlarıdır.

## Bilgi Bankası Sayfasına Erişim

1. Sol menüden **Bilgi Bankası**'nı seçin
2. İki ana sekme görünür:
   * **Bilgi Bankaları**: Tüm bilgi bankalarınız
   * **Dosyalar**: Yüklediğiniz tüm dosyalar

## Yeni Bilgi Bankası Oluşturma

<Steps>
  <Step title="Oluştur Sayfasına Gidin">
    **Bilgi Bankası** sayfasında **Yeni Bilgi Bankası Oluştur** butonuna tıklayın
  </Step>

  <Step title="Temel Bilgiler">
    ### İsim

    * Bilgi bankasına açıklayıcı bir isim verin
    * **Minimum**: 2 karakter
    * **Maksimum**: 50 karakter
    * **Örnek**: "İade Politikası", "Ürün Kataloğu", "Sık Sorulan Sorular"

    ### Açıklama

    * Bilgi bankasının ne içerdiğini kısaca açıklayın
    * **Minimum**: 1 karakter
    * **Maksimum**: 250 karakter
    * **Örnek**: "Müşteri iade ve değişim süreçleri hakkında detaylı bilgiler"
  </Step>

  <Step title="Dosya Yükleme">
    ### Desteklenen Dosya Formatları

    <Info>
      Yalnızca aşağıdaki üç format desteklenmektedir. PDF, Markdown veya Excel dosyaları kabul edilmez.
    </Info>

    | Format    | Uzantı  | Açıklama                                                          |
    | --------- | ------- | ----------------------------------------------------------------- |
    | **Word**  | `.docx` | Microsoft Word belgeleri (yalnızca .docx, eski .doc desteklenmez) |
    | **Metin** | `.txt`  | Düz metin dosyaları (UTF-8)                                       |
    | **CSV**   | `.csv`  | Virgülle ayrılmış değer dosyaları (tablo verileri için)           |

    ### Dosya Boyutu Limiti

    <Warning>
      Her dosya **maksimum 300KB** boyutunda olabilir. Daha büyük dosyalar reddedilir.
    </Warning>

    ### Dosya Yükleme Yöntemleri

    **Yöntem 1: Sürükle Bırak**

    1. Dosyaları **"Dosyaları buraya sürükleyip bırakın"** alanına sürükleyin
    2. Birden fazla dosya seçebilirsiniz
    3. Seçilen dosya sayısı gösterilir: "X dosya seçildi"

    **Yöntem 2: Göz At**

    1. **"göz atın"** linkine tıklayın
    2. Bilgisayarınızdan dosya seçin
    3. **Aç** butonuna tıklayın
  </Step>

  <Step title="Bilgi Bankasını Kaydet">
    Tüm alanları doldurduktan sonra **Oluştur** butonuna tıklayın
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/knowledge-create.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=13a1955552bd5e5b34e4dd9a15ecac09" alt="Bilgi bankası oluşturma — ad girişi ve dosya yükleme alanı" width="1528" height="943" data-path="images/knowledge-create.png" />
</Frame>

<Warning>
  **Hata**: "Lütfen en az bir dosya yükleyin" - Bilgi bankası oluşturmak için en az bir dosya yüklemeniz gerekmektedir.
</Warning>

## Bilgi Bankası Listeleme

### Bilgi Bankaları Sekmesi

Liste görünümünde her bilgi bankası için:

#### Kart Bilgileri

* **İsim**: Bilgi bankası adı
* **Açıklama**: Kısa açıklama
* **Dosya Sayısı**: "X dosya" formatında
* **Durum**:
  * **Aktif** (Yeşil): Kullanıma hazır
  * **Pasif** (Gri): Henüz atanmamış
* **Oluşturulma Tarihi**: Ne zaman oluşturuldu

#### Eylemler

* **Düzenle**: Bilgi bankasını düzenle
* **Sil**: Bilgi bankasını sil

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/knowledge-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=38e0b4e0a551d654fab113285109c016" alt="Bilgi bankası listesi — doküman sayısı ve oluşturma tarihi" width="1528" height="943" data-path="images/knowledge-list.png" />
</Frame>

### İstatistikler

Sayfa üst kısmında:

* **Toplam Bilgi Bankası**: Toplam bilgi bankası sayısı
* **Aktif Bilgi Bankası**: En az bir agent'a atanmış olanlar
* **Kullanıma hazır**: Dosyaları yüklenmiş ve aktif olanlar

### Boş Durum

Henüz bilgi bankası oluşturmadıysanız:

* "Henüz Bilgi Bankası Yok"
* "Başlamak için ilk bilgi bankanızı oluşturun."
* **"İlk Bilgi Bankanızı Oluşturun"** butonu

## Bilgi Bankası Düzenleme

<Steps>
  <Step title="Düzenleme Sayfasına Gidin">
    Bilgi bankası kartında **Düzenle** butonuna tıklayın
  </Step>

  <Step title="Bilgileri Güncelleyin">
    **Güncellenebilir Alanlar:**

    * İsim
    * Açıklama
    * Dosyalar (ekle/sil)

    ### Yeni Dosya Ekleme

    1. **"Dosyaları buraya sürükleyip bırakın"** alanını kullanın
    2. Veya **"göz atın"** linkine tıklayın
    3. Yeni dosyalar mevcut dosyalara eklenir

    ### Mevcut Dosyaları Görüntüleme

    **"Mevcut Dosyalar"** bölümünde:

    * Yüklü tüm dosyalar listelenir
    * Her dosyanın adı ve boyutu gösterilir
    * **Yenile** butonu ile listeyi güncelleyin
  </Step>

  <Step title="Değişiklikleri Kaydet">
    **Güncelle** butonuna tıklayın
  </Step>
</Steps>

## Dosya Yönetimi

### Dosyalar Sekmesi

Tüm yüklediğiniz dosyaları görüntüleyin:

#### Dosya Listesi Bilgileri

* **Dosya Adı**: Yüklenen dosyanın adı
* **Dosya Tipi**: DOCX, TXT veya CSV
* **Dosya Boyutu**: KB cinsinden (maks. 300KB)
* **Yüklenme Tarihi**: Ne zaman yüklendi
* **Bağlı Bilgi Bankası**: Hangi bilgi bankasında kullanılıyor

#### Dosya Eylemleri

<Tabs>
  <Tab title="İndir">
    <Steps>
      <Step title="İndir Butonu">
        Dosya satırında **İndir** butonuna tıklayın
      </Step>

      <Step title="İndirme">
        "İndiriliyor..." mesajı görünür ve dosya bilgisayarınıza indirilir
      </Step>
    </Steps>
  </Tab>

  <Tab title="Sil">
    <Steps>
      <Step title="Sil Butonu">
        Dosya satırında **Sil** butonuna tıklayın
      </Step>

      <Step title="Onay">
        Onay dialogu açılır: "'{name}' dosyasını silmek istediğinizden emin misiniz? Bu işlem geri alınamaz."
      </Step>

      <Step title="İşlemi Onayla">
        **Sil** butonuna tıklayın
      </Step>
    </Steps>

    <Warning>
      **Hata**: "Dosya aktif, silinemez. Önce bilgi bankasından kaldırın."

      * Bu dosya aktif bir bilgi bankasında kullanılıyor
      * Önce bilgi bankasını düzenleyin ve dosyayı kaldırın
    </Warning>
  </Tab>
</Tabs>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/knowledge-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=38e0b4e0a551d654fab113285109c016" alt="Bilgi bankası dosyaları — dosya adı, boyut ve yükleme tarihi" width="1528" height="943" data-path="images/knowledge-list.png" />
</Frame>

## Bilgi Bankasını Agent'a Atama

### Agent Oluşturma/Düzenleme Sırasında

<Steps>
  <Step title="Agent Sayfasına Gidin">
    AI Agent oluşturma veya düzenleme sayfasına gidin
  </Step>

  <Step title="Bilgi Bankası Bölümü">
    **Bilgi Bankası** bölümünü bulun (genellikle gelişmiş ayarlarda)
  </Step>

  <Step title="Bilgi Bankası Seçin">
    Açılır menüden bir veya birden fazla bilgi bankası seçin
  </Step>

  <Step title="Kaydedin">
    **Oluştur** veya **Güncelle** butonuna tıklayın
  </Step>
</Steps>

### Agent'ın Bilgi Bankalarını Görüntüleme

Agent detay sayfasında:

* Atanmış bilgi bankaları listelenir
* Her bilgi bankasının dosya sayısı gösterilir

## Bilgi Bankası Silme

<Warning>
  **Dikkat**: Silme işlemi geri alınamaz!
</Warning>

<Steps>
  <Step title="Sil Butonu">
    Bilgi bankası kartında **Sil** butonuna tıklayın
  </Step>

  <Step title="Onay">
    Onay dialogu açılır: "'{name}' bilgi bankasını silmek istediğinizden emin misiniz? Bu işlem geri alınamaz."
  </Step>

  <Step title="İşlemi Onayla">
    **Sil** butonuna tıklayın
  </Step>
</Steps>

### Silme Hatası

<Warning>
  **Hata**: "Bilgi bankası aktif, silinemez. Önce agent'lardan kaldırın."
</Warning>

**Çözüm**:

1. Bilgi bankasını kullanan agent'ları bulun
2. Her agent'ı düzenleyin
3. Bilgi bankası atamasını kaldırın
4. Ardından bilgi bankasını silin

## Dosya Limitleri ve Desteklenen Formatlar

### Dosya Boyutu Limiti

| Limit                          | Değer                |
| ------------------------------ | -------------------- |
| **Maksimum dosya boyutu**      | 300KB (dosya başına) |
| **Minimum isim uzunluğu**      | 2 karakter           |
| **Maksimum isim uzunluğu**     | 50 karakter          |
| **Maksimum açıklama uzunluğu** | 250 karakter         |

<Warning>
  300KB limitini aşan dosyalar otomatik olarak reddedilir. Büyük dosyalarınızı yüklemeden önce bölmeniz veya küçültmeniz gerekebilir.
</Warning>

### Desteklenen Formatlar ve Özellikleri

<Tabs>
  <Tab title="Word (.docx)">
    * Yalnızca `.docx` formatı desteklenir (eski `.doc` formatı desteklenmez)
    * Tablolar ve metin içeriği okunur
    * Dosya boyutu 300KB'yi geçmemelidir
  </Tab>

  <Tab title="Metin (.txt)">
    * UTF-8 encoding desteklenir
    * Düz metin içeriği
    * Dosya boyutu 300KB'yi geçmemelidir
  </Tab>

  <Tab title="CSV (.csv)">
    * Virgülle ayrılmış değer dosyaları
    * Tablo verileri, ürün listeleri ve yapılandırılmış veriler için idealdir
    * Dosya boyutu 300KB'yi geçmemelidir
  </Tab>
</Tabs>

<Info>
  **Not:** PDF (.pdf), Markdown (.md), Excel (.xlsx, .xls) ve eski Word (.doc) formatları şu anda desteklenmemektedir. Dosyalarınızı desteklenen formatlara dönüştürmek için uygun araçlar kullanın.
</Info>

### Güvenli Depolama

Dosyalarınız güvenli depolama alanında saklanır:

**Güvenlik:**

* Şifrelenmiş depolama (AES-256)
* Organizasyon bazlı izolasyon
* Otomatik yedekleme

### Toplu Dosya Yükleme

**Çoklu Seçim:**

1. Dosya seçim dialogunda
2. Ctrl/Cmd tuşuna basılı tutun
3. Birden fazla dosya seçin
4. **Aç**

**Sürükle-Bırak:**

* Birden fazla dosyayı seçin
* Sürükleme alanına bırakın
* Tümü bir seferde yüklenir

<Info>
  Her dosya 300KB limitine tabi olduğu için büyük dosyaları yüklemeden önce boyutlarını kontrol edin.
</Info>

## Bilgi Bankası En İyi Uygulamalar

### Dosya Organizasyonu

<Tip>
  #### Tek Konu Prensibi

  * Her bilgi bankası tek bir konu/kategoriyi kapsasın
  * **İyi**: "İade Politikası" bilgi bankası
  * **Kötü**: "Genel Bilgiler" (çok geniş)

  #### Dosya Adlandırma

  * Açıklayıcı dosya adları kullanın
  * **İyi**: "urun-garanti-kosullari.docx"
  * **Kötü**: "dokuman1.docx"

  #### Dosya Boyutu

  * Her dosya maksimum 300KB olabilir
  * Büyük dosyaları parçalara bölün
  * Gereksiz biçimlendirmeyi kaldırarak boyutu küçültün
</Tip>

### İçerik Kalitesi

<Tip>
  #### Güncel Tutma

  * ✅ Bilgileri düzenli güncelleyin
  * ✅ Eski/geçersiz dosyaları silin
  * ✅ Versiyon numarası kullanın

  #### Netlik

  * ✅ Açık ve anlaşılır dil kullanın
  * ✅ Kısaltmalardan kaçının
  * ✅ Örnekler verin

  #### Yapılandırma

  * ✅ Başlıklar kullanın
  * ✅ Madde işaretleri ile listeleyin
  * ✅ Tablolar ile organize edin
</Tip>

### Agent Atamaları

* Sadece agent'ın ihtiyaç duyduğu bilgileri atayın
* Gereksiz bilgi karışıklığa yol açar
* Agent'ların doğru bilgi bankalarını kullandığını test edin
* Düzenli olarak konuşma transkriptlerini gözden geçirin

## Sorun Giderme

<AccordionGroup>
  <Accordion title="&#x22;Dosya yüklenemedi&#x22; Hatası">
    **Olası Nedenler:**

    * Dosya formatı desteklenmiyor (yalnızca .docx, .txt, .csv kabul edilir)
    * Dosya boyutu 300KB'dan büyük
    * İnternet bağlantısı kesildi

    **Çözüm:**

    * Desteklenen format kullanın (.docx, .txt veya .csv)
    * Dosya boyutunu 300KB'nin altına düşürün
    * İnternet bağlantınızı kontrol edin
  </Accordion>

  <Accordion title="&#x22;Bilgi bankası silinemiyor&#x22; Hatası">
    **Neden**: Bilgi bankası aktif agent'larda kullanılıyor

    **Çözüm:**

    1. AI Agent'lar sayfasına gidin
    2. Bu bilgi bankasını kullanan agent'ları bulun (arama yapın)
    3. Her agent'ı düzenleyin ve bilgi bankası atamasını kaldırın
    4. Ardından bilgi bankasını silin
  </Accordion>

  <Accordion title="Agent Yanlış Bilgi Veriyor">
    **Kontrol Listesi:**

    1. ✅ Bilgi bankası güncel mi?
    2. ✅ Doğru bilgi bankası agent'a atandı mı?
    3. ✅ Bilgi içeriği açık ve net mi?
    4. ✅ Çelişkili bilgiler var mı?

    **Çözüm:**

    * Bilgi bankasını gözden geçirin ve güncelleyin
    * Agent'ın sistem talimatını optimize edin
  </Accordion>

  <Accordion title="Dosya İndiremiyor">
    **Olası Nedenler:**

    * Dosya silinmiş
    * Tarayıcı indirmeleri engelliyor
    * Yetki sorunu

    **Çözüm:**

    * Dosyanın hala listede olduğunu kontrol edin
    * Tarayıcı ayarlarını kontrol edin
    * Farklı tarayıcı deneyin
  </Accordion>

  <Accordion title="Dosya boyutu limiti aşılıyor">
    **Neden**: Dosyanız 300KB sınırını aşıyor

    **Çözüm:**

    * Word dosyalarında görsel ve biçimlendirmeyi azaltın
    * Büyük CSV dosyalarını daha küçük parçalara bölün
    * Metin dosyalarında gereksiz boşluk ve tekrarları kaldırın
  </Accordion>
</AccordionGroup>

## Sık Sorulan Sorular

<AccordionGroup>
  <Accordion title="Bir bilgi bankasını birden fazla agent'a atayabilir miyim?">
    Evet, aynı bilgi bankası birden fazla agent tarafından kullanılabilir.
  </Accordion>

  <Accordion title="Hangi dosya formatları desteklenir?">
    Yalnızca üç format desteklenir: **Word (.docx)**, **Metin (.txt)** ve **CSV (.csv)**. PDF, Markdown, Excel ve eski Word (.doc) dosyaları kabul edilmez.
  </Accordion>

  <Accordion title="Maksimum dosya boyutu nedir?">
    Her dosya maksimum **300KB** boyutunda olabilir. Bu limiti aşan dosyalar otomatik olarak reddedilir.
  </Accordion>

  <Accordion title="CSV dosyalarını ne için kullanabilirim?">
    CSV dosyaları, ürün listeleri, fiyat tabloları, sıkça sorulan sorular listesi ve benzeri yapılandırılmış veriler için idealdir. Verilerinizi virgülle ayrılmış formatta düzenleyerek yükleyebilirsiniz.
  </Accordion>

  <Accordion title="Bilgi bankası ne kadar sürede aktif olur?">
    Dosyalar yüklendikten sonra birkaç dakika içinde agent'lar tarafından kullanılabilir hale gelir.
  </Accordion>

  <Accordion title="Eski dosya versiyonları nasıl yönetilir?">
    Eski dosyayı silin ve yeni versiyonu aynı isimle yükleyin. Veya versiyon numarası ekleyin (örn: "politika-v2.docx").
  </Accordion>
</AccordionGroup>

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="AI Agent Oluşturma" icon="robot" href="/docs/voice-ai-agents/create-agent">
    Yeni AI Agent oluşturma ve yapılandırma
  </Card>
</CardGroup>