Yakha Futhi Uqinisekise I-ejenti Ye-AI Yezomthetho Nge-Legal Agent Workshop

Okwenziwa yi-Legal Agent Workshop

I-Legal Agent Workshop iphrojekthi esebenzayo eyenziwa ngezikhathi ezimbili yokwakha nokuhlola i-ejenti ye-AI yezomthetho. Ababambiqhaza baqala ngokusebenzisa umjikelezo wophenyo osekelwe kuma-ejenti bese bekhiqiza imemo yezomthetho engakaqinisekiswa. Bese bengeza ungqimba lokuqinisekisa olusebenza ngaphandle kolawulo lwe-ejenti.

Le ndawo yokugcina ikhodi inikeza ikhithi eseyakhiwe kusetshenziswa ikhodi elula ye-OpenAI Python SDK. Iqukethe ifayela elilodwa ngethuluzi ngalinye, ukufundwa kwamadokhumenti nge-Files API, kanye nohlelo lokuphatha amacala olulandelela amaqiniso ahlolwe ngezingcaphuno. Icala elifakiwe yi-northbridge-v-caldera, kodwa i-ejenti uqobo luhlala lujwayelekile futhi alinalo leli cala ngaphakathi.

Umthetho obalulekile wendawo yokusebenza: Qalisa i-Muse Code kuphela usuka ku-directory ye-agent/. Ama-directory e-cases/, world/, ground_truth/, solutions/, kanye ne-ui/ kufanele ahlale engaphandle kwendawo yokusebenza ye-Muse Code.

Izici Ezibalulekile

• I-ejenti yezomthetho ejwayelekile: I-ejenti ibhala uhlu lokuhlola, yakhe uhlelo, iphenye amadokhumenti, bese ikhiqiza imemo.
• Ukusebenzisa i-OpenAI Python SDK: Umjikelezo osekelwe kuma-ejenti usebenzisa ikhodi eqondile ye-SDK esikhundleni solunye uhlaka lwama-ejenti.
• Ukuhlaziya amadokhumenti: Ikhithi isebenzisa i-Files API ukufunda amadokhumenti ecala.
• Amaqiniso ahlolwe ngezingcaphuno: Uhlelo lokuphatha amacala lugcina amaqiniso kanye nezingcaphuno ezisekelayo.
• Ukuqinisekisa kwangaphandle: Ukuhlolwa kohlu lokuhlola nememo kwenziwa ngaphandle kolawulo lwe-ejenti.
• Ukuqhathanisa neqiniso eliyisisekelo: Umqinisekisi wohlu lokuhlola uqhathanisa umsebenzi we-ejenti nohlu lokuhlola oluqondene necala, oluyiqiniso eliyisisekelo futhi i-ejenti engakwazi ukulubona.
• Ukugeleza komsebenzi okuqhubekayo: Umsebenzi weSession 1 ungahlukaniswa bese uqhubekwa nokuqinisekisa okuvuliwe.
• Live Agent Console: Isixhumi esibonakalayo esesakhiwe ngaphambilini sibonisa izinguquko, izinto zohlu lokuhlola, ubufakazi obusekelayo, ukukhishwa kobufakazi, kanye nokusayinwa ngummeli.

Qonda Isakhiwo Sendawo Yokugcina Ikhodi

• HANDBOOK.md iqukethe imiyalelo yokusetha, izikhathi zombili ze-workshop, kanye nomyalezo wemithetho eyisisekelo ye-Muse Code esigabeni 1.7.
• agent/ iqukethe ikhodi yokuqala futhi iyona kuphela directory okufanele ivezwe njengendawo yokusebenza ye-Muse Code.
• cases/northbridge-v-caldera/ iqukethe inhloso yecala kanye namadokhumenti anikezwa i-ejenti.
• ground_truth/ iqukethe uhlu lokuhlola oluyimfihlo olusetshenziswa ekuqinisekiseni kwangaphandle. Akumele neze lufakwe ecaleni noma luboniswe i-ejenti.
• world/ imele umhlaba wangaphandle olingiswayo, okuhlanganisa amadokhumenti okulandelela agodliwe kanye neskripthi sokukhishwa kobufakazi.
• solutions/ iqukethe izithombe ezigciniwe zeSession 1 neSession 2.
• ui/ iqukethe i-Agent Console eseyakhiwe ngaphambilini futhi ihlala ingaphandle kwendawo yokusebenza ye-Muse Code.

Faka futhi Ulungiselele i-Workshop

