Jenga na Thibitisha Wakala wa AI wa Kisheria kwa Warsha ya Wakala wa Kisheria

Warsha ya Wakala wa Kisheria Hufanya Nini

Warsha ya Wakala wa Kisheria ni mradi wa vitendo wa vipindi viwili wa kujenga na kutathmini wakala wa AI wa kisheria. Washiriki kwanza hutekeleza mzunguko wa uchunguzi wa kiwakala na kutoa memo ya kisheria ambayo haijathibitishwa. Kisha huongeza safu ya uthibitishaji inayofanya kazi nje ya udhibiti wa wakala.

Hifadhi hii inatoa kifurushi kilichojengwa awali kinachotumia msimbo wa kawaida wa OpenAI Python SDK. Inajumuisha faili moja kwa kila zana, usomaji wa hati kupitia Files API, na mfumo wa usimamizi wa kesi unaofuatilia ukweli uliokaguliwa kwa nukuu. Kesi iliyojumuishwa ni northbridge-v-caldera, lakini wakala wenyewe unabaki wa jumla na hauna maelezo ya kesi hiyo.

Sheria muhimu ya workspace: Zindua Muse Code kutoka kwenye saraka ya agent/ pekee. Saraka za cases/, world/, ground_truth/, solutions/, na ui/ lazima zibaki nje ya workspace ya Muse Code.

Vipengele Muhimu

• Wakala wa jumla wa kisheria: Wakala huandaa orodha hakiki, huunda mpango, huchunguza hati, na kutoa memo.
• Utekelezaji kwa OpenAI Python SDK: Mzunguko wa kiwakala hutumia msimbo wa moja kwa moja wa SDK badala ya mfumo wa ziada wa mawakala.
• Uchambuzi wa hati: Kifurushi hutumia Files API kusoma hati za kesi.
• Ukweli uliokaguliwa kwa nukuu: Mfumo wa usimamizi wa kesi hurekodi ukweli pamoja na nukuu zinazounga mkono.
• Uthibitishaji wa nje: Ukaguzi wa orodha hakiki na memo hufanyika nje ya udhibiti wa wakala.
• Ulinganisho na ukweli msingi: Kithibitishaji cha orodha hakiki hulinganisha kazi ya wakala na orodha hakiki maalum ya kesi iliyo na ukweli msingi ambao wakala hauwezi kuiona.
• Mtiririko unaoweza kuendelezwa: Uendeshaji wa Kipindi cha 1 unaweza kugawanywa na kuendelezwa huku uthibitishaji ukiwa umewezeshwa.
• Dashibodi ya Moja kwa Moja ya Wakala: Kiolesura kilichojengwa awali huonyesha mizunguko, vipengee vya orodha hakiki, uthibitisho unaounga mkono, utoaji wa ushahidi, na idhini ya wakili.

Elewa Muundo wa Hifadhi

• HANDBOOK.md ina maelekezo ya usanidi, vipindi vyote viwili vya warsha, na ombi la kanuni za msingi za Muse Code katika sehemu ya 1.7.
• agent/ ina msimbo wa kuanzia na ndiyo saraka pekee inayopaswa kuwekwa wazi kama workspace ya Muse Code.
• cases/northbridge-v-caldera/ ina lengo la kesi na hati zinazotolewa kwa wakala.
• ground_truth/ ina orodha hakiki ya faragha inayotumiwa na uthibitishaji wa nje. Haipaswi kamwe kujumuishwa kwenye kesi au kuonyeshwa kwa wakala.
• world/ inawakilisha ulimwengu wa nje uliosimuliwa, ikijumuisha hati za ufuatiliaji zilizozuiwa na hati ya utoaji wa ushahidi.
• solutions/ ina nakala za hali za Kipindi cha 1 na Kipindi cha 2.
• ui/ ina Dashibodi ya Wakala iliyojengwa awali na inabaki nje ya workspace ya Muse Code.

Sakinisha na Sanidi Warsha

