المسرد
المصطلحات الأساسية المستخدَمة في توثيق Syncanix.
المفردات الشاملة المستخدَمة في كامل هذا التوثيق. وتعرّف الأقسام اللاحقة مصطلحاتها الخاصة حيث ترد.
- القدرة
- شيء واحد تستطيع واجهة برمجة التطبيقات لديك القيام به — نقطة نهاية أو إجراء، مثل «ردّ مبلغ طلب» — موصوف كي يعرف المساعد ما يفعله ومتى يستخدمه.
- كتالوج القدرات
- القائمة المنظَّمة بكل قدراتك. تُكتشَف من واجهة برمجة التطبيقات لديك وهي المصدر الوحيد للحقيقة الذي تقرأ منه الأداة والدردشة وخادم MCP.
- الاكتشاف
- عملية فحص شيفرتك لبناء كتالوج القدرات، تنفّذها أداة سطر أوامر Syncanix.
- الأثر الجانبي
- ما يفعله الإجراء ببياناتك: قراءة (يبحث عن شيء)، أو كتابة (يغيّر شيئًا)، أو مدمّر (يحذف أو يغيّر على نحو لا رجعة فيه). يحدّد الأثر الجانبي كيفية تأكيد الإجراء.
- الأداة (Widget)
- مكوّن الدردشة القابل للتضمين الذي تضيفه إلى تطبيقك بوسم سكربت واحد.
- واجهة الدردشة
- تجربة المساعد التي يتفاعل معها مستخدموك — الإجابة عن الأسئلة وتنفيذ الإجراءات عبر واجهة برمجة التطبيقات لديك.
- الاستناد (الاسترجاع)
- الإجابة من وثائقك ومحتواك بدل المعرفة العامة للنموذج. يسترجع المساعد المادة ذات الصلة ويستشهد بها، فتعكس الإجابات منتجك.
- MCP (Model Context Protocol)
- معيار مفتوح يتيح لعملاء الذكاء الاصطناعي مثل Claude Desktop وCursor وChatGPT الاتصال بالأدوات والبيانات الخارجية.
- خادم MCP
- نقطة النهاية لكل مساحة عمل التي يمنحك إياها Syncanix كي تصل عملاء MCP إلى قدراتك.
- المطوِّر / المسؤول
- فريقك — الأشخاص الذين يشغّلون أداة سطر الأوامر ويضبطون لوحة التحكم ويديرون مساحة العمل.
- المستخدم النهائي
- مستخدم عميلك المسجَّل الدخول، الذي يتحدّث إلى الأداة أو يربط عميل MCP. وتُستخدَم هويته الخاصة — لا هوية مشتركة — في كل إجراء.
- تعلّم المستخدم
- قدرة اختيارية تتيح للمساعد تعلّم التفضيلات والسياق الدائمين لكل مستخدم نهائي مسجَّل دخوله من محادثاته، مع إدراج ملخّص مضغوط ومحدود بميزانية في الأدوار المقبلة لتخصيص الردود والإجراءات المتاحة.
- أثر الوكيل
- واجهة التحليلات التي تقيس القيمة التجارية التي يقدّمها الوكيل — كم عدد طلبات المستخدمين النهائيين التي حلّها دون مساعدة بشرية (التحويل)، ونتائج تلك المحادثات، وعائد استثمار تقديري — مُجمَّعة ليليًا لكل مساحة عمل مع إفصاح صادق عن أخذ العيّنات.
- خريطة ال تفاعل
- خريطة مرئية لرسم قدرات الوكيل والمسارات التي يسلكها المستخدمون النهائيون عبره — أيّ المناطق والمسارات والقدرات التي يصلون إليها، وأين يتركّز الطلب، وأين تبقى فجوات في القدرات — معروضة كلوحة تفاعلية مع عرض جدولي متاح للجميع.
- تقرير الفريق الأحمر
- تقرير أمني موقَّع خاص بكل مساحة عمل، يُشغّل مجموعة الاختبارات العدائية المنسَّقة لدى Syncanix — اختبارات حقن التعليمات وتجاوز الضوابط وتسريب البيانات — عبر الدفاعات الحيّة ويمنح كل فئة هجوم درجة. ولا تجتاز الفئة إلا إذا اكتُشفت كل اختبارات الهجوم ولم يُوسم أي اختبار مشروع خطأً. وتَحكم المجموعة ذاتها التكامل المستمر، فلا يمكن للتقرير أن يدّعي تغطية لا يفرضها البناء أيضاً.
- مزوّد الهوية (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 الوسيطة الاختيارية. تُبقي الشواهد الكتالوج متوافقًا مع ما تقدّمه واجهتك فعليًا.
- CU (وحدات الحوسبة)
- مقياس مُرجَّح لما يفعله مساعدك — الرسائل واستدعاءات الأدوات والرموز الأساسية تستهلك CU. تُحدَّد الخطط وفق وحدات الحوسبة المضمّنة، فالتكلفة يحدّدها الاستخدام لا عدد المستخدمين.
- البيئة
- نسخة معزولة من إعداداتك. لكل مساحة عمل بيئة تطوير للإعداد وبيئة إنتاج يصل إليها مستخدموك.
- الترقية
- نقل إعداداتك من التطوير إلى الإنتاج، بحيث لا يتغيّر السلوك المباشر إلا عندما تقصد ذلك.
- المفتاح القابل للنشر والمفتاح السري
- يمكن تضمين المفتاح القابل للنشر (pk_…) بأمان في صفحة الويب لديك من أجل الأداة؛ أما المفتاح السري (gak_…) فيُستخدَم في الخادم، مثلًا من أداة سطر الأوامر. لا تكشف مفتاحًا سريًا في شيفرة العميل أبدًا.
- مساحة العمل
- مستأجِر Syncanix واحد — مشروعك، بكتالوجه وإعداداته وفريقه وفوترته. ويمكن أن تنتمي إلى أكثر من واحدة.