> ## 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.

# Hızlı Başlangıç — AI Agent Oluşturma ve Test Rehberi

> AI Agent TR platformuna kayıt olun, dakikalar içinde ilk AI Agent'ınızı oluşturun ve tarayıcıdan sesli arama ile test edin. Adım adım hızlı kurulum rehberi.

## 3 Adımda Başlayın

Platform ile çalışmaya başlamak ve ilk AI çağrınızı gerçekleştirmek için bu rehberi takip edin.

<Steps>
  <Step title="Hesap Kurulumu">
    Platforma kayıt olun ve organizasyonunuzu oluşturun (veya sonraya bırakın)
  </Step>

  <Step title="İlk AI Agent'ınızı Oluşturun">
    İlk AI Agent'ınızı yapılandırın
  </Step>

  <Step title="Test Araması Yapın">
    Agent'ınızı tarayıcıdan veya telefonla test edin ve sonuçları gözden geçirin
  </Step>
</Steps>

***

## Adım 1: Hesap Kurulumu

### Platforma Kayıt Olun

<Steps>
  <Step title="Platformu Açın">
    Tarayıcınızda platformun URL adresine gidin
  </Step>

  <Step title="Hesap Oluşturun veya Giriş Yapın">
    **Kayıt Ol** ile yeni hesap oluşturun veya **Giriş Yap** ile mevcut hesabınıza erişin
  </Step>

  <Step title="Seçim Ekranı">
    İlk girişte bir seçim ekranı karşınıza çıkar — organizasyonunuzu nasıl oluşturmak istediğinize karar verin
  </Step>
</Steps>

### Organizasyon Seçenekleri

İlk girişte size üç yol sunulur:

<Tabs>
  <Tab title="Şimdi Kurulum Yap">
    Organizasyon bilgilerinizi eksiksiz doldurup hemen başlayın.

    * Şirket bilgileri, vergi bilgileri, adres bilgileri girilir
    * Faturalama ve tam platform kullanımı için önerilen yoldur
    * Detaylar: [Organizasyon Oluşturma](/docs/organization-management/create-organization)
  </Tab>

  <Tab title="Sonra Kurulumu Yap">
    Hızlıca platforma girin — detayları daha sonra tamamlayın.

    * Herhangi bir form doldurmanız **gerekmez**
    * Sistem taslak bir organizasyon oluşturur ve sizi doğrudan **Panel** sayfasına yönlendirir
    * Organizasyon bilgilerinizi daha sonra **Ayarlar → Organizasyon** sayfasından tamamlayabilirsiniz
  </Tab>

  <Tab title="Davet Kabul Et">
    Mevcut bir organizasyona davet edildiyseniz, daveti kabul ederek katılabilirsiniz.

    * Bekleyen davetler seçim ekranının üst kısmında listelenir
    * **Kabul Et** butonuna tıklayarak organizasyona katılın
    * Doğrudan **Panel** sayfasına yönlendirilirsiniz
  </Tab>
</Tabs>

<Tip>
  Organizasyon kurulumunu atlamak platformu keşfetmenizi engellemez — agent oluşturma, test araması yapma gibi temel özellikleri hemen kullanabilirsiniz. Bilgilerinizi daha sonra tamamlayabilirsiniz.
</Tip>

<Info>
  Platform API bağlantısı her üç yolda da **otomatik olarak yapılandırılır**. Manuel API anahtarı girmenize gerek yoktur.
</Info>

### Kontrol Panelini Keşfedin

Organizasyon oluşturulduktan (veya taslak olarak atlandıktan) sonra **Kontrol Paneli** sayfasına yönlendirilirsiniz.

Ana metrikler:

* **Aktif Çağrılar**: Şu anda devam eden çağrı sayısı
* **Bugün Yapılan Çağrılar**: Bugünkü toplam çağrı ve süre
* **Başarı Oranı**: Geçen haftayla karşılaştırmalı başarı metriği
* **AI Entegrasyonu**: Bağlantı durumu (Bağlı olmalı ✅)
* **Kalan Krediler**: Kullanılabilir krediniz

***

## Adım 2: İlk AI Agent'ınızı Oluşturun

### Agent Oluşturma Sayfasına Gidin

<Steps>
  <Step title="Sol Menüden AI Agent'lar'ı Seçin">
    Ana menüden **AI Agent'lar** bölümüne gidin
  </Step>

  <Step title="Yeni AI Agent Oluştur">
    **Yeni AI Agent Oluştur** butonuna tıklayın
  </Step>
</Steps>

### Temel Bilgileri Doldurun

