کار در 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 را فشار دهید؛ ارجاع‌های به آن از وابستگی‌های گام‌های باقی‌مانده برداشته می‌شوند.

در بازرس همچنین می‌توانید شرح، نقش و شِمای خروجی گام را ویرایش کنید. ویرایش‌ها پس از مکثی کوتاه به‌صورت یک بازبینی تازه خودکار ذخیره می‌شوند؛ یک خطای اعتبارسنجی (که در نوار تأیید نشان داده می‌شود) تا رفع آن، ذخیره را مسدود می‌کند.

فقط گام‌های کاری ویرایش‌پذیرند. گره‌های ساختاری — پژوهش، بحث و ترکیب — فقط‌خواندنی‌اند و هر گامی که کارش از قبل اجرا شده نیز همین‌طور است (با برچسب «از قبل اجرا شده» مشخص می‌شود، چون ویرایش آن برنامه را شاخه می‌کند).

ذخیره‌سازی به‌شکل هم‌روندی خوش‌بینانه بر پایهٔ همان بازبینی‌ای است که از آن شروع کرده‌اید. اگر ارکستراسر زیر پای شما برنامه را دوباره طرح کند، ذخیره‌تان به‌جای ادغام یا رونویسی خاموش، با پیام «برنامه جلوتر رفته است» رد می‌شود؛ بازبینی جاری را دوباره بخوانید و ویرایش‌تان را از نو انجام دهید. طرح‌های مجدد آغازشده از سوی عامل خودشان به یکی در هر دو دقیقه محدود شده‌اند، پس این حالت نادر می‌ماند.

خواندن برآوردهای هزینه، زمان و ریسک

در نوار تأیید برآورد را فشار دهید.

هر گام روی بوم نشانی با یک بازهٔ هزینه و اندازهٔ نمونهٔ پشت آن می‌گیرد، یا «هنوز تاریخچه‌ای نیست» وقتی نقش آن گام هرگز اجرا نشده است. یک گام را برای جزئیات کامل در بازرس انتخاب کنید: بازهٔ هزینه با اندازهٔ نمونه، یک بازهٔ مدت و یک شعاع اثر (فایل‌ها و نمادها) برگرفته از منشأ گام — یا «ناشناخته» وقتی گام هیچ منشأیی ندارد.
نوار تأیید جمع کل برنامه را نشان می‌دهد: یک بازهٔ هزینهٔ کلی، یک بازهٔ مدت برای مسیر بحرانی (شاخه‌های موازی هم‌پوشانی دارند، پس این جمع نیست) و سقف بودجه وقتی برنامه یکی تعیین کرده باشد.
اگر فقط برخی گام‌ها تاریخچه داشته باشند، جمع جزئی علامت می‌خورد و تنها گام‌های قابل‌برآورد را پوشش می‌دهد. اگر انتهای بالای برآورد از سقف بودجه فراتر برود، جمع با هشدار فراتر از بودجه سرخ می‌شود.

برآوردها یا صادق‌اند یا غایب: گامی که نقشش هیچ تاریخچه‌ای از اجرای کامل‌شده ندارد، اندازهٔ نمونهٔ صفر و هیچ بازه‌ای گزارش می‌کند و به‌جای حدس‌زدن، ناشناخته نمایش داده می‌شود. «هنوز تاریخچه‌ای نیست» را «هیچ‌کس نمی‌داند» بگیرید، نه «ارزان».

سقف بودجه یک مقایسهٔ نمایشی با همین برآورد است. پس از آغاز اجرای برنامه هیچ‌چیز آن را اجرا نمی‌کند — برای کنترل‌هایی که واقعاً خرج را متوقف می‌کنند مدیریت هزینه‌ها را ببینید.

دیف یک بازبینی در برابر یک پیشنهاد پیشین

هر ویرایش و هر طرح مجدد از سوی ارکستراسر به یک خط زمانی بازبینی فقط‌افزودنی می‌پیوندد که در پنل نسخه‌ها در سمت چپ یک برنامهٔ ارکستراسیون نشان داده می‌شود.

روی یک بازبینی کلیک کنید تا با پیشنهاد جاری دیف شود. بدون هیچ انتخاب، پنل بازبینی پیشین را با بازبینی جاری دیف می‌گیرد.
دیف را در نیمهٔ پایینی پنل بخوانید: گام‌های افزوده، حذف‌شده یا تغییرکرده میان دو بازبینی.
اگر برنامه هنوز proposed است، روی نماد عقب‌بردنِ یک بازبینی کلیک کنید تا به آن برگردید. عقب‌بردن آن پیشنهاد را به‌صورت یک بازبینی تازه ذخیره می‌کند — هیچ‌چیز از دست نمی‌رود.

