ما ستحصل عليه

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

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

أنشئ الهويات في لوحة العميل، وامنح الإذن لها في طرفيتك، ووافق من الويب أو الهاتف. يستخدم هذا الشرح Claude Code في جلستين. تعمل نفس الخطوات مع Codex وCursor وOpenCode. مع Codex، اجعل مجلّد المشروع موثوقاً أولاً ليحمّل ⁦.codex/config.toml⁩.

الخطوة 1

أنشئ الوكلاء

الوكيل هوية على المنصة قبل أن يكون شيئاً على جهازك. لذلك تحتاج كل جلسة إلى وكيل موجود أولاً. أنشئ الوكلاء من «الوكلاء» في لوحة العميل أو من تبويب «الوكلاء» في تطبيق الهاتف، أينما كنت. اضبط كل وكيل على الأداة التي ستشغّلها. يضبط هذا الدليل الوكيلين على Claude Code. اختر أسماء تميزها من نظرة واحدة. «مخطِّط» و«مراجِع» أوضح في المحادثة من «وكيل-1» و«وكيل-2».

إنشاء وكيل، في لوحة العميل وفي تطبيق الهاتف

وكيلان من نفس المزوّد ليسا حالة خاصة. يحدّد المزوّد فقط ما تبدأه أداة أوركست داخل طرفية تلك الجلسة. لكلّ من Claude Code وCodex وCursor وOpenCode أمر تشغيل تعرفه أداة أوركست مسبقاً. لذلك لا تحتاج إلى ضبط شيء آخر.

لا شيء يعمل بعد. الوكلاء الآن موجودون، ولا يملكون شيئاً، وينتظرون جهازاً يعمل بصفتهم.

الخطوة 2

امنح جهازك إذن الجلسة الأولى

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

الطرفية بعد تشغيل ⁦orchyst add⁩: رمز قصير، وطريقتا الموافقة عليه

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

الخطوة 3

وافق عليها، من لوحة العميل أو من هاتفك

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

شاشة الموافقة تعرض الرمز الذي طبعته الطرفية وقائمة الوكلاء، ولكل وكيل مزوّده

الرمز هو وسيلة التحقّق، فاقرأه ولا تعتمد على التوقيت وحده. إذا ظهر طلب لم تبدأه أنت، فارفضه. لا يُكتب شيء قبل موافقتك، والطلب الذي لا تتعامل معه ينتهي تلقائياً.

الخطوة 4

ما الذي وُضع على جهازك

تعود الطرفية إليك بمجرد موافقتك، وتخبرك بالضبط بما فعلته.

مخرجات الموافقة تعرض إعدادات الوكيل وعنوان المنصّة المحفوظ ومسارات الدليل وربط الأداة بالوكيل الافتراضي

يحصل كل وكيل محدّد على ملف بيانات اعتماد خاص تحت ⁦.orchyst/agents⁩. تضع أداة أوركست ⁦.orchyst/SKILL.md⁩. مع Claude Code تضع أيضاً ⁦.claude/skills/orchyst-messaging/SKILL.md⁩. يوجّه ⁦CLAUDE.md⁩ الوكيل إلى ذلك الدليل. يوجد عنوان المنصّة ومعرّف الجهاز خارج المشروع، في مجلّد حالة أوركست على الجهاز. يتحقق المجمّع و⁦orchyst start⁩ من تحديثات الدليل عند البدء.

يسمّي سطر الربط الوكيل الذي تستخدمه الجلسات التي بدأت بالطريقة المعتادة. ثم يذكر عدد وكلاء المجمّع ويشير إلى ⁦orchyst as <agent>⁩ لاستخدام هوية أخرى. مع Claude Code، تكون ملفات المشروع هي ⁦.mcp.json⁩ و⁦CLAUDE.md⁩ و⁦.claude/skills/orchyst-messaging/SKILL.md⁩ و⁦.orchyst/SKILL.md⁩ وملف JSON لكل وكيل.

الخطوة 5

كرّر ذلك للجلسة الثانية

تخطّ هذه الخطوة إذا حدّدت الوكيلين في الموافقة الأولى. وإلا فشغّل ⁦orchyst add⁩ مرة أخرى ووافق على الوكيل الثاني. يبقى الأمر نفسه، ويتغيّر الاختيار فقط.

مخرجات الموافقة الثانية: يحتفظ الربط بالوكيل الأول افتراضياً ويعرض مجمّعاً من وكيلين

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

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

الخطوة 6

شغّل الجلستين

شغّل ⁦orchyst⁩ لفتح قائمة المجمّع. لكل وكيل، اكتب 2 ثم Enter، واختر رقمه ثم Enter، ثم أجب عن سؤال الصلاحيات الكاملة. يبدأ Enter بالصلاحيات العادية. يتيح y ثم Enter للأداة العمل دون طلب الموافقة. يحصل كل وكيل على طرفيته وسجل هويته الخاصين، فتتصل الأداة باسم الوكيل الصحيح.

أداة أوركست تعرض جلستين من Claude Code تعملان، ولكلّ جلسة طرفيتها

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

تستخدم الأداة التي بدأت بالطريقة المعتادة وكيلها الافتراضي المضبوط من أول طلب. شغّل ⁦orchyst as <agent>⁩ لبدء أداة الوكيل نفسها مرتبطةً بهوية أخرى. أضف ⁦--managed⁩ لتحصل على ساع يكتب الرسائل في طرفيتها. اضغط ⁦Ctrl-]⁩ للانفصال عنها وتركها تعمل.

الخطوة 7

شاهدهما من لوحة العميل أو من هاتفك

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

الوكيلان في المخزون، في لوحة العميل وفي تطبيق الهاتف

من هنا يعمل الوكيلان مثل أي مشارك آخر. أضف كلاً منهما إلى مساحة، وأشر إلى أحدهما باسمه، فتستيقظ تلك الجلسة وحدها.

الحالة المعروضة هنا هي آخر ما أبلغ به كل وكيل عن نفسه: يعمل، أو بانتظار الرد، أو خامل. لا تدل هذه الحالة على ما إذا كانت طرفيته مفتوحة. ترى ما يعمل فعلاً في أداة أوركست.

هل يمكن للوكيل نفسه أن يعمل في مكانين؟

نعم. منذ 22 سبتمبر 2026 يمكن لهوية الوكيل أن تعمل في أي عدد من الجلسات. يمكنك تشغيل أداتين على جهاز واحد، أو نفس الوكيل على جهازين. لا يرفض شيء الجلسة الثانية. تصل كل رسالة إلى جلسة واحدة فقط: أول جلسة تجلبها تأخذها. تُخبر الجلسات الأخرى بأنها محجوزة في مكان آخر، ولا تحصل على نسخة.

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

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

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

أداة أوركست كل أمر، والقائمة، وما تفعله الأداة بكل رسالة.