Kuidas täiustada AI-ga ehitatud rakendust nii, et see ei katkeks

AI-ga ehitatud rakenduse täiustamiseks ilma selle katkestamata muuda ühte asja promptis, kontrolli seda eelvaates ja salvesta kontrollpunkt enne edasiliikumist. Kirjelda, mida näed, mitte seda, mida sinu arvates kood teeb, planeeri suured muudatused enne nende ehitamist ning kui muudatus läheb valesti, naase viimase töötava versiooni juurde, selle asemel et paluda AI-l parandada oma enda parandust.

Rakenduse esimene versioon valmib sageli minutitega. Raske on viiekümnes muudatus, kui iga uus prompt võib katkestada midagi, mis juba töötas. See juhend kirjeldab tsüklit, mis seda väldib.

Täiustamise tsükkel

1. Vali üks muudatus. Üks funktsioon, üks viga, üks leht.
2. Kirjelda seda selle kaudu, mida kasutaja näeb ja teeb.
3. Suurte muudatuste puhul planeeri esmalt. Palu plaani, loe see läbi, seejärel ehita.
4. Kontrolli tulemust eelvaates — muudatust ja selle lähedal olevaid voogusid.
5. Salvesta kontrollpunkt või commit.
6. Korda.

Iga samm on olemas selleks, et muudatused jääksid väikseks ja tagasipööratavaks.

Samm 1: pea lühikest nimekirja

Enne promptimist kirjuta üles, mida tahad muuta, tähtsuse järjekorras. See takistab sul saatmast ühes sõnumis kümmet soovi ja annab sulle võimaluse öelda „mitte praegu“ ideedele, mis tekivad keset tööd.

Kui muudatus on suur, jaota see. „Lisa meeskonna kontod“ muutub järgmiseks: loo meeskonnad, kutsu liige, vaheta meeskondade vahel, piira andmed praeguse meeskonnaga. Igaüks on eraldi prompt. Kasutajalugude kirjutamine on selleks hea viis.

Samm 2: kirjelda, mida näed

AI ei näe sinu ekraani, kui sa seda ei ütle. Osuta konkreetsetele asjadele ja ütle, mis peaks juhtuma:

Hinnalehel telefonis on Pro-kaardi nupp paremalt servast läbi lõigatud. Hoia lauaarvuti paigutus samana; alla 640 px ekraanidel paiguta kaardid üksteise alla ja tee nupud täislaiusega.

Võrdle seda sellega: „hinnaleht näeb mobiilil halb välja“. Esimese saab teha ja kontrollida ühe korraga; teine kutsub esile ümberkujunduse, mida sa ei palunud.

Ekraanipildid aitavad. Kui su ehitaja võtab vastu pilte, lisa üks ja tähista probleem.

Samm 3: planeeri enne suuri muudatusi

Kõige puhul, mis puudutab mitut rakenduse osa — uus andmemudel, maksed, kasutajarollid —, palu enne koodi muutmist plaani:

Ära muuda veel koodi. Tahan, et kasutajad kuuluksid meeskondadesse ja näeksid ainult oma meeskonna projekte. Planeeri muudatus: millised tabelid, lehed ja API marsruudid muutuvad, mis saab olemasolevate kasutajate andmetest ja mis järjekorras seda ehitaksid.

Loe plaan läbi. Kui see on vale, on plaani parandamine palju odavam kui ehituse tagasivõtmine.

Samm 4: ütle, mis ei tohi muutuda

AI-tööriistad „korrastavad“ mõnikord asju, mida sa ei küsinud. Kaitse seda, mis töötab:

Lisa tellimuste tabelisse kuupäevafilter. Ära muuda tabeli veerge, kujundust ega ekspordinuppu.

Kehtivate reeglite jaoks, mis kehtivad kõikjal — brändivärvid, tooni hääl, „ära kustuta kunagi andmeid ilma kinnituseta“ —, pane need projekti märkmete faili või teadmiste seadistusse, mida AI loeb igal korral, selle asemel et neid korrata.

Samm 5: kontrolli rohkemat kui muudatust

Pärast iga prompti testi:

• Muudatust ise. Kas see teeb seda, mida palusid, lauaarvutil ja telefonis?
• Naabreid. Asju samal lehel ja voogusid, mis kasutavad samu andmeid.
• Kriitilist teed. Registreerimine, sisselogimine, põhitegevus, makse. Pool minutit iga suure muudatuse järel tabab enamiku katkestusi varakult.

