Qondisa Imisebenzi Yama-Agent E-AI Nge-Sprix SAGE Router

Yini i-Sprix SAGE Router?

I-Sprix SAGE Router iphrojekthi yocwaningo ye-Python enomthombo ovulekile yokunquma ukuthi ama-ejenti e-AI kufanele awenze kanjani umsebenzi ngemva kokuba umsebenzi usuqalile. I-SAGE imele State-Aware Graph Exchange. Isebenza phakathi kokutholwa kwama-ejenti nokwenziwa komsebenzi, ikhethe ukucushwa kwama-ejenti okungenzeka, icabangele inqubekelaphambili yamanje, amakhono, izimvume, izindleko, ukubambezeleka, ukuncika, nokulahleka kokudluliswa komongo.

I-router iqhathanisa izindlela ezintathu zokwenza umsebenzi:

• SELF: I-ejenti ekhona iyaqhubeka iyodwa lapho amakhono ayo nomongo ewubuthile kwanele.
• COLLABORATE: I-ejenti ekhona igcina ubunikazi bomsebenzi, kuyilapho ama-ejenti ahambisanayo evala izidingo ezingekho.
• HANDOFF: Omunye umngane uthatha ubunikazi obuphelele lapho inzuzo yakhe yobungcweti idlula izindleko zokudlulisa umongo.

I-SAGE yakhelwe ukusebenza ngaphezu kwe-phrothokholi ye-Agent2Agent. I-A2A ichaza ama-Agent Card asebenzisanayo, imisebenzi, imilayezo, izinto ezikhiqiziwe, ukuqinisekiswa kobunikazi, kanye nezindlela zokuthutha. I-SAGE iphendula umbuzo ohlukile: yikuphi ukucushwa okufanelekile okufanele kwenze umsebenzi, ngayiphi indlela, futhi ngani?

I-prototype yamanje ibuyisa izinqumo zokuqondisa. Ayidluliseli imisebenzi kuma-ejenti, ngakho iklayenti le-A2A noma olunye ungqimba lokwenza umsebenzi kufanele lusebenzise umzila okhethiwe.

Izici ezibalulekile zokuqondisa

I-SAGE ihlanganisa ukuqondisa, ukuhlela, nokufunda ku-inthanethi enqubweni eyodwa yesinqumo ehlolisisekayo. Izici zayo eziyinhloko zihlanganisa:

• Ukuqondisa ngezindlela ezintathu: Abakhethwayo be-SELF, COLLABORATE, ne-HANDOFF bancintisana ngaphansi kwenhloso efanayo yokusetshenziswa.
• Ukuhlela kabusha okuqaphela inqubekelaphambili: Inqubekelaphambili eqoqiwe, abenzi abasebenzayo, ukwehluleka, ama-node omsebenzi aqediwe, kanye nomongo odlulisekayo kungathinta ukuthi ukushintsha kuyazuzisa yini.
• Ukukhetha iqembu elihambisanayo: Amaqembu aklonyeliswa ngokwengeza ukumbozwa kwezidingo, kunokuqoqela ama-ejenti asezingeni eliphezulu aphindaphindayo.
• Ukwethenjwa okusekelwe kumongo: Ukuthembeka kufundwa ku-ejenti ngayinye nasesidingweni ngasinye, kunokwehliselwa kumaphuzu odumo omhlaba wonke.
• Ukuhlela kwe-Task-DAG: Izidingo zinikezwa abenzi, kuyilapho imiphetho yokuncika inquma ukuhleleka kokwenziwa, ukwakheka kokuxhumana, kanye nokubambezeleka kwendlela ebalulekile.
• Ukusesha okulinganiselwe: Ukusesha kwe-beam kuhlola iziqalo zamaqembu amaningana okubambisana kunokwenza ukukhetha okukodwa okuhahela inzuzo esheshayo.
• Ukuhlunga okubeka imigoqo kuqala: Ama-ejenti angafanele ayasuswa ngaphambi kokubekwa ezingeni, kungakhathaliseki ikhwalithi yawo ebikezelwe.
• Ukufunda okuqaphela ubufakazi: Amaphuzu ezidingo, izindleko zangempela, kanye nokubambezeleka kwangempela kungabuyekeza ukwethenjwa, ukuhambisana, imodeli yempumelelo, kanye nokunemba kwamabhidi.
• Imiphumela ehlolisisekayo: Izinqumo ziveza indlela ekhethiwe, izabelo, ukwakheka kokuxhumana, impumelelo ebikezelwe, ukumbozwa, izindleko, ukubambezeleka, ubungozi, ukusetshenziswa, kanye nesizathu.