1. Klona indawo yokugcina ikhodi

Klona iphrojekthi, bese ungena ku-directory ye-agent/ ngaphambi kokusetha noma ukwethula i-Muse Code.

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

2. Dala ifayela lendawo

Kopisha ukulungiselelwa okuyisibonelo uye ku-.env.

cp .env.example .env

Hlela i-.env bese ufaka i-MODEL_API_KEY yakho. Qinisekisa ukuthi i-CASE_DIR ikhomba ecaleni elifakiwe:

../cases/northbridge-v-caldera

3. Qalisa umsizi wokusetha

./helper setup

Umyalo wokusetha udala indawo ye-.venv ene-OpenAI Python SDK, ukopisha amadokhumenti ecala endaweni elindelekile, futhi uhlole ukhiye we-API omisiwe.

4. Qalisa i-Muse Code

Ngenkathi usesengaphakathi kwe-agent/, qalisa i-Muse Code:

muse

Umyalezo wakho wokuqala kufanele kube umyalezo wemithetho eyisisekelo osesigabeni 1.7 se-HANDBOOK.md. Thumela lowo myalezo futhi ngemva kokuqalisa kabusha ngakunye noma iseshini entsha ye-Muse Code.

Session 1: Yakha futhi Usebenzise i-Ejenti Yezomthetho

ISession 1 igxile ekusebenziseni umjikelezo ojwayelekile osekelwe kuma-ejenti kusetshenziswa ikhithi enikeziwe. Landela imiyalelo yesinyathelo ngesinyathelo eku-HANDBOOK.md ngenkathi ugcina wonke umsebenzi ngaphakathi kwe-agent/.

Ukugeleza komsebenzi okuhlosiwe yilokhu:

1. Yenza uhlu lokuhlola: Thola imibuzo nobufakazi okufanele uphenyo lukuhlanganise.
2. Hlela uphenyo: Nquma ukuthi ungawasebenzisa kanjani amathuluzi namadokhumenti ecala atholakalayo.
3. Phenya: Funda amadokhumenti ngokusebenzisa ukugeleza komsebenzi okunikeziwe, bese uqopha amaqiniso ahlolwe ngezingcaphuno ohlelweni lokuphatha amacala.
4. Lungisa umphumela: Qeda umsebenzi ngememo engakaqinisekiswa esekelwe ophenyweni.

Kulesi sigaba, imemo ayikaqinisekiswa ngamabomu. ISession 2 ikhombisa ukuthi umphumela we-ejenti obonakala uphelele ungase ushiye izinto ezidingekayo zohlu lokuhlola noma wephule imithetho yememo.

Buka Umsebenzi ku-Agent Console

Kusuka empandeni yendawo yokugcina ikhodi, qalisa isixhumi esibonakalayo esakhiwe ngaphambilini:

python3 ui/ui.py

Vula i-http://127.0.0.1:8765 esipheqululini. I-console ingabonisa umsebenzi bukhoma, okuhlanganisa ukushintshana ngakunye kwe-ejenti, uhlu lwayo lokuhlola, nokuthi izinto zohlu lokuhlola zifakazelwa kanjani. Iphinde isekele izigaba zokukhishwa kobufakazi nokusayinwa ngummeli ze-workshop.

Session 2: Hlola Okuphuthelwe yi-Ejenti

ISession 2 yethula ukuhlolwa okubili okuzimele kokuqinisekisa. Okukodwa kuhlola uhlu lokuhlola kuqhathaniswa neqiniso eliyisisekelo elifihliwe lecala. Okunye kuhlola imemo kuqhathaniswa nemithetho yayo edingekayo.

Qinisekisa imemo

Kusuka ku-agent/, shintsha u-RUN_ID ufake isihlonzi sokuqalisa kweSeshini 1:

./helper verify RUN_ID --memo

Lokhu kuveza izinkinga ezitholwa ukuhlolwa kwememo yeSeshini 1.

Qinisekisa uhlu lokuhlola

./helper verify RUN_ID --checklist

Lokhu kuqhathanisa uhlu lokuhlola lomenzeli nohlu lokuhlola oluyiqiniso oluqondene necala. Iqiniso eliyisisekelo lihlala lingaphandle kwecala nasendaweni yokusebenza yomenzeli.

Yakha ukuhlola kokuqinisekisa

Landela imiyalelo yeSeshini 2 eku-HANDBOOK.md ukuze wakhe ukuhlolwa kohlu lokuhlola nememo. Gcina umngcele wokwethembana: lokhu kuhlola kufanele kusebenze ngaphandle kolawulo lomenzeli, kunokuthembela kulo menzeli ukuthi avumele umsebenzi wawo.

