تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

كيف يعمل Syncanix

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

يقوم Syncanix على فكرة واحدة: اكتشِف مرة واحدة ما يستطيع منتجك القيام به، ثم أعِد استخدامه في كل مكان. ينتج هذا الاكتشاف كتالوج قدرات، وكل شيء آخر هو عرض لهذا الكتالوج.

١. اكتشف واجهة برمجة التطبيقات لديك

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

npx syncanix init

لا يعمل الإثراء الاختياري بالذكاء الاصطناعي (عناوين وأوصاف أوضح) إلا بعد منحك موافقة صريحة على عدم الاحتفاظ بالبيانات. وإلا فلن ترسل أداة سطر الأوامر أي شيء.

٢. ضمّن الأداة

أضِف وسم سكربت واحدًا إلى تطبيقك. تُحمَّل الأداة على نحوٍ مؤجَّل، وتعمل داخل Shadow DOM كي لا تتعارض أنماطك وأنماطنا أبدًا، وتلتقط هويتك التجارية من نظام التصميم لديك تلقائيًا.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
></script>

٣. دردشة تتّخذ إجراءات

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

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

٤. اربط عملاء الذكاء الاصطناعي عبر MCP

تحصل كل مساحة عمل على خادم MCP خاص بها، كي يصل مستخدموك إلى القدرات نفسها من Claude Desktop وCursor وChatGPT وغيرها من العملاء المتوافقين مع MCP. ويُفوَّض تسجيل الدخول إلى مزوّد الهوية لديك، فتُطبَّق الهوية والصلاحيات نفسها هناك أيضًا.

اضبط كل شيء من لوحة التحكم

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

الرحلة في لمحة

تشغيل أول نموذجي، من تطبيق قائم إلى مساعد يعمل فعليًا:

  1. الاكتشافشغّل أداة سطر الأوامر لفحص واجهة برمجة التطبيقات لديك ورفع كتالوج القدرات.
  2. المراجعة والضبطفي لوحة التحكم، حدّد درجات الخطورة والصلاحيات وشخصية المساعد.
  3. التضمينأضِف سكربت الأداة إلى تطبيقك وتأكّد من توافقه مع هويتك التجارية.
  4. الترقيةرقِّ من التطوير إلى الإنتاج عندما ترضى عن سلوكه.

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