دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

بني وتحقّق من وكيل قانوني بالذكاء الاصطناعي مع ورشة الوكيل القانوني

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

حوالي 15 دقايق ديال القراية
بناء والتحقّق من وكيل قانوني بالذكاء الاصطناعي مع ورشة الوكيل القانوني

شنو كيدير Legal Agent Workshop

Legal Agent Workshop هو مشروع تطبيقي على جوج ديال الجلسات لبناء وتقييم وكيل ذكاء اصطناعي قانوني. فالأول، كيطبّق المشاركون حلقة ديال التحقيق الوكيلي وكيخرجو مذكرة قانونية مازال ما تراجعاتش. من بعد، كيزيدو طبقة ديال التحقق خدامة من برا تحكم الوكيل.

المستودع كيوفّر حزمة واجدة مبنية على كود Python عادي ديال OpenAI SDK. فيها ملف مستقل لكل أداة، وقراية الوثائق عبر Files API، ونظام لتدبير القضايا كيتبع الوقائع اللي تراجعات الاقتباسات ديالها. القضية المرفقة هي northbridge-v-caldera، ولكن الوكيل راسو عام وما فيهش القضية.

قاعدة مهمة ديال مساحة العمل: شغّل Muse Code غير من مجلد agent/. خاص مجلدات cases/ وworld/ وground_truth/ وsolutions/ وui/ يبقاو برا من مساحة عمل Muse Code.

الخصائص الرئيسية

  • وكيل قانوني عام: الوكيل كيصايب لائحة تحقق، وكيحط خطة، وكيحقق فالوثائق، وكيخرج مذكرة.
  • تنفيذ باستعمال OpenAI Python SDK: الحلقة الوكيلية كتستعمل كود SDK مباشر بلا إطار إضافي للوكلاء.
  • تحليل الوثائق: الحزمة كتستعمل Files API لقراية وثائق القضية.
  • وقائع مرفقة باقتباسات متحققة: نظام تدبير القضية كيسجل الوقائع مع الاقتباسات اللي كتدعمها.
  • تحقق خارجي: فحوصات اللائحة والمذكرة كتدار من برا تحكم الوكيل.
  • مقارنة مع الحقيقة المرجعية: أداة التحقق من اللائحة ككتقارن الخدمة ديال الوكيل مع لائحة خاصة بالقضية وما كيقدرش الوكيل يشوفها.
  • مسار قابل للاستئناف: يمكن تفريع جلسة 1 ومواصلة الخدمة مع تفعيل التحقق.
  • واجهة Agent Console مباشرة: الواجهة الجاهزة كتعرض الأدوار، وعناصر اللائحة، والإثبات الداعم، وإتاحة الأدلة، ومصادقة المحامي.

فهم بنية المستودع

  • HANDBOOK.md فيه تعليمات الإعداد، والجوج ديال جلسات الورشة، والبرومبت ديال القواعد الأساسية ديال Muse Code فالقسم 1.7.
  • agent/ فيه الكود الأولي، وهو المجلد الوحيد اللي خاصو يكون مكشوف كمساحة عمل Muse Code.
  • cases/northbridge-v-caldera/ فيه هدف القضية والوثائق اللي معطاة للوكيل.
  • ground_truth/ فيه لائحة التحقق الخاصة اللي كيستعملها التحقق الخارجي. ممنوع نهائيا تدخل فالقضية ولا تبان للوكيل.
  • world/ كيمثل العالم الخارجي المحاكى، بما فيه وثائق المتابعة المحجوبة وسكريبت إتاحة الأدلة.
  • solutions/ فيه لقطات ديال جلسة 1 وجلسة 2.
  • ui/ فيه Agent Console الجاهزة وكيبقى برا من مساحة عمل Muse Code.

تثبيت وإعداد الورشة

1. نسخ المستودع

نسخ المشروع، ومن بعد دخل لمجلد agent/ قبل ما تجهز ولا تشغّل Muse Code.

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

أمر الإعداد كينشئ بيئة .venv فيها OpenAI Python SDK، وكيكوپي وثائق القضية للمكان المتوقع، وكيأكد من مفتاح API المهيأ.

4. تشغيل Muse Code

باقي داخل agent/، شغّل Muse Code:

muse

أول رسالة خاصها تكون برومبت القواعد الأساسية من القسم 1.7 ديال HANDBOOK.md. عاود صيفط داك البرومبت من بعد كل إعادة تشغيل ولا جلسة جديدة ديال Muse Code.

الجلسة 1: بناء وتشغيل الوكيل القانوني

الجلسة 1 كتركز على تنفيذ الحلقة الوكيلية العامة باستعمال الحزمة المعطاة. تبع التعليمات خطوة بخطوة فـHANDBOOK.md، وخلي الخدمة كاملة داخل agent/.

المسار المقصود هو:

  1. صياغة لائحة تحقق: حدّد الأسئلة والأدلة اللي خاص التحقيق يغطيها.
  2. التخطيط للتحقيق: قرر كيفاش تستعمل الأدوات ووثائق القضية المتاحة.
  3. التحقيق: قرا الوثائق عبر مسار الوثائق المعطى وسجّل الوقائع المرفقة باقتباسات متحققة فـنظام تدبير القضية.
  4. تحضير النتيجة: سالِ الجولة بمذكرة مازال ما تراجعاتش، مبنية على التحقيق.

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

تتبّع جولة فـAgent Console

من جذر المستودع، شغّل الواجهة الجاهزة:

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

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

بنِ فحوصات التحقّق

تبع تعليمات الجلسة 2 فـ HANDBOOK.md باش تبني فحوصات اللائحة والمذكرة. حافظ على حدّ الثقة: خاص هاد الفحوصات تخدم من برا تحكّم الوكيل، وما تعتمدش على الوكيل باش يصادق على خدمتو براسو.

كمّل التشغيل مع تفعيل التحقّق

فرّع التشغيل الأصلي ديال الجلسة 1 انطلاقاً من اللائحة الموجودة ديالو:

./helper branch RUN_ID

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

طلّق الأدلة المحجوبة

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

python3 world/release.py

من بعد ما تطلق الأدلة، كمّل سيرورة الورشة وتابع التشغيل المستأنف فـ Agent Console.

نصائح متقدمة

حمي حدود مساحة العمل

ديما بدا Muse Code من agent/، وما تبداش من جذر المستودع. هاد الشي كيمنع Muse Code من يشوف مصدر الحالة، والحقيقة المرجعية المخفية، والعالم المحاكى، ولقطات الحلول، وكود الواجهة. هاد الفصل أساسي فـنموذج التحقّق ديال الورشة.

ما تكشفش الحقيقة المرجعية للوكيل

الملف ground_truth/northbridge-v-caldera.json موجود من أجل فحص اللائحة الخارجي. ما تنسخوش للحالة، وما تدخلوش لمساحة عمل Muse Code، وما تعطيهش للوكيل.

عاود طبّق القواعد الأساسية من بعد إعادة التشغيل

جلسة Muse Code اللي تعاودات ولا تخلقات من جديد ما كتحيدش ضرورة إعطاء التلقين ديال القواعد الأساسية. كل مرة، نسخو من القسم 1.7 فـ HANDBOOK.md.

زِد حالة أخرى باستعمال التصميم المعتمد

الحالة الجديدة كتتمثّل فمجلد فيه ملف 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

# من جذر المستودع
python3 ui/ui.py
python3 world/release.py

# من agent/
./helper verify RUN_ID --memo
./helper verify RUN_ID --checklist
./helper branch RUN_ID

الخلاصة

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