Skip to main content

​
Genel Bakış

Agent araçları, AI Agent’ınızın görüşme sırasında dış sistemlerle etkileşim kurmasını, veri çekmesini ve işlemler yapmasını sağlar. Araçlar sayesinde agent, sadece konuşmakla kalmaz, aynı zamanda aksiyonlar da alabilir.

​
Araç Nedir?

Tool (Araç): Agent’ın görüşme sırasında çağırabileceği dış fonksiyonlardır.

Randevu Yönetimi

  • Randevu oluşturma
  • Müsait saatleri kontrol etme
  • Randevu iptal etme
  • Randevu güncelleme

E-ticaret

  • Ürün stok kontrolü
  • Fiyat sorgulama
  • Sipariş oluşturma
  • Kargo takibi

CRM Entegrasyonu

  • Müşteri bilgisi çekme
  • Müşteri notu ekleme
  • Lead oluşturma
  • Ticket açma

Finansal İşlemler

  • Bakiye sorgulama
  • İşlem geçmişi
  • Ödeme linki gönderme
  • Fatura oluşturma

​
Araç Tipleri

​
1. Dahili Araçlar (Built-in)

Platform ile gelen hazır araçlar:
  • getCustomer - Müşteri bilgisi çekme
  • updateCustomer - Müşteri güncelleme
  • createCustomer - Yeni müşteri oluşturma

​
2. Özel Araçlar (Custom)

Kendi oluşturduğunuz araçlar:
  • Kendi API’nize istek atma
  • Harici servislerle entegrasyon
  • Özel iş mantığı

​
Araç Ekleme

1

Agent Düzenleme

  1. AI Agent’lar sayfası
  2. Agent seçin > Düzenle
  3. Araçlar sekmesi
2

Dahili Araç Ekleme

Mevcut Araçlar listesi:
  1. Eklemek istediğiniz aracı seçin
  2. Etkinleştir switch’i açın
  3. Ayarlar (varsa) yapılandırın
  4. Kaydet
3

Özel Araç Oluşturma

Custom Tool bölümü:
  1. Yeni Araç Oluştur butonu
  2. Araç Adı: İngilizce, boşluksuz (örn: checkStock)
  3. Açıklama: Ne iş yaptığını açıklayın
  4. API Endpoint: Çağrılacak URL
  5. HTTP Method: GET/POST/PUT/DELETE
  6. Headers: API key vb. header’lar
  7. Parameters: Gönderilecek parametreler
4

Prompt Güncellemesi

Agent promptuna araç kullanımı ile ilgili talimat ekleyin.Örnek:
Müşteri stok durumu sorarsa, checkStock aracını kullanarak
kontrol et ve sonucu müşteriye bildir.
5

Test ve Kaydet

Test Et butonuyla test edin, sonra Kaydet
Agent araçları ayarları
Ekran görüntüsü eklenecek: Araçlar sekmesinde dahili ve özel araç ekleme

​
Özel Araç Oluşturma Detayı

​
Araç Şeması

Örnek: Stok Kontrol Aracı 
{
  "name": "checkStock",
  "description": "Ürün stok durumunu kontrol eder",
  "endpoint": "https://api.yourstore.com/products/check-stock",
  "method": "POST",
  "parameters": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "string",
        "description": "Ürün ID'si"
      },
      "quantity": {
        "type": "number",
        "description": "İstenen miktar"
      }
    },
    "required": ["productId"]
  },
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  }
}

​
API Response Format

{
  "success": true,
  "inStock": true,
  "availableQuantity": 25,
  "productName": "iPhone 15 Pro"
}
Agent Davranışı: “Ürün stoklarımızda mevcut. 25 adet bulunuyor.”

​
Test Etme

1

Test Tool Butonu

Araç oluşturma sayfasında Test Tool butonuna tıklayın
2

Test Parametreleri

Test parametreleri girin
3

Test Et

Test Et butonuna tıklayın ve response’u görüntüleyin
4

Kaydet

Başarılıysa aracı kaydedin

​
Katalog Yönetimi

​
Katalog Nedir?

Catalog: Agent’a önceden yüklenmiş ürün/hizmet listesi. Kullanım:
  • Agent, katalogdaki ürünleri bilir
  • Fiyat sorularına cevap verebilir
  • Stok durumunu kontrol edebilir
  • Sipariş alabilir

​
Katalog Oluşturma

1

Katalog Sayfası

Ayarlar > Kataloglar veya Araçlar > Kataloglar
2

Yeni Katalog

  1. Yeni Katalog Oluştur
  2. Katalog Adı: Örn: “Ürün Kataloğu”
  3. Açıklama: “Satış ürünleri listesi”
  4. Oluştur
3

Ürün Ekleme

Manuel Ekleme:
  1. Ürün Ekle butonu
  2. Ürün Adı, SKU/ID, Fiyat, Açıklama, Stok Durumu
  3. Kaydet
Toplu Ekleme:
  1. Toplu İçe Aktar
  2. CSV template indir
  3. Excel’de doldurun
  4. Upload edin
4

Agent İlişkilendirme

Agent Düzenleme:
  1. Araçlar sekmesi
  2. Katalog Ayarları
  3. Kullanılacak kataloğu seçin
  4. Kaydet

​
CSV Format

name,sku,price,description,inStock
iPhone 15 Pro,IP15P,45000,256GB Model,true
MacBook Air M2,MBA-M2,35000,8GB RAM 256GB SSD,true
AirPods Pro,APP2,9000,2. Nesil,false
Katalog yönetimi
Ekran görüntüsü eklenecek: Katalog oluşturma ve ürün ekleme sayfası

​
Kategori ve Alt Kategori

