Sahifa amallari

Sayt amalini roʻyxatdan oʻtkazish#

Sahifa amallari saytning oʻz interfeysini ochadi yoki ruxsat etilgan sahifaga oʻtadi. Joriy embedni oʻrnating va script yuklangandan keyin roʻyxatdan oʻtkazing. Funksiya saytda qoladi; agentga faqat nom, tavsif va parametr taʼriflari uzatiladi.

MakeAgentFast.registerAction("show_details", {
  description: "Shu sahifadagi tafsilotlar boʻlimini koʻrsatish",
  params: { section: { type: "string", description: "delivery yoki returns ishlating" } },
  confirm: true
}, async ({ section }) => {
  const sections = {
    delivery: document.getElementById("delivery-details"),
    returns: document.getElementById("returns-details")
  };
  if (!Object.hasOwn(sections, section) || !sections[section]) {
    throw new Error("Nomaʼlum boʻlim");
  }
  sections[section].scrollIntoView({ block: "start" });
  return { shown: section };
});

// Sahifa komponenti olib tashlanganda bajaring:
// MakeAgentFast.unregisterAction("show_details");

Ikkala metod qabul qilinganini bildiruvchi boolean qaytaradi. Nom kichik harfdan boshlanib, 2–40 ta kichik harf, raqam yoki pastki chiziqdan iborat boʻladi. Toʻqqizta maxsus amal va tayyor open_page uchun joy bor. Har bir taʼrif beshtagacha majburiy satr parametrini qabul qiladi; qiymatlar 200 belgigacha. Tavsiflar ham 200 belgigacha. Funksiya 10 soniya ichida 2 KB gacha satr yoki JSONʼga aylantiriladigan qiymat qaytarishi kerak.

Panelda ruxsat berish#

Oʻrnatilgan saytni ochib, amal nomlari va tavsiflarini bildiring, soʻng Agent → Amallar → Sahifa amallarini oching. Funksiyani yoqing va kerakli amallarga ruxsat bering. Sayt bergan tavsiflar ishonchsiz metadata; topilgan amal oʻz-oʻzidan tasdiqlanmaydi. Sozlamalar avtomatik saqlanadi.

Agent faqat ayni paytda roʻyxatda boʻlgan va ruxsat berilgan amalni taklif qiladi. Bajarishdan oldin mijoz karta koʻradi. Egasi xavfsiz deb belgilamasa, tasdiq talab qilinadi; sayt kodidagi confirm: true doim tugma bosishni talab qiladi. Faqat confirm: false egasining siyosatini chetlab oʻtolmaydi. Xavfsiz rejimni zararsiz UI oʻzgarishlari uchun saqlang.

Tayyor open_page uchun funksiya yozish shart emas. Panelda ruxsat bering; u agent ruxsat bergan sayt originlariga tegishli nisbiy yoʻl yoki HTTP(S) URLʼni qabul qiladi. Nisbiy yoʻlda joriy sayt origini ham ruxsat etilgan boʻlishi kerak. Ixtiyoriy tashqi manzilga oʻtolmaydi.

track bilan hodisa yuborish#

MakeAgentFast.track("form_error", { formId: "contact" });
MakeAgentFast.track("checkout_help", { step: "delivery" });

Embed yuklangach va haqiqiy hodisa yuz berganda chaqiring. Keyingi xabarlarda shu nomli hodisani sozlang. Nomlar bir xil 2–40 belgili formatda; ixtiyoriy data 1 KB gacha JSON obyekt boʻlishi kerak. Maydon qiymatlari, maxfiy kalitlar yoki toʻlov maʼlumotini yubormang. Qoidalar hodisa/yoʻl/kechikish boʻyicha ishlaydi; metadata saqlanmaydi, modelga berilmaydi va konversiya dalili emas. true — yuklagich qabul qilganini bildiradi, xabar koʻrsatilganini emas.

Xavfsizlik va tekshiruv#

Amallar faqat jonli sayt vidjetida ishlaydi; xabar kanallari, egasining mashq chati va jonli ovozda ishlamaydi. Yuklagich va freym origin, manba, slug va kutilayotgan soʻrov IDʼsini tekshiradi. Natija chatga ishonchsiz brauzer maʼlumoti sifatida qaytadi; server yozuvi oʻzgarganini tasdiqlamaydi. Funksiya/backendda autentifikatsiya va ruxsat tekshiruvlarini saqlang. Muhim biznes yozuvlari uchun Oʻzgartirish amallaridan foydalaning.

Vaqt tugashi funksiyani bekor qilmaydi va hech narsa boʻlmaganini isbotlamaydi. Noaniq amalni avtomatik takrorlamang. Sahifa komponenti yopilganda funksiyani roʻyxatdan chiqaring. Eski keshlangan embedlar ushbu API uchun 20261014-page-actions versiyasiga yangilanishi kerak.

Toʻlovlar va Shopify konnektori bu APIʼga kirmaydi.