Jinsi ya Kutatua Hitilafu kwenye Programu Iliyojengwa kwa AI: Mbinu ya Vitendo

Ili kutatua hitilafu kwenye programu iliyojengwa kwa AI, kwanza fanya hitilafu itokee tena kwa makusudi, kisha kusanya ushahidi — hatua kamili, ujumbe wa hitilafu, na kile console ya kivinjari na kichupo cha mtandao vinaonyesha — kisha umpe AI kwa muundo wa "nilifanya X, nilitarajia Y, nikapata Z". Ikiwa marekebisho yanaharibu zaidi, rudi nyuma kwenye toleo la mwisho lililofanya kazi badala ya kurundika marekebisho juu yake. Hujahitaji kusoma msimbo ili kufanya haya vizuri.

Mwongozo huu unashughulikia mzunguko mzima, pamoja na ziara fupi ya zana za msanidi wa kivinjari kwa watu wasio wasanidi.

Mzunguko wa utatuzi

Kila marekebisho ya hitilafu, iwe ni mtu au AI anayeyafanya, yanafuata mzunguko uleule:

1. Zalisha tena — fanya hitilafu itokee kwa uhakika.
2. Angalia — kusanya ujumbe wa hitilafu na kile programu ilikuwa ikifanya.
3. Eleza — mpe AI hatua sahihi, matokeo yanayotarajiwa na matokeo halisi.
4. Rekebisha — acha AI ibadilishe jambo moja.
5. Thibitisha — rudia hatua hasa na uthibitishe kwamba imerekebishwa, na kwamba kilicho karibu hakikuvunjika.
6. Rudisha nyuma ikihitajika — ikiwa imeharibika zaidi, tengua na ujaribu tena kwa taarifa bora.

Muda mwingi unaopotea kwenye programu zilizojengwa kwa AI unatokana na kuruka hatua 1, 2 na 5: kusema "imevunjika", kukubali mabadiliko bila kuyajaribu, kisha kuomba marekebisho mengine juu ya kitu kilichovunjika.

Hatua ya 1: Zalisha tena hitilafu

Hitilafu unayoweza kuianzisha unapoitaka imeshatatuliwa nusu. Jaribu kupata seti fupi zaidi ya hatua inayoisababisha.

Jiulize:

• Je, hutokea kila wakati? Ikiwa wakati mwingine tu, ni nini kinatofautiana wakati inapotokea — rekodi fulani, muunganisho wa polepole, au kutoka kwenye akaunti?
• Je, hutokea kwa kila mtumiaji? Ingia kwa akaunti tofauti. Hitilafu nyingi zinaonekana tu kwa watumiaji wapya wasio na data, au kwa mtumiaji mwenye jukumu tofauti.
• Je, hutokea kwenye kila kifaa? Jaribu skrini ya upana wa simu na kivinjari tofauti.
• Je, ilianza baada ya mabadiliko mahususi? Ikiwa ilifanya kazi jana, mabadiliko machache ya mwisho ndiyo wahusika wakuu.

Andika hatua kama orodha fupi yenye namba. Utaibandika kwenye maagizo baadaye.

Hatua ya 2: Soma ujumbe wa hitilafu

Ujumbe wa hitilafu unatisha, lakini unahitaji sehemu chache tu.

Hujahitaji kuielewa; unahitaji kuinakili kwa usahihi. "Cannot read properties of undefined (reading 'name')" inamwambia AI kwamba msimbo ulitarajia data fulani (labda oda au mtumiaji) ambayo haikuwepo. Kuieleza kwa maneno yako kama "hitilafu fulani ya undefined" kunapoteza taarifa hiyo.

Baadhi ya za kawaida, kwa tafsiri ya haraka:

• Hitilafu za undefined / null — msimbo ulitarajia data isiyofika. Mara nyingi ni hali ya kupakia au orodha tupu ambayo msimbo haukuishughulikia.
• 404 Not Found — ukurasa au anwani ya API haipo. Mara nyingi ni kosa la kuandika kwenye njia au kiungo cha ukurasa uliobadilishwa jina.
• 401 Unauthorized / 403 Forbidden — ombi halikuwa limeingia, au mtumiaji haruhusiwi kufanya hilo.
• 500 Internal Server Error — msimbo wa upande wa seva umeanguka. Sababu halisi iko kwenye kumbukumbu za seva, si kwenye kivinjari.
• Hitilafu za CORS — kivinjari kimezuia ombi kwenda kwenye kikoa kingine. Kwa kawaida ni tatizo la usanidi upande wa seva.

