Cum descrii o eroare unui asistent AI pentru ca acesta să o diagnosticheze cu acuratețe?

Question

Accepted Answer

Un bun raport de eroare pentru un AI este același ca un bun raport de eroare pentru un om: furnizează-i **suficient context pentru a reproduce problema în mintea sa**, și elimină zgomotul. AI-ul poate doar să gândească asupra a ceea ce lipești — descrieri vagi produc ghiciri vagi.

## Ce să incluzi

- **Mesajul exact de eroare și stack trace complet** — copiază-l verbatim, nu o parafrazare. Fișierul și linia din trace sunt cel mai util indiciu.
- **Codul relevant** — funcția care aruncă eroarea plus apelurile sale directe, nu tot repository-ul.
- **Comportamentul așteptat vs real** — "Aștept X, dar obțin Y" este esența oricărui raport de eroare.
- **Pași de reproducere** — exact intrarea sau secvența care o declanșează.
- **Mediu/versiuni** — limbajul de programare, versiunile framework-ului și bibliotecilor (o eroare poate fi specifică unei versiuni).
- **Schema DB sau date eșantion** — când eroarea afectează o interogare sau o formă de date.

## Ce să omiti

Fișiere nerelaționate, toată configurația ta, secrete/chei API, și "cred că ar putea fi X" teorii care influențează diagnosticul. Dă fapte, nu intuiții.

## Raport slab vs puternic

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

Cu versiunea puternică, AI-ul poate indica direct verificarea `undefined` lipsă și propune o protecție, pentru că fiecare fapt de care are nevoie este pe pagină.

## De ce conteaza

Un asistent AI **nu are acces la sistemul tău în execuție** — gândește doar despre ceea ce furnizezi. Un raport slab o forțează să ghicească la eroare, cod și mediu din același timp, și o ghicire greșită irosește o rundă. Un raport puternic (trace exact + cod relevant + așteptat/real + repro + versiuni) transformă diagnosticul într-o sarcină concentrată și de obicei obține reparația corectă din prima încercare. Învăță să scrii rapoarte de eroare strânse și te va face și pe tine un mai bun debugger, pentru că te forțează să izolezi faptele înainte de a cere ajutor.