واجهة وقت تشغيل الأداة

بمجرّد تحميل الأداة، تثبّت كائن window.syncanix الذي يمكنك استدعاؤه من شيفرتك الخاصة.

ما الذي يمكنك فعله

• open() — فتح لوحة الدردشة برمجيًا.
• setPosition(position) — نقل المشغّل إلى زاوية أخرى.
• unmount() — إزالة الأداة من الصفحة.
• registerComponent() / unregisterComponent() / getComponentCatalog() — سجّل مكوّنات React الخاصة بك كي يعرضها المساعد، مُتحقَّقًا منها بمخطّط.
• setContext() / clearContext() — تغذية الحالة الحيّة للتطبيق (المستخدم، الصفحة، السلّة) في الدور التالي. JSON محدود فقط — لا أسرار أبدًا.
• setTokenProvider(fn) — توفير رمز المستخدم النهائي لكل دور (له أولوية على سمة data).
• setStepUpProvider(fn) — توفير تدفّق إعادة المصادقة المعزَّزة.

مثال

// Open the chat programmatically
window.syncanix.open();

// Feed live host-app context into the next turn (bounded JSON, no secrets)
window.syncanix.setContext({ page: 'checkout', cartItems: 3 });

// Provide the signed-in user's token per turn (recommended for SSR apps)
window.syncanix.setTokenProvider(async () => await getAccessToken());

ما الذي يمكن للمساعد عرضه — وما الذي لا يمكنه رؤيته

سطح العرض صريح بالتصميم: العناصر الأولية المدمجة، والمكوّنات التي تسجّلها عبر registerComponent، والتضمينات من الأصول التي أدرجها مسؤولك في قائمة السماح. لا يمكن للمساعد التحكم إلا فيما سلّمته له عمدًا.

لا تفحص الأداة DOM صفحتك ولا تكتشفه تلقائيًا ولا تلتقطه إلى النموذج أبدًا. قراءة محتوى الصفحة المضيفة في سياق ذكاء اصطناعي هي سطح لتسريب البيانات والحقن؛ لذا يبقى التقاط DOM الحي بوساطة العميل: أنت من يقرر ما هو قابل للتضمين عبر تسجيله.

يُحمَّل مرة واحدة

تثبيت الكائن العام عملية مُتكافئة — فإن أُدرِج السكربت مرتين، يُتجاهَل المكرّر مع تحذير، فلا تنتهي أبدًا بأداتين.

الخطوات التالية