Embed haqida

Embed qanday ishlaydi#

embed.js host hujjatiga bitta tugma qoʻshadi. Birinchi bosishdan oldin sahifa qoidalarini tekshirish uchun https://makeagent.fastdan yashirin iframe oldindan yuklanishi mumkin. Tashrifchi tugma yoki xabar orqali chatni ochadi. Host CSS chat uslubini oʻzgartirmaydi. Host sahifadagi oʻzgarishlar faqat roʻyxatdan oʻtgan va egasi ruxsat bergan sahifa funksiyalari orqali bajariladi.

Yuklagich ochiq va API kalitidan foydalanmaydi. Kirish agentning Saytimda ko‘rsatish kaliti va aniq ota manzillar ro‘yxati (Ruxsat etilgan sayt manzillari) 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 Agent havolasini yoqish shart emas.
3. Agentning Agent sahifasida Ishga tushirish → Sayt vidjetini oching. Vidjet hali yoqilmagan bo‘lsa, Joylashni yoqishni tanlang; keyin Saytimda ko‘rsatish yoqilganini tekshiring.
4. Ruxsat etilgan sayt manzillari ostida ishga tushiruvchini render qiladigan har bir ota manzilni qo‘shing.
5. Joylash sozlamalarini saqlashni tanlang, 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.

Sayt vidjeti oynasi (Agent sahifasi → Ishga tushirish) 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=20261022-open"
  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=20261022-open"
  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.

Yaratilgan ildizdagi data-maf-open chat ochiqligini ichki kuzatadi. Bu script tegi sozlamasi yoki vidjet ochish buyrugʻi emas. Hodisalar uchun Keyingi xabarlarga qarang.

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 panelidagi Koʻrinish oʻzgarishlari 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 sahifa qoidalari uchun oldindan yuklanishi mumkin; xabar yoki chat ochilguncha yashirin qoladi. Qoidani ishlatib boʻlgan sessiya kech yuklashni saqlaydi. Mikrofon, autoplay va clipboard-write brauzerning iframe ruxsat modeliga boʻysunadi.
• 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 namespaceʼli hayot sikli, shaxs, hodisa va sahifa amali 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, eʼlon qilingan sahifani sinang:

1. Deployment URLʼini maxfiy oynada ochib, uning aniq originiga ruxsat berilganini tekshiring.
2. Network panelida https://makeagent.fast/embed.js?v=20261022-open 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 Agent havolasidan foydalaning — agentning oʻz manzilidagi bitta ochiq chat sahifasi; u onboarding oxirida (Telefonda sinash) va Agent sahifasining Koʻrinish tabida yoqiladi. 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.