العمل في Plan Studio

يبيّن هذا الدليل كيف تعمل على الخطط في Plan Studio. لما يعنيه التنسيق ومستند الخطة، انظر التنسيق و استخدام وضع الخطة.

فتح خطة

تنتمي الخطة إلى المحادثة التي أنتجتها، ومنها تُفتح في العادة: صف الخطة فيه إجراء فتح، فيُفتح Plan Studio لسان محرّر إلى جوار المحادثة.

تعرض صفحة الخطط ثلاثة أقسام:

الخطط النشطة — التنسيقات، وتُعرض المقترحة أولًا، مع الحالة وعدد الخطوات ورقم النسخة.
مستندات الخطط — خطط سلّمها وكيل واحد بأداة submit_plan في وضع الخطة، ما دامت مقترحة أو تمت الموافقة عليها.
كتيبات التشغيل — قوالب خطط محفوظة ذات معاملات.

انقر بطاقة لتفتحها في Plan Studio. المسار /workspaces/<workspace-id>/plans/<kind>/<plan-id>، حيث kind هو orchestration أو document، فتستطيع فتح خطة واحدة من رابطها أيضًا.

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

تحرير DAG

يمكن تعديل التنسيق ما دامت حالته proposed. وتُجرى كل عمليات التحرير على اللوحة باختصارات لوحة المفاتيح:

انقر اللوحة، ثم انقل التحديد بـمفاتيح الأسهم.
اضغط n لإضافة خطوة. تظهر محددة بعنوان «خطوة جديدة»؛ أعد تسميتها في المفتّش على اليسار.
اضغط e على الخطوة التي يجب أن تعمل أولًا، ثم انقر الخطوة التابعة (أو حدّدها واضغط Enter) لوصل تبعية. اضغط Esc للعدول عن وصل معلّق.
اضغط x لقطع أحدث تبعية للخطوة المحددة، أو بدّل كل تبعية على حدة في محرّر التبعيات داخل المفتّش.
اضغط Delete لحذف الخطوة المحددة، وتُزال الإحالات إليها من تبعيات ما يبقى من الخطوات.

في المفتّش تستطيع أيضًا تحرير الوصف والدور ومخطط المخرجات (JSON) للخطوة. تُحفظ التعديلات تلقائيًا كنسخة جديدة بعد مهلة قصيرة، ويُمنع الحفظ بخطأ تحقق يظهر في شريط الموافقة حتى تصلحه.

لا يُحرَّر إلا خطوات العمل. العقد البنيوية — البحث والنقاش والتجميع — للقراءة فقط، وكذلك أي خطوة نُفّذ عملها: تُعلَّم بـ«نُفّذت بالفعل»، لأن تحريرها يفرّع الخطة.

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

قراءة تقديرات التكلفة والوقت والمخاطرة

اضغط تقدير في شريط الموافقة.

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

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

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

مقارنة نسخة بمقترح أقدم

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

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

يرفض propose_orchestration والمحرّر أي تغيير ما إن تخرج الخطة من proposed، فلا يتلقّى التشغيل الجاري إعادة تخطيط في منتصف تنفيذه.

الموافقة على خطة أو رفضها أو توسيعها

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

الموافقة للمشغّل وحده. لا أداة MCP لها، فيقترح الوكيل الخطة ويعدّلها ولا يوافق عليها.

وما إن يصير التنسيق قيد التنفيذ حتى يتغيّر الشريط:

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

الخطوات الخارجة عن مجموعة الموافقة الجزئية تظهر مؤجّلة، ولا تعمل حتى توسّع المجموعة.

تشغيل كتيب تشغيل بمعاملات

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

من قسم كتيبات التشغيل في صفحة الخطط، اضغط تشغيل على كتيب التشغيل (أو افتح لوحة الأوامر بـ ⌘K واختره منها).
املأ المعاملات. معاملات التعداد تظهر قوائم منسدلة، ومعاملات المستودع والوكيل تأخذ مرجع مستودع أو وكيل، والمعاملات الاختيارية تُملأ بقيمتها الافتراضية.
اختر التذكرة المرجعية التي تُقترَح الخطة مقابلها، ثم أكّد.

تشغيل كتيب التشغيل يقترح خطة فقط. يُفتح التنسيق المُنشأ في Plan Studio بحالة proposed، ولا يُنفَّذ شيء حتى توافق عليه هناك. ولحذف كتيب التشغيل، اضغط أيقونة سلة المهملات على بطاقته.

ينشئ الوكلاء كتيبات التشغيل ويشغّلونها بأداتي MCP create_playbook وrun_playbook؛ انظر مرجع أدوات MCP.

أدلة ذات صلة

استخدام وضع الخطة: كيف ينتج الوكيل مستند خطة بأداة submit_plan
تشغيل تنسيق: دورة الموافقة الواحدة من جهة المحادثة
إنشاء قالب خط أنابيب: حين تحتاج منطقًا لا يسعه كتيب التشغيل
مراقبة تشغيلات خطوط الأنابيب: عرض المحرّك لخطة تمت الموافقة عليها

مفاهيم ذات صلة

التنسيق