Table of Contents

Înapoi la cursul Flux de lucru practic cu IA

Acceptă un rezultat IA numai după ce verifici dovezile potrivite pentru sarcină. O explicație bine formulată, un instrument configurat și un indicator verde al testelor răspund la întrebări diferite. Această lecție creează o singură înregistrare de verificare pentru laboratorul atelierului.

Obiectiv de învățare: vei crea o înregistrare de acceptare pentru surse, domeniul fișierelor, teste, confidențialitate și utilizare.

Idei principale

  • Verificarea surselor: compară o afirmație factuală cu o sursă actuală și autoritară.
  • Verificarea domeniului: inspectează fișierele sau sistemele modificate.
  • Verificarea comportamentului: rulează teste și cazuri manuale relevante.
  • Verificarea confidențialității: inspectează materialele primite de instrument sau furnizor.
  • Verificarea utilizării: înregistrează tokenii, apelurile instrumentelor și tariful folosit la calculul costului.

Înainte să începi

Cerințe preliminare: laboratorul cursului, docs/requirements.md, un snapshot Git local și lecția MCP sau alternativa în browser. Alocă 40 de minute. Dificultatea este intermediară. Folosește laboratorul editat în prima sarcină cu un agent de programare. Dacă ai omis editarea, folosește o extracție nouă și marchează verificările funcțiilor ca neimplementate. Versiunea inițială neatinsă trece în continuare cele două teste originale.

Verifică o afirmație factuală

Afirmație: „Valorile de stare aprobate sunt open și pending.” Deschide docs/requirements.md, revizia 1. Documentul indică open și done. Afirmația este greșită. Un ton sigur nu schimbă cerința.

Pentru afirmațiile despre produse, folosește documentația oficială actuală și notează titlul paginii și data verificării. O afirmație despre un meniu, un plan, o comandă sau o limită de context se învechește mai repede decât un principiu general de flux de lucru. Documentația Codex , documentația Claude Code și documentația OpenCode descriu interfețele actuale.

AfirmațieSursăDecizie
open și pendingCerința laboratorului, revizia 1Respinge, înlocuiește pending cu done
Numărul fără filtru este 4Programul de bază și patru intrări JSONVerifică rulând programul
A avut loc o citire MCPTranscrierea instrumentelor sesiuniiAcceptă numai dacă este vizibil un apel al instrumentului

Inspectează modificarea

Pentru o sarcină de programare, folosește Git pentru a lista fișierele modificate și a citi diff-ul real. Un fișier nou, neurmărit, apare în status chiar dacă nu apare într-un diff obișnuit, așa că inspectează ambele.

git status --short
git diff -- task_report.py tests

Domeniul așteptat: după sarcina cu filtrul se schimbă doar task_report.py și testele dedicate. O modificare în tasks.json, docs/requirements.md sau într-un fișier de configurare ascuns necesită o explicație și o verificare separată. Dacă nu ai făcut o editare, nu ar trebui să existe modificări.

Testează comportamentul

Rulează aceleași verificări de bază și ale funcțiilor din directorul extras al laboratorului. Raportul de finalizare al agentului trebuie să includă rezultatele observate.

python3 -m unittest discover -s tests -v
python3 task_report.py tasks.json
python3 task_report.py tasks.json --status open
python3 task_report.py tasks.json --status done
python3 task_report.py tasks.json --status invalid

În copia editată, testele acoperă cazurile noi, numărătorile sunt 4, 2 și 2, iar valoarea nevalidă produce o eroare clară și un cod de ieșire nenul. Într-o copie inițială nouă, trec numai cele două teste de bază, iar totalul este 4. Înregistrează separat starea inițială.

Un test de funcție eșuat trebuie diagnosticat. Dacă open afișează 4, verifică dacă argumentul filtrului ajunge la funcția de numărare și dacă programul compară câmpul status al sarcinii. Nu declara reușit un test eșuat doar pentru că agentul afirmă că a terminat implementarea.

Verifică confidențialitatea și accesul

Înregistrează ce fișiere a primit agentul. Laboratorul conține date sintetice și niciun secret. Un proiect real ar putea conține date de autentificare, date despre clienți sau documente private. Înainte de a partaja rezultatul, inspectează prompturile, jurnalele, capturile de ecran și diff-urile pentru astfel de valori.

