Conas a chuireann tú síos ar bhug d'fhoassistant AI ionas gur féidir leis/léi é a dhiagnostiú go cruinn?

Question

Accepted Answer

Is ionann tuairisc bhug mhaith d'AI agus tuairisc bhug mhaith do dhuine: tabhair dó **go leor comhthéacs chun an fhadhb a atáirgeadh ina intinn**, agus bain an torann amach. Ní féidir leis an AI a bheith ag smaoineamh ach ar na rudaí a ghreamadh tú — tugann cur síos vague tomhaltais vague.

## Cad atá le n-áireamh

- **An teachtaireacht earráide dhíreach agus an staic gheal iomlán** — cóipeálann sé focal ar fhocal, ní athfhriotal. Is iad an comhad agus an líne san iomláine an leithéid is úsáideach aon amháin.
- **An cód ábhartha** — an fheidhm a thairgíonn móide a ghlaoitheoirí dlúth, ní an stór ar fad.
- **Iompar ionchais i bhfreagra ar iompar iarbhír** — "Bhraithim X, ach faighim Y" is croílár aon tuairisc bhug.
- **Céimeanna atáirgeadh** — an ionchur nó an t-ord cruinn a thionscnaíonn sé.
- **Timpeallacht/leaganacha** — teanga, creatlach, agus leaganacha leabharlainne (is féidir bug a bheith leagan-shonrach).
- **Scéimh dhB nó sonraí samplacha** — nuair a bhailíonn an bug fhriotal nó cruth sonraí.

## Cad atá le fágáil ar lár

Comhaid dhíshuim, do bhunriarú iomlán, rúnda/eochracha API, agus "Smaoiním gur b'fhéidir go bhfuil sé X" teoiricí a bhraistint an diagnóiseoireacht. Tabhair fíricí, ní amhránaí.

## Tuairisc lag vs láidir

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

Leis an leagan láidir, is féidir leis an AI a thaispeáint díreach ag an tseic `undefined` ar iarraidh agus cosaint a mholadh, toisc go bhfuil gach fíric a bhíonn i ngan fhios air ar an leathanach.

## Cén fáth a bhíonn tábhacht ann

Nilí rochtain ar do chóras ag rith ag an assistant AI — smaoiníonn sé ach ar na rudaí a sholáthair tú. Cuireann tuairisc lag iallach air a bheith ag déanamh tomhais ar an earráid, an cód, agus an timpeallacht ar fad ag an am céanna, agus maolódh tomhais bhreagach dul i spás timpeall-shiúil. Cas tuairisc láidir (iomláine thraic + cód ábhartha + ionchais/iarbhír + atáirgeadh + leaganacha) diagnóiseoireacht i dtasc dírithe agus téann sé i gcrích ar an gcéad bhabhta a rith. Tógálann foghlama a scríobh tuairiscí cruas, níos fearr freisin a dhéanann tú féin i do dhiagnostiú, toisc go dtugann sé iallach ort an fíricí a anonn sular iarr tú.