Premye jou a te demonte yon chatbot sou yon tablo blan epi bay chak pyès yon non: entèfas, sèvo, memwa, pèsonalite, chemen desizyon, zouti. Sis konpozan, pou pèsonn nan sal la pa t ka itilize mo chatbot san yo pa konnen sa ki anndan youn.
The bot is the GPS, ("Bot la se GPS la,") T. Valerie Onu te di yo premye maten sa a. The human is the driver. ("Moun nan se chofè a.")
Tout sa k te vin apre te bati sou ankadreman sa a. Yon bot diksyonè ki te konekte yon kesyon ak yon repons ki estoke, ak dekouvèt rapid sou jan sa te ka pote ti kras. Baryè pwoteksyon, pou l te refize olye l enpwovize. Golden Record la, pou chak fè te rive ak yon sous ak yon dat atache. Rekiperasyon, pou repons lan te soti nan yon dokiman kliyan an posede olye nan memwa modèl la sou entènèt la.
Nan kòmansman katriyèm semèn nan, patisipan kan yo te gen yon bon bot. Men li te gen yon sèl fòm, e fòm nan pa t janm varye: yon kesyon rive, sistèm nan al chèche yon bagay, yon repons tounen.
Yon tou. Yon desizyon. Yon responsablite.
Travay reyèl pa rive nan fòm sa a.
Anvan AI a, sikui travay la
Pwochen etap la pa t teknik ditou.
Yo te mande patisipan kan yo gade pwosesis biznis òdinè, ki anniye — kalite pwosesis tout moun te deja fè liy ladan yon lè — epi demonte yo kòm sikui travay. Pa "aplike pou yon prè" kòm yon sèl evènman, men kòm yon sekans: kiyès ki manyen l, nan ki lòd, kisa chak moun bezwen nan men l anvan li ka aji, e kisa k rive lè bagay li bezwen an pa la.
Dènye kesyon sa a te vin tounen tout sijè a.
Yo te pratike sou similasyon anvan yo t al pre pwoblèm yon kliyan, e similasyon yo te fèt espre pou yo te amizan — bay yon pas festival, fè yon demann pase de bout an bout, fè sekans lan avanse etap pa etap epi gade sa k ap anpile sou klipbòd pataje a pandan l ap avanse. Valè yon similasyon se ke ou ka fè l ankò, e kase l espre. Pèsonn pa gen dwa fè sa ak yon bank.
Kase l espre, se la aprantisaj la te vrèman chita. Yon sikui travay ki toujou mache san pwoblèm pa aprann anyen, paske chak pwosesis reyèl pase pi fò nan lavi l nan eksepsyon yo. Kidonk chak similasyon te vini ak echèk li yo deja ladan l: pas festival kote prèv laj la manke. Peman ki echwe. Dokiman idantite a ki twò twoub pou moun li.
Se sèlman lè sa a otomatizasyon te rive — e li te rive kòm yon kesyon olye yon zouti. Ki etap nan sa yo yon sistèm ta ka pran? Kiyès yon moun dwe kenbe? E kisa ki dwe rive nan moman egzak yon etap pa ka fini?
Tariq se kote kesyon sa a te jwenn egzanp travay li.
Tariq bezwen yon prè
Se tout premis la, e li espre òdinè. Li antre nan yon bank — oswa li louvri yon fenèt chat, sa ki, an 2026, se menm bagay la — epi li mande lajan pou l fè yon biznis grandi. Sa k rive apre a se pa yon kesyon ak yon repons. Se yon sekans, e chak etap ladan l se pou yon moun diferan.
Yon moun dwe akeyi l epi konprann kisa li bezwen toutbon. Yon moun dwe etabli kiyès li ye ak ki kalite kliyan li ye. Yon moun dwe chèche sa pwòp règ bank lan di sou prè. Yon moun dwe verifye règ sa yo kont dokiman li yo. Si yon bagay manke, yon moun dwe retounen mande l li — sa vle di sekans lan dwe kapab fè bak. Yon moun dwe enspekte rezilta a anvan li soti. E yon moun dwe remèt Tariq li nan yon langaj li ka itilize.
Mande yon sèl chatbot fè tout sa e l ap eseye. Li pral tou, yon kote nan mitan an, envante yon règ prè san fè bri.
Poukisa nou te ansenye l kòm yon ekipaj
Se nan moman sa a kan an sispann ansenye chatbot AI jeneratif e li kòmanse ansenye jeni AI ajantik.
Yon ekipaj se pa yon chatbot ak plis prompt. Se menm pwoblèm nan divize an travay ki gen non, chak ak pwòp antre li, pwòp kontrent li ak pwòp dwa pou l refize. Tariq's Digital Crew (Ekipaj Dijital Tariq la) te bay travay sa yo figi: Grace akeyi, Marcus fè pwofil la, Ava al chèche sa règ yo di, Daniel verifye konfòmite, Maya fè entèvyou lè yon bagay manke, Theo enspekte, Zara remèt rezilta a.
Sèt ajan, yon sèl klipbòd pataje, e — pati ki pi enpòtan an — yon lyen ki fè bouk an aryè. Lè Daniel jwenn yon dokiman manke, travay la pa echwe e li pa kontinye. Li retounen bay Maya, ki mande Tariq bagay ki manke a, e se sèlman lè sa a li avanse.
Rakonte kòm yon istwa anvan
Okenn nan sa pa pase kòm yon dyagram achitekti yon madi maten.
Kidonk yo te ansenye l kòm yon istwa. Kan an te kreye bann desine pou ajan yo, bay chak youn yon karaktè anvan li te janm yon fonksyon, e li te pwodui yon videyo ki swiv vwayaj Tariq depi demann lan jiska repons lan. Patisipan kan yo te rankontre Grace, Daniel ak Maya kòm moun ki gen yon travay anvan yo te rankontre yo kòm ne nan yon graf.
Lòd sa a se te pwen an. Yon jèn kenzan ki swiv demann Tariq la nan sèt pè men deja konprann transfè, eta ak routaj kondisyonèl — li jis poko konnen se mo sa yo. Lè kòd la rive, se pa yon nouvo lide. Se lide pa l, ekri an Python.
Answit, pati ki difisil la
Rakonte istwa mennen w jiska lide a. Li pa mennen w jiska yon sistèm pwodiksyon, e kan an pa t fè kòmsi.
Framework kote yo te mennen patisipan kan yo se te LangGraph, e li vo lapenn pou n presi sou sa sa vle di, paske li fasil pou n sipoze yon pwogram ete ap pran zouti ki pi dous la. Li te fè kontrè a.
LangGraph se yon framework ba nivo. Nan jeni lojisyèl, ba nivo vle di kontwòl detaye ak kòd ki pi eksplisit — yo pa ba w abstraksyon ki reflechi pou ou. Kote yon framework wo nivo kite yon devlopè deklare wòl yon ajan an angle senp epi fè modèl la konfyans pou l jwenn etap yo, LangGraph egzije pou twa bagay ekri alamen:
Nodes (ne yo) — blòk kòd egzak oswa apèl modèl ki egzekite yon aksyon.
Edges (lyen yo) — lojik kondisyonèl ak chemen desizyon ki konekte aksyon sa yo, enkli sa yo ki fè bouk an aryè.
State (eta a) — yon chema santral ki anrejistre egzakteman sa ekipaj la konnen nan nenpòt moman.
Paske li pa kache anyen nan sa dèyè abstraksyon pratik, li bay yon kontwòl absoli sou bouk yo, sou oto-koreksyon ak sou entèvansyon yon moun nan bouk la. Kontwòl sa a se tout rezon antrepriz yo chwazi l. Lè yon ajan k ap alisine ka fè yon bank pèdi lajan, ou vle yon machin eta ak limit strik, pa yon pilòt otomatik ki ka pèdi wout.
Poukisa ba nivo, egzakteman
Kan an te ka pran yon framework wo nivo. Sa t ap pi rapid, pi dous, e li t ap pwodui yon bagay pou montre depi apremidi a. Li te chwazi pa fè sa, e rezon an se te sekirite.
Nan yon framework wo nivo, se modèl la ki deside sa k ap rive apre. Se sa ki fè l vann — dekri yon wòl, e sistèm nan jwenn etap yo. Se tou, egzakteman, sifas atak la.
Enjeksyon prompt mache lè yon moun rive mete tèks nan kontèks yon modèl ke modèl la trete kòm enstriksyon. Si modèl la jis ap ekri yon repons, yon enjeksyon ki reyisi pwodui yon move repons. Si modèl la ap chwazi wout la tou, yon enjeksyon ki reyisi chwazi wout la: sote verifikasyon konfòmite a, rive sou yon zouti li pa t janm sipoze touche, bay yon chif pèsonn pa t verifye. Yon sèl enstriksyon manipile, e reyon eksplozyon an se tout sikui travay la.
Ekri graf la eksplisitman e kalite atak sa a pa gen kote pou l ale. Yon enjeksyon ka toujou kòwonp sa yon ne di. Li pa ka envante yon lyen ki pa egziste. Li pa ka kontoune Daniel, paske Daniel se pa yon sijesyon — se yon ne trafik la oblije pase ladan l. Li pa ka rele yon zouti graf la pa janm konekte. Otorite modèl la sispann nan limit ne l ap fonksyone anndan l lan.
Se sa ranfòsman sekirite vle di isit la. Pa yon filt yo boulonnen apre, men yon achitekti kote chemen danjere yo pa t janm konstwi.
Se sa tou ki te fè laboratwa nevyèm jou a vo lapenn. Patisipan kan yo te pase yon sesyon ap eseye fè jailbreak pwòp bot yo, e egzèsis sa a aprann ou yon bagay sèlman si gen yon estrikti pou teste kont li. Kase yon pilòt otomatik e ou pwouve yon modèl ka konvenk pou l fè bagay, sa tout moun te deja konnen. Kase yon graf ki kode e ou jwenn egzakteman ki ne ki te fè fwit ak presizeman kisa li te gen dwa rive jwenn — yon rezilta ase etwat pou w ka korije l.
E se poutèt sa CUB-VA te ka deklare envaryan li a osi kareman: ke li p ap janm mande, estoke oswa revele enfòmasyon idantifikasyon bankè konfidansyèl — pa gen nimewo kont, pa gen modpas, pa gen balans. Yon ajan ki deside pwòp pwochen etap li pa ka pwomèt sa onètman. Yon ajan ki mache sèlman sou chemen yon moun te ekri ka fè l.
Sa sa mande yon aprenan toutbon
LangGraph se yon aplikasyon dirèk teyori graf ak machin eta sou AI jeneratif. Pou itilize l byen, ou bezwen graf oryante ak graf siklik, pèsistans done ak pwogramasyon asenkwòn — fondamantal syans enfòmatik, pa ti konsèy sou chatbot. Se yon baz nan kou inivèsite avanse ak nan atelye AI nivo pwodiksyon, e an jeneral yo konsidere l twò avanse pou yon moun k ap konstwi premye pwototip li.
Yo te ansenye l bay adolesan Karayib nan katriyèm semèn nan.
Kote domèn nan ye toutbon
Li vo lapenn pou n klè sou jan tout sa resan. Rekiperasyon ak orkestrasyon ajan se pa pratik ki etabli ak yon dizèn ane liv dèyè yo. Se pwoblèm vivan AI aplike a — y ap rezoud li kounye a menm, an pwodiksyon, pa ekip ki gen anpil plis resous pase yon pwogram ete.
Rezon an se ke modèl la pa t janm pati ki difisil la. Nenpòt òganizasyon ka rele yon entèfas pwogramasyon aplikasyon (API). Sa ki separe yon demonstrasyon ak yon bagay yon bank ap mete non l sou li se tout sa ki òganize otou modèl la: ki kote fè yo soti, sa sistèm nan gen dwa di, sa k rive lè yon etap echwe, e bay kiyès li voye monte lè li pa ta dwe reponn ditou. Sa se orkestrasyon, e se la vrè difikilte a chita kounye a.
Sa se afimasyon ki vo lapenn fè sou pwogram sa a, e li etwat. Yo pa t bay patisipan kan yo teknoloji dènye dizèn ane a reanbale pou lekòl. Yo te mennen yo nan pati domèn nan moun toujou ap diskite sou li — epi yo te mande yo livre yon bagay ladan l.
Yon ajan, de fason
Daniel verifye si yon moun k ap mande prè gen dokiman règ yo egzije. Isit la, nou ekri l pou yon framework wo nivo, answit nou ekri l jan kan an te ansenye l.
class State(TypedDict): # what the crew knows, exactly
applicant: str
documents: list[str]
missing_items: list[str]
compliance_status: str
def daniel(state: State) -> State: # the NODE
missing = required_docs() - set(state["documents"])
return {
**state,
"missing_items": sorted(missing),
"compliance_status": "pass" if not missing else "hold",
}
def route(state: State) -> str: # the EDGE
return "maya" if state["compliance_status"] == "hold" else "theo"
graph.add_node("daniel", daniel)
graph.add_conditional_edges("daniel", route) # loops back on a failNe, lyen ak eta, ekri an detay. Anyen pa sipoze — enkli lyen kondisyonèl ki voye yon verifikasyon ki echwe tounen bay Maya olye l kite l pase.
| Wo nivo | LangGraph | |
|---|---|---|
| Abstraksyon | Wo — deklare wòl la, modèl la jwenn etap yo | Ba — chak chemen ki otorize ekri eksplisitman |
| Kontwòl | Pilòt otomatik. Modèl la deside kilè pou l fè bouk oswa avanse | Total. Devlopè a dikte kilè pou fè bouk, eseye ankò oswa kanpe |
| Previzibilite | Pi ba. Ajan yo ka pèdi wout, oswa rete bloke nan yon bouk lojik | Pi wo. Limit strik kenbe modèl la sou ray yo |
| Koub aprantisaj | Dous. Bon pou yon pwototip pou demen maten | Rèd. Bezwen yon vrè baz nan achitekti lojisyèl |
Kòd la ekri pou montre diferans lan, li pa soti nan repo yon patisipan kan. Ekipaj la, wòl yo ak lyen kondisyonèl ki tounen bay Maya a se pou kan an menm.
Laboratwa patisipan kan yo te travay ladan l lan piblik, e li toujou piblik. Li konstwi yon ajan rekiperasyon liy pa liy — sa w tape sou yon bò, sa LangGraph bay sou lòt bò a, e kijan chak etap koresponn ak òganizasyon ajan ou te desine anvan ou te ekri okenn kòd.
Sa patisipan kan yo te pote lakay yo
Kidonk ann retire ankadreman chatbot la epi gade sa ven jou yo te transmèt toutbon.
Teyori graf, aplike. Ne, lyen, flou oryante ak siklik — pa kòm yon abstraksyon men kòm bagay ki deside si demann Tariq la fè bouk an aryè oswa li avanse.
Konsepsyon eta. Yon chema pou sa yon sistèm konnen nan nenpòt moman, ak disiplin pou reflechi sou sa k rive lè yon pati ladan l manke.
Kontwòl flou nan ensètitid. Kilè pou eseye ankò, kilè pou kanpe, kilè pou rete epi pase bay yon moun. Pifò lojisyèl sipoze yo pral reyisi; ajan yo dwe ekri pa yon moun ki sipoze yo p ap reyisi.
Rekiperasyon nan yon kòpis ki jere. Ankre yon repons nan yon sous yon moun posede, epi site l.
Tès advèsè. Nevyèm jou a se te patisipan kan yo k ap atake pwòp sistèm yo sou prensip ke ou dwe panse tankou yon pirat e konstwi tankou yon defansè.
Validasyon sòti. Verifikatè chema, kondisyon refi, ak abitid pou pa fè sòti yon modèl konfyans paske li sonnen byen.
Deplwaman. Soti FastAPI, pase GitHub, rive Render, ak yon kòmand demaraj ki dwe egzakteman kòrèk.
E Python, nan yon estanda yon ekzaminatè ekstèn verifye.
Sèt premye yo se sa yon manadjè anbochaj ta rekonèt kòm nivo senyò. Dènye a se sa ki antre sou yon sètifika. Sa ki pa sou okenn lis se jijman ki anba tout sa — konnen kilè yon sistèm dwe refize — e se pati sa a ou pa ka al chèche.
Transfè a
Yon rigè konsa konte sèlman si li siviv kontak ak yon kliyan reyèl, e se la ven jou yo ka odite olye yo dekri.
W.E.S dirije yon ijans anvan li mande yon non — yon lyen kondisyonèl, pran paske yon lakou ki inonde pa ka tann dèyè yon verifikasyon idantite. A.I.D.A. voye monte bay yon konsòl anplwaye olye l enpwovize yon desizyon sou taks — yon ne kote yon moun rete nan bouk la, mete egzakteman kote erè koute pi chè. ASPIRE AI te ajoute verifikatè chema sòti apre ajan li yo te mele nan tès plizyè tou, sa ki se yon pwoblèm eta moun ki te koze l yo te dyagnostike e repare. PILOT pase nenpòt bagay ki touche ladwàn bay yon dispatchè pò — yon kondisyon kanpe, ekri espre olye yo te espere l.
Sa yo se pa fonksyon pèsonn te panse mande. Se sa yon graf sanble lè moun k ap desine l lan konprann ke pati ki pi difisil nan yon ajan se konnen kilè li dwe kanpe.
Sou sèn nan, pandan yo t ap gade pwòp sistèm yo pase men kòrèkteman anba presyon, yon ekip te di l pi senp pase tout sa: That is what agentic means in practice! ("Se sa ajantik vle di nan pratik!")