1. Nakili hifadhi

Hifadhi mradi kwa kuunakili, kisha ingia kwenye saraka ya agent/ kabla ya kusanidi au kuzindua Muse Code.

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

2. Unda faili la mazingira

Nakili usanidi wa mfano hadi .env.

cp .env.example .env

Hariri .env na uongeze MODEL_API_KEY yako. Thibitisha kuwa CASE_DIR inaelekeza kwenye kesi iliyojumuishwa:

../cases/northbridge-v-caldera

3. Endesha msaidizi wa usanidi

./helper setup

Amri ya usanidi huunda mazingira ya .venv yenye OpenAI Python SDK, hunakili hati za kesi hadi eneo linalotarajiwa, na hukagua ufunguo wa API uliosanidiwa.

4. Anzisha Muse Code

Ukiwa bado ndani ya agent/, zindua Muse Code:

muse

Ujumbe wako wa kwanza lazima uwe ombi la kanuni za msingi kutoka sehemu ya 1.7 ya HANDBOOK.md. Tuma ombi hilo tena baada ya kila kuwasha upya au kila kipindi kipya cha Muse Code.

Kipindi cha 1: Jenga na Endesha Wakala wa Kisheria

Kipindi cha 1 kinalenga kutekeleza mzunguko wa jumla wa kiwakala kwa kutumia kifurushi kilichotolewa. Fuata maelekezo ya hatua kwa hatua katika HANDBOOK.md huku ukihakikisha kazi yote inabaki ndani ya agent/.

Mtiririko unaokusudiwa ni:

1. Andaa orodha hakiki: Tambua maswali na ushahidi ambao uchunguzi unapaswa kushughulikia.
2. Panga uchunguzi: Amua jinsi ya kutumia zana na hati za kesi zinazopatikana.
3. Chunguza: Soma hati kupitia mtiririko wa hati uliotolewa na unakili ukweli uliokaguliwa kwa nukuu katika mfumo wa usimamizi wa kesi.
4. Andaa matokeo: Maliza uendeshaji kwa memo ambayo haijathibitishwa, kulingana na uchunguzi.

Katika hatua hii, memo haijathibitishwa kwa makusudi. Kipindi cha 2 kinaonyesha jinsi matokeo ya wakala yanayoonekana kuwa kamili yanavyoweza bado kuacha vipengee vinavyohitajika vya orodha hakiki au kukiuka kanuni za memo.

Fuatilia Uendeshaji katika Dashibodi ya Wakala

Ukiwa kwenye mzizi wa hifadhi, anzisha kiolesura kilichojengwa awali:

python3 ui/ui.py

Fungua http://127.0.0.1:8765 kwenye kivinjari. Dashibodi inaweza kuonyesha uendeshaji moja kwa moja, ikijumuisha kila mzunguko wa wakala, orodha yake hakiki, na jinsi vipengee vya orodha hakiki vinavyothibitishwa. Pia inaunga mkono hatua za warsha za utoaji wa ushahidi na idhini ya wakili.

Kipindi cha 2: Jaribu Kile Ambacho Wakala Alikosa

Kipindi cha 2 kinaanzisha ukaguzi wawili huru wa uthibitishaji. Mmoja hutathmini orodha hakiki dhidi ya ukweli msingi uliofichwa wa kesi. Mwingine hutathmini memo dhidi ya kanuni zake zinazohitajika.

Thibitisha memo

Kutoka agent/, badilisha RUN_ID na kitambulisho cha utekelezaji wa Session 1:

./helper verify RUN_ID --memo

Hii hufichua matatizo yanayotambuliwa na ukaguzi wa memo wa Session 1.

Thibitisha orodha hakiki

./helper verify RUN_ID --checklist

Hii hulinganisha orodha hakiki ya wakala na orodha hakiki halisi ya kesi hiyo. Ukweli halisi huhifadhiwa nje ya kesi na nafasi ya kazi ya wakala.

