Πώς περιγράφετε ένα σφάλμα σε έναν βοηθό τεχνητής νοημοσύνης ώστε να μπορεί να το διαγνώσει με ακρίβεια;

Question

Accepted Answer

Μια καλή αναφορά σφάλματος σε μια ΤΝ είναι το ίδιο με μια καλή αναφορά σφάλματος σε έναν άνθρωπο: δώστε της **αρκετό περιεχόμενο ώστε να μπορεί να αναπαράγει το πρόβλημα στο μυαλό της**, και μειώστε τον θόρυβο. Η ΤΝ μπορεί να συλλογιστεί μόνο για αυτό που επικολλάτε — οι αόριστες περιγραφές παράγουν αόριστες εικασίες.

## Τι πρέπει να περιλαμβάνεται

- **Το ακριβές μήνυμα σφάλματος και το πλήρες stack trace** — αντιγράψτε το κατά γράμμα, όχι μια παράφραση. Το αρχείο και η γραμμή στο ίχνος είναι η πιο χρήσιμη ενδεία.
- **Ο σχετικός κώδικας** — η συνάρτηση που πετάει και οι άμεσοι καλούντες της, όχι το ολόκληρο repo.
- **Αναμενόμενη έναντι πραγματικής συμπεριφοράς** — "Περιμένω X, αλλά παίρνω Y" είναι η ουσία κάθε αναφοράς σφάλματος.
- **Βήματα αναπαραγωγής** — η ακριβής είσοδος ή ακολουθία που το ενεργοποιεί.
- **Περιβάλλον/εκδόσεις** — γλώσσα, εκδόσεις framework και βιβλιοθήκης (ένα σφάλμα μπορεί να είναι ειδικό για την έκδοση).
- **Σχήμα DB ή δείγμα δεδομένων** — όταν το σφάλμα αφορά ένα query ή σχήμα δεδομένων.

## Τι πρέπει να παραλείψετε

Ασχετικά αρχεία, ολόκληρη τη διαμόρφωσή σας, μυστικά/κλειδιά API και θεωρίες "Νομίζω ότι ίσως είναι X" που προκαλούν ή αποκλίνουν τη διάγνωση. Δώστε γεγονότα, όχι εικασίες.

## Ασθενής έναντι δυνατής αναφοράς

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

Με τη δυνατή έκδοση, η ΤΝ μπορεί να δείξει κατευθείαν τον έλλειψη ελέγχου `undefined` και να προτείνει ένα guard, επειδή κάθε γεγονός που χρειάζεται είναι στη σελίδα.

## Γιατί έχει σημασία

Ένας βοηθός τεχνητής νοημοσύνης **δεν έχει πρόσβαση στο σύστημά σας που εκτελείται** — συλλογίζεται μόνο για αυτό που παρέχετε. Μια ασθενής αναφορά τον αναγκάζει να μαντέψει το σφάλμα, τον κώδικα και το περιβάλλον ταυτόχρονα, και μια λάθος εικασία σπαταλά ένα γύρο. Μια δυνατή αναφορά (ακριβές ίχνος + σχετικός κώδικας + αναμενόμενο/πραγματικό + αναπαραγωγή + εκδόσεις) μετατρέπει τη διάγνωση σε μια εστιασμένη εργασία και συνήθως παίρνει τη σωστή επιδιόρθωση την πρώτη φορά. Η εκμάθηση γραφής χτισμένων αναφορών σφαλμάτων σας κάνει επίσης έναν καλύτερο debugger, επειδή σας αναγκάζει να απομονώσετε τα γεγονότα πριν ρωτήσετε.