المسرد

المفردات الشاملة المستخدَمة في كامل هذا التوثيق. وتعرّف الأقسام اللاحقة مصطلحاتها الخاصة حيث ترد.

القدرة

شيء واحد تستطيع واجهة برمجة التطبيقات لديك القيام به — نقطة نهاية أو إجراء، مثل «ردّ مبلغ طلب» — موصوف كي يعرف المساعد ما يفعله ومتى يستخدمه.

كتالوج القدرات

القائمة المنظَّمة بكل قدراتك. تُكتشَف من واجهة برمجة التطبيقات لديك وهي المصدر الوحيد للحقيقة الذي تقرأ منه الأداة والدردشة وخادم MCP.

الاكتشاف

عملية فحص شيفرتك لبناء كتالوج القدرات، تنفّذها أداة سطر أوامر Syncanix.

الأثر الجانبي

ما يفعله الإجراء ببياناتك: قراءة (يبحث عن شيء)، أو كتابة (يغيّر شيئًا)، أو مدمّر (يحذف أو يغيّر على نحو لا رجعة فيه). يحدّد الأثر الجانبي كيفية تأكيد الإجراء.

الأداة (Widget)

مكوّن الدردشة القابل للتضمين الذي تضيفه إلى تطبيقك بوسم سكربت واحد.

واجهة الدردشة

تجربة المساعد التي يتفاعل معها مستخدموك — الإجابة عن الأسئلة وتنفيذ الإجراءات عبر واجهة برمجة التطبيقات لديك.

الاستناد (الاسترجاع)

الإجابة من وثائقك ومحتواك بدل المعرفة العامة للنموذج. يسترجع المساعد المادة ذات الصلة ويستشهد بها، فتعكس الإجابات منتجك.

المواقع المعتمدة

الصفحات والنطاقات التي يجوز للوكيل قراءتها أثناء الإجابة — صادرة، وللقراءة فقط. بدون أي مُدخل لا يقرأ شيئًا خارج فهرسك وموصّلاتك ووثائقك المفهرسة. وهي ليست نفسها مصادر تضمين الودجة، التي تحكم الاتجاه المعاكس: أي مواقعك يجوز لها تضمين الودجة. كل مُدخل يعتمده مسؤول، ومقيَّد بطلبات GET، ويُعاد فحصه مقابل قواعدك مع كل طلب ومع كل إعادة توجيه، ولا يمكنه مطلقًا أن يشير إلى عنوان خاص أو داخلي.

رسم خريطة الموقع

أن يتعلّم Syncanix منتجك بقراءته. تُفتح صفحاتك في متصفحك أنت، وأنت مسجَّل الدخول، ويسجّل Syncanix ما تحتويه كل صفحة — الأقسام والنماذج والأزرار والمسارات بينها — كي يستطيع الوكيل الإجابة عن منتجك وإرشاد الناس خلاله. وهذا ليس ملف sitemap، أي قائمة العناوين التي ينشرها موقعك لمحركات البحث: فرسم الخريطة يتعلق بما هو داخل الصفحة، لا بأيّ الصفحات موجودة. وليس «خريطة التفاعل» أيضًا، التي تُظهر ما فعله المستخدمون النهائيون بعد تشغيل الوكيل.

دليل الموقع

وصف مُولّد ومنظّم لموقعك — صفحاته وعناصر تحكمه ومساراته — يُجمَّع من الاكتشاف لمساحات العمل التي لا تملك توثيقًا خاصًا بها. يستند الوكيل إليه في أسئلة الموقع ويستشهد به كأي مصدر آخر، بلغة الزائر.

أدلة المهام

مسار مُسمّى ومنشور يمكن للوكيل أن يرافق الزائر خلاله على صفحاتك — الخطوات نفسها، يُشار إليها عنصر تحكم تلو الآخر، لا مقالًا يصفها. يقترح Syncanix الأدلة مما رصده الاكتشاف ومن المسارات التي تعرضها؛ ولا يُقدَّم أي منها لأحد قبل أن تنشره.

التفاعل

المكان الوحيد الذي تُضبط فيه طريقة مبادرة مساعدك: ما الذي يعرضه على الزائر قبل أن يكتب (الاقتراحات)، ومتى يتحدث أولاً (التنبيهات)، وأين يظهر أصلاً (قواعد الصفحات). ليست صفحة مقاييس — فكل واجهات التحليلات في المنتج تقيس التفاعل، وهنا يُحدَّد السلوك نفسه. تحل محل ثلاث صفحات منفصلة كانت كل واحدة منها تصف جزءاً من تجربة الزائر ذاتها.

