Widgetul AI pe website

Widgetul este locul unde vizitatorul întâlnește asistentul. Configurația trebuie să combine claritatea, ținta corectă și accesul permis.

Pașii se referă la funcționalități identificate în codul aplicației. Validarea pe o instanță live nu a fost efectuată pentru acest material; verifică documentația și opțiunile din versiunea ta.

Cum funcționează, pas cu pas

Bucla unui agent cu limite

Agentul combină un model cu unelte, obiectiv și stare. Observă cererea, alege un pas, primește rezultatul și decide dacă trebuie să continue. Un chatbot poate doar genera text; un agent poate cere o acțiune externă. Definițiile comerciale variază, deci urmărește controlul real. Definește succesul și oprirea: rezultat verificat, număr maxim de pași, eroare repetată sau buget epuizat. Folosește capabilități înguste și drepturi minime. Autonomia utilă înseamnă libertate în interiorul unor limite aplicate de software.

Accesul se verifică înainte de folosire

Permisiunile trebuie aplicate în server și în stratul de date. Nu lăsa modelul să decidă dacă un utilizator poate vedea un document. Filtrează sursele înainte să intre în context, nu după generarea răspunsului. Folosește chei cu acces minim, nu le pune în prompturi, capturi sau cod din browser și rotește-le dacă sunt expuse. O listă de domenii permise pentru widget nu înlocuiește autentificarea API. Autentificarea arată cine ești; autorizarea arată ce operații și date poți folosi. Testează și accesul refuzat.

Definește succesul înainte de optimizare

Pregătește un set de cereri reprezentative și răspunsuri sau proprietăți așteptate. Include cazuri obișnuite, ambigue, fără date și cu erori de unelte. Pentru RAG măsoară separat găsirea dovezii și corectitudinea răspunsului. Recall@k urmărește proporția dovezilor relevante găsite în primele k rezultate; precision@k urmărește proporția rezultatelor relevante. Pentru agenți urmărește și acțiunile, accesul și oprirea. Un LLM-as-judge poate accelera evaluarea, dar se calibrează față de oameni. Nu modifica simultan promptul, modelul și indexul dacă vrei să înțelegi cauza îmbunătățirii.

Harta vizuală

Urmărește săgețile continue pentru fluxul principal. Săgețile albastre punctate furnizează date sau context; cele roz punctate arată feedback sau rezultate care revin. Culorile și formele disting modelele, stocările, deciziile și rezultatele. Pe ecrane mici, derulează orizontal pentru a urmări întreaga diagramă.

Un exemplu complet

În Widgets alegi agent, workflow sau RAG, personalizezi culori și mesajul de întâmpinare, verifici preview și domeniile permise. Folosești codul de integrare furnizat în versiunea aplicației.

Încearcă tu

1. Testează pe un domeniu de test permis și unul nepermis, apoi pe mobil.
2. Notează intrarea, sursa și rezultatul așteptat înainte să rulezi experimentul. Folosește doar datele fictive din exemplu.
3. Urmărește etapele din diagramă. La fiecare pas scrie ce informație primește și ce produce; nu confunda rezultatul intermediar cu rezultatul final.
4. Repetă cazul după eliminarea unei informații necesare sau după o intrare ambiguă. Verifică dacă sistemul cere clarificare, se oprește sau inventează.
5. Compară cu soluția comentată. Păstrează configurația, data, rezultatul și o explicație pentru orice diferență. Schimbă un singur lucru și retestează.

Soluție comentată

Widgetul răspunde pe domeniul permis și are contrast, text lizibil și un mesaj clar despre rol. Pentru a considera exercițiul reușit, poți arăta legătura dintre intrare, etapele parcurse și rezultat. Dacă lipsesc date, un răspuns prudent este mai util decât o completare inventată. Nu compara doar stilul: verifică și condițiile, sursele și operațiile efectuate.

Când merită și ce poate merge prost

Nu pune chei API private în snippet-ul browserului. Alege această abordare când îmbunătățește o nevoie măsurată. Păstrează o variantă simplă ca referință și compară rezultatele pe aceleași intrări. Un singur exemplu reușit nu stabilește fiabilitatea în toate situațiile.

Verifică ce ai înțeles

Mai multă autonomie produce întotdeauna un rezultat mai bun?

Nu. Crește și spațiul pentru greșeli, costuri și acțiuni inutile.

De ce este prea târziu să elimini sursa privată după răspuns?

Pentru că datele au intrat deja în contextul modelului și pot fi divulgate.

Ce rezultat trebuie să obții în acest exercițiu?

Widgetul răspunde pe domeniul permis și are contrast, text lizibil și un mesaj clar despre rol.

Cuvinte de ținut minte

• Agent: Sistem care poate decide pași și utiliza unelte spre un obiectiv.
• Autorizare / Authorization: Verificarea dreptului la o operație sau resursă.
• Regresie / Regression: O schimbare care strică un caz anterior corect.

Surse și următorul pas

• LangGraph — Workflows and agents
• OWASP — Prompt injection

Pentru pregătire: U04 — Conversații și feedback