Kendi sistemlerinizden canlı verilerle yanıt verin
Araç çağırma, sohbet robotunun konuşma sırasında API'nizi çağırmasına, gelen yanıtı okumasına ve bu yanıtı kullanarak cevap vermesine olanak tanır. Müşteri siparişini sorduğunda, robot genel bir yanıt yerine gerçek bilgiyi verir.
Eğitim, sohbet robotuna sabit kalan şeyleri öğretir. Araç çağırma ise dakikalar içinde değişenleri kapsar: sipariş durumu, takip numarası, rezervasyon. Bu gelişmiş bir özelliktir ve sunucunuzda özel kod gerektirir, bu nedenle sistemlerinizle ilgilenen kişiyle planlayın.
Adım adım
Aramanın nereye ait olduğuna karar verin
Araç çağırma, Soru-Cevap ve Akışlar tarafından kullanılır. Tek bir sorunun canlı yanıt gerektirdiği durumlarda Soru-Cevap'a, aramanın daha uzun bir konuşma yolunun bir adımı olduğu durumlarda ise akışa ekleyin.
Uç noktanızı belirtin
URL alanına, isteğe yanıt verecek API uç noktasının adresini girin. Headers alanına, uç noktanızın ihtiyaç duyduğu anahtar:değer çiftlerini ekleyin. Soru-Cevap'ta başlıklar virgülle ayrılır; akışlarda ise tek tek eklenir.
Müşterinin size ne vermesi gerektiğini tanımlayın
Özellikler, sohbet robotunun sizi aramadan önce toplaması gereken değerlerdir; örneğin bir şehir veya takip numarası. Olası değerler önceden biliniyorsa, robotun bu küme içinde kalması için İzin verilen değerler altında listeleyin.
Sunucunuzda isteği okuyun
Sunucunuza şu yapıyı gönderiyoruz: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — POST için JSON gövdesi olarak, GET için ise başlık olarak. Her argüman anahtarı, özellik adının kebab case halidir; yani "Sipariş Numarası" order-number olarak gelir. Ayrıca bir değeri doğrudan URL'ye birleştirme alanıyla yerleştirebilirsiniz, örneğin {order-number}.
Sohbet robotunun kullanabileceği JSON döndürün
Sunucunuz, botun konuşmasını istediğiniz değerleri içeren bir JSON ile yanıt vermelidir. Örneğin: {"order_status":"2 saat 25 dakika önce teslim edildi","success":true}. "success": true yalnızca istek gerçekten başarılı olduğunda ekleyin.
Ayarlar referansı
| Ayar | Ne işe yarar |
|---|---|
| URL | Sohbet botunun çağırdığı API uç noktanızın adresi. |
| Headers | İstekle birlikte gönderilen anahtar:değer çiftleri. Soru-Cevap'ta virgülle ayrılır, akışlarda ise tek tek eklenir. |
| Properties | Çağrı yapılmadan önce kullanıcının sağlaması gereken değerler (örneğin bir şehir veya takip numarası). |
| Allowed values | Bir özelliği serbest metin yerine bilinen bir seçenek kümesiyle sınırlar. |
Bilmenizde fayda var
"success": true bir formalite değil, bir taahhüttür
Yalnızca istek gerçekten çalıştığında döndürün. Sipariş numarası geçersizse veya hiçbir şey bulunamadıysa, botun bir başarısızlığı yanıt olarak sunmaması için bu alanı dışarıda bırakın.
Argüman adları şekil değiştirir
Özellik adları kebab-case olarak gelir, yani "Order Number" order-number olur. Kodunuzda ve URL'ye koyduğunuz herhangi bir birleştirme alanında bu yazımı eşleştirin.
GET ve POST verileri farklı şekilde alır
POST için yük JSON gövdesi olarak gelir. GET için ise başlık olarak gelir. İsteği okumaya başlamadan önce uç noktanızın hangi yöntemi kullandığını kontrol edin.
Her çağrıda bağlam alırsınız
İstek, user_id, conversation_id ve user_language bilgilerini içerir; böylece uç noktanız kimin hangi dilde sorduğunu bilir.
Bu, bir geliştirici gerektirir.
Tools calling gelişmiş bir özelliktir. Panel tarafı kısadır ancak sunucunuzda isteği alıp JSON döndürecek bir şey olmalıdır.
Sık sorulan sorular
Tools calling'i nerede kullanabilirim?
Sunucuma tam olarak ne gönderiyorsunuz?
Müşterinin değerini URL'ime nasıl eklerim?
Sunucum ne döndürmeli?
Müşteri var olmayan bir numara verirse ne olur?
Müşterinin girebileceği değerleri sınırlayabilir miyim?
Kaosa son vermeye hazır mısınız?
Mesajlarınızı birleştirin, tekrarlayan soruları otomatikleştirin ve sohbetleri gelire dönüştürün — hemen bugün.
Hemen başlayın