Kā atkļūdot AI veidotu lietotni: praktiska metode

Lai atkļūdotu AI veidotu lietotni, vispirms izraisiet kļūdu atkārtoti tīšām darbībām, pēc tam savāciet pierādījumus — precīzos soļus, kļūdas ziņojumu un to, ko rāda pārlūka konsole un tīkla cilne — un nododiet tos AI kā „Es izdarīju X, sagaidīju Y, saņēmu Z”. Ja labojums pasliktina situāciju, atgriezieties pie pēdējās darbojošās versijas, nevis kraujiet labojumus virsū. Lai to visu darītu labi, nav jāpārzina kods.

Šis ceļvedis aptver visu ciklu, ieskaitot ātru ekskursiju pa pārlūka izstrādātāju rīkiem nespeciālistiem.

Atkļūdošanas cikls

Katrs kļūdas labojums, neatkarīgi no tā, vai to dara cilvēks vai AI, seko vienam ciklam:

1. Atkārtot — izraisīt kļūdu uzticami.
2. Novērot — savākt kļūdas ziņojumu un to, ko lietotne darīja.
3. Aprakstīt — dot AI precīzus soļus, paredzamo rezultātu un faktisko rezultātu.
4. Labot — ļaut AI mainīt vienu lietu.
5. Pārbaudīt — atkārtot precīzos soļus un pārliecināties, ka kļūda novērsta un tuvumā nekas nesalūza.
6. Atgriezties, ja vajag — ja kļūda kļuva sliktāka, atsaukt un mēģināt vēlreiz ar labāku informāciju.

Lielākā daļa laika, kas pazūd AI veidotās lietotnēs, rodas, izlaižot 1., 2. vai 5. soli: sakot „tas ir salūzis”, pieņemot izmaiņu bez pārbaudes un tad prasot vēl vienu labojumu uz jau salūzuša.

1. solis: atkārtojiet kļūdu

Kļūda, ko var izraisīt pēc vēlēšanās, ir jau pusē novērsta. Mēģiniet atrast īsāko soļu kopu, kas to izraisa.

Jautājiet sev:

• Vai tā notiek vienmēr? Ja tikai dažreiz, kas atšķiras, kad tā notiek — konkrēts ieraksts, lēns savienojums, izrakstīšanās?
• Vai tā notiek visiem lietotājiem? Piesakieties ar citu kontu. Daudzas kļūdas parādās tikai jauniem lietotājiem bez datiem vai lietotājam ar citu lomu.
• Vai tā notiek visās ierīcēs? Izmēģiniet tālruņa platuma ekrānu un citu pārlūku.
• Vai tā sākās pēc konkrētas izmaiņas? Ja tā strādāja vakar, pēdējās dažas izmaiņas ir galvenie aizdomu objekti.

Uzrakstiet soļus īsā numurētā sarakstā. Vēlāk to ielīmēsiet uzvednē.

2. solis: izlasiet kļūdas ziņojumu

Kļūdu ziņojumi izskatās biedējoši, bet jums vajag tikai dažas to daļas.

Neviens neprasa, lai jūs to saprastu; jums jānokopē tas precīzi. „Cannot read properties of undefined (reading 'name')” saka AI, ka kods gaidīja datus (iespējams, rezervāciju vai lietotāju), kas nebija. Parafrāze „kāda undefined kļūda” šo informāciju zaudē.

Dažas biežas, aptuveni tulkotas:

• undefined / null kļūdas — kods gaidīja datus, kas nepienāca. Bieži tā ir ielādes stāvoklis vai tukšs saraksts, ko kods neapstrādāja.
• 404 Not Found — lapa vai API adrese nepastāv. Bieži kļūda maršrutā vai saite uz lapu, kas pārdēvēta.
• 401 Unauthorized / 403 Forbidden — pieprasījums nebija pieteicies vai lietotājam nav atļauts to darīt.
• 500 Internal Server Error — servera puses kods avarēja. Patiesais iemesls ir servera žurnālos, nevis pārlūkā.
• CORS kļūdas — pārlūks bloķēja pieprasījumu uz citu domēnu. Parasti tā ir konfigurācijas problēma servera pusē.

