Lucrul în echipă

Colaborarea cere responsabilități și delimitarea accesului.

Ce vei învăța

  • Explici: accesul se verifică înainte de folosire
  • Aplici ideea într-un exemplu: Lucrul în echipă
  • Recunoști limitele și verifici rezultatul exercițiului

Colaborarea cere responsabilități și delimitarea accesului. Verifică rolurile efective ale organizației și proiectului, nu doar etichetele din UI.

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

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.

Erorile au nevoie de trasee explicite

Un timeout nu este același lucru cu o eroare de permisiune. Reîncearcă doar erorile tranzitorii, cu un număr limitat de încercări și pauze crescătoare. O operație cu efecte poate fi executată înainte ca răspunsul să se piardă; repetarea fără cheie de idempotency poate dubla efectul. Streaming arată progresul, dar nu garantează finalizarea. Checkpoint-urile pot permite reluarea etapelor eșuate, în limitele runtime-ului. Păstrează identificatorul rulării, etapa, durata și eroarea, eliminând secretele din logs. Măsoară și cel mai lent traseu, nu doar media.

Harta vizuală

Lucrul în echipă 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. Relații: Membrii echipei și roluri → Permisiuni de acces; Permisiuni de acces → Agenți configurați; Agenți configurați → Teste în Playground; Teste în Playground → Trace de execuție; Workspace și proiect → Domeniu organizație / proiect; Domeniu organizație / proiect → Permisiuni de acces; Permisiuni de acces → Documente și unelte private. U07 · Hartă de relații Lucrul în echipă Date Membrii echipei și roluri Stocare / index Workspace și proiect Decizie / control Domeniu organizație / proiect Decizie / control Permisiuni de acces Model AI / agent Agenți configurați Stocare / index Documente și unelte private Procesare Teste în Playground Stocare / index Trace de execuție Flux principal Date și context Feedback și revenire

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

Două echipe au proiecte de suport și documentație. Membrul fără acces nu trebuie să vadă surse private în căutare, răspunsuri sau apeluri API.

Încearcă tu

  1. Invită conturi de test cu roluri diferite și verifică două proiecte cu date sintetice.
  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ă

Matricea de acces documentează citire, modificare și administrare și este verificată în cazuri permise și refuzate. 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 presupune că gruparea într-un folder controlează accesul. 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

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.

O notă bună de stil dovedește succesul unui agent?

Nu. Agentul poate scrie frumos după ce a folosit unealta sau datele greșite.

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

Matricea de acces documentează citire, modificare și administrare și este verificată în cazuri permise și refuzate.

Cuvinte de ținut minte

  • Autorizare / Authorization: Verificarea dreptului la o operație sau resursă.
  • Regresie / Regression: O schimbare care strică un caz anterior corect.
  • Idempotency: Repetarea controlată fără duplicarea efectului.

Surse și următorul pas

Pentru pregătire: U06 — API și chei de acces pentru dezvoltatori