Hiyerarşi: 
Elektronik
  ├─ Telefonlar
  │   ├─ iPhone
  │   └─ Samsung
  └─ Bilgisayarlar
      ├─ Laptop
      └─ Masaüstü
Kategori Oluşturma:
  1. Katalog içinde Kategori Ekle
  2. Kategori adı (örn: “Telefonlar”)
  3. Kaydet
Alt Kategori:
  1. Kategorinin yanındaki + ikonu
  2. Alt kategori adı (örn: “iPhone”)
  3. Kaydet

​
Araç Çağrısı ve Yanıt

​
Agent Araç Çağırma Süreci

1

Müşteri Sorusu

Müşteri: "iPhone 15 Pro stokta var mı?"
2

Agent Karar

Agent promptuna göre checkStock aracını çağırmaya karar verir
3

Araç Çağrısı

{
  "tool": "checkStock",
  "parameters": {
    "productId": "IP15P"
  }
}
4

API Response

{
  "success": true,
  "inStock": true,
  "availableQuantity": 15
}
5

Agent Cevabı

Agent: "Evet, iPhone 15 Pro stoklarımızda mevcut.
15 adet bulunuyor."

​
Çoklu Araç Çağrısı

Senaryo: Müşteri sipariş vermek istiyor. Adımlar:
  1. checkStock - Stok kontrolü
  2. createOrder - Sipariş oluşturma
  3. sendConfirmation - SMS onayı gönderme
Agent bu araçları sırayla çağırır.

​
Araç Güvenliği

​
API Key Yönetimi

  • API key’leri güvenli saklayın
  • Environment variables kullanın
  • Hard-code etmeyin

​
Yetkilendirme

  • Agent sadece yetkili işlemleri yapabilmeli
  • Ödeme işlemleri için ek doğrulama
  • Kritik işlemler için onay mekanizması

​
Rate Limiting

  • API’nize rate limit koyun
  • Agent çok fazla istek atarsa engelleyin
  • Abuse koruması

​
İpuçları ve En İyi Uygulamalar

​
Araç Tasarımı

  • ✅ Tek bir işe odaklanın (Single Responsibility)
  • ✅ Açıklayıcı isim kullanın
  • ✅ Parametreleri minimumda tutun
  • ✅ Hata durumlarını iyi yönetin
  • ❌ Çok karmaşık araçlar yapmayın
  • ❌ Çok fazla parametre eklemeyin

​
Katalog Yönetimi

  • ✅ Katalog düzenli güncelleyin
  • ✅ Stok durumlarını senkron tutun
  • ✅ Fiyatları güncel tutun
  • ✅ Kategori kullanın
  • ❌ Güncel olmayan verilerle çalışmayın

​
Prompt ile Uyum

Kötü Örnek: 
Araç ekledim ama prompt'ta belirtmedim.
Agent ne zaman kullanacağını bilmiyor.
İyi Örnek: 
"Müşteri ürün stoku sorarsa checkStock aracını kullan.
Sipariş vermek isterse createOrder aracını kullan."

​
Örnek Entegrasyonlar

Araç: checkAvailabilityEndpoint: Google Calendar APIKullanım:
  • Müşteri randevu tarihi sorar
  • Agent takvimden müsait saatleri kontrol eder
  • Müsait saati önerir
Araç: getCRMDataEndpoint: HubSpot/Salesforce APIKullanım:
  • Müşteri ID ile CRM’den bilgi çeker
  • Önceki etkileşimleri görür
  • Kişiselleştirilmiş hizmet verir
Araç: createPaymentLinkEndpoint: Stripe/PayTR APIKullanım:
  • Sipariş tutarı hesaplanır
  • Ödeme linki oluşturulur
  • Müşteriye SMS ile gönderilir

​
Sorun Giderme

Sebep: Agent ne zaman kullanacağını bilmiyorÇözüm:
  1. Prompt’u güncelleyin
  2. Araç kullanımını açık bir şekilde belirtin
  3. Test görüşmesi yapın
Sebep: API endpoint çalışmıyor veya hatalıÇözüm:
  1. Test Tool ile test edin
  2. API endpoint’i kontrol edin
  3. Headers ve authentication kontrol edin
  4. Response formatını kontrol edin
Sebep: Ürünler eklenmemiş veya agent ile ilişkilendirilmemişÇözüm:
  1. Katalog’a ürün ekleyin
  2. Agent ayarlarından katalog seçin
  3. Kaydedin ve test edin
Sebep: Katalog güncel değilÇözüm:
  1. Katalog’u güncelleyin
  2. Fiyat ve stok durumlarını kontrol edin
  3. Agent’ı yeniden test edin

​
Sık Sorulan Sorular

Teknik limit yok, ancak 5-10 arası ideal. Çok fazla araç agent’ı karıştırabilir.
Platform ücreti yok, ancak kendi API’nizin maliyeti size aittir.
Agent hata mesajını alır ve müşteriye kibarca bilgi verir. İşlemi tekrar deneyebilir.
Şu anda manuel veya CSV import. Gelecekte API ile otomatik güncelleme eklenebilir.
Şu anda bir agent bir katalog kullanabilir. Gelecekte çoklu katalog desteği eklenebilir.
Hayır, sadece API endpoint ve parametreleri tanımlarsınız. Kod yazmaya gerek yok.
Evet, transkript detayında araç çağrıları ve yanıtları görünür.

​
İlgili Makaleler

AI Agent Oluşturma

Yeni AI Agent oluşturma ve yapılandırma

Yapılandırılmış Çıktılar

JSON formatında veri toplama

Bilgi Bankası Yönetimi

Agent bilgi kaynaklarını yönetme

Gelişmiş Yapılandırma

Agent performans optimizasyonu