3. solis: izmantojiet pārlūka izstrādātāju rīkus

Katrs galddatora pārlūks ir ar iebūvētiem izstrādātāju rīkiem („devtools”). Tie rāda, ko lapa dara aizkulisēs. Chrome, Edge un Firefox ar peles labo pogu noklikšķiniet jebkurā lapas vietā un izvēlieties Inspect (Pārbaudīt) vai nospiediet F12 (Cmd+Option+I Mac datorā). Safari vispirms ieslēdziet izvēlni Develop Safari iestatījumos.

Jums vajag tikai trīs cilnes.

Konsole

Cilnē Console (Konsole) ir uzskaitītas lapas koda kļūdas un ziņojumi. Kļūdas ir sarkanas. Ja poga nedara neko, kad uz to noklikšķiniet, konsolē ļoti bieži parādās sarkana kļūda tieši klikšķa brīdī. Nokopējiet kļūdas pilno tekstu (lielākajā daļā pārlūku ar peles labo pogu ir opcija kopēt).

Tīkls

Cilnē Network (Tīkls) ir uzskaitīts katrs lapas pieprasījums — datu ielāde, veidlapas saglabāšana, pieteikšanās. Atveriet to un atkārtojiet darbības, kas izraisa kļūdu.

• Meklējiet rindas sarkanā krāsā vai ar statusu 400 vai augstāku.
• Noklikšķiniet uz neveiksmīgās rindas, lai redzētu tās Response (Atbildi). Servera kļūda bieži tur ietver ziņojumu, kas noderīgāks par visu, kas redzams ekrānā.
• Pierakstiet pieprasījuma URL un statusa kodu — „POST uz /api/bookings atgrieza 500” ir ļoti noderīgs teikums AI.

Ieslēdziet Preserve log (Saglabāt žurnālu), ja kļūda saistīta ar lapas pārlādi vai pāradresāciju, lai pieprasījumi nepazustu.

Elementi

Cilne Elements (Elementi) jeb inspektors rāda lapas struktūru un stilus. Tā visnoderīgākā ir izkārtojuma kļūdām: uzvelciet peli virs elementa, lai redzētu tā izmēru un atstarpes. Jums nav jārediģē nekas; pietiek pateikt „kājene ir 2000 pikseļu plata mobilajā ierīcē un bīda lapu sāniski”.

4. solis: pārbaudiet servera žurnālus

Dažas kļūdas notiek serverī, kur pārlūks tās neredz. 500 kļūda tīkla cilnē ir klasiska pazīme. Servera žurnāli — jūsu aizmugures programmas teksta izvade tās darbības laikā — parasti satur patieso kļūdu ar steka izsekojumu (funkciju saraksts, kas darbojās brīdī, kad kļūda notika).

Kur tos atrast, atkarīgs no rīka. Vairumā AI lietotņu veidotāju var atvērt projekta termināli vai žurnālu skatu, vai vienkārši pajautāt AI: „Pārbaudi servera žurnālus, vai pēdējā pieprasījumā ir kļūdas, un pastāsti, kas neizdevās.”

5. solis: aprakstiet kļūdu AI

Ievietojiet savāktos datus šādā formā:

Rezervāciju lapā, pieteicies kā dalībnieks: nospiedu Cancel rītdienas 9:00 nodarbībai. Sagaidīju: rezervācija pazūd un nodarbībā ir par vienu brīvu vietu vairāk. Notika: ekrānā nekas nemainās. Konsolē redzama TypeError: Cannot read properties of undefined (reading 'id') vietā BookingCard.tsx:31, un tīkla cilnē DELETE /api/bookings/123 atgrieza 500. Atrodi cēloni, salabo to un pārbaudi, vai atcelšana strādā dalībniekam ar vienu rezervāciju un ar vairākām.

Katrai daļai ir nozīme:

• Kur un kā kas sašaurina to līdz vienam ekrānam un vienai lomai.
• Precīzi soļi ļauj AI atkārtot kļūdu.
• Sagaidīts pret faktisko nosaka, kas nozīmē „salabots”.
• Kļūdas teksts un neizdevies pieprasījums norāda tieši uz cēloni.
• „Pārbaudi, ka…” prasa, lai AI pārbauda, nevis tikai labo.

Ja AI divreiz mēģinājis labot un neizdevies, lūdziet to izskaidrot, pirms kaut ko maina:

Vēl nemaini kodu. Ko tu domā, kas to izraisa, un kādi pierādījumi to atbalsta?

Nepareizu teoriju ir viegli pamanīt, kad tā ir uzrakstīta, un tās labošana ir daudz lētāka nekā nepareizs labojums.

6. solis: pārbaudiet un paskatieties apkārt

Kad AI saka, ka tas ir salabots, atkārtojiet precīzos soļus no 1. soļa. Pēc tam pārbaudiet lietas ap to:

• Tā pati darbība citai lomai
• Tā pati darbība bez datiem un ar lielu datu apjomu
• Lapas, kas dalās komponentēs ar to, ko salabojāt
• Tālruņa platuma ekrāns, ja labojums skāra izkārtojumu

AI izmaiņas dažreiz salabo vienu ceļu un klusi salauž citu. Divu minūšu pārbaude tagad ietaupa stundu neskaidrību vēlāk.

7. solis: atgriezieties, nevis kraujiet virsū

Ja labojums pasliktināja situāciju vai esat trīs reizes gājis bez progresa, atgriezieties. Atgriešanās pie pēdējās darbojošās versijas un pārformulēšana ar labākiem pierādījumiem gandrīz vienmēr ir labāka nekā ceturtais labojums virs trim kļūdainiem. Katrs neveiksmīgs mēģinājums atstāj kodu, kas traucē nākamajam.

Labi paradumi, kas atvieglo atgriešanos:

• Testējiet pēc katras izmaiņas, lai zinātu, kura izmaiņa salauza lietas.
• Turiet izmaiņas nelielas — viena funkcija vai labojums vienā ziņojumā.
• Atzīmējiet pēdējo labo versiju, pirms sākat kaut ko riskantu.
• Ja kods ir Git, saglabājiet darbojošās versijas, lai varētu atgriezties.

Biežākie kļūdu modeļi AI veidotās lietotnēs

Kad problēma nav kļūda

Dažas „kļūdas” ir tādas, ka AI būvē tieši to, ko tam lika, un apraksts bija neskaidrs. Ja labojums, ko lūdzat, patiesībā ir uzvedības maiņa, sakiet to skaidri: „Mainī tā, lai…”. Ja nezināt, kāda ir pareizā uzvedība, izlemiet to vispirms. Mūsu ceļvedis par uzvedņu rakstīšanu AI lietotņu veidotājiem aptver, kā skaidri norādīt noteikumus. Un, ja gatavojat lietotni reāliem lietotājiem, AI prototipa nodošana ražošanā aptver pārbaudes, kas vērts veikt pirms palaišanas.

Atkļūdošana Mythex

Mythex ir rīki katram cikla solim:

• Preview kļūdas atkārtošanai, tostarp tālruņa platuma kadrs.
• /test liek aģentam noklikšķināt caur jūsu tiešraides priekšskatījumu kā lietotājam un ziņot par salūzušām plūsmām.
• /fix vērš aģentu uz konkrētiem bojājumiem.
• Plan režīms ļauj aģentam izpētīt un izskaidrot pirms jebkādas rediģēšanas.
• Code → terminal rāda jūsu lietotnes servera žurnālus.
• Revert to this point jebkurā atbildē atgriež projektu šajā kontrolpunktā.

Ja publicēšana neizdodas, publicēšanas dialogā parasti ir poga Fix with AI, kas nolasa būvēšanas izvadi vai lietotnes žurnālus. Skatiet dokumentācijā Debug your app un Publish troubleshooting.

Jautājumi