Agjenti i parë në n8n: automatizimi pa regjistra është kuti e zezë

Për agjentin tuaj të parë të shërbimit në n8n, lidhni AI Agent me një model bisede dhe një mjet që kërkon regjistra klientësh, si në kursin Quickstart të n8n. Shtoni memorie të kufizuar, ruani ekzekutimet dhe vendosni miratim njerëzor para çdo mjeti që dërgon mesazhe ose ndryshon të dhëna.

Projekti konkret është një pyetje për statusin e një kërkese: agjenti merr identitetin e verifikuar të klientit, gjen kërkesën përkatëse dhe përgjigjet nga rezultati i kërkimit. Ruajtja e ekzekutimeve ju lejon të shihni çfarë mori mjeti dhe ku u ndërpre rrjedha; pa këtë gjurmë, një përgjigje e gabuar është shumë më e vështirë të hetohet.

Përgatitni të dhënat dhe hyrjen

Për këtë shembull, krijoni një tabelë me ID të klientit, ID të kërkesës, status dhe datën e përditësimit. Këto janë fusha të propozuara për projektin, jo një skemë e detyrueshme. Përdorni vetëm të dhënat reale që i duhen përgjigjes dhe vendosni paraprakisht cilët klientë mund të shohë secili përdorues.

Chat Trigger mund të shërbejë si hyrje bisede, por teksti që shkruan vizitori nuk provon identitetin e tij. Për përdorim me regjistra realë, merrni ID-në e klientit nga një kanal i autentikuar ose nga një operator i autorizuar dhe kalojeni si vlerë të rrjedhës. Nëse po provoni vetëm një bisedë të hapur, përdorni të dhëna prove; përndryshe, dikush mund të kërkojë statusin e një klienti tjetër duke shkruar ID-në e tij.

Ndërtoni mjetin e kërkimit

Vendosni Chat Trigger përpara AI Agent dhe lidhni modelin e bisedës te agjenti. Krijoni një nënrrjedhë që pranon ID-në e verifikuar të klientit dhe ID-në e kërkesës, pastaj përdor operacionin Get të Data Table. Kërkimi duhet të përputhë të dyja vlerat dhe të kthejë vetëm fushat që lejohen në përgjigje.

Lidheni nënrrjedhën me AI Agent përmes Call n8n Workflow Tool. ID-ja e verifikuar duhet të jetë hyrje e caktuar nga rrjedha, jo parametër që modeli e nxjerr nga biseda. Jepini mjetit një përshkrim të ngushtë: ai përdoret vetëm për statusin e kërkesës së klientit të identifikuar. Nënrrjedha e këtij versioni ka vetëm lexim; nuk i jepni agjentit operacione për përditësim ose fshirje.

Parashikoni një dalje të qartë për kërkimin pa rezultat. Për shembull, përdorni If Row Does Not Exist që nënrrjedha të kthejë gjendjen not_found, ndërsa një rresht i gjetur të kthejë statusin dhe datën e tij. Në udhëzimin e agjentit kërkoni përgjigje vetëm nga dalja e mjetit: kur nuk gjendet rresht, ai duhet të thotë se kërkesa nuk u gjet, jo të hamendësojë një status.

Kufizoni memorien e bisedës

Shtoni Simple Memory dhe caktoni një çelës sesioni që i ndan bisedat. Parametri Context Window Length kufizon sa ndërveprime të mëparshme përdoren si kontekst. Zgjidhni një dritare të shkurtër që lejon pyetje pasuese, por mos e përdorni memorien për të vendosur se cilit klient i përket një kërkesë.

ID-ja e verifikuar duhet të vijë në çdo ekzekutim nga hyrja e autorizuar. Edhe statusi duhet të lexohet përsëri nga tabela kur përdoruesi pyet: një përgjigje e ruajtur në bisedë mund të jetë vjetruar pasi kërkesa është përditësuar. Kështu, memoria ndihmon formulimin e pyetjes pasuese, ndërsa tabela mbetet vendi nga merret gjendja e kërkesës.

