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ı, çağrıları aktarmasını ve işlemler yapmasını sağlar. Araçlar sayesinde agent, sadece konuşmakla kalmaz, aynı zamanda aksiyonlar da alabilir.

​
Araç Tipleri

Platform şu araç tiplerini destekler:

Handoff (Aktarma)

Çağrıyı başka bir AI Agent’a bağlam mühendisliği ile aktarma

Özel Fonksiyon

HTTP webhook üzerinden özel iş mantığı çalıştırma

Çağrı Yönlendirme

Çağrıyı telefon numarası veya SIP adresine aktarma

Bilgi Sorgulama

Bilgi bankasından veri sorgulama

Çağrı Sonlandırma

Görüşmeyi programatik olarak sonlandırma

Sesli Mesaj

Sesli mesaj algılama ve yönetimi

​
Handoff Aracı (Çağrı Aktarma)

Handoff aracı, bir AI Agent’ın görüşmeyi başka bir AI Agent’a aktarmasını sağlar. Aktarma sırasında konuşma bağlamının ne kadarının hedef agent’a iletileceği yapılandırılabilir.

​
Bağlam Mühendisliği (Context Engineering)

Handoff aracının en güçlü özelliği bağlam mühendisliğidir. Çağrı aktarılırken hedef agent’a iletilecek konuşma bağlamını kontrol edebilirsiniz:
Tip: allGörüşmedeki tüm mesajlar hedef agent’a iletilir.✅ Kullanım: Hedef agent’ın konuşmanın tamamını bilmesi gerektiğinde❌ Dikkat: Uzun görüşmelerde bağlam penceresi dolabilir

​
Değişken Çıkarma (Variable Extraction)

Handoff aracı, aktarma öncesinde görüşmeden belirli bilgileri şema bazlı olarak çıkarabilir. Bu bilgiler hedef agent’a değişken olarak iletilir. Örnek Şema: 
{
  "type": "object",
  "properties": {
    "musteriAdi": {
      "type": "string",
      "description": "Müşterinin tam adı"
    },
    "siparisNumarasi": {
      "type": "string",
      "description": "Sipariş numarası"
    },
    "sorunOzeti": {
      "type": "string",
      "description": "Müşterinin yaşadığı sorunun kısa özeti"
    }
  }
}
Bu şema sayesinde aktarma öncesinde agent, konuşmadan ilgili bilgileri otomatik olarak çıkarır ve hedef agent’a yapılandırılmış veri olarak iletir.

​
Handoff Hedef Tipleri

Hedef TipiAçıklama
Assistant (AI Agent)Platformdaki başka bir AI Agent’a aktarma. Agent ID ve platform referans ID’si gereklidir.
Dynamic (Dinamik)Çalışma zamanında belirlenen bir hedefe aktarma.

​
Handoff Mesaj Kontrolleri

Handoff aracı için aşağıdaki mesaj alanları yapılandırılabilir:
AlanAçıklama
messageToCustomerAktarma başlatılırken müşteriye söylenecek mesaj
waitForMessageToBeSpokenMesajın tamamen söylenmesi beklensin mi
messageToCustomerOnDelayedAktarma geciktiğinde söylenecek mesaj
delayInMsOnDelayedGecikme mesajının tetikleneceği süre (100-12.000 ms)
messageToCustomerOnFailedAktarma başarısız olduğunda söylenecek mesaj
endTheCallAfterMessageIsSpokenBaşarısız mesajından sonra arama sonlandırılsın mı

​
Özel Fonksiyon Aracı (Custom Function)

Özel fonksiyon aracı, AI Agent’ın görüşme sırasında HTTP webhook üzerinden özel iş mantığı çalıştırmasını sağlar. Platform, tanımlanan webhook URL’sine istek göndererek dış sistemlerle entegrasyon kurar.

​
Çalışma Prensibi

1

Agent Karar Verir

Agent, konuşma bağlamına göre özel fonksiyonu çağırmaya karar verir
2

Parametreler Hazırlanır

Agent, aşağıdaki sabit parametre yapısını doldurur:
ParametreTipZorunluAçıklama
actionstring✅ EvetÇalıştırılacak aksiyonun adı
input01stringHayırBirinci girdi
input02stringHayırİkinci girdi
input03stringHayırÜçüncü girdi
sensitiveInput01stringHayırBirinci hassas girdi
sensitiveInput02stringHayırİkinci hassas girdi
sensitiveInput03stringHayırÜçüncü hassas girdi
3

Webhook Çağrılır

Platform, yapılandırılmış webhook URL’sine HTTP isteği gönderir
4

Yanıt İşlenir

Webhook’tan gelen yanıt agent’a iletilir ve agent müşteriye bilgi verir
Hassas Girdiler: sensitiveInput01-03 alanları, kredi kartı numarası, TC kimlik numarası gibi hassas bilgiler için kullanılır. Bu alanlar loglamada maskelenir.

​
Özel Fonksiyon Mesaj Kontrolleri

Özel fonksiyon aracı için de handoff aracıyla aynı mesaj kontrolleri yapılandırılabilir:
AlanAçıklama
messageToCustomerFonksiyon çağrılırken müşteriye söylenecek mesaj
waitForMessageToBeSpokenMesajın tamamen söylenmesi beklensin mi
messageToCustomerOnDelayedİşlem geciktiğinde söylenecek mesaj
delayInMsOnDelayedGecikme mesajının tetikleneceği süre (100-12.000 ms)
messageToCustomerOnFailedİşlem başarısız olduğunda söylenecek mesaj
endTheCallAfterMessageIsSpokenBaşarısız mesajından sonra arama sonlandırılsın mı

​
Kullanım Senaryoları

