Embed haqida

Embed qanday ishlaydi#

embed.js host hujjatiga bitta mahkamlangan ishga tushiruvchi qo‘shadi. Tashrifchi birinchi marta bosganda https://makeagent.fastdan lazy-load iframe ochiladi; agent va suhbat shu iframe ichida host sahifadan ajratilgan holda qoladi. Host CSS chat uslubini o‘zgartira olmaydi, agent kontenti esa host hujjatini qayta yoza olmaydi.

Yuklagich ochiq va API kalitidan foydalanmaydi. Kirish Embedni yoqish tugmasi va aniq ota manzillar ro‘yxati bilan boshqariladi. Sayt slugʼi identifikator, sir emas.

Talablar#

Kodni nusxalashdan oldin:

1. Boshqaruv panelida agent yarating va sinang.
2. Agentning haqiqiy o‘rnatish kodidan foydalaning. Uning alohida ommaviy sahifasini chop etish shart emas.
3. Saytning Embed sahifasini ochib, Embedni yoqishni yoqing.
4. Ishga tushiruvchini render qiladigan har bir ota manzilni qo‘shing.
5. Saqlang, keyin yaratilgan kod parchani nusxalang.

Origin faqat protokol, host nomi va ixtiyoriy portdan iborat. Unda yo‘l bo‘lmaydi. Quyidagilar to‘rtta turli manzil va ishlatilsa alohida qo‘shilishi kerak:

https://example.com
https://www.example.com
https://staging.example.com
http://localhost:3000

https://example.com/pricing, *.example.com yoki oxirgi wildcardni kiritmang. Ishlab chiqarish bare domendan wwwga redirect qilsa, redirectdan keyin brauzer manzil satrida qoladigan originni qo‘shing.

Yuklagichni o‘rnatish#

Yopuvchi </body> tegidan oldin bitta skript joylang yoki freymvork qo‘llanmasi tavsiya qilgan faqat brauzerda ishlaydigan hayot siklidan foydalaning.

Boshqaruv paneli Joylash sahifasi shu shaklni nusxalaydi (sayt slugʼi, joylashuv, ixtiyoriy yorliq va ?v= kesh buster). asyncni saqlang. Host eskirgan yuklagichni mahkamlamasligi uchun ?v=ni saqlang.

<script
  src="https://makeagent.fast/embed.js?v=20260728-widget-v2"
  data-agent="YOUR_SITE_SLUG"
  data-position="right"
  async
></script>

Faqat data-agent majburiy. Yuklagich haqiqatda oʻqiydigan ixtiyoriy atributlar:

<script
  src="https://makeagent.fast/embed.js?v=20260728-widget-v2"
  data-agent="YOUR_SITE_SLUG"
  data-position="right"
  data-label="Savol bering"
  data-accent="#6d5ce7"
  data-locale="uz"
  data-theme="light"
  async
></script>

Hech bir data-* atributiga MAF API kaliti, provayder kaliti, konnektor tokeni, tashrifchi shaxsi yoki yopiq mijoz maʼlumotini kiritmang. data-api-key, data-z-index, data-offset, data-delay kabi atributlarni oʻylab topmang. data-maf-bootstrappedni yuklagich oʻzi qoʻyadi.

Atributlarni sozlash#

Faqat embed.js tegidan oʻqing. Iframe faqat hex aksentni qabul qiladi.

data-theme boʻlmasa, yuklagich host fonidan namuna oladi va keyin tashrifchining OS tanloviga qaytadi. U host shrift oilasini iframeʼga uzatadi va eng yangi launcher koʻrinishini oladi. Koʻrinish soʻrovi ishlamasa ham launcher bloklanmaydi. Boshqaruv panelida koʻrinishni saqlash saytni qayta eʼlon qilmasdan shu soʻrovni yangilaydi.

Ishlash vaqtidagi holat#

• Skriptni bir hujjatda bir marta yuklang. Bir xil slugni takrorlash idempotent va bitta maf-embed-root-YOUR_SITE_SLUG rootini yaratadi.
• Bitta hujjatda turli agentlar birga ishlashi mumkin. Loader qayta ishlangan har bir skriptni data-maf-bootstrapped bilan belgilaydi, shuning uchun asinxron fallback har bir alohida data-agent tegini aynan bir marta ishga tushiradi.
• Iframe lazy va tashrifchi ochmaguncha yashirin. Mikrofon, autoplay va clipboard-write ruxsatini faqat brauzerning iframe ruxsat modeli orqali so‘raydi.
• Mijoz tomonida yo‘naltiriladigan ilovada yuklagichni suhbat yo‘nalish almashganda yangilanmasligi uchun unga egalik qilishi kerak bo‘lgan eng yuqori layoutga ulang.
• Faqat skript elementini olib tashlash allaqachon yaratilgan ishga tushiruvchini yo‘q qilmaydi. Yo‘nalishga xos tozalashda mos maf-embed-root-... elementini ham olib tashlang. Qayta ulash uchun tozalashdan keyin skriptni yana yuklang.
• Iframe va yuklagich faqat namespaceʼli hayot sikli xabarlarini almashadi. Yuklagich Make Agent Fast manzili va joriy sayt slugidan kelmagan xabarlarni rad etadi.

O‘rnatishni tekshirish#

Faqat veb-sayt muharriri previewʼsini emas, ochiq sahifani sinang:

1. Deployment URLʼini maxfiy oynada ochib, uning aniq originiga ruxsat berilganini tekshiring.
2. Network panelida https://makeagent.fast/embed.js?v=20260728-widget-v2 200 qaytarishini tasdiqlang.
3. data-maf-embed="YOUR_SITE_SLUG"li bitta element borligini tekshiring.
4. Ishga tushiruvchini ochib, /embed/YOUR_SITE_SLUG iframe so‘rovi muvaffaqiyatli bo‘lishini tekshiring.
5. Haqiqiy savol yuborib, Suhbatlarda paydo bo‘lishini tasdiqlang.
6. Tor mobil viewport va yoqilgan bo‘lsa mikrofon ruxsatini sinang.

Yo‘q ishga tushiruvchini aniqlash#

O‘rnatish qo‘llanmasini tanlash#

Notion yoki Linktree kabi skriptga ruxsat bermaydigan platformalar uchun agentning yoqilgan Ommaviy sahifa havolasidan foydalaning. Uni onboarding oxiri yoki agent sozlamalaridan nusxalang. Vidjet o‘rnatilgan o‘z veb-saytingizga ham havola berishingiz mumkin.

Kodlash agentlari uchun#

Claude Code, Cursor yoki Codex orqali mijoz saytiga o‘rnatayotganda Make Agent Fast repositoriyasidagi skills/embed-agent/SKILL.md ni .cursor/skills/embed-agent/ yoki .claude/skills/embed-agent/ ga nusxalang. Atributlar, CSP va joylashtirish uchun o‘sha fayl kanonik. Bu sahifa odamlar uchun qo‘llanma.