لیگل ایجنٹ ورکشاپ کے ساتھ قانونی AI ایجنٹ بنائیں اور اس کی تصدیق کریں

لیگل ایجنٹ ورکشاپ کیا کرتی ہے

لیگل ایجنٹ ورکشاپ ایک عملی، دو سیشنز پر مشتمل منصوبہ ہے جس میں قانونی AI ایجنٹ تیار اور جانچا جاتا ہے۔ شرکاء پہلے ایجنٹ پر مبنی تحقیق کا چکر نافذ کرتے ہیں اور ایک غیر مصدقہ قانونی میمو تیار کرتے ہیں۔ اس کے بعد وہ ایک ایسی توثیقی پرت شامل کرتے ہیں جو ایجنٹ کے کنٹرول سے باہر کام کرتی ہے۔

ریپوزٹری سادہ OpenAI Python SDK کوڈ پر مبنی پہلے سے تیار کِٹ فراہم کرتی ہے۔ اس میں ہر ٹول کے لیے الگ فائل، Files API کے ذریعے دستاویزات پڑھنے کی سہولت، اور ایک کیس مینجمنٹ سسٹم شامل ہے جو اقتباس سے جانچے گئے حقائق کا ریکارڈ رکھتا ہے۔ شامل کیس northbridge-v-caldera ہے، لیکن ایجنٹ خود عمومی رہتا ہے اور اس میں کیس شامل نہیں ہوتا۔

ورک اسپیس کا اہم اصول: Muse Code صرف agent/ ڈائریکٹری سے لانچ کریں۔ cases/، world/، ground_truth/، solutions/، اور ui/ ڈائریکٹریاں Muse Code ورک اسپیس سے باہر رہنی چاہییں۔

اہم خصوصیات

• عمومی قانونی ایجنٹ: ایجنٹ ایک چیک لسٹ تیار کرتا ہے، منصوبہ بناتا ہے، دستاویزات کی تحقیق کرتا ہے، اور میمو تیار کرتا ہے۔
• OpenAI Python SDK کا نفاذ: ایجنٹ پر مبنی چکر اضافی ایجنٹ فریم ورک کے بجائے براہِ راست SDK کوڈ استعمال کرتا ہے۔
• دستاویزات کا تجزیہ: کِٹ کیس کی دستاویزات پڑھنے کے لیے Files API استعمال کرتی ہے۔
• اقتباس سے جانچے گئے حقائق: کیس مینجمنٹ سسٹم معاون اقتباسات کے ساتھ حقائق ریکارڈ کرتا ہے۔
• بیرونی توثیق: چیک لسٹ اور میمو کی جانچ ایجنٹ کے کنٹرول سے باہر چلتی ہے۔
• اصل حقائق سے موازنہ: چیک لسٹ ویری فائر ایجنٹ کے کام کا موازنہ کیس سے متعلق اصل حقائق پر مبنی چیک لسٹ سے کرتا ہے، جسے ایجنٹ نہیں دیکھ سکتا۔
• دوبارہ شروع کیے جانے کے قابل ورک فلو: سیشن 1 کی رن کو شاخ بنا کر توثیق فعال ہونے کے ساتھ جاری رکھا جا سکتا ہے۔
• لائیو ایجنٹ کنسول: پہلے سے تیار انٹرفیس ٹرنز، چیک لسٹ آئٹمز، معاون ثبوت، شواہد کے اجرا، اور وکیل کی منظوری دکھاتا ہے۔

ریپوزٹری کی ساخت سمجھیں

• HANDBOOK.md میں سیٹ اپ کی ہدایات، دونوں ورکشاپ سیشنز، اور سیکشن 1.7 میں Muse Code کے بنیادی قواعد کا پرامپٹ موجود ہے۔
• agent/ میں ابتدائی کوڈ موجود ہے اور یہی واحد ڈائریکٹری ہے جسے Muse Code ورک اسپیس کے طور پر ظاہر کیا جانا چاہیے۔
• cases/northbridge-v-caldera/ میں کیس کا مقصد اور ایجنٹ کو فراہم کی جانے والی دستاویزات موجود ہیں۔
• ground_truth/ میں بیرونی توثیق کے لیے استعمال ہونے والی نجی چیک لسٹ موجود ہے۔ اسے کبھی کیس میں شامل یا ایجنٹ کو دکھایا نہیں جانا چاہیے۔
• world/ فرضی بیرونی دنیا کی نمائندگی کرتا ہے، جس میں روکے گئے بعد کے دستاویزات اور شواہد کے اجرا کا اسکرپٹ شامل ہے۔
• solutions/ میں سیشن 1 اور سیشن 2 کے اسنیپ شاٹس موجود ہیں۔
• ui/ میں پہلے سے تیار Agent Console موجود ہے اور یہ Muse Code ورک اسپیس سے باہر رہتا ہے۔

ورکشاپ انسٹال اور ترتیب دیں

1. ریپوزٹری کلون کریں

پروجیکٹ کلون کریں، پھر Muse Code ترتیب دینے یا لانچ کرنے سے پہلے agent/ ڈائریکٹری میں داخل ہوں۔

