Kuinka kuvaile virhettä tekoälyavustajalle niin, että se pystyy diagnostisoimaan sen tarkasti?

Question

Accepted Answer

Hyvä virheilmoitus tekoälylle on sama kuin hyvälle virheilmoitus ihmiselle: anna sille **tarpeeksi kontekstia ongelman palauttamiseen sen mielessä** ja poista häly. Tekoäly voi päätellä vain siitä, mitä liität — epäselvät kuvaukset tuottavat epäselviä arvauksia.

## Mitä sisällyttää

- **Tarkka virhesanoma ja koko stack trace** — kopioi se sanatarkasti, ei parafraasi. Jäljityksen tiedosto ja rivi ovat yksittäin hyödyllisin vihje.
- **Relevantti koodi** — funktio, joka heittää poikkeuksen, ja sen välittömät kutsujat, ei koko repo.
- **Odotettu vs. todellinen käyttäytyminen** — "Odotan X:tä, mutta saan Y:n" on minkä tahansa virheilmoituksen ydin.
- **Toistovaiheet** — tarkka tulo tai sekvenssi, joka laukaisee sen.
- **Ympäristö/versiot** — kieli, framework- ja kirjastoversiot (virhe voi olla versiokohtainen).
- **Tietokannan rakenne tai esimerkkitiedot** — kun virhe koskee kyselyä tai tietomuotoa.

## Mitä jättää pois

Ei-asiaan liittyvät tiedostot, koko konfiguraatiosi, salaisuudet/API-avaimet ja "Luulen, että se voisi olla X" teoriat, jotka vääristävät diagnoosia. Anna tosiasiat, ei arvailuja.

## Heikko vs vahva raportti

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

Vahvan version ansiosta tekoäly voi osoittaa suoraan puuttuvan `undefined` tarkistuksen ja ehdottaa suojausta, koska jokainen tieto, jota sillä on, on sivulla.

## Miksi se on tärkeää

Tekoälyavustajalla **ei ole pääsyä käynnissä olevaan järjestelmääsi** — se päättelee vain siitä, mitä annat. Heikko raportti pakottaa sen arvaamaan virheen, koodin ja ympäristön samanaikaisesti, ja väärä arvaus tuhlaa palautesilmukan. Vahva raportti (tarkka jäljitys + relevantti koodi + odotettu/todellinen + toisto + versiot) muuttaa diagnoosin keskittyneeksi tehtäväksi ja yleensä saa oikean korjauksen ensimmäisellä kerralla. Tiukkojen virheilmoitusten kirjoittamisen oppiminen tekee sinusta myös paremman debuggerin, koska se pakottaa sinut eristämään tosiasiat ennen kysymisen esittämistä.