propose_orchestration و ویرایشگر هر دو پس از آنکه برنامه دیگر proposed نباشد تغییرات را رد می‌کنند، پس یک اجرای در جریان، طرح مجددی در میانهٔ اجرا را برنمی‌دارد.

تأیید، رد یا گستردن یک برنامه

در اپلیکیشن، یک برنامهٔ پیشنهادشده یک تصمیم یکپارچه است که کامل گرفته می‌شود: از نوار تأیید تأیید برنامه یا رد. تأیید برنامه همیشه همهٔ گام‌ها را تأیید می‌کند — راهی برای انتخاب زیرمجموعه از پیش وجود ندارد. تا زمانی که پیشنهاد خطای اعتبارسنجی داشته باشد تأیید مسدود است؛ این خطاها کنار دکمه‌ها نشان داده می‌شوند.

تأیید فقط در اختیار اپراتور است. ابزار MCP‌ای برای آن وجود ندارد، پس یک عامل می‌تواند برنامه‌ای را پیشنهاد و بازنگری کند اما هرگز آن را تأیید نکند.

وقتی ارکستراسیون در حال اجرا شد، نوار تغییر می‌کند:

اگر گامی در میانهٔ اجرا برای پرسیدن متوقف شده باشد، آن را انتخاب کنید و برای ادامه دادنش ادامهٔ گره را فشار دهید.
برای گستردن یک تأیید جزئی به گام انتخاب‌شده به‌علاوهٔ هر چیزی که به‌طور گذرا به آن وابسته است، تأیید انتخاب‌شده‌ها را فشار دهید (یک گام هرگز بدون وابستگی‌هایش تأیید نمی‌شود). این کنترل روی نوار در حال اجرا برای هر ارکستراسیونی هست؛ وقتی برنامه کامل تأیید شده باشد بی‌اثر است.
برای متوقف کردن کل ارکستراسیون لغو اجرا را فشار دهید.

گام‌های بیرون از یک مجموعهٔ تأییدشدهٔ جزئی به‌صورت به‌تعویق‌افتاده رندر می‌شوند و تا گستردن مجموعه اجرا نمی‌شوند.

اجرای یک کتابچه با پارامترها

کتابچه یک قالب برنامهٔ ذخیره‌شده با جانگهدارهای {{param}} نوع‌دار در هدف، عنوان‌های گام، شرح‌ها و پرامپت‌های آن است. جای‌گذاری تحت‌اللفظی است — زبان عبارتی وجود ندارد؛ اگر منطق لازم دارید، به‌جای آن از یک پایپ‌لاین استفاده کنید.

در بخش کتابچه‌ها در هاب، روی کتابچه اجرا را فشار دهید (یا پالت ⌘K را باز کنید و کتابچه را از همان‌جا انتخاب کنید).
پارامترها را پر کنید. پارامترهای شمارشی به‌صورت فهرست بازشو رندر می‌شوند؛ پارامترهای مخزن و عامل یک ارجاع مخزن یا عامل می‌گیرند؛ پارامترهای اختیاری به مقدار پیش‌فرض خود برمی‌گردند.
تیکت لنگری را که برنامه در برابر آن پیشنهاد می‌شود انتخاب کنید، سپس تأیید کنید.

اجرای یک کتابچه تنها یک برنامه پیشنهاد می‌کند — ارکستراسیون نمونه‌سازی‌شده در Plan Studio به‌صورت proposed باز می‌شود و تا زمانی که آن را در آن‌جا تأیید نکنید هیچ‌چیز اجرا نمی‌شود. برای حذف یک کتابچه، روی نماد سطل زبالهٔ کارتش فشار دهید.

عامل‌ها کتابچه‌ها را با ابزارهای MCP create_playbook و run_playbook می‌سازند و اجرا می‌کنند؛ مرجع ابزارهای MCP را ببینید.

راهنماهای مرتبط

استفاده از حالت برنامه: چگونه یک عامل با submit_plan یک سند برنامه تولید می‌کند
اجرای یک ارکستراسیون: چرخهٔ عمر تأیید یک‌باره از سمت گفتگو
ایجاد قالب پایپ‌لاین: وقتی منطقی لازم دارید که کتابچه نمی‌تواند بیان کند
نظارت بر اجراهای پایپ‌لاین: نمای موتور از یک برنامهٔ تأییدشده

مفهوم‌های مرتبط

ارکستراسیون