Foydalanuvchi qo'llanmasi

UI vidjetlar

Agent suhbat ichida chizadigan interaktiv kartochkalar: nima uchun kerak, vidjet chatga qanday tushadi, asosiy tushunchalar va ma’lumot ustuvorligi.

🧩 UI vidjetlar

UI vidjetlar — agentingiz suhbat ichida oddiy matn o‘rniga chizadigan interaktiv kartochkalar: formalar, buyurtmalar ro‘yxati, narx jadvallari, grafiklar, bron kartochkalari. Foydalanuvchi chatdan chiqmasdan tugma bosadi, forma to‘ldiradi va amalni yakunlaydi.

Vidjetlar loyihaning Konstruktor → Vidjetlar bo‘limida tuziladi va Konstruktor → Funksiyalar orqali agentga ulanadi.

🎯 Nima uchun kerak

Tuzilgan ma’lumot yig‘ish — lead forma, ariza, bron so‘rovi.
Ma’lumotni ko‘rsatish — buyurtma holati, mahsulot ro‘yxati, hisobot grafigi.
Amal bajarish — tugma orqali API chaqirish, xabar yuborish, havola ochish.
Shartli ko‘rinish — bir vidjet ichida “taklif” va “tasdiqlandi” holatlari.
Ulashish — vidjetni .widget fayl sifatida eksport qilib, boshqa loyihaga import qilish.

🔄 Vidjet chatga qanday tushadi

Vidjet o‘zi paydo bo‘lmaydi — uni doim agent funksiyasi chiziltiradi:

1. Vidjetlar sahifasida vidjet tuzasiz va saqlaysiz.
2. Funksiyalar sahifasida yangi funksiya yaratib, Amal maydonida Vidjet ko‘rsatish yoki API chaqirish + vidjet ni tanlaysiz va vidjetni biriktirasiz.
3. Mehmon savol beradi, agent shu funksiyani chaqiradi.
4. Agent vidjet sxemasi bo‘yicha ma’lumot to‘ldiradi (yoki API javobi olinadi).
5. Vidjet suhbat ichida chiziladi — sinov maydonida ham, saytdagi chat vidjetida ham.
6. Mehmon tugma bossa, vidjetning o‘z funksiyalari ishga tushadi.

🧱 Asosiy tushunchalar

Code — vidjet ko‘rinishi. JSX ko‘rinishida yoziladi, ichida JSON daraxt sifatida saqlanadi.
Schema — vidjet kutayotgan ma’lumot tuzilmasi. Agent aynan shu sxema bo‘yicha maydonlarni to‘ldiradi.
Default — namunaviy ma’lumot. Faqat muharrirdagi ko‘rinish uchun.
Misollar (Example N) — turli holatlarni sinash uchun qo‘shimcha namunalar.
Functions — foydalanuvchi harakatiga javob: API chaqirish, o‘zgaruvchi yozish, xabar yuborish, havola ochish, yopish.
States — daraxtning bir qismini shart asosida ko‘rsatish yoki yashirish.

📊 Ma’lumot ustuvorligi

Vidjet chizilayotganda ma’lumot quyidagi tartibda olinadi:

API javobi  >  funksiya (amal) ma’lumoti  >  Default misol  >  sxema bo‘yicha bo‘sh qiymatlar

Ya’ni Default hech qachon jonli ma’lumot ustidan yozmaydi — u faqat muharrirda ko‘rinadi.

📂 Import va eksport

Muharrirdagi Eksport qilish tugmasi vidjetni .widget fayl sifatida yuklab beradi: daraxt, sxema, misollar, funksiyalar va holatlar — hammasi bitta faylda. Vidjetlar sahifasidagi Import qilish uni qaytadan yuklaydi. Import qilingan vidjet yangi loyihada funksiyaga qayta biriktirilishi kerak.

🚧 Hozircha mavjud emas

Map (xarita) komponenti.
Iframe orqali ishlaydigan client function.
Matn asosida vidjet yaratadigan AI-builder.