Ruani gjurmën dhe ndani gabimet nga mungesa e të dhënave

Aktivizoni ruajtjen e ekzekutimeve që ju duhen për diagnostikim dhe shqyrtojini te Executions. Për një përgjigje të dyshimtë, ndiqni hyrjen e agjentit, parametrat e mjetit, rezultatin e kërkimit dhe daljen përfundimtare. Ekzekutimet e ruajtura mund të përmbajnë të dhëna personale, ndaj kufizoni qasjen dhe kohën e ruajtjes; mos kopjoni gjithë bisedën edhe në njoftimet e gabimeve.

Një kërkesë pa rresht përkatës është rezultat i kërkimit, ndërsa pamundësia për të lexuar tabelën është gabim teknik. Kthejini si gjendje të ndryshme, që agjenti të mos e paraqesë një dështim si përgjigjen «nuk u gjet». Kur kapni një gabim në nënrrjedhë dhe ktheni një gjendje të kontrolluar, ajo rrjedhë mund të përfundojë pa u shënuar si e dështuar; për këtë arsye, regjistroni edhe gjendjen unavailable dhe shkakun e saj.

Për dështimet e pakapura, krijoni një rrjedhë të veçantë që nis me Error Trigger dhe caktojeni te Error workflow i rrjedhës kryesore. Udhëzimi i n8n për gabimet përshkruan këtë lidhje dhe të dhënat që merr rrjedha e gabimit; ID-ja dhe lidhja e ekzekutimit kërkojnë që ekzekutimi të jetë ruajtur. Përdorini ato për njoftimin e personit përgjegjës, pa dërguar në njoftim më shumë të dhëna të klientit sesa duhen për hetim.

Ndalo veprimet me ndikim për miratim

Agjenti i ndërtuar deri këtu vetëm lexon. Nëse i shtoni një mjet për dërgim emaili ose ndryshim statusi, lidheni atë pas hapit Human review. Sipas dokumentacionit të n8n për miratimin e mjeteve, rrjedha ndalet para thirrjes së mjetit: shqyrtuesi sheh mjetin dhe parametrat e propozuar, pastaj e miraton ose e refuzon. Refuzimi e anulon atë veprim.

Kërkesa për miratim duhet të tregojë marrësin e mesazhit ose rreshtin që do të ndryshohet, veprimin dhe vlerat e propozuara. Në udhëzimin e agjentit përcaktoni edhe përgjigjen ndaj refuzimit, që përdoruesit të mos i thuhet se veprimi u krye. Një miratim i përgjithshëm për tekstin e përgjigjes nuk kontrollon parametrat që mjeti do të përdorë.

Provoni rastet që ndryshojnë përgjigjen

Para përdorimit të rregullt, bëni prova me një kërkesë që ekziston, një ID pa përputhje, një përpjekje për të pyetur për klient tjetër dhe një dështim të kërkimit. Në secilin rast, krahasoni përgjigjen me daljen e mjetit dhe shihni në Executions nëse mbeti gjurmë e mjaftueshme për të kuptuar vendimin. Një provë e suksesshme nuk mjafton nëse rruga pa rezultat ose rruga e gabimit mbetet e paqartë.

Nëse keni shtuar mjetin me ndikim, provoni veçmas miratimin dhe refuzimin me vlera prove. Kontrolloni që thirrja e mjetit të ndodhë vetëm pas miratimit dhe që refuzimi t’i kthehet agjentit si vendim i anuluar. Kjo provë lidh përgjigjen që sheh klienti me veprimin që ndodhi realisht në rrjedhë.

Lexoni gjithashtu:

• n8n apo Make për agjentë AI: vetëhostimi ndryshon faturën
• Prompt injection te agjentët AI: lejet e kufizuara vlejnë më shumë se filtri
• Riverside apo Descript: regjistrimi dhe montazhi ndajnë fituesin