Make Agent Fast hujjatlari

Astro

Embed agentni umumiy Astro layoutiga yoki tanlangan statik va island sahifalariga qo‘shish.

Qisqacha koʻrinish

Embed agentni umumiy Astro layoutiga yoki tanlangan statik va island sahifalariga qo‘shish.

Joylash yoʻliSaytingizdagi yuklagich joylashtirilgan agent muhiti bilan ishlaydi

Joylashtirish haqidaAstroXavfsizlik va CSP

Joylashtirish manzilini tayyorlash#

Make Agent Fast agenti uchun joylashtirishni yoqing va Astroʼning ishlab chiqish, oldindan ko‘rish hamda ishlab chiqarish muhitlaridagi aniq manzillarini ruxsat etilganlar ro‘yxatiga kiriting. Build serveri yoki repozitoriy URLʼi emas, brauzerdagi yakuniy protokol/host nomi/port muhim.

Umumiy layoutga qo‘shish#

Standart tashqi yuklagichni ishga tushiruvchiga egalik qilishi kerak bo‘lgan Astro layoutidagi </body> tegidan oldin joylang.

---
// src/layouts/BaseLayout.astro
---

<html lang="en">
  <body>
    <slot />

    <script
      is:inline
      src="https://makeagent.fast/embed.js?v=20260728-widget-v2"
      data-agent="YOUR_SITE_SLUG"
      data-position="right"
      data-label="Ask us"
      async
    ></script>
  </body>
</html>

is:inline Astroʼga tashqi skript tegi va uning data-* atributlarini paketlash yoki o‘zgartirishsiz saqlashni bildiradi. Yuklagich ochiq va freymvorkdan mustaqil; uni server moduliga import qilmang.

Faqat tanlangan sahifalarda ko‘rsatish#

Ichki layoutdan foydalaning yoki tegni faqat tanlangan .astro sahifalariga qo‘shing. Bir xil tegni asosiy layoutga ham, sahifaga ham joylamang. Yuklagich bir xil slug uchun takroriy rootni eʼtiborsiz qoldiradi, ammo takroriy HTML navigatsiya va tozalashni tushunishni qiyinlashtiradi.

Astroʼning mijoz tomondagi view transition imkoniyati yoqilgan bo‘lsa, sahifani to‘g‘ridan-to‘g‘ri yuklashni ham, ilova ichidagi navigatsiyani ham sinang. Butun sayt agenti uchun doimiy umumiy layout maʼqul. Yo‘nalishga xos ishlash kerak bo‘lsa, keyin yangi skript qo‘shishdan oldin yo‘nalishdan chiqishda skript va maf-embed-root-YOUR_SITE_SLUG elementlarini olib tashlang.

CSP va rozilikni sozlash#

Statik hosting sarlavhalari baribir brauzerni boshqaradi. script-src, frame-src va tegishli ulanish siyosatida https://makeagent.fast manziliga ruxsat bering. Rozilik boshqaruvchisi skriptni to‘ssa, CSPʼni zaiflashtirish yoki rozilikni chetlab o‘tish o‘rniga tegni kerakli rozilik olingandan keyin yuklang.

Yaratilgan natijani tekshirish#

Astro ishlab chiqarish buildini ishga tushiring va chiqarilgan HTML ichida data-agent tegi saqlanganini tekshiring.
Joylashtirilgan sahifani maxfiy oynada oching.
Bitta embed root va muvaffaqiyatli yuklagich/iframe so‘rovlari borligini tasdiqlang.
Astro yo‘nalishlari bo‘ylab o‘tib, agent kerakli tarzda saqlanishini tekshiring.
Haqiqiy xabar yuborib, mobil ekran va mikrofonni sinang.

Muammolarni hal qilish#

Muammo	Yechim
Yaratilgan HTML atributlarni tashlab yuboradi yoki o‘zgartiradi	Tashqi skriptga `is:inline` qo‘shing
Ikkita skript tegi chiqariladi	O‘rnatishni bitta layout yoki sahifada saqlang
Mijoz navigatsiyasi to‘g‘ridan-to‘g‘ri yuklashdan farq qiladi	View transitionlarni sinang va doimiy umumiy layoutni tanlang
Ishlab chiqishda ishlaydi, statik hostingda ishlamaydi	Aniq ishlab chiqarish manzilini va hosting CSP sarlavhalarini qo‘shing
Ovoz ishlamaydi	HTTPS, brauzer ruxsati va Permissions Policyʼni sozlang

Hozircha npm uchun Astro adapteri chiqarilmagan; shu yerda ko‘rsatilgan joylashtirilgan yuklagichdan foydalaning.