Qhubeka Nokuqalisa Ukuhlola Kunikwe Amandla

Yakha igatsha lokuqalisa kwasekuqaleni kweSeshini 1 usebenzisa uhlu lwayo lokuhlola olukhona:

./helper branch RUN_ID

Ukuhamba komsebenzi okuqhubekayo kuhlola ukuziphatha okuqaphela ukuqinisekiswa, okuhlanganisa ukwenqaba, ukukhuphula udaba, ukukhishwa kobufakazi obusha, ukuqhubeka, nokusayinwa kommeli. Ukwakha igatsha kugcina uhlu lokuhlola njengesiqalo, esikhundleni sokuqala uphenyo olungahlobene.

Khipha ubufakazi obubanjwe

Lapho ukuqaliswa kufinyelela ku-needs_input, sebenzisa umhlaba wangaphandle olingisiwe ukuze ukhiphe izinto zokulandelela. Qalisa lo myalo usuka empandeni yenqolobane:

python3 world/release.py

Ngemva kokukhishwa kobufakazi, qhubeka nokugeleza komsebenzi weshabhu bese ubheka ukuqaliswa okuqhubekile ku-Agent Console.

Izeluleko Ezithuthukile

Vikela umngcele wendawo yokusebenza

Njalo qala i-Muse Code usuka ku-agent/, hhayi empandeni yenqolobane. Lokhu kuvimbela i-Muse Code ukuthi ibone umthombo wecala, iqiniso eliyisisekelo elifihliwe, umhlaba olingisiwe, izithombe zezixazululo, noma ikhodi ye-UI. Lokhu kwehlukaniswa kubalulekile kumodeli yokuqinisekisa yeshabhu.

Ungalokothi uveze iqiniso eliyisisekelo kumnenzeli

Ifayela elithi ground_truth/northbridge-v-caldera.json likhona ukuze kusetshenziswe ukuhlolwa kohlu lokuhlola kwangaphandle. Ungalikopishi uliyise ecaleni, ungalifaki endaweni yokusebenza ye-Muse Code, futhi ungalinikezi umenzeli.

Phinda usebenzise imithetho eyisisekelo ngemva kokuqalisa kabusha

Iseshini ye-Muse Code eqalwe kabusha noma esanda kwakhiwa ayisusi imfuneko yokunikeza umyalo wemithetho eyisisekelo. Uwukopishe esigabeni 1.7 se-HANDBOOK.md njalo.

Faka elinye icala usebenzisa ukwakheka okumisiwe

Icala elisha limelelwa yifolda equkethe ifayela elithi objective.md kanye nohlu lwemibhalo oluthi documents/. Gcina icala lingaphandle kwe-agent/ bese ukhomba i-CASE_DIR kulo. I-README ayicacisi ezinye izinyathelo zokubhala amacala noma zokukhiqiza iqiniso eliyisisekelo, ngakho landela i-handbook ngaphambi kokwandisa ukusethwa kokuqinisekisa.

Sebenzisa izithombe zezixazululo ngokucophelela

Izinkomba ze-solutions/01_session1/ kanye ne-solutions/02_session2/ zinikeza izithombe zezikhathi ezimbili. Njengoba zingaphandle kwendawo yokusebenza ye-Muse Code, zingasetshenziswa njengezinkomba zeshabhu ngaphandle kokuzenza ingxenye yomongo wokusebenza wommenzeli.

Inkomba Yemiyalo

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

# Kusuka empandeni yenqolobane
python3 ui/ui.py
python3 world/release.py

# Kusuka ku-agent/
./helper verify RUN_ID --memo
./helper verify RUN_ID --checklist
./helper branch RUN_ID

Isiphetho

I-Legal Agent Workshop ikhombisa izinhlangothi zombili zokuthuthukiswa kommeleli wezomthetho: ukwakha umenzeli okwazi ukuhlela, ukuphenya, nokubhala uhlaka, kanye nokwakha izilawuli zangaphandle ezihlola ukuthi umsebenzi wawo uphelele futhi uyahambisana yini nemithetho. Ngokugcina amacala, iqiniso eliyisisekelo, izinsiza zokuqinisekisa, nobufakazi obulingisiwe kungaphandle kwendawo yokusebenza ye-Muse Code, iphrojekthi yenza umngcele wokwethembana ubonakale futhi uhlolwe.