MCP (Model Context Protocol)

معيار مفتوح يتيح لعملاء الذكاء الاصطناعي مثل Claude Desktop وCursor وChatGPT الاتصال بالأدوات والبيانات الخارجية.

خادم MCP

نقطة النهاية لكل مساحة عمل التي يمنحك إياها Syncanix كي تصل عملاء MCP إلى قدراتك.

المطوِّر / المسؤول

فريقك — الأشخاص الذين يضمّنون الأداة ويضبطون لوحة التحكم ويديرون مساحة العمل.

المستخدم النهائي

مستخدم عميلك المسجَّل الدخول، الذي يتحدّث إلى الأداة أو يربط عميل MCP. وتُستخدَم هويته الخاصة — لا هوية مشتركة — في كل إجراء.

تعلّم المستخدم

قدرة اختيارية تتيح للمساعد تعلّم التفضيلات والسياق الدائمين لكل مستخدم نهائي مسجَّل دخوله من محادثاته، مع إدراج ملخّص مضغوط ومحدود بميزانية في الأدوار المقبلة لتخصيص الردود والإجراءات المتاحة.

أثر الوكيل

واجهة التحليلات التي تقيس القيمة التجارية التي يقدّمها الوكيل — كم عدد طلبات المستخدمين النهائيين التي حلّها دون مساعدة بشرية (التحويل)، ونتائج تلك المحادثات، وعائد استثمار تقديري — مُجمَّعة ليليًا لكل مساحة عمل مع إفصاح صادق عن أخذ العيّنات.

تفاعل

دور واحد محتسَب — سؤال وإجابة المساعد عليه، بما في ذلك ما تُجريه تلك الإجابة من استدعاءات للأدوات وMCP ونقاط النهاية — أو استدعاء أداة مستقلّ واحد. لكل منها سعر معلن: 3 أرصدة استخدام للإجابة، و6 إذا نفّذ إجراءً كذلك، و9 إذا بحث عن معلومة كذلك، و12 إذا فعل الأمرين. المحادثة تتكوّن من عدّة تفاعلات لا من واحد. ولا علاقة لذلك بخريطة التفاعلات التي تعرض رحلات المستخدمين بدل تسعيرها.

خريطة التفاعل

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

مزوّد الهوية (IdP)

الخدمة التي تصادق مستخدميك — مثل Auth0 أو Clerk أو Cognito أو WorkOS. يستخدمها Syncanix بدلًا من تخزين بيانات الاعتماد بنفسه.

الاتحاد (Federation)

تفويض تسجيل الدخول إلى مزوّد الهوية لديك، بحيث تنطبق داخل Syncanix الهوية والصلاحيات نفسها التي يملكها مستخدموك بالفعل.

رمز الويب JSON‏ (JWT)

رمز مضغوط وموقَّع يثبت هوية المستخدم المسجَّل دخوله. يصدره مزوّد الهوية الخاص بك؛ ويتحقّق Syncanix من توقيعه ليثق بالهوية.

مجموعة مفاتيح الويب (JWKS)

مجموعة المفاتيح العامة التي ينشرها مزوّد الهوية الخاص بك كي تتمكّن الخدمات من التحقّق من التواقيع على رموزه، دون مشاركة أي سرّ إطلاقًا.

بروتوكول OpenID Connect‏ (OIDC)

بروتوكول تسجيل الدخول القياسي الذي يتحدّث به معظم مزوّدي الهوية. إن كان مزوّدك يدعمه، فيمكن لـ Syncanix التحقّق من مستخدميك عبره.

مفتاح إثبات تبادل الرمز (PKCE)

خطوة أمنية في تدفّق تسجيل الدخول عبر OAuth تمنع استخدام رمز تفويض معترَض من قِبل أي شخص آخر. يسجّل عملاء MCP دخولهم بهذه الطريقة.

النطاق

صلاحية مسمّاة مرتبطة برمز — أي ما يُسمَح لحامله بفعله. إجراءات المساعد محدودة بنطاقات المستخدم، لا أكثر.

تبادل الرموز

طريقة قياسية (RFC 8693) لاستبدال رمز برمز أضيق مرتبط بمهمّة محدّدة — تُستخدَم في إعدادات المؤسسات كي يحصل كل إجراء تابع على رمزه الخاص المُصدَر صراحةً والمحدود النطاق.

الخادم الخلفي للواجهة (BFF)

خادم صغير تشغّله يقع بين الودجت وSyncanix، كي لا تصل رموز المصادقة إلى المتصفّح إطلاقًا. وهي أكثر طرق مصادقة مستخدميك إحكامًا.

المصادقة المعزَّزة (Step-up)

مطالبة المستخدم بإعادة تأكيد هويته — مثلًا بالمصادقة متعدّدة العوامل — قبل تنفيذ إجراء حسّاس.

التصرّف نيابةً

تنفيذ المساعد إجراءً بصفة المستخدم النهائي، بهويته وصلاحياته — لا بوصول مرتفع أو مشترك أبدًا.

مستويات التأكيد

كيف يضبط Syncanix الإجراءات حسب الخطورة: إجراءات القراءة يمكن أن تُنفَّذ تلقائيًا، وإجراءات الكتابة تطلب تأكيدًا، والإجراءات المدمِّرة محظورة ما لم تسمح بها.

الأمان على مستوى الصفوف

ميزة في قاعدة البيانات تُرشِّح كل استعلام تلقائيًا إلى صفوف مساحة عمل واحدة — وهي خط دفاع Syncanix الأخير الذي يُبقي بيانات العملاء منفصلة حتى لو أغفل استعلام حصر نفسه.

النية الموقَّعة

رمز مقاوم للعبث ووحيد الاستخدام يربط إجراءً موافَقًا عليه بمستخدم وقدرة ومدخلات محدّدة، بحيث لا يمكن تعديل إجراء مؤكَّد ولا إعادة تشغيله.

بوابة التقييم

فحص جودة تلقائي يجري قبل الترقية إلى الإنتاج ويحجب التغيير إن تراجعت إجابات المساعد — فلا يتغيّر الإنتاج إلا نحو الأفضل.

كشف الانحراف

ملاحظة تغيّر الـ API الخاص بك أو سلوكه بحيث لم يعد الكتالوج مطابقًا للواقع، والإشارة إلى ذلك كي لا يتصرّف المساعد أبدًا بناءً على صورة قديمة.

عدم الاحتفاظ بالبيانات (ZDR)

ترتيب يعالج فيه مزوّد الذكاء الاصطناعي طلبًا دون تخزينه أو التدريب عليه. وتشترط أداة سطر الأوامر موافقتك الصريحة قبل أي إثراء بالذكاء الاصطناعي.

BYOK (أحضِر مفتاحك الخاص)

استخدام مفاتيح مزوّد الذكاء الاصطناعي الخاصة بك، فيفوتر مزوّدك استخدام النموذج لك مباشرةً بدلًا من احتسابه على خطتك.

BYOMCP (أحضر خادم MCP الخاص بك)

ربط خوادم MCP التي تشغّلها بالفعل كمصادر أدوات إضافية. تظهر أدواتها إلى جانب الكتالوج المكتشف لديك، وتُحوَّل الاستدعاءات إلى خادمك مع احترام عزل المستأجرين والمصادقة المعزّزة (step-up).

Witness (الشاهد)

ملاحظة وقت التشغيل لشكل استدعاء واجهة البرمجة — أسماء الحقول والأنواع المستنتجة، وليس القيم أبدًا — تنتجها أداة api-witness الوسيطة الاختيارية. تُبقي الشواهد الكتالوج متوافقًا مع ما تقدّمه واجهتك فعليًا.

UC (أرصدة الاستخدام)

الوحدة التي يُسعّر بها Syncanix التفاعلات. يكلّف كل تفاعل 6 أو 15 أو 18 أو 30 وحدة بحسب ما فعله: الإجابة، أو تنفيذ إجراء، أو البحث عن معلومة، أو الأمرين معًا. تُقاس الباقات بأرصدة الاستخدام المضمّنة، فالتكلفة يحدّدها الاستخدام لا عدد الموظفين.

البيئة

نسخة معزولة من إعداداتك. لكل مساحة عمل بيئة تطوير للإعداد وبيئة إنتاج يصل إليها مستخدموك.

الترقية

نقل إعداداتك من التطوير إلى الإنتاج، بحيث لا يتغيّر السلوك المباشر إلا عندما تقصد ذلك.

المفتاح القابل للنشر والمفتاح السري

يمكن تضمين المفتاح القابل للنشر (pk_…) بأمان في صفحة الويب لديك من أجل الأداة؛ أما المفتاح السري (gak_…) فيُستخدَم في الخادم، مثلًا من أداة سطر الأوامر. لا تكشف مفتاحًا سريًا في شيفرة العميل أبدًا.

مساحة العمل

مستأجِر Syncanix واحد — مشروعك، بكتالوجه وإعداداته وفريقه وفوترته. ويمكن أن تنتمي إلى أكثر من واحدة.