Un test local demonstrează doar comportamentul local. Nu demonstrează permisiunile unui cont cloud, domeniul unui server MCP sau comportamentul unui serviciu implementat. Testează fiecare limită în mediul relevant.

Înregistrează utilizarea și costurile

Tokenii măsoară volumul de intrare și ieșire al modelului. Tablourile de bord diferă, așa că folosește cifrele de utilizare afișate de furnizorul tău. Înregistrează separat apelurile instrumentelor și costurile pentru imagini sau medii găzduite, când se aplică. Verifică tarifele actuale înainte să calculezi o factură reală.

Deschide vizualizarea de utilizare pentru contul care a executat sarcina. Notează tokenii de intrare și ieșire afișați, modelul, perioada de facturare și orice categorie de intrare memorată în cache. Pentru abonamentele ChatGPT sau Claude, o limită ori o alocație de utilizare nu este același lucru cu un cost API per sarcină. Pentru o execuție OpenCode prin API sau furnizor, consultă utilizarea sau facturarea furnizorului și tariful actual. Dacă produsul nu afișează tokeni per sarcină, scrie „indisponibil” și nu deduce costuri din lungimea conversației.

Calcul ilustrativ, nu tarif de furnizor: 30.000 de tokeni de intrare la 1 $ per milion costă 0,03 $. 5.000 de tokeni de ieșire la 5 $ per milion costă 0,025 $. Costul combinat al modelului în acest exemplu este 0,055 $, înainte de costurile instrumentelor sau găzduirii.

cost de intrare = tokeni de intrare / 1.000.000 × tarif de intrare
cost de ieșire = tokeni de ieșire / 1.000.000 × tarif de ieșire
total = cost de intrare + cost de ieșire + costuri separate ale instrumentelor

O sarcină delegată consumă și ea tokeni. Delegarea mută rezultatele detaliate în afara conversației principale, dar nu face munca gratuită. Compară costul cu valoarea verificării independente.

Păstrează separat categoriile de cost. Intrarea memorată în cache, intrarea nouă, ieșirea, apelurile instrumentelor și execuția găzduită pot avea tarife diferite. Acest exemplu folosește doar tarifele pentru intrare nouă și ieșire. Nu spune nimic despre o factură de abonament sau o taxă de instrument.

Păstrează o înregistrare de acceptare

CâmpExemplu completat după editare
Sursădocs/requirements.md, revizia 1, citită
Fișiere modificatetask_report.py și tests/test_task_report.py în git status --short
TesteTestele de bază și noile teste de filtru au trecut, notează numărul observat
Rezultat manualS-au observat Total tasks: 4, 2 și 2, valoarea invalidă a fost respinsă
Starea funcției--status open și --status done implementate
ConfidențialitateNumai fișiere sintetice
UtilizareNotează cifrele furnizorului tău, dacă sunt disponibile
DecizieAcceptă numai după trecerea verificărilor sursei, diff-ului, testelor și confidențialității

Rezultatul tău: copiază această înregistrare și completeaz-o după propria rulare. Înlocuiește „observat” numai cu un rezultat văzut de tine. Alege Acceptă când trec toate verificările necesare, Revizuiește când o corecție are un domeniu limitat și Oprește când sursa, domeniul sau accesul nu sunt clare.

Verifică ce ai înțeles

  1. Întrebare: o bază inițială care trece demonstrează că există funcția solicitată? Răspuns: Nu. După editare, testează noul comportament de acceptare.

  2. Întrebare: ce intră într-o înregistrare de acceptare? Răspuns: dovezile sursei, fișierele modificate, verificările comportamentului, domeniul accesului și utilizarea observată.

Depanare

  • Nu există o sursă pentru afirmație: marcheaz-o ca neverificată și găsește o sursă autoritară.
  • Testele trec, dar rezultatul diferă: adaugă un caz manual și inspectează datele.
  • Lipsesc datele de utilizare: notează „indisponibil” în loc să estimezi un cost real.
  • Diff-ul include date private: oprește partajarea rezultatului și elimină acele date din înregistrarea de practică.

Pașii următori

Continuă cu Delegarea agenților . Pentru detalii despre costuri și confidențialitate, citește despre rutarea furnizorilor și limita de confidențialitate a IA locale .

Navigarea cursului: Anterior: Configurarea MCP , Structura cursului .