git clone https://github.com/meta-models/legal-agent-workshop.git
cd legal-agent-workshop/agent

2. ماحول کی فائل بنائیں

مثالی ترتیب کو .env میں کاپی کریں۔

cp .env.example .env

.env میں ترمیم کرکے اپنی MODEL_API_KEY شامل کریں۔ تصدیق کریں کہ CASE_DIR شامل کیس کی طرف اشارہ کرتا ہے:

../cases/northbridge-v-caldera

3. سیٹ اپ ہیلپر چلائیں

./helper setup

سیٹ اپ کمانڈ OpenAI Python SDK کے ساتھ .venv ماحول بناتی ہے، کیس کی دستاویزات کو مطلوبہ مقام پر کاپی کرتی ہے، اور ترتیب دی گئی API کلید کی جانچ کرتی ہے۔

4. Muse Code شروع کریں

اب بھی agent/ کے اندر رہتے ہوئے Muse Code لانچ کریں:

muse

آپ کا پہلا پیغام HANDBOOK.md کے سیکشن 1.7 میں موجود بنیادی قواعد کا پرامپٹ ہونا چاہیے۔ ہر ری اسٹارٹ یا نئے Muse Code سیشن کے بعد یہ پرامپٹ دوبارہ جمع کریں۔

سیشن 1: قانونی ایجنٹ بنائیں اور چلائیں

سیشن 1 فراہم کردہ کِٹ استعمال کرتے ہوئے عمومی ایجنٹ پر مبنی چکر نافذ کرنے پر مرکوز ہے۔ HANDBOOK.md میں دی گئی مرحلہ وار ہدایات پر عمل کریں اور تمام کام agent/ کے اندر رکھیں۔

مطلوبہ ورک فلو یہ ہے:

1. چیک لسٹ تیار کریں: ان سوالات اور شواہد کی شناخت کریں جن کا تحقیق میں احاطہ ہونا چاہیے۔
2. تحقیق کا منصوبہ بنائیں: طے کریں کہ دستیاب ٹولز اور کیس کی دستاویزات کیسے استعمال کرنی ہیں۔
3. تحقیق کریں: فراہم کردہ دستاویزی ورک فلو کے ذریعے دستاویزات پڑھیں اور کیس مینجمنٹ سسٹم میں اقتباس سے جانچے گئے حقائق درج کریں۔
4. نتیجہ تیار کریں: تحقیق کی بنیاد پر غیر مصدقہ میمو کے ساتھ رن مکمل کریں۔

اس مرحلے پر میمو جان بوجھ کر غیر مصدقہ ہوتا ہے۔ سیشن 2 یہ دکھاتا ہے کہ بظاہر مکمل ایجنٹ کا آؤٹ پٹ بھی مطلوبہ چیک لسٹ آئٹمز چھوڑ سکتا ہے یا میمو کے قواعد کی خلاف ورزی کر سکتا ہے۔

ایجنٹ کنسول میں رن دیکھیں

ریپوزٹری کی جڑ سے پہلے سے تیار انٹرفیس شروع کریں:

python3 ui/ui.py

براؤزر میں http://127.0.0.1:8765 کھولیں۔ کنسول رن کو براہِ راست دکھا سکتا ہے، جس میں ایجنٹ کا ہر ٹرن، اس کی چیک لسٹ، اور یہ شامل ہے کہ چیک لسٹ آئٹمز کیسے ثابت کیے جاتے ہیں۔ یہ ورکشاپ کے شواہد کے اجرا اور وکیل کی منظوری کے مراحل کو بھی سپورٹ کرتا ہے۔

سیشن 2: جانچیں کہ ایجنٹ سے کیا رہ گیا

سیشن 2 دو آزاد توثیقی جانچیں متعارف کراتا ہے۔ ایک چیک لسٹ کو کیس کے پوشیدہ اصل حقائق کے مقابل جانچتی ہے۔ دوسری میمو کو اس کے لازمی قواعد کے مقابل جانچتی ہے۔

میمو کی تصدیق کریں

agent/ سے RUN_ID کی جگہ سیشن 1 کے رَن کا شناخت کنندہ درج کریں:

./helper verify RUN_ID --memo

یہ وہ مسائل ظاہر کرتا ہے جن کا سیشن 1 کا میمو چیک سراغ لگاتا ہے۔

چیک لسٹ کی تصدیق کریں

./helper verify RUN_ID --checklist

یہ ایجنٹ کی چیک لسٹ کا کیس کے لیے مخصوص اصل چیک لسٹ سے موازنہ کرتا ہے۔ اصل چیک لسٹ کیس اور ایجنٹ کے ورک اسپیس، دونوں سے باہر رہتی ہے۔

تصدیقی چیکس بنائیں

HANDBOOK.md میں سیشن 2 کی ہدایات پر عمل کرتے ہوئے چیک لسٹ اور میمو چیکس بنائیں۔ اعتماد کی حد برقرار رکھیں: یہ چیکس ایجنٹ کے اختیار سے باہر چلنے چاہییں، نہ کہ ایجنٹ سے اپنا کام خود منظور کروانے پر انحصار کریں۔

