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 کے طور پر کھلتی ہے اور جب تک آپ وہاں منظوری نہ دیں کچھ عمل درآمد نہیں ہوتا۔ پلے بک ہٹانے کے لیے اس کے کارڈ پر کوڑے دان کا آئیکن دبائیں۔

ایجنٹ create_playbook اور run_playbook MCP ٹولز سے پلے بکس بناتے اور چلاتے ہیں؛ MCP ٹولز کا حوالہ دیکھیں۔