Hatua ya 3: Tumia zana za msanidi wa kivinjari

Kila kivinjari cha kompyuta kina zana zilizojengwa ndani za wasanidi ("devtools"). Zinaonyesha ukurasa unafanya nini nyuma ya pazia. Kwenye Chrome, Edge na Firefox, bonyeza-kulia popote kwenye ukurasa kisha chagua Inspect, au bonyeza F12 (Cmd+Option+I kwenye Mac). Kwenye Safari, washa kwanza menyu ya Develop kwenye mipangilio ya Safari.

Unahitaji vichupo vitatu tu.

Console

Kichupo cha Console kinaorodhesha hitilafu na ujumbe kutoka msimbo wa ukurasa. Hitilafu zinaonyeshwa kwa nyekundu. Kitufe kikibonyezwa na hakifanyi lolote, console mara nyingi itaonyesha hitilafu nyekundu wakati unabonyeza. Nakili maandishi kamili ya hitilafu (bonyeza-kulia kwa chaguo la kunakili kwenye vivinjari vingi).

Network

Kichupo cha Network kinaorodhesha kila ombi ambalo ukurasa unatuma — kupakia data, kuhifadhi fomu, kuingia. Kifungue, kisha rudia hatua zinazosababisha hitilafu.

• Tafuta safu zilizo nyekundu au zenye hali ya 400 au zaidi.
• Bonyeza safu iliyoshindwa kuona Response yake. Hitilafu ya seva mara nyingi ina ujumbe pale unaofaa zaidi kuliko chochote kwenye skrini.
• Andika URL ya ombi na msimbo wa hali — "POST kwenda /api/bookings ilirudisha 500" ni sentensi yenye manufaa sana kumpa AI.

Weka alama Preserve log ikiwa hitilafu inahusisha kupakia upya ukurasa au uelekezaji, ili maombi yasipotee.

Elements

Kichupo cha Elements (au Inspector) kinaonyesha muundo na mitindo ya ukurasa. Kinafaa zaidi kwa hitilafu za mpangilio: elekeza juu ya kipengele ili kuona ukubwa na nafasi yake ikionyeshwa. Hujahitaji kuhariri chochote hapa; inatosha kusema "footer ina upana wa pikseli 2,000 kwenye simu na inasukuma ukurasa pembeni".

Hatua ya 4: Kagua kumbukumbu za seva

Baadhi ya hitilafu zinatokea kwenye seva, mahali kivinjari hakiwezi kuona. Hitilafu ya 500 kwenye kichupo cha network ni ishara ya kawaida. Kumbukumbu za seva — matokeo ya maandishi ya backend yako wakati inafanya kazi — kwa kawaida zina hitilafu halisi pamoja na stack trace (orodha ya kazi zilizokuwa zikiendeshwa wakati ilipoanguka).

Zinapatikana wapi inategemea zana yako. Kwenye vijenzi vingi vya programu vya AI unaweza kufungua terminal au mwonekano wa kumbukumbu za mradi, au kwa urahisi kuuliza AI: "Kagua kumbukumbu za seva kwa hitilafu za ombi la mwisho na uniambie kilichoshindwa."

Hatua ya 5: Eleza hitilafu kwa AI

Weka ulichokusanya katika umbo hili:

Kwenye ukurasa wa Bookings, nikiwa nimeingia kama mwanachama: nilibonyeza Cancel kwenye darasa la kesho saa 9:00. Nilitarajia: oda inatoweka na darasa linaonyesha nafasi moja zaidi ya bure. Halisi: hakuna kinachobadilika kwenye skrini. Console inaonyesha TypeError: Cannot read properties of undefined (reading 'id') kwenye BookingCard.tsx:31, na kichupo cha network kinaonyesha DELETE /api/bookings/123 kilirudisha 500. Tafuta chanzo, rekebisha, kisha hakikisha kughairi kunafanya kazi kwa mwanachama mwenye oda moja na mwenye nyingi.

Kila sehemu ina umuhimu wake:

• Wapi na kama nani kinapunguza hadi skrini moja na jukumu moja.
• Hatua kamili zinamwezesha AI kuizalisha tena.
• Inayotarajiwa dhidi ya halisi inafafanua maana ya "imerekebishwa".
• Maandishi ya hitilafu na ombi lililoshindwa yanaelekeza moja kwa moja kwenye chanzo.
• "Hakikisha kwamba…" inamwomba AI athibitishe, si kuhariri tu.

Ikiwa AI imejaribu marekebisho mara mbili na kushindwa, mwombe aeleze kabla ya kubadilisha chochote:

Usibadilishe msimbo bado. Unafikiri nini kinasababisha hili, na ni ushahidi gani unaounga mkono?

Nadharia mbaya ni rahisi kuiona ikishaandikwa, na ni nafuu zaidi kuirekebisha kuliko marekebisho mabaya.

Hatua ya 6: Thibitisha, kisha kagua vilivyo karibu

AI ikisema imerekebishwa, rudia hatua kamili kutoka Hatua ya 1. Kisha kagua vitu vilivyo karibu:

• Kitendo kile kile kwa jukumu tofauti la mtumiaji
• Kitendo kile kile bila data, na kwa data nyingi
• Kurasa zinazoshiriki vipengele na ile uliyorekebisha
• Skrini ya upana wa simu, ikiwa marekebisho yaligusa mpangilio

Mabadiliko ya AI wakati mwingine yanarekebisha njia moja na kuvunja nyingine kimya kimya. Ukaguzi wa dakika mbili sasa unaokoa saa moja ya kuchanganyikiwa baadaye.

Hatua ya 7: Rudi nyuma badala ya kurundika

Ikiwa marekebisho yameharibu zaidi, au umepitia raundi tatu bila maendeleo, rudi nyuma. Kurudi kwenye toleo la mwisho lililofanya kazi na kueleza upya kwa ushahidi bora karibu kila mara ni bora kuliko kuomba marekebisho ya nne juu ya matatu yaliyo mabaya. Kila jaribio lililoshindwa linaacha msimbo nyuma, na msimbo huo unachanganya jaribio linalofuata.

Tabia nzuri zinazorahisisha kurudi nyuma:

• Jaribu baada ya kila mabadiliko, ili ujue ni mabadiliko yapi yaliyovunja mambo.
• Weka mabadiliko madogo — kipengele au marekebisho moja kwa kila ujumbe.
• Andika toleo la mwisho lililofanya kazi kabla ya kuanza jambo la hatari.
• Ikiwa msimbo uko kwenye Git, fanya commit kwenye matoleo yanayofanya kazi ili uweze kurudi kwake.

Mifumo ya kawaida ya hitilafu kwenye programu za AI

Wakati tatizo si hitilafu

Baadhi ya "hitilafu" ni AI ikijenga hasa kile ilichoambiwa, na maelezo yalikuwa na utata. Ikiwa marekebisho unayoomba kwa kweli ni mabadiliko ya tabia, sema hivyo wazi: "Badilisha ili kwamba…". Ukijikuta huna uhakika tabia sahihi ni ipi hasa, amua hilo kwanza. Mwongozo wetu wa kuandika maagizo kwa vijenzi vya programu vya AI unaeleza jinsi ya kubainisha kanuni wazi. Na ukiandaa programu kwa watumiaji halisi, kupeleka prototype ya AI hadi uzalishaji unaeleza ukaguzi wa kufanya kabla ya kuzindua.

Utatuzi kwenye Mythex

Mythex ina zana kwa kila hatua ya mzunguko:

• Onyesho kuzalisha tena hitilafu, pamoja na fremu ya ukubwa wa simu.
• /test inamwezesha wakala kubofya onyesho lako hai kama mtumiaji na kuripoti mitiririko iliyovunjika.
• /fix inamwelekeza wakala kwenye uvunjaji mahususi.
• Hali ya Plan inamruhusu wakala kuchunguza na kueleza kabla ya kuhariri chochote.
• Msimbo → terminal inaonyesha kumbukumbu za seva za programu yako.
• Rudi kwenye hatua hii kwenye jibu lolote inarudisha mradi kwenye checkpoint hiyo.

Ikiwa uchapishaji unashindwa, kidirisha cha uchapishaji kwa kawaida kinatoa Fix with AI, kinachosoma matokeo ya ujenzi au kumbukumbu za programu. Angalia Rekebisha programu yako na Utatuzi wa uchapishaji kwenye nyaraka.

Maswali