Әрекеттер

Қоңырау кезінде өзекті деректерді алу

Қоңырау шалушы күтіп тұрғанда агент жүйеңізден тапсырысты, қойма қалдығын немесе аккаунтты сұрай алсын.

API RAG құралы арқылы агент сөйлесудің ортасында жүйеңізден өзекті деректерді сұрайды — тапсырыстың күйін, тауардың қалдығын, аккаунт деректерін — және соларға сүйеніп жауап береді. Құралды қашан шақыру керегін агент сіздің сипаттамаңыз бойынша шешеді.

Баптау

1. Құралды қосыңыз

   Агентті ашыңыз → Әрекеттер → Құрал қосу → CRM және сервистер → API RAG құралы.

2. Оны сипаттап, эндпоинтіңізге бағыттаңыз

   Өріс	Не енгізу керек
   Аты	мысалы, Тапсырысты іздеу
   Жалпы шарт	Қашан пайдалану керек, мысалы, клиент тапсырыстың күйін сұрайды
   API соңғы нүктесінің URL-і	мысалы, https://api.yourshop.com/orders/{order_id} — {placeholders} агент жинаған мәндермен толтырылады
   HTTP әдісі	GET, POST, PUT, DELETE немесе PATCH
   Орындау хабарламасы	Агент күтіп тұрғанда не айтады, мысалы, Бір сәт, тапсырысыңызды тексеріп жатырмын
   Сұрау уақыты (мс)	Жауабыңызды қанша күту керек; әдепкі 5000
   Тақырыптар, Query параметрлері	Міндетті емес тұрақты мәндер, мысалы API кілтіңіз

3. Агент нені жинауы керек екенін көрсетіңіз

   Параметрлер схемасы (JSON) агент қоңырау шалушыдан алып, жіберетін мәндерді тізімдейді — төменде қараңыз. Міндетті мән жетіспесе, агент алдымен соны сұрайды.

кеңес

Орындау хабарламасын әрдайым толтырыңыз — сұрау орындалып жатқандағы үнсіздік үзілген қоңырау сияқты естіледі.

Параметрлер схемасы

Бұл сұраудың денесі емес, жиналатын мәндердің JSON Schema сипаттамасы. Мәндер қайда түседі:

Жағдай	Мән қайда барады
URL ішінде {name} бар	URL-ге
GET, DELETE	Қалғаны ?key=value түрінде
POST, PUT, PATCH	Қалғаны JSON денесі ретінде

Нөмір бойынша тапсырысты іздеу:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Клиент сұрап отырған тапсырыс нөмірі, әдетте 6–10 цифр. Айтпаса, сұра."
    }
  },
  "required": ["order_id"]
}

Бірнеше мәні бар брондау:

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "Алдыңғы іздеудегі тауар ID-і." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Қанша дана. Әдепкі 1." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Клиент тауарды қалай алғысы келеді." },
    "customer_email": { "type": "string", "format": "email", "description": "Растауға арналған email. Айтпаса, сұра." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Статикалық эндпоинт, мысалы жұмыс уақыты: { "type": "object", "properties": {} }.

Дауысқа арналған жақсы схемалар:

• Жалпақ ұстаңыз: 3–5 мән.
• Әр мәнге мысалдары бар description жазыңыз — агентті ең жақсы солар бағыттайды.
• Тұрақты таңдаулар үшін enum пайдаланыңыз: агент «көгін» дегенді blue мәніне айналдырады.
• Мәнді тек сұрау онсыз жұмыс істей алмайтын болса ғана required деп белгілеңіз.
• URL-дегі {placeholders} атауларына сәйкес келетін snake_case атауларын пайдаланыңыз.

Қолдану мысалдары

• Тапсырыс күйі — «482913 тапсырысым қайда?»
• Қолжетімділік — өз жүйеңізден қойма қалдығын немесе бос үстелді тексеру.
• Аккаунт туралы сұрақтар — баланс, келісімшарттың аяқталуы, ашық тикеттер.

Жиі кездесетін мәселелер

Мәселе	Нені тексеру керек
Агент оны ешқашан шақырмайды	Жалпы шарт сұранысты нақты атасын
Эндпоинтіңізге бос мәндер келеді	Схемадағы атаулар {placeholders} атауларымен дәл сәйкес келуі керек
Агент тексере алмағанын айтады	Эндпоинтіңіз тайм-ауттан ұзақ жауап берді немесе қатемен жауап қайтарды

Қатысты беттер

• Қоңырау басталмай тұрып қоңырау шалушыны білу — сәлемдесуге дейінгі деректер
• MCP серверлері — бір серверден көп құрал