Maxsus amallar

Maxsus amal HTTP endpointni botingiz ishlatadigan vositaga aylantiradi. Savolga jonli ma’lumot yoki amal kerak bo‘lganda — buyurtmani tekshirish, tiket yaratish — AI sizning amalingizni chaqiradi, kerakli ma’lumotlarni yig‘adi va natijani javobga qo‘shadi.

Amal yaratish#

Integratsiyalar → Customni oching va amal yarating. Konstruktor to‘rt qismdan o‘tkazadi:

  1. Identity (kimlik)

    Ichki nom va tavsif. Tavsif AI’ga amal nima uchun ekanini aytadi — aniq yozing.
  2. System connection (ulanish)

    Endpointning HTTP metodi, URL va sarlavhalari. Hammasini bir vaqtda to‘ldirish uchun cURL buyrug‘ini import qilishingiz mumkin.
  3. Parameters (parametrlar)

    Amalga kerakli kirish ma’lumotlari — quyida qarang.
  4. Response parsing (javobni tahlil)

    Bot javobda ishlatishi uchun JSON javobidan qaysi maydonlarni olishni tanlang.

cURL’dan import#

Agar ishlaydigan so‘rovingiz bo‘lsa, uning cURL buyrug‘ini joylashtiring — konstruktor metod, URL va sarlavhalarni siz uchun to‘ldiradi:

curl https://api.example.com/orders/123 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Parametrlar#

Parametrlar — amal ishlashi uchun kerakli qiymatlar. Har biri uchun belgilaysiz:

  • Maydon nomi va ma’lumot turi.
  • Bot savoli — bu qiymatni olish uchun bot mijozdan nimani so‘raydi.
  • Texnik tavsif — maydonni qanday ishlatish bo‘yicha AI uchun kontekst.
  • Majburiy — amal usiz bajarila oladimi.
  • Body path — qiymat so‘rovda qayerga qo‘yiladi.

Sinab ko‘ring, so‘ng ulang#

Amalni real qiymatlar bilan bajarib, kutilgan natijani qaytarishini tasdiqlash uchun sinov panelidan foydalaning; xulosa ko‘rinishi bot uni qanday bajarishini ko‘rsatadi.

Ishlagach, amalni botning Integratsiyalar va vositalar sozlamalaridan unga ulang. AI uni qachon chaqirishni tavsifingizga qarab o‘zi hal qiladi.

Nimani ochayotganingizga e’tibor bering

Amal tizimlaringizda o‘qishi va yozishi mumkin. Tokenlarni minimal kerakli ruxsatlar bilan cheklang va yozish chindan kerak bo‘lmasa, read-only endpointlarni afzal ko‘ring.