<Tabs>
  <Tab title="AI Agent Adı ve Açıklama">
    Açıklayıcı bir isim ve kısa bir açıklama verin:

    * **Ad**: Örn. "Müşteri Hizmetleri Asistanı", "Randevu Yönetim Botu" (maks. 40 karakter)
    * **Açıklama**: Agent'ın ne iş yaptığını kısaca tanımlayın (maks. 1000 karakter)
  </Tab>

  <Tab title="AI Agent Tipi">
    Kullanım amacınıza göre seçin:

    * **E-ticaret**: Sipariş takibi, ürün bilgisi
    * **Randevu**: Randevu alma ve yönetimi
    * **Destek**: Teknik destek ve sorun giderme
  </Tab>

  <Tab title="Pipeline ve Departman">
    * **Pipeline**: Satış veya destek sürecinizi seçin
    * Mevcut pipeline'larınız listeden otomatik yüklenir
  </Tab>

  <Tab title="İlk Mesaj Modu ve Dil">
    * **İlk Mesaj Modu**: "Agent ilk konuşur" — dışa dönük aramalar için önerilir
    * **Dil**: Agent'ın konuşacağı dili seçin (varsayılan: Türkçe)
  </Tab>
</Tabs>

### Karşılama Mesajını Yazın

Agent'ınızın müşteriyi nasıl karşılayacağını belirleyin (maks. 250 karakter):

```
Merhaba! Ben [Şirket Adı]'ndan yapay zeka asistanıyım.
Size nasıl yardımcı olabilirim?
```

### Sistem Talimatını Oluşturun

Agent'ınızın nasıl davranacağını açıklayın:

**Örnek Talimat:**

```
Sen bir müşteri hizmetleri asistanısın.
Müşterilere ürünler hakkında bilgi ver ve sorularını yanıtla.
Her zaman nazik ve yardımsever ol.
Cevaplayamadığın sorular için insan temsilciye yönlendir.
```

<Tip>
  **İpucu**: Açık ve spesifik olun. Agent'ın ne yapması ve ne YAPMAMASI gerektiğini belirtin. Sistem talimatı zorunludur.
</Tip>

### Agent'ı Oluşturun

<Steps>
  <Step title="Formu Tamamlayın">
    Tüm zorunlu alanları doldurduktan sonra **AI Agent Oluştur** butonuna tıklayın
  </Step>

  <Step title="Başarı Mesajı">
    "AI Agent başarıyla oluşturuldu" mesajını göreceksiniz
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/agents-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=3dffaac835bfff7cee24f4dac0c94c27" alt="AI Agent listesi — oluşturulan agent'ların ad, tip ve durum bilgileri" width="1528" height="943" data-path="images/agents-list.png" />
</Frame>

***

## Adım 3: Test Araması Yapın

### Web Üzerinden Test Araması (Önerilen)

<Info>
  Telefonunuza gerek kalmadan, doğrudan tarayıcınızdan agent'ınızı test edebilirsiniz!
</Info>

<Steps>
  <Step title="Agent Listesine Gidin">
    **AI Agent'lar** sayfasında oluşturduğunuz agent'ı bulun
  </Step>

  <Step title="Konuş Butonuna Tıklayın">
    Agent kartında **Konuş** butonuna tıklayın (mikrofon ikonu)
  </Step>

  <Step title="Ses Ayarlarını Yapılandırın">
    Sesli arama penceresi açılır. Tarayıcınız mikrofon izni istediğinde **İzin Ver**'e tıklayın.
  </Step>

  <Step title="Konuşmaya Başlayın">
    Bağlantı kurulduğunda agent ile konuşmaya başlayın:

    * Gerçek zamanlı transkript ekranda görünür
    * Mikrofon seviyenizi izleyebilirsiniz
    * Ses kapatma (mute) butonu ile mikrofonunuzu kontrol edebilirsiniz
    * İstediğiniz zaman **Kapat** butonu ile aramayı sonlandırabilirsiniz
  </Step>
</Steps>

<Tip>
  **Web Aramasının Avantajları**: Telefon numarasına ihtiyaç yok, anlık transkript görüntüleme, kolay ve hızlı test!
</Tip>

### Telefon ile Test Araması

Gerçek telefon deneyimini test etmek istiyorsanız:

<Steps>
  <Step title="Ara Butonuna Tıklayın">
    Agent kartında **Ara** butonuna tıklayın (telefon ikonu)
  </Step>

  <Step title="Telefon Numarası Girin">
    Aranacak telefon numarasını girin ve aramayı başlatın
  </Step>
</Steps>

<Note>
  Telefon ile test araması için SIP trunk yapılandırması ve yeterli kredi gereklidir.
</Note>

### Çağrıyı Değerlendirin

<AccordionGroup>
  <Accordion title="Çağrı Başladığında">
    * Web aramasında: Bağlantı kurulur ve agent karşılama mesajını söyler
    * Telefon aramasında: Telefonunuz çalar ve agent konuşmaya başlar
    * Soru sorun ve yanıtları değerlendirin
  </Accordion>

  <Accordion title="Test Sırasında Kontrol Edin">
    * Agent'ın karşılaması doğru mu?
    * Sorularınızı anlıyor mu?
    * Yanıtları mantıklı mı?
    * Ses kalitesi iyi mi?
    * Web aramasında: Transkript doğru mu görünüyor?
  </Accordion>

  <Accordion title="Çağrı Sonrası">
    * **Görüşmeler** sayfasına gidin
    * Test çağrınızı bulun ve detaylarını görüntüleyin
    * Transkripti okuyun
    * Gerekirse agent ayarlarını düzenleyin
  </Accordion>