Indlela i-algorithm ehlola ngayo umzila

Ngesidingo ngasinye somsebenzi, i-SAGE ihlanganisa ukwethenjwa komhlaba wonke nokwethenjwa okuhambisana nesidingo ukuze ilinganisele ikhono le-ejenti elilinganiselwe. Ukumbozwa kweqembu kuyanda lapho amalungu enikeza ikhono eliwusizo nelingaphindaphindiwe. Isidingo ngasinye esisele sinikezwa ilungu leqembu elinamandla kakhulu ngokwesilinganiso.

Umhleli uhlonipha i-DAG yezidingo. Umsebenzi onikezwe i-ejenti eyodwa wenziwa ngokulandelana, kuyilapho umsebenzi ozimele onikezwe ama-ejenti ahlukene ungasebenza ngokuhambisana. Ngemva kokwakha iqembu elingenele, i-SAGE ihlola izindleko zeqembu kanye nokubambezeleka kwendlela ebalulekile uma kuqhathaniswa nesabelomali nomnqamulajuqu womsebenzi.

Abakhethwayo abangenzeka babekwa ezingeni ngomsebenzi wokusetshenziswa olinganisa inani lempumelelo elibikezelwe nezindleko, ukubambezeleka, ubungozi, ukulahleka kokudluliswa komongo, izindleko zokuxhumanisa, kanye nokungaqiniseki. Lokhu kuvumela uchwepheshe onamandla ukuthi ahlulwe yi-ejenti ekhona lapho ukudlulisa kungalahla umongo omningi owusizo. Kuphinde kuvumele iqembu elihambisanayo ukuthi linqobe iqoqo lama-ejenti elidumile kodwa eliphindaphindayo.

Faka futhi uqinisekise iphrojekthi

Okudingekayo ngaphambi kokuqala

Ukuqaliswa okuyisithenjwa kudinga Python 3.10 noma entsha. Ngokwe-README yephrojekthi, akunazo izincike zangempela zokuqalisa.

Clone inqolobane

git clone https://github.com/wang2122/sprix-sage-router.git
cd sprix-sage-router
python demo.py

I-script ye-demo.py inikeza isibonelo esifundeka kalula esisuka ekuqaleni kuye ekugcineni. Ngenxa yokuthi inqolobane iveza ukuqaliswa kwayo ngqo nge-sprix_sage.py, ukuqala ngokushesha akudingi umyalo ohlukile wokufaka iphakheji.

Qalisa izivivinyo ne-benchmark

python -m unittest -v
python benchmark.py

Izivivinyo zamayunithi ziqinisekisa ukuziphatha okulindelekile kwe-router. I-benchmark iqhuba isimulathayi sangaphandle esingesona esiqondile kuzo zonke izinhlamvu zembewu ezinqunyiwe, ivumele izinguqulo ezimile neziku-inthanethi ze-SAGE ziqhathaniswe namasu okuqondisa alula.

Dala isimo sakho sokuqala sokuqondisa

Isinyathelo 1: Ngenisa izinhlobo eziyinhloko

from sprix_sage import (
    Agent,
    ExecutionOutcome,
    Requirement,
    SAGERouter,
    Task,
)

Lesi sibonelo sisebenzisa i-Agent ukuchaza abakhethwayo, i-Requirement ne-Task ukuchaza umsebenzi, i-SAGERouter ukukhetha umzila, kanye ne-ExecutionOutcome ukubuyisa ubufakazi ngemva kokwenziwa.

Isinyathelo 2: Chaza ama-ejenti atholakalayo

agents = [
    Agent(
        "planner",
        {"planning": 0.92, "coding": 0.55},
        cost=0.08,
        latency_ms=900,
    ),
    Agent(
        "coder",
        {"planning": 0.35, "coding": 0.96},
        cost=0.12,
        latency_ms=1200,
    ),
]

