İşlemler

Arama sırasında güncel verileri getirin

Arayan beklerken ajanın sisteminize bir siparişi, stok durumunu veya bir hesabı sormasını sağlayın.

API Aracı RAG ile ajan, görüşmenin ortasında sisteminizden güncel verileri ister — bir siparişin durumu, bir ürünün stoğu, bir hesabın bilgileri — ve bunlarla yanıt verir. Ne zaman çağıracağına ajan, açıklamanıza göre karar verir.

Kurulum

1. Aracı ekleyin

   Ajanı açın → İşlemler → Araç Ekle → CRM ve hizmetler → API Aracı RAG.

2. Aracı tanımlayın ve uç noktanıza yönlendirin

   Alan	Ne girilmeli
   Ad	ör. Sipariş sorgulama
   Genel Koşul	Ne zaman kullanılacağı, ör. müşteri bir siparişin durumunu soruyor
   API Uç Noktası URL’si	ör. https://api.yourshop.com/orders/{order_id} — {placeholders}, ajanın topladığı değerlerle doldurulur
   HTTP Metodu	GET, POST, PUT, DELETE veya PATCH
   Yürütme Mesajı	Ajanın beklerken söylediği, ör. Bir saniye, siparişinizi kontrol ediyorum
   İstek Zaman Aşımı (ms)	Yanıtınızın ne kadar bekleneceği; varsayılan 5000
   Header'lar, Query Parametreleri	İsteğe bağlı sabit değerler, ör. API anahtarınız

3. Ajanın neleri toplaması gerektiğini belirtin

   Body Parametre Şeması (JSON), ajanın arayandan topladığı ve gönderdiği değerleri listeler — bkz. aşağıda. Zorunlu bir değer eksikse ajan önce onu sorar.

ipucu

Yürütme Mesajı'nı her zaman doldurun — istek sürerkenki sessizlik, kopan bir arama gibi duyulur.

Body Parametre Şeması

Bu, isteğin gövdesinin kendisi değil, toplanacak değerlerin bir JSON Schema tanımıdır. Değerlerin gittiği yer:

Durum	Değer nereye gider
URL {name} içeriyor	URL'ye
GET, DELETE	Geri kalanı ?key=value olarak
POST, PUT, PATCH	Geri kalanı JSON gövdesi olarak

Numaraya göre sipariş sorgulama:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Müşterinin sorduğu sipariş numarası, genellikle 6 ila 10 hane. Söylemezse sor."
    }
  },
  "required": ["order_id"]
}

Birkaç değer içeren bir rezervasyon:

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "Önceki bir aramadan gelen ürün ID'si." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Kaç adet. Varsayılan 1." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Müşterinin ürünü nasıl teslim almak istediği." },
    "customer_email": { "type": "string", "format": "email", "description": "Onay için e-posta. Söylemezse sor." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Statik bir uç nokta, ör. çalışma saatleri: { "type": "object", "properties": {} }.

Ses için iyi şemalar:

• Düz tutun: 3–5 değer.
• Her değer için örnekler içeren bir description yazın — ajanı en iyi bunlar yönlendirir.
• Sabit seçenekler için enum kullanın: ajan "mavi olan" ifadesini blue ile eşleştirir.
• Bir değeri yalnızca istek o değer olmadan çalışamıyorsa required olarak işaretleyin.
• URL'deki {placeholders} ile eşleşen snake_case adlar kullanın.

Kullanım örnekleri

• Sipariş durumu — "482913 numaralı siparişim nerede?"
• Müsaitlik — kendi sisteminizde stoğu veya boş bir masayı kontrol etmek.
• Hesap soruları — bakiye, sözleşme bitişi, açık talepler.

Sık karşılaşılan sorunlar

Sorun	Neyi kontrol etmeli
Ajan aracı hiç çağırmıyor	Genel Koşul'un isteği açıkça adlandırmasını sağlayın
Uç noktanıza boş değerler geliyor	Şemadaki adlar {placeholders} ile birebir aynı olmalı
Ajan kontrol edemediğini söylüyor	Uç noktanız zaman aşımından uzun sürdü veya bir hatayla yanıt verdi

İlgili

• Arama başlamadan arayanı tanıyın — selamlamadan önceki veriler
• MCP Sunucuları — tek bir sunucudan birçok araç