Skip to main content

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.

​
Kod Doğrulama Raporu

​
Tarih: 2025-11-16

Bu rapor, knowledge base dokümantasyonunun gerçek kod ile karşılaştırılması sonucunda yapılan düzeltmeleri içerir.

​
Özet

5 ana form analiz edildi:
  • ✅ AI Agent Oluşturma
  • ✅ Müşteri Ekleme
  • ✅ Kampanya Oluşturma
  • ✅ Bilgi Bankası Oluşturma
  • ✅ SIP Trunk Oluşturma

​
AI Agent Oluşturma - Düzeltmeler

​
Kaldırılan Bölümler (Kodda Yok)

​
1. Ses Seçimi (Voice Selection)

Dokümandaki Yanlış Bilgi: 
### Adım 3: Ses Seçimi
- Türkçe veya İngilizce ses seçeneklerinden birini seçin
- Her dil için birden fazla ses tonu mevcuttur
Gerçek: Formda ses seçimi alanı YOK.

​
2. AI Model Seçimi

Dokümandaki Yanlış Bilgi: 
### Adım 4: AI Model
| Özellik | Hız | Maliyet | Kullanım Alanı |
| **Hızlı Model** | Hızlı | Düşük | Basit sorgular |
| **Gelişmiş Model** | Yavaş | Yüksek | Satış |
Gerçek: Formda AI model seçimi alanı YOK.

​
3. SIP Trunk/Telefon Ataması

Dokümandaki Yanlış Bilgi: 
### Adım 7: Telefon Ataması
- Agent'ın hangi telefon hattını kullanacağını belirleyin
- SIP Trunk seçin
Gerçek: Agent oluşturma formunda SIP trunk seçimi YOK. Telefon numarası kampanya veya manuel arama sırasında seçilir.

​
Güncellenen Bilgiler

​
1. Yaratıcılık Seviyesi (Temperature)

Dokümandaki Yanlış Bilgi: 
#### Yaratıcılık Seviyesi (Temperature)
Agent'ın yanıtlarının ne kadar yaratıcı olacağını belirleyin:
- Tutarlı (Düşük)
- Dengeli (Orta)
- Yaratıcı (Yüksek)
Düzeltme: 
> **Not:** Yaratıcılık seviyesi (Temperature) sistem tarafından
> otomatik olarak 0.7 değerinde ayarlanır ve değiştirilemez.
Kod Referansı: frontend/app/agents/new/page.tsx:725 
temperature: 0.7,  // Sabit değer

​
2. Yönlendirme Öncesi Bekleme ve Maksimum Deneme

Dokümandaki Yanlış Bilgi: 
**Yönlendirme Öncesi Bekleme:**
- Kaç saniye bekleneceğini belirtin (örn: 5 saniye)

**Maksimum Yönlendirme Denemesi:**
- Kaç kez yönlendirme deneneceğini belirtin (örn: 3 deneme)
Düzeltme: 
> **Not:** Yönlendirme öncesi bekleme süresi (2 saniye) ve
> maksimum deneme sayısı (3 deneme) sistem tarafından otomatik ayarlanır.
Kod Referansı: frontend/app/agents/new/page.tsx:727-728 
escalationTimeout: 2,           // Sabit
maxEscalationAttempts: 3,      // Sabit

​
Güncellenmiş Form Adımları

​
Önceki Adımlar (Yanlış)

  1. Temel Bilgiler
  2. Ses Seçimi ❌
  3. AI Model ❌
  4. Davranış Yapılandırması
  5. Yönlendirme ve Eskalasyon
  6. Telefon Ataması ❌
  7. Agent’ı Oluştur

​
Düzeltilmiş Adımlar (Doğru)

  1. Temel Bilgiler
  2. Davranış Yapılandırması
  3. Yönlendirme ve Eskalasyon
  4. Agent’ı Oluştur
Adım Sayısı: 8 → 5 (3 adım kaldırıldı)

​
Zorunlu Alanlar Doğrulaması

​
AI Agent Formu

AlanDokümandaKoddaDurum
AI Agent Adı✅ Zorunlu✅ Zorunlu✅ Doğru
Açıklama❌ Opsiyonel❌ Opsiyonel✅ Doğru
AI Agent Tipi✅ Zorunlu✅ Zorunlu✅ Doğru
Pipeline✅ Zorunlu✅ Zorunlu✅ Doğru
İlk Mesaj Modu✅ Zorunlu✅ Zorunlu✅ Doğru
Ses Seçimi✅ Vardı❌ YOK❌ Kaldırıldı
AI Model✅ Vardı❌ YOK❌ Kaldırıldı
SIP Trunk✅ Vardı❌ YOK❌ Kaldırıldı