Kui midagi on valesti, kirjelda seda täpselt — vaata kuidas kirjutada head veateadet.

Samm 6: naase tagasi, selle asemel et kuhjata

Kui muudatus katkestab midagi ja esimene parandus ei aita, peatu. Iga lisaparandus on ehitatud katkisele olekule ning probleemid kasvavad.

Selle asemel:

1. Naase viimase töötava versiooni juurde (kontrollpunkt või Git commit).
2. Mõtle välja, mis prompti juures ebaselge oli.
3. Proovi uuesti väiksema või selgema päringuga.

See muudatus katkestas mustandite salvestamise. Olen tagasi pöördunud. Seekord: lisa ainult automaatsalvestuse näidik, tekstina päises. Ära muuda mustandite salvestamise viisi.

Samm 7: tea, millal uuesti ehitamine on õige

Nullist uuesti ehitamine viskab ära palju töötavaid detaile. See on väärt ainult siis, kui:

• tootekontseptsioon on täielikult muutunud;
• aluseks olev struktuur ei toeta seda, mida nüüd vajad — näiteks on see ehitatud staatilise saidina, aga nüüd vajab kontosid ja andmebaasi;
• projekt on veel peaaegu tühi.

Kui ehitad uuesti, loetle, mida alles hoida: nimi, värvid, tekst, osad, mis kasutajatele meeldisid.

Näidisprompti

Enne jätkamist võta kokku, kuidas rakendus praegu töötab: lehed, andmed, mida see salvestab, ja kõik, mida pead hapraks.

Tahan lisada korduvad broneeringud. Mis on väikseim versioon, mis oleks kasulik? Paku see kolmeks eraldi muudatuseks, mida saame teha ükshaaval.

Vaata viimased kolm muudatust üle, et leida midagi, mis võis katkestada väljamineku voo. Ära veel muuda.

Levinud vead

• Kümme päringut ühes promptis. Mõned tehakse, mõned pooleldi, ja sa ei saa aru, millised.
• Ebamäärane tagasiside. „See on katki“ või „tee paremaks“ annab oletusi.
• Naabrite mitte kontrollimine. Muudatus jagatud komponendis katkestab kolm muud lehte.
• Parandite parandamine. Neljandal prompti vea parandamisel naase tagasi.
• Konteksti kordamine igal korral, selle asemel et hoida püsivaid reegleid projekti märkmetes.
• Uuesti ehitamine kinni jäädes. Enamik „alusta otsast“ hetki tähendavad tegelikult „naase kaks sammu tagasi“.

Kontrollnimekiri

• Üks eesmärk prompti kohta.
• Kirjeldan, mida näen ja mis peaks juhtuma.
• Suured muudatused saavad enne koodi plaani.
• Ütlen, mis ei tohi muutuda.
• Pärast iga muudatust testin seda, naabreid ja kriitilist teed.
• Salvestan kontrollpunkti või commit'i iga töötava muudatuse järel.
• Kui parandus ebaõnnestub, naasen tagasi, selle asemel et kuhjata parandusi.
• Püsivad reeglid on projekti märkmetes, mida AI loeb igal korral.

Täiustamine Mythexis

Mythex on ehitatud selle tsükli ümber:

• Plaani, ehitamise ja küsimise režiimid. Plaan arutab lähenemist enne muutmist; Küsi vastab ilma koodi muutmata; Ehita teeb muudatuse. Vaata Vestlus.
• Kontrollpunktid. Pärast iga edukat pööret salvestab Mythex Git-kontrollpunkti; Naase sellesse punkti pöörab tagasi. Samuti saad muuta varasemat sõnumit ja Loobu ja saada uuesti, et proovida sellest punktist teistsugust prompti. Vaata Täiustamine ilma uuesti ehitamata.
• Teadmised. Projekti seaded → Teadmised hoiavad püsivaid märkmeid, mida agent järgib igal sõnumil.
• /test laseb agendil pärast suurt muudatust eelvaates klõpsida nii, nagu kasutaja teeks.

Väiksemad päringud maksavad ka vähem krediite. Promptide enda kirjutamise kohta vaata kuidas kirjutada prompte AI-rakenduste ehitajatele; kui midagi siiski katkeb, vaata kuidas silluda AI-ga ehitatud rakendust.

Küsimused