Action: checkAvailability, createAppointment
  • Müşteri randevu tarihi sorar
  • Agent takvimden müsait saatleri kontrol eder
  • Randevu oluşturur ve onay verir
Action: checkOrderStatus, getTrackingInfo
  • Müşteri sipariş durumu sorar
  • Agent sipariş numarası ile webhook’a istek atar
  • Kargo takip bilgisini müşteriye iletir
Action: createPaymentLink, checkBalance
  • Sipariş tutarı hesaplanır
  • Ödeme linki oluşturulur
  • Müşteriye SMS ile gönderilir
Action: getCRMData, createTicket
  • Müşteri bilgisi CRM’den çekilir
  • Kişiselleştirilmiş hizmet verilir
  • Destek talebi oluşturulur

​
Dahili Araçlar

Platform ile birlikte gelen hazır araçlar:
Çağrıyı bir telefon numarasına veya SIP adresine yönlendirir.
  • Birden fazla hedef yapılandırılabilir
  • Her hedef için koşul tanımlanabilir
  • Mesaj kontrolleri ile müşteri bilgilendirilir

​
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
AI Agent oluşturma formu — araç bağlantıları ve fonksiyon ayarları

​
Kategori ve Alt Kategori

Hiyerarşi: 
Elektronik
  ├─ Telefonlar
  │   ├─ iPhone
  │   └─ Samsung
  └─ Bilgisayarlar
      ├─ Laptop
      └─ Masaüstü

​
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, sistem talimatlarına göre uygun aracı çağırmaya karar verir
3

Araç Çağrısı

{
  "action": "checkStock",
  "input01": "IP15P"
}
4

Webhook Yanıtı

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

Agent Cevabı

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

​
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

​
Handoff Aracı

  • ✅ Bağlam mühendisliği tipini kullanım senaryosuna göre seçin
  • ✅ Uzun görüşmelerde “Son N Mesaj” tercih edin
  • ✅ Değişken çıkarma ile kritik bilgileri aktarın
  • ✅ Aktarma mesajını her zaman yapılandırın
  • ❌ “Tüm Mesajlar” seçeneğini çok uzun görüşmelerde kullanmayın
  • ❌ “Bağlam Yok” seçeneğini müşteri bilgisi gerektiğinde kullanmayın

​
Özel Fonksiyon Aracı

  • ✅ action parametresini açıklayıcı isimlendirin (örn: checkStock, createOrder)
  • ✅ Hassas bilgiler için sensitiveInput alanlarını kullanın
  • ✅ Webhook yanıtınızda açıklayıcı hata mesajları döndürün
  • ✅ Gecikme mesajını yapılandırarak müşteriyi bilgilendirin
  • ❌ Webhook’ta uzun süren işlemler yapmayın (timeout riski)
  • ❌ Hassas verileri normal input alanlarında göndermeyin

​
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

​
Sistem Talimatı Uyumu

Agent’ın araçları doğru zamanda kullanması için sistem talimatlarında açık yönergeler verin: Kötü Örnek: 
Araç ekledim ama sistem talimatında belirtmedim.
Agent ne zaman kullanacağını bilmiyor.
İyi Örnek: 
Müşteri ürün stoku sorarsa checkStock aksiyonunu kullan.
Müşteri sipariş vermek isterse createOrder aksiyonunu kullan.
Müşteri teknik destek istiyorsa çağrıyı Teknik Destek Agent'ına aktar.

​
Sorun Giderme

Sebep: Agent ne zaman kullanacağını bilmiyorÇözüm:
  1. Sistem talimatını güncelleyin
  2. Araç kullanımını açık bir şekilde belirtin
  3. Test görüşmesi yapın
Sebep: Hedef agent yapılandırması hatalıÇözüm:
  1. Hedef agent’ın aktif olduğunu kontrol edin
  2. Agent ID ve platform referans ID’sinin doğru olduğunu doğrulayın
  3. Bağlam mühendisliği tipinin geçerli olduğunu kontrol edin
  4. “Son N Mesaj” tipinde mesaj sayısının en az 1 olduğunu doğrulayın
Sebep: Webhook endpoint çalışmıyor veya hatalıÇözüm:
  1. Webhook URL’sinin erişilebilir olduğunu kontrol edin
  2. HTTP yanıt kodunu kontrol edin (200 OK beklenir)
  3. Yanıt formatının JSON olduğunu doğrulayın
  4. Authentication bilgilerini 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.
Handoff: Çağrıyı başka bir AI Agent’a aktarır. Bağlam mühendisliği ve değişken çıkarma ile zenginleştirilmiş aktarma sağlar.Transfer Call: Çağrıyı bir telefon numarasına veya SIP adresine aktarır. İnsan temsilcilere yönlendirme için kullanılır.
Sabit olarak 7 parametre: 1 zorunlu action + 3 normal girdi (input01-03) + 3 hassas girdi (sensitiveInput01-03).
Evet, transkript detayında araç çağrıları ve yanıtları görünür.
Şu anda bir agent bir katalog kullanabilir.
Hedef agent hiçbir konuşma geçmişi almaz ve sıfırdan başlar. Müşteri bilgilerini tekrar sorması gerekebilir.
Evet, webhook endpoint’inizi kendiniz oluşturmanız gerekir. Platform, tanımlanan URL’ye HTTP isteği gönderir. Endpoint’iniz JSON yanıt döndürmelidir.

​
İlgili Makaleler

AI Agent Oluşturma

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

Gelişmiş Yapılandırma

Eskalasyon, performans ve davranış optimizasyonu

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

JSON formatında veri toplama

Bilgi Bankası Yönetimi

Agent bilgi kaynaklarını yönetme