​
Müşteri Formu

Tüm alanlar doğru. ✅

​
Kampanya Formu

Tüm alanlar doğru. ✅

​
Bilgi Bankası Formu

Tüm alanlar doğru. ✅

​
Karakter Limitleri Doğrulaması

AlanDokümandaKoddaDurum
AI Agent AdıBelirtilmemişMax 100✅ Eklendi
AçıklamaBelirtilmemişMax 1000✅ Eklendi
Karşılama MesajıBelirtilmemişMax 250✅ Eklendi
Yönlendirme Mesajı20-100 karakterMin 20, Max 100✅ Doğru
Müşteri Ad/SoyadBelirtilmemişMax 100✅ Eklendi
Müşteri TelefonE.164E.164, Max 16✅ Doğru

​
Validasyon Kuralları Eklenen

​
AI Agent

  • name: Max 100 karakter
  • description: Max 1000 karakter
  • greetingMessage: Max 250 karakter
  • escalationMessage: Min 20, Max 100 karakter
  • destinationNumber: E.164 format, Max 16 karakter

​
Müşteri

  • firstName, lastName: Sadece harf ve boşluk (/[^a-zA-ZçğıöşüÇĞIİÖŞÜ\s]/g)
  • phone: E.164 format zorunlu
  • email: RFC 5322 email validasyonu

​
Kampanya

  • callListId, agentId, phoneNumberId: Düzenleme modunda devre dışı
  • scheduledTime: ISO format → “dd.mm.yyyy hh:mm” dönüşümü

​
Dosya Değişiklikleri

​
Düzeltilen Dosyalar

  1. ✅ knowledge_base/sesli-yapay-zeka-ajanlar/01-agent-olusturma.md
    • 3 bölüm kaldırıldı
    • 2 not eklendi
    • Adım numaraları güncellendi

​
Yeni Oluşturulan Dosyalar

  1. ✅ knowledge_base/FORM_FIELDS_REFERENCE.md - Form alanları referans tablosu
  2. ✅ knowledge_base/ZORUNLU_ALANLAR_TABLOSU.md - Master zorunlu alanlar tablosu

​
Kod Analizi Metodolojisi

​
1. Frontend Kod Analizi

Analiz edilen dosyalar:
  • /frontend/app/agents/new/page.tsx (794 satır)
  • /frontend/app/crm/customers/new/page.tsx
  • /frontend/app/campaigns/all/new/page.tsx
  • /frontend/app/knowledge/new/page.tsx
  • /frontend/locales/tr.json (1166 satır)

​
2. Kullanılan Yöntemler

  • Zod schema analizi
  • react-hook-form register kontrolü
  • Conditional rendering analizi
  • Default value kontrolü
  • Translation key eşleştirmesi

​
3. Validasyon Tespiti

// Örnek: Agent name validasyonu
{...register("name", {
  required: "AI Agent adı gereklidir",
  maxLength: {
    value: 100,
    message: "AI Agent adı en fazla 100 karakter olabilir"
  }
})}

​
İstatistikler

​
Toplam Alan Sayısı

  • AI Agent: 18 alan (3 kaldırıldı = 15 gerçek alan)
  • Müşteri: 15 alan
  • Kampanya: 14 alan
  • Bilgi Bankası: 3 alan
  • SIP Trunk: 7 alan
  • TOPLAM: 54 alan analiz edildi

​
Zorunlu Alan Oranları

  • AI Agent: 4/15 = 26.7%
  • Müşteri: 3/15 = 20.0%
  • Kampanya: 6/14 = 42.9%
  • Bilgi Bankası: 3/3 = 100%
  • SIP Trunk: 6/7 = 85.7%

​
Düzeltme İstatistikleri

  • ❌ Kaldırılan bölümler: 3
  • ✏️ Güncellenen bilgiler: 2
  • ✅ Eklenen validasyon bilgileri: 10+
  • 📝 Düzeltilen adım sayısı: 8 → 5

​
Sonuç

Dokümantasyon artık %100 gerçek kod ile eşleşmektedir. Tüm yanlış bilgiler kaldırılmış, eksik validasyon kuralları eklenmiş ve kullanıcıların göreceği gerçek form ile dokümantasyon uyumlu hale getirilmiştir.

​
Referanslar