Unda ukaguzi wa uthibitishaji

Fuata maagizo ya Session 2 katika HANDBOOK.md ili kuunda ukaguzi wa orodha hakiki na memo. Linda mpaka wa uaminifu: ukaguzi huu lazima uendeshwe nje ya udhibiti wa wakala badala ya kumtegemea wakala kuidhinisha kazi yake yenyewe.

Endeleza Utekelezaji Ukiwa na Uthibitishaji

Unda tawi la utekelezaji wa awali wa Session 1 kutoka kwenye orodha hakiki yake iliyopo:

./helper branch RUN_ID

Mtiririko unaoendelea hujaribu mienendo inayozingatia uthibitishaji, ikiwemo kukataa, kupeleka suala kwa ngazi ya juu, kutoa ushahidi mpya, kuendelea tena, na idhini ya wakili. Kuunda tawi huhifadhi orodha hakiki kama mwanzo badala ya kuanza uchunguzi usiohusiana.

Toa ushahidi uliozuiwa

Utekelezaji unapofikia needs_input, tumia ulimwengu wa nje ulioigwa kutoa nyenzo za ufuatiliaji. Endesha amri hii kutoka kwenye mzizi wa hazina:

python3 world/release.py

Baada ya ushahidi kutolewa, endelea na mtiririko wa warsha na uangalie utekelezaji ulioendelea tena katika Dashibodi ya Wakala.

Vidokezo vya Juu

Linda mpaka wa nafasi ya kazi

Anzisha Muse Code kila mara kutoka agent/, si kutoka kwenye mzizi wa hazina. Hii huzuia Muse Code kuona chanzo cha kesi, ukweli halisi uliofichwa, ulimwengu ulioigwa, nakala za suluhisho, au msimbo wa kiolesura. Utenganishaji huu ni msingi wa mfumo wa uthibitishaji wa warsha.

Usimwonyeshe wakala ukweli halisi kamwe

Faili ground_truth/northbridge-v-caldera.json lipo kwa ajili ya ukaguzi wa orodha hakiki ya nje. Usilinakili kwenye kesi, usilijumuishe katika nafasi ya kazi ya Muse Code, wala usimpe wakala.

Tumia tena kanuni za msingi baada ya kuanzisha upya

Kikao cha Muse Code kilichoanzishwa upya au kipya hakiondoi hitaji la kutoa mwongozo wa kanuni za msingi. Unakili kutoka sehemu ya 1.7 ya HANDBOOK.md kila mara.

Ongeza kesi nyingine kwa kutumia mpangilio uliowekwa

Kesi mpya huwakilishwa na folda iliyo na faili ya objective.md na saraka ya documents/. Ihifadhi kesi nje ya agent/ na uelekeze CASE_DIR kwake. README haielezi hatua za ziada za kuunda kesi au ukweli halisi, hivyo fuata handbook kabla ya kupanua usanidi wa uthibitishaji.

Tumia nakala za suluhisho kwa uangalifu

Saraka za solutions/01_session1/ na solutions/02_session2/ hutoa nakala za vikao viwili. Kwa kuwa ziko nje ya nafasi ya kazi ya Muse Code, zinaweza kutumiwa kama marejeo ya warsha bila kuwa sehemu ya muktadha wa kazi wa wakala.

Marejeo ya Amri

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

Hitimisho

Warsha ya Wakala wa Kisheria inaonyesha pande zote mbili za uundaji wa wakala wa kisheria: kujenga wakala anayeweza kupanga, kuchunguza na kuandaa rasimu, pamoja na kuunda vidhibiti vya nje vinavyopima ikiwa kazi yake imekamilika na inatii mahitaji. Kwa kuweka kesi, ukweli halisi, rasilimali za uthibitishaji na ushahidi ulioigwa nje ya nafasi ya kazi ya Muse Code, mradi huu hufanya mpaka wa uaminifu uwe wazi na uweze kujaribiwa.