Si i përshkruani një gabim një asistenti AI në mënyrë që ai ta diagnostikojë atë me saktësi?

Question

Accepted Answer

Një raport i mirë i gabimit për një AI është i njëjtë me një raport të mirë të gabimit për një njeri: jepini atij **kontekst të mjaftueshëm për të riprodhuar problemin në kokën e tij**, dhe hiqni zhurmën. AI-ja mund të arsyetojë vetëm për atë që ngjizni — përshkrimet e paqarta prodhojnë hamendje të paqarta.

## Çfarë të përfshijë

- **Mesazhi i gabimit i saktë dhe gjurmimi i plotë i stivës** — kopjojeni verbatim, jo një parafrazë. Skedari dhe linja në gjurmim janë njonjësia më e dobishme.
- **Kodi relevant** — funksioni që hedh plus thirrësit e tij të menjëhershëm, jo e gjithë repo.
- **Sjellja e pritshme kundër aktual** — "Pres X, por marr Y" është bërthama e çdo raporti gabimi.
- **Hapat e riprodhimit** — inputi i saktë ose sekuenca që e shkakton atë.
- **Mjedisi/versionet** — gjuha, versionet e framework-ut dhe bibliotekës (një gabim mund të jetë specifik për versionin).
- **Skema e DB-ës ose të dhëna shembullore** — kur gabimi përfshin një pyetje ose formë të dhënash.

## Çfarë të lihet jashtë

Skedaret e palidhura, të gjithë konfigurimin tuaj, sekretet/çelësat API, dhe "Mendoj se mund të jetë X" teori që paraanojnë diagnozën. Jepini faktet, jo hamendjet.

## Raporti i dobët kundër të fortit

```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.
```

Me versionin e fortë, AI-ja mund të tregojë drejt në kontrollimin e `undefined` që mungon dhe të propozojë një gard, sepse çdo fakt që i duhet është në faqe.

## Pse ka rëndësi

Një asistent AI nuk ka **qasje në sistemin tuaj në ekzekutim** — arsyeton vetëm nga ato që jepni. Një raport i dobët e detyron atë të hamendësojë gabimet, kodin dhe mjedisin të gjithë njëherësh, dhe një hamendësim i gabuar shpenzon një udhëtim në raund. Një raport i fortë (gjurmim i saktë + kod relevant + pret/aktual + riprodhim + versione) e kthen diagnozën në një detyrë të fokusuar dhe zakonisht merr ndreqjen e duhur në përpjekjen e parë. Mësimi i shkrimit të raporteve të ngushta të gabimeve ju bën gjithashtu një debugger më të mirë, sepse ju detyron të izoloni faktet para se të pyetni.