بدء سريع

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

قبل أن تبدأ

• مساحة عمل Syncanix — تواصل مع فريق المبيعات لدينا عبر syncanix.com/contact للبدء.
• Node.js الإصدار 20 أو أحدث.
• واجهة برمجة تطبيقات HTTP قائمة فيها نقطة نهاية واحدة على الأقل مُصادَق عليها.
• مزوّد هوية لمستخدميك — Auth0 أو Clerk أو Cognito أو WorkOS أو OIDC الخاص بك.
• مفتاح Anthropic أو OpenAI أو AWS Bedrock-EU — أو استخدم الوصول المُدار إلى النموذج، وهو مُضمَّن في خطتك.

1. جهّز مساحة عملك ومفاتيحك

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

1. 1
   احصل على مساحة عملكتواصل مع فريق المبيعات لدينا عبر syncanix.com/contact لإعداد مساحة عملك. لوحة التحكم هي موطن الكتالوج ومفاتيح API وإعدادات الأداة لديك.
2. 2
   سجّل الدخول من CLIنفّذ npx syncanix login — يفتح متصفحك لوحة التحكم للموافقة على هذا الجهاز، وتحفظ CLI جلسة مرتبطة بحسابك في ‎~/.syncanix/credentials ليتمكن init من رفع الكتالوج. جهاز دون واجهة؟ نفّذ npx syncanix login --key والصق مفتاح جهاز من الإعدادات ← مفاتيح API.
3. 3
   انسخ مفتاحك القابل للنشرمن الإعدادات ← مفاتيح API في لوحة التحكم، انسخ مفتاحك القابل للنشر (pk_live_…). يستخدمه مقطع تضمين الأداة قيمةً لـ data-key — ومن الآمن شحنه في المتصفح.

npx syncanix login

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

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

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

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

3. دعه يقرأ منتجك

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

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

4. راجع ما وجده

افتح لوحة التحكم لرؤية ما اكتُشِف. هنا تقرّر ما الذي يستطيع المساعد فعله، وبأي قدر من الحذر:

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

5. اختياري: اقرأ شيفرتك لمعرفة الأشكال بدقّة

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

npx syncanix init

6. اختياري: اربط خادمك

عند إضافتها، ثبّت SDK في الخدمة التي تملك واجهة API لديك. تبدأ خلال أجزاء من الثانية وتُبقي كتالوجك محدَّثًا عبر اكتشاف الانحراف أثناء التشغيل:

npm install @syncanix/sdk-node

import { init } from '@syncanix/sdk-node';

// Resolves your API key from SYNCANIX_API_KEY, ~/.syncanix/credentials,
// or an inline { apiKey } — in that order.
const { environment, bootDurationMs } = await init({ environment: 'development' });
console.log(`Syncanix booted in ${bootDurationMs.toFixed(1)}ms`);

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

import { createToolRegistry } from '@syncanix/sdk-node';

const registry = createToolRegistry();

registry.tool({
  name: 'refund-order',
  description: 'Refund a customer order. Requires an admin role.',
  handler: async ({ orderId, amountCents }, ctx) => {
    // ctx.userId is the verified end user from your identity provider.
    return payments.refund({ orderId, amountCents, actor: ctx.userId });
  },
});

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

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

8. انتقل إلى الإنتاج

عندما ترضى عن سلوك المساعد في التطوير، رقِّه إلى الإنتاج من لوحة التحكم. تعمل أولًا بوابة تقييم تمنع الترقية إذا تراجعت الجودة، بحيث لا يتغيّر الإنتاج إلا نحو الأفضل.

ما لديك الآن

• مساعد مضمَّن في تطبيقك يجيب عن الأسئلة وينفّذ إجراءاتك.
• خادم MCP لكل مساحة عمل من أجل Claude Desktop وCursor وChatGPT.
• سجلّ تدقيق لكل إجراء وكل ترقية وكل تغيير إداري.
• كل شيء مستضاف في الاتحاد الأوروبي، مع تشفير بياناتك أثناء التخزين.

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