5 daqiqada birinchi ijro

Bu sahifa oxirigacha bajarilsa sizda ishlaydigan ijro va uning natijasini to’g’ri o’qiydigan kod bo’ladi.

Kerak bo’ladi

Python	3.10+
Kalit	DAVIRIX_KEY — konsoldan olinadi
Tenant	tenant_id — sizning tashkilotingiz identifikatori

Qadamlar

1. O’rnating

   pip install davirix

   Paket sof-Python (py3-none-any) — Linux, macOS va Windows’da bir xil ishlaydi.

2. Kalitni muhitga qo’ying

   export DAVIRIX_KEY="dx_..."

   aside.caution

   Kalitni kodga yozmang va repoga qo’ymang. SDK uni muhitdan o’qiydi.

3. Ulanishni tekshiring

   import os
   from davirix import Davirix
   
   dx = Davirix(api_key=os.environ["DAVIRIX_KEY"], tenant_id="bank-uz")
   print(dx)   # <Davirix base_url='https://api.davirix.com' tenant_id='bank-uz'>

4. Birinchi ijroni yuboring

   Python

   n = dx.run(
       agent_id="card-support",
       input={"text": "Kartani bloklang, oxirgi 4 raqam 7731"},
       idempotency_key="buyurtma-2026-08-12-0001",
   )

   curl

   curl -X POST https://api.davirix.com/v1/executions \
     -H "Authorization: Bearer $DAVIRIX_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "tenant_id": "bank-uz",
       "actor":     {"type": "user", "id": "u-42"},
       "input":     {"text": "Kartani bloklang, oxirgi 4 raqam 7731"},
       "agent_id":  "card-support",
       "idempotency_key": "buyurtma-2026-08-12-0001"
     }'

   idempotency_key — sizning himoyangiz

   Har mantiqiy amal uchun barqaror kalit yuboring. Tarmoq uzilib qayta chaqirganingizda dublikat himoyasi aynan shu bilan ishlaydi. Batafsil: idempotentlik.

5. Natijani to’g’ri o’qing

   n.status        # "completed" — model javob berdi
   n.verified      # ⚡ AMAL manbadan tasdiqlandimi
   n.unknown       # natija noma'lummi
   
   for op in n.operations:
       print(op.capability_id, op.status)

   ⛔ n.status == "completed" ni «bajarildi» deb o’qish — eng ko’p uchraydigan xato. Sabab va to’g’ri naqsh: eng muhim qoida.

6. Xatolarni ajrating

   from davirix import APIError
   
   try:
       n = dx.run(...)
   except APIError as e:
       if e.retryable:
           ...      # qayta urinish XAVFSIZ
       else:
           ...      # qayta urinish muammoni tuzatmaydi

Bugungi cheklov

Amal VERIFIED bo’lishi uchun konnektorda read-back amali bo’lishi shart. Bugun bu faqat bitrix24 da bor.

Zanjirdagi uchta nosozlik tuzatildi, lekin u haqiqiy portalga qarshi hali yurgizilmagan — ya’ni «ishlashi kerak», «isbotlangan» emas.

Shuning uchun hozir boshqa konnektorlardagi amallar ACKNOWLEDGED yoki UNKNOWN da qoladi. To’liq ro’yxat: cheklovlar.

Keyingi qadam

• Python SDK — to’liq API
• Holatlar — ijro qanday rivojlanadi
• Xatolar — xato konverti va retryable