I-ejenti ngayinye inesikhombi, i-vector yamakhono, isilinganiso sezindleko, kanye nesilinganiso sokubambezeleka. Lapha, planner inamandla ekuhleleni, kanti coder inamandla kakhulu ekubhaleni ikhodi. Lo mehluko unikeza i-SAGE isizathu sokucabangela ukubambisana noma ukudlulisela umsebenzi, esikhundleni sokubeka ama-ejenti ezingeni ngokwesikolo esisodwa esiphelele.

Isinyathelo 3: Yakha imodeli yezidingo nokuncik依

task = Task(
    "build-feature",
    requirements=(
        Requirement("planning", 0.4),
        Requirement(
            "coding",
            0.6,
            depends_on=("planning",),
        ),
    ),
    value=1.0,
    budget=0.30,
    deadline_ms=4000,
    progress=0.35,
)

Umsebenzi uqukethe izidingo ezimbili ezinesisindo. Isidingo sokubhala ikhodi sincike ekuhleleni, sakhe i-DAG encane lapho ukuhlela kufanele kuqedwe ngaphambi kokubhala ikhodi. Umsebenzi uphinde unikeze amanani adingekayo ekuqondiseni okunemikhawulo:

• value imele inani lokuqedwa ngempumelelo.
• budget ibeka umkhawulo wezindleko ezamukelekayo.
• deadline_ms ibeka umkhawulo wokubambezeleka okuhleliwe.
• progress yazisa i-router ukuthi ukwenziwa komsebenzi sekufinyelele kumaphesenti angu-35.

Inqubekelaphambili ibalulekile ngoba ukushintsha ubunikazi ngesikhathi umsebenzi uqhubeka kungadala ukulahleka komongo odluliswayo. Ngakho-ke, inzuzo yekhono likachwepheshe ayenzi ngokuzenzakalelayo ukudlulisela umsebenzi kube yindlela engcono.

Isinyathelo 4: Qondisa umsebenzi

router = SAGERouter(
    agents,
    incumbent_id="planner",
)

decision = router.route(task)

print(decision.mode)
print(decision.assignments)
print(decision.topology)

Umnikazi wamanje yi-ejenti ephethe umsebenzi njengamanje. Ukubiza route kuqhathanisa abazongenela abafanelekile bezindlela ze-SELF, COLLABORATE, kanye ne-HANDOFF. Isinqumo esibuyisiwe singahlolwa ngezinkambu ezifana nalezi:

• decision.mode yendlela yokwenza ekhethiwe.
• decision.assignments yezabelo zezindima ezisuka ezidingweni ziye kuma-ejenti.
• decision.topology yesakhiwo sokuxhumana esidalwe ukuncika.

Ungacabangi ukuthi lesi simo kufanele ngaso sonke isikhathi sikhiqize indlela ethile. Umphumela uncike ezilinganisweni ezilungiswe yi-router, emikhawulweni, enqubekelaphambili, nasezifundweni ezitholiwe.

Funda emiphumeleni yokwenziwa

Ukuqondisa kuyingxenye yokuqala kuphela yenqubo. Ngemva kokuba ama-ejenti akhethiwe enze umsebenzi, buyisela ubufakazi obuqine kakhulu obutholakalayo ku-router:

router.record_outcome(
    decision,
    ExecutionOutcome(
        success=0.9,
        requirement_scores={
            "planning": 0.95,
            "coding": 0.86,
        },
        actual_cost=0.19,
        actual_latency_ms=1450,
    ),
)

Inani lempumelelo lilonke linikeza i-router umphumela osezingeni lomsebenzi. Izikolo eziqondene nezidingo zinikeza ukwabiwa kwekhredithi okunembe kakhulu, zivimbele ilungu ngalinye leqembu ekutholeni ikhredithi efanayo. Izindleko zangempela nokubambezeleka kusiza ukulungisa izibikezelo zesikhathi esizayo nezilinganiso zabahlinzeki.

Ukuqondisa okuphindaphindiwe nempendulo kuvumela i-SAGE esebenza ku-inthanethi ukuthi ithuthukise ukwethembana komongo, imiphumela yamapheya, izibikezelo zempumelelo, nokunemba kwezilinganiso. Ukuze ukufunda kube wusizo, rekhoda imiphumela ngokungaguquguquki futhi ukhethe ubufakazi obulinganisiwe kunamalebula empumelelo ajwayelekile noma nini lapho lobo bufakazi butholakala.

