Öz sistemlərinizdən canlı məlumatlarla cavablandırın
Alətlərin çağırışı chatbotun söhbət zamanı API-nizi çağırmasına, qayıdan məlumatı oxumasına və cavabında istifadə etməsinə imkan verir. Müştəri sifarişi barədə soruşur və bot ümumi deyil, real cavab verir.
Təlim chatbota dəyişməyən şeyləri öyrədir. Alətlərin çağırışı isə dəqiqədən-dəqiqəyə dəyişənləri əhatə edir: sifariş statusu, izləmə nömrəsi, rezervasiya. Bu qabaqcıl xüsusiyyətdir və serverinizdə xüsusi kod tələb edir, ona görə də sistemlərinizə baxan şəxslə planlaşdırın.
Addım-addım
Axtarışın hara aid olduğuna qərar verin
Alətlərin çağırışı Q&A və Flows tərəfindən istifadə olunur. Tək sual canlı cavab tələb etdikdə onu Q&A-ya, axtarış daha uzun söhbət yolunun bir addımı olduqda isə flow-a qoyun.
Endpoint-inizi göstərin
URL-də sorğuya cavab verəcək API endpoint-in ünvanını daxil edin. Headers-də endpoint-inizin ehtiyac duyduğu açar:dəyər cütlərini əlavə edin. Q&A-da headers vergüllə ayrılır; flows-da onları bir-bir əlavə edirsiniz.
Müştərinin nə verməli olduğunu müəyyən edin
Properties chatbotun sizi çağırmazdan əvvəl toplamalı olduğu dəyərlərdir, məsələn şəhər və ya izləmə nömrəsi. Mümkün dəyərlər əvvəlcədən məlumdursa, botun həmin çərçivədə qalması üçün onları Allowed values altında sadalayın.
Serverinizdə sorğunu oxuyun
Serverinizə bu formanı göndəririk: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — POST üçün JSON body, GET üçün header olaraq. Hər bir arqument açarı property adının kebab case formasıdır, yəni "Order Number" order-number kimi gəlir. Siz həmçinin dəyəri birbaşa URL-ə birləşmə sahəsi ilə yerləşdirə bilərsiniz, məsələn {order-number}.
Chatbotun istifadə edə biləcəyi JSON-u qaytarın
Serveriniz, botun danışması üçün lazım olan dəyərləri JSON formatında qaytarmalıdır, məsələn {"order_status":"2 saat 25 dəqiqə əvvəl çatdırıldı","success":true}. "success": true yalnız sorğu həqiqətən uğurlu olduqda əlavə edin.
Tənzimləmələr arayışı
| Parametr | Nə edir |
|---|---|
| URL | Chatbotun çağırdığı API endpointinizin ünvanı. |
| Headers | Sorğu ilə göndərilən açar:dəyər cütləri, sual-cavabda vergüllə ayrılır, flows-da isə bir-bir əlavə olunur. |
| Properties | Zəng edilməzdən əvvəl istifadəçinin təqdim etməli olduğu dəyərlər, məsələn şəhər və ya izləmə nömrəsi. |
| Allowed values | Bir xassəni sərbəst mətn əvəzinə məlum seçimlər dəsti ilə məhdudlaşdırır. |
Bilmək faydalıdır
"success": true bir vəddir, rəsmiyyət deyil
Yalnız sorğu həqiqətən işlədikdə qaytarın. Sifariş nömrəsi yalnışdırsa və ya heç nə tapılmadısa, onu buraxın ki, chatbot uğursuzluğu cavab kimi təqdim etməsin.
Arqument adları forma dəyişir
Xassə adları kebab case-də gəlir, yəni "Order Number" order-number olur. Kodunuzda və URL-də istifadə etdiyiniz birləşmə sahələrində bu yazılışa uyğunlaşın.
GET və POST məlumatları fərqli qəbul edir
POST üçün yük JSON body olaraq gəlir. GET üçün isə header olaraq gəlir. Sorğunu oxumağa başlamazdan əvvəl endpointinizin hansı metoddan istifadə etdiyini yoxlayın.
Hər zənglə kontekst alırsınız
Sorğuya user_id, conversation_id və user_language daxildir ki, endpointiniz kimin hansı dildə soruşduğunu bilsin.
Bu, tərtibatçı tələb edir.
Tools calling qabaqcıl bir xüsusiyyətdir. Panel tərəfi qısadır, lakin serverinizdə sorğunu qəbul edib JSON qaytaran bir şey olmalıdır.
Ümumi suallar
Tools calling harada istifadə edə bilərəm?
Serverimə tam olaraq nə göndərirsiniz?
Müştərinin dəyərini URL-ə necə daxil edə bilərəm?
Serverim nə qaytarmalıdır?
Müştəri mövcud olmayan bir nömrə verərsə nə baş verir?
Müştərinin daxil edə biləcəyi məlumatı məhdudlaşdıra bilərəmmi?
Qarışıqlığa son qoymağa hazırsınız?
Mesajlarınızı birləşdirin, təkrarlanan sualları avtomatlaşdırın və söhbətləri gəlirə çevirin — bu gündən başlayaraq.
Başlayın