</AccordionGroup>

### Sonuçları İnceleyin

Çağrı detay sayfasında:

* **Transkript**: Tam konuşma metni
* **Analiz**: AI tarafından oluşturulan özet
* **Kayıt**: Ses kaydını dinleyin

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/conversations-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=beefe8bf9b1b1dffea4b3db013aa0354" alt="Görüşmeler listesi — çağrı geçmişi, süre ve durum bilgileri" width="1528" height="943" data-path="images/conversations-list.png" />
</Frame>

***

## Sonraki Adımlar

Tebrikler! İlk AI Agent'ınızı oluşturup test ettiniz.

### Önerilen Sonraki Adımlar

<CardGroup cols={2}>
  <Card title="İlk Kampanyanızı Oluşturun" icon="rocket" href="/docs/campaigns/first-campaign-guide">
    Adım adım ilk kampanyanızı başlatma rehberi
  </Card>

  <Card title="Çağrı Testi Yapın" icon="vial" href="/docs/voice-ai-agents/call-testing">
    Agent'ınızı web veya telefon üzerinden test edin
  </Card>

  <Card title="Bilgi Bankası Ekleyin" icon="database" href="/docs/voice-ai-agents/knowledge-base-management">
    Agent'ınıza ürün/hizmet bilgileri yükleyin
  </Card>

  <Card title="Müşteri Ekleyin" icon="users" href="/docs/customer-management/add-customer">
    CRM'e müşterilerinizi ekleyin
  </Card>

  <Card title="Telefon Numarası Ekleyin" icon="phone" href="/docs/phone-numbers/sip-trunk-setup">
    SIP trunk yapılandırmasını tamamlayın
  </Card>

  <Card title="Kampanya Başlatın" icon="megaphone" href="/docs/campaigns/create-campaign">
    Toplu çağrı kampanyanızı oluşturun
  </Card>
</CardGroup>

### İleri Seviye Özellikler

<Steps>
  <Step title="Yönlendirme Ayarlayın">
    Agent'ın karmaşık durumları insan temsilciye yönlendirebilmesini sağlayın
  </Step>

  <Step title="Pipeline Oluşturun">
    Satış veya destek süreçlerinizi pipeline'lar ile yönetin
  </Step>

  <Step title="Analitik İnceleyin">
    Kampanya performansınızı detaylı metriklerle takip edin
  </Step>
</Steps>

## Sık Karşılaşılan Sorunlar

<AccordionGroup>
  <Accordion title="Web Araması Başlamıyor">
    **Kontrol Listesi:**

    * ✅ Tarayıcınız mikrofon erişimine izin veriyor mu?
    * ✅ Yeterli krediniz var mı?
    * ✅ Agent aktif durumda mı?
    * ✅ Tarayıcınız güncel mi? (Chrome, Firefox veya Edge önerilir)
  </Accordion>

  <Accordion title="Telefon Araması Başlamıyor">
    **Kontrol Listesi:**

    * ✅ SIP trunk yapılandırması tamamlandı mı?
    * ✅ Yeterli krediniz var mı?
    * ✅ Telefon numarası `E.164` formatında mı? (`+905XXXXXXXXX`)
    * ✅ Agent aktif durumda mı?
  </Accordion>

  <Accordion title="Agent Ses Çıkarmıyor">
    **Çözüm:**

    * Karşılama mesajının dolu olduğundan emin olun
    * Sistem talimatını gözden geçirin
    * AI entegrasyon durumunu kontrol panelinden kontrol edin
    * Web aramasında hoparlör sesinizi kontrol edin
  </Accordion>

  <Accordion title="Organizasyon bilgilerimi sonra tamamlayabilir miyim?">
    Evet! **Sonra Kurulumu Yap** ile hızlıca başlayabilir, bilgilerinizi daha sonra **Ayarlar → Organizasyon** sayfasından tamamlayabilirsiniz. Detaylar: [Organizasyon Oluşturma](/docs/organization-management/create-organization)
  </Accordion>
</AccordionGroup>

## Yardıma mı İhtiyacınız Var?

<CardGroup cols={2}>
  <Card title="Platform Tanıtımı" icon="book" href="/docs/getting-started/platform-introduction">
    Platform özelliklerinin detaylı açıklaması
  </Card>

  <Card title="Kontrol Paneli" icon="gauge" href="/docs/getting-started/dashboard">
    Metrikleri anlama ve izleme
  </Card>
</CardGroup>

<Info>
  Platform içinde her sayfada yardım butonlarını kullanabilir ve ilgili dokümantasyon bölümlerine hızlıca erişebilirsiniz.
</Info>