Өз жүйелеріңіздің нақты деректерімен жауап беру
Құралдарды шақыру чатботқа әңгіме барысында API-іңізге қоңырау шалуға, жауапты оқуға және оны өз жауабында пайдалануға мүмкіндік береді. Клиент өз тапсырысы туралы сұрайды, ал бот жалпылама емес, нақты жауап береді.
Оқыту чатботқа өзгермейтін нәрселерді үйретеді. Құралдарды шақыру минут сайын өзгеретін нәрселерді: тапсырыс күйін, жөнелту нөмірін, броньды қамтиды. Бұл кеңейтілген мүмкіндік және серверіңізде арнайы кодты қажет етеді, сондықтан оны жүйелеріңізге кім қарайтын болса, сол адаммен жоспарлаңыз.
Қадам бойынша
Іздеу қайда тиесілі екенін анықтаңыз
Құралдарды шақыру Q&A және Flows арқылы қолданылады. Бір сұраққа нақты жауап қажет болса, оны Q&A-ға, ал іздеу ұзағырақ әңгіме жолының бір қадамы болса, оны flow-ға қойыңыз.
Оны endpoint-іңізге бағыттаңыз
URL өрісіне сұранысқа жауап беретін API endpoint мекенжайын енгізіңіз. Headers өрісіне endpoint-іңізге қажет кез келген key:value жұптарын қосыңыз. Q&A-да header-лар үтірмен бөлінеді; flows-та оларды бір-бірден қосасыз.
Клиент нені беруі керек екенін анықтаңыз
Properties — бұл чатбот сізге қоңырау шалмас бұрын жинауы тиіс мәндер, мысалы, қала немесе жөнелту нөмірі. Егер мүмкін мәндер алдын ала белгілі болса, оларды Allowed values тізіміне енгізіңіз, сонда бот сол жиынның ішінде қалады.
Серверіңіздегі сұранысты оқыңыз
Біз серверіңізге мына пішінді жібереміз: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — POST үшін JSON денесі ретінде, ал GET үшін header ретінде. Әрбір argument кілті — бұл property атауы kebab case-те, сондықтан "Order Number" order-number болып келеді. Сондай-ақ, мәнді біріктіру өрісі арқылы тікелей URL-ге қоюға болады, мысалы {order-number}.
Чатбот пайдалана алатын JSON қайтарыңыз
Серверіңіз боттың айтуы үшін қажетті мәндерді JSON форматында қайтаруы керек, мысалы {"order_status":"2 сағат 25 минут бұрын жеткізілді","success":true}. "success": true мәнін тек сұраныс шынымен сәтті орындалғанда ғана қосыңыз.
Параметрлер анықтамасы
| Параметр | Не істейді |
|---|---|
| URL | Чат-бот шақыратын API нүктеңіздің мекенжайы. |
| Headers | Сұраныспен бірге жіберілетін кілт:мән жұптары, сұрақ-жауапта үтірмен бөлініп, ағындарда бір-бірден қосылады. |
| Properties | Қоңырау шалу алдында пайдаланушы беруі тиіс мәндер, мысалы қала немесе жөнелту нөмірі. |
| Allowed values | Қасиетті еркін мәтіннің орнына белгілі опциялар жиынтығымен шектейді. |
Білу пайдалы
"success": true — бұл уәде емес, міндеттеме
Оны тек сұраныс шынымен жұмыс істегенде ғана қайтарыңыз. Егер тапсырыс нөмірі жарамсыз болса немесе ештеңе табылмаса, оны қоспаңыз, әйтпесе чат-бот сәтсіздікті жауап ретінде көрсетеді.
Аргумент атаулары пішінін өзгертеді
Қасиет атаулары kebab регистрінде келеді, сондықтан "Order Number" order-number болады. Кодыңызда және URL-ге қоятын кез келген біріктіру өрісінде осы емлені дәл сақтаңыз.
GET және POST деректерді әртүрлі қабылдайды
POST үшін жүктеме JSON денесі ретінде келеді. GET үшін ол header ретінде келеді. Сұранысты оқуды бастамас бұрын нүктеңіз қай әдісті пайдаланатынын тексеріңіз.
Әр қоңырау сайын контекст аласыз
Сұраныс user_id, conversation_id және user_language өрістерін қамтиды, сондықтан сіздің эндпойнтыңыз кім сұрап жатқанын және қай тілде екенін біледі.
Бұл үшін әзірлеуші қажет
Tools calling — бұл кеңейтілген мүмкіндік. Панель жағы қысқа, бірақ серверіңізде сұранысты қабылдап, JSON қайтаратын бір нәрсе болуы керек.
Жиі қойылатын сұрақтар
Tools calling қайда қолдануға болады?
Сіз менің серверіме нақты не жібересіз?
Клиенттің мәнін URL-ге қалай енгіземін?
Менің серверім не қайтаруы керек?
Егер клиент жоқ нөмірді берсе не болады?
Клиенттің енгізуіне шектеу қоя аламын ба?
Хаосты тоқтатуға дайынсыз ба?
Хабарламаларыңызды біріктіріп, қайталанатын сұрақтарды автоматтандырып, әңгімелерді табысқа айналдырыңыз — бүгіннен бастап.
Бастау