تصدیق فعال کرکے رَن جاری رکھیں

اصل سیشن 1 رَن کو اس کی موجودہ چیک لسٹ سے برانچ کریں:

./helper branch RUN_ID

جاری رکھا گیا ورک فلو تصدیق سے آگاہ رویوں کو آزماتا ہے، جن میں انکار، معاملہ اوپر بھیجنا، نئے شواہد کا اجرا، دوبارہ آغاز، اور وکیل کی منظوری شامل ہیں۔ برانچنگ چیک لسٹ کو نقطۂ آغاز کے طور پر برقرار رکھتی ہے، بجائے اس کے کہ ایک غیر متعلقہ تفتیش شروع کی جائے۔

روکے گئے شواہد جاری کریں

جب کوئی رَن needs_input تک پہنچے تو فالو اَپ مواد جاری کرنے کے لیے نقلی بیرونی دنیا استعمال کریں۔ یہ کمانڈ ریپوزٹری کے روٹ سے چلائیں:

python3 world/release.py

شواہد جاری ہونے کے بعد ورکشاپ کا سلسلہ جاری رکھیں اور Agent Console میں دوبارہ شروع ہونے والے رَن کا مشاہدہ کریں۔

اعلیٰ درجے کی تجاویز

ورک اسپیس کی حد محفوظ رکھیں

Muse Code ہمیشہ ریپوزٹری کے روٹ سے نہیں بلکہ agent/ سے شروع کریں۔ اس سے Muse Code کیس کے ماخذ، پوشیدہ اصل چیک لسٹ، نقلی دنیا، حل کے اسنیپ شاٹس، یا UI کوڈ کو دیکھنے سے قاصر رہتا ہے۔ یہ علیحدگی ورکشاپ کے تصدیقی ماڈل کا بنیادی حصہ ہے۔

اصل چیک لسٹ ایجنٹ کے سامنے کبھی ظاہر نہ کریں

فائل ground_truth/northbridge-v-caldera.json بیرونی چیک لسٹ چیک کے لیے موجود ہے۔ اسے کیس میں نقل نہ کریں، Muse Code کے ورک اسپیس میں شامل نہ کریں، اور ایجنٹ کو فراہم نہ کریں۔

دوبارہ شروع کرنے کے بعد بنیادی اصول دوبارہ نافذ کریں

دوبارہ شروع کیا گیا یا نیا بنایا گیا Muse Code سیشن بنیادی اصولوں والا پرامپٹ فراہم کرنے کی ضرورت ختم نہیں کرتا۔ ہر بار اسے HANDBOOK.md کے سیکشن 1.7 سے نقل کریں۔

قائم شدہ لے آؤٹ استعمال کرکے ایک اور کیس شامل کریں

نئے کیس کی نمائندگی ایک ایسے فولڈر سے ہوتی ہے جس میں objective.md فائل اور documents/ ڈائریکٹری ہو۔ کیس کو agent/ سے باہر رکھیں اور CASE_DIR کو اس کی طرف متعین کریں۔ README کیس لکھنے یا اصل چیک لسٹ تیار کرنے کے اضافی مراحل بیان نہیں کرتا، اس لیے تصدیقی سیٹ اَپ کو بڑھانے سے پہلے ہینڈ بک کی پیروی کریں۔

حل کے اسنیپ شاٹس احتیاط سے استعمال کریں

solutions/01_session1/ اور solutions/02_session2/ ڈائریکٹریاں دونوں سیشنز کے اسنیپ شاٹس فراہم کرتی ہیں۔ چونکہ یہ Muse Code کے ورک اسپیس سے باہر موجود ہیں، اس لیے انہیں ایجنٹ کے کام کے سیاق کا حصہ بنائے بغیر ورکشاپ کے حوالوں کے طور پر استعمال کیا جا سکتا ہے۔

کمانڈ حوالہ

git clone https://github.com/meta-models/legal-agent-workshop.git
cd legal-agent-workshop/agent
cp .env.example .env
./helper setup
muse

# From the repository root
python3 ui/ui.py
python3 world/release.py

# From agent/
./helper verify RUN_ID --memo
./helper verify RUN_ID --checklist
./helper branch RUN_ID

نتیجہ

Legal Agent Workshop قانونی ایجنٹ کی تیاری کے دونوں پہلوؤں کا مظاہرہ کرتی ہے: ایسا ایجنٹ بنانا جو منصوبہ بندی، تفتیش اور مسودہ تیار کر سکے، اور ایسے بیرونی کنٹرولز بنانا جو جانچیں کہ آیا اس کا کام مکمل اور ضوابط کے مطابق ہے۔ کیسز، اصل چیک لسٹ، تصدیقی وسائل اور نقلی شواہد کو Muse Code کے ورک اسپیس سے باہر رکھ کر یہ منصوبہ اعتماد کی حد کو واضح اور قابلِ آزمائش بناتا ہے۔