Hlanganisa i-SAGE nohlelo lwe-A2A

Ukuhlanganiswa kokukhiqiza kungahumushela amasiginali ephrothokholi nawemakethe abe yizethulo zangaphakathi ze-SAGE:

• Hlela ngokujwayelekile AgentCard.skills ube ama-vector wamakhono.
• Sebenzisa izidingo zokuphepha njengezihlungi eziqinile zezimvume.
• Hlola izindlela zokufaka nokukhipha ezisekelwayo ukuze uqinisekise ukuhambisana ngaphambi kokwenza amaphuzu.
• Guqula isimo somsebenzi, ama-artifact, ama-node e-DAG aqediwe, nokwehluleka kube isimo samanje sokwenziwa kanye nezilinganiso zokulahleka kokudlulisa.
• Yethula izilinganiso zabahlinzeki njengamabhidi aqukethe izindleko, ukubambezeleka, nokuzethemba.
• Sebenzisa ukuhlolwa kwemisebenzi eqediwe ukuze ubuyekeze ukwethembana komongo, izinsalela zamapheya, izibikezelo zempumelelo, nokunemba kwamabhidi.

Uma i-SAGE isibuyise isinqumo, iklayenti le-A2A lingasenza lisebenzisa imisebenzi yephrothokholi efana nokuthumela imilayezo, ukusakaza, ukuhlola umsebenzi ngezikhathi ezithile, noma ukuwukhansela. Gcina umngcele ucacile: i-SAGE ikhetha futhi ichaze indlela, kanti ungqimba lwe-A2A luphatha ukuxhumana nokwenziwa.

Amathiphu okusebenzisa athuthukile

Yenza umsebenzi ube yi-DAG enenjongo

Sebenzisa ukuncika ukuze umele ukulandelana kwangempela kokwenziwa, esikhundleni sokubeka zonke izidingo ohlwini oluyisicaba. Ukuncika okunembile kwenza i-SAGE ihlukanise umsebenzi olandelanayo kowenziwa ngokufana futhi ikhiqize isilinganiso esiwusizo kakhulu sokubambezeleka komzila obucayi.

Khetha izincazelo zamakhono ezihambisanayo

Chaza ama-ejenti ngamakhono asezingeni lezidingo. Isikolo esisodwa esibanzi singafihla umehluko phakathi kokuhlela, ukubhala ikhodi, ucwaningo, noma amanye amakhono, futhi sinciphise ukwethembana komongo nokwabiwa kwezindima.

Phatha izimvume njengemikhawulo eqinile

Ungasebenzisi ikhwalithi ebikezelwe ukweqa imithetho yokufinyelela. Idizayini ye-SAGE eqala ngezimvume ilindele ukuthi ama-ejenti angafaneleki akhishwe ngaphambi kokubekwa kwabangenele umncintiswano ezingeni. Ukuhambisana, ukuqinisekiswa kobunikazi, nokuhlolwa kwezinqubomgomo nakho kufanele kwenzeke ngaphambi kokwenziwa.

Sebenzisa amabhajethi nezikhathi zokugcina ezinengqondo

I-SAGE ihlola imikhawulo ngesikhathi kwakhiwa abangenele umncintiswano futhi iphinde ihlole ezingeni leqembu. Nikeza amabhajethi nezikhathi zokugcina eziqondene nomsebenzi ukuze iqoqo lama-ejenti elikhangayo ngalinye lingakhethwa lapho izindleko zalo ezihlanganisiwe noma umzila walo obucayi kungenzeki.

Hlola izinqumo esikhundleni sokusebenzisa imodi kuphela

Buyekeza izabelo, i-topology, ukumbozwa, impumelelo ebikezelwe, izindleko, ukubambezeleka, ubungozi, usizo, kanye nesizathu. Umlando wokucwaninga ungaveza ukuthi indlela ikhethwe ngenxa yokuhambisana kwangempela, ukugcina umongo womnikazi wamanje, ukulahleka kokudlulisa okuphansi, noma ukufaneleka ngaphansi kwemikhawulo.

Linganisa ukunemba kwezilinganiso

Buyisa izindleko zangempela nokubambezeleka ngemva kokwenziwa. Ngaphandle kwamanani abonwe ekusebenzeni, i-router inobufakazi obuncane bokunquma ukuthi ukuzethemba, intengo, nesikhathi esicashuniwe kuthembekile yini.

Hlola ukuvumelana kwezinto usebenzisa usizo olufanayo

Ibhentshimakhi yokwenziwa efakiwe ibika ukuthi i-SAGE esebenza ku-inthanethi ifinyelela ikhwalithi elingisiwe ephezulu kanye nosizo olufanayo olungcono kunezisekelo eziqhathaniswayo ezibalwe, kodwa isebenzisa okungaphezu kwe-SAGE emile. Lokhu kuvumelana kwezinto okubonakalayo kubalulekile: uku-routing akufanele kufihle izindleko ngemuva kwamaphuzu asekelwe emandleni kuphela.

Ibhentshimakhi yenziwe ngokulingisa futhi ayibubufakazi bokuphakama ekusetshenzisweni kwangempela. Ukuhlola ukuthunyelwa kwangempela kudinga ukwenziwa okumele izimo zangempela, izisekelo eziqinile ze-routing, ukuhlaziywa kokulinganisa, ukuphindaphindwa kwamarekhodi emakethe, ama-agent ahlukahlukene, nezimo eziphikisanayo.

Qonda imikhawulo yokubuka kuqala kocwaningo

I-SAGE iwukubuka kuqala kocwaningo olusesigabeni sokuqala, hhayi isiqinisekiso sezinga lesevisi yokukhiqiza noma umphumela obuyekezwe ontanga. Inqubomgomo yayo efundwe kancane ayithathi indawo yokuqeqeshwa ngamarekhodi angempela noma ukuhlolwa kwe-causal off-policy.

Ngaphambi kokuthunyelwa ekukhiqizeni, i-README incoma abahloli abalungiswe kahle, ubuwena obuqinisekisiwe, imethadatha yamakhono esayiniwe, ukubuyekezwa kobumfihlo nokuphepha, ukubuyiselwa okuqhubekayo okuqhutshwa imicimbi, ukuqapha, nokuqinisekiswa okuqondene nomsebenzi. Ama-adapter angempela okuthola i-A2A, ukwenza, ukusakaza, nokukhansela aseyizinto ezisohlelweni lwesikhathi esizayo, njengoba kunjalo nokusebenza kwesevisi esabalalisiwe namasango okugunyazwa ngabantu.

Izinsiza zekhosombe

• sprix_sage.py iqukethe i-contextual router, umhleli we-DAG, ukusesha kwe-beam, nezibuyekezo eziku-inthanethi.
• demo.py inikeza isibonelo esiphelele kusukela ekuqaleni kuze kube sekugcineni.
• benchmark.py iqukethe isimuli sangaphandle nezisekelo zosizo olufanayo.
• test_sprix_sage.py iqukethe ukuhlolwa kwamayunithi kokuziphatha.
• I-ALGORITHM.md ichaza inhloso esemthethweni, inqubo yokusesha, ukwabiwa kwekhredithi, nemikhawulo.
• Ikhosombe le-GitHub liqukethe ulwazi lokunikela, ukuphepha, ukuphathwa, nelayisensi.

Isiphetho

I-Sprix SAGE Router inikeza ukuqaliswa okuyisethenjwa okusebenzayo kokufanisa ama-agent okuqaphela isimo. Ngokumela umsebenzi njengama-DAG ezidingo, uqhathanisa i-SELF, i-COLLABORATE, ne-HANDOFF ngaphansi kwemikhawulo efanayo, futhi ubuyisele ubufakazi bokwenziwa ku-router, ungazama izinqumo zama-agent amaningi ezihlolisisekayo ezicabangela kokubili ikhwalithi ebikezelwe nezindleko zokusebenza.

Qala nge-demo.py, phinda ukhiqize isibonelo esincane, hlola zonke izinqumo ze-routing, bese usebenzisa izivivinyo nebhentshimakhi yokwenziwa. Ukuze uthumele i-A2A yangempela, engeza i-adapter ehlukile yokwenza bese uqedela umsebenzi wokuqinisekisa, ukuphepha, ukubonakala kokusebenza, ukubuyiselwa, nokuqinisekiswa odingwa yindawo yakho.