Kako napisati upite za AI alate za izradu aplikacija (sa primjerima prije i poslije)

Dobar upit za AI alat za izradu aplikacija opisuje proizvod, a ne kod: ko ga koristi, šta radi korak po korak, koje podatke čuva i ko smije šta da vidi. Nakon što prva verzija postoji, tražite jednu konkretnu promjenu po poruci, recite šta mora ostati isto i opišite probleme kao "uradio sam X, očekivao sam Y, dobio sam Z". Ove tri navike rješavaju većinu razočaravajućih rezultata.

Ostatak ovog vodiča detaljno prikazuje obrasce, uz primjere prije i poslije koje možete prilagoditi.

Zašto je upitivanje AI alata za aplikacije drugačije od chata s AI-jem

Kada asistentu postavite pitanje, loš upit daje loš odgovor i idete dalje. Kada upitate AI alat za izradu aplikacija, odgovor je program koji radi. Svaka praznina u vašem opisu popunjava se nagađanjem, a ta nagađanja postaju kod, tabele u bazi i ekrani koje onda morate da prihvatite ili poništite.

Dakle, cilj upita nije da zvuči pametno. Cilj je da se manje važnih odluka prepusti slučaju. Ne treba vam tehnički rječnik za to. Potrebno je da budete konkretni u stvarima koje samo vi znate: o vašim korisnicima, vašem toku rada i vašim pravilima.

Šta uključiti u prvi upit

Prije nego što bilo šta napišete, odgovorite na ova pitanja. Svako zatvara prazninu koju bi AI inače pogađao.

Ta posljednja stavka je potcijenjena. Reći šta ne želite sprječava AI da doda blog, stranicu s cijenama i prijavu za newsletter koje niste tražili.

Prije i poslije: prvi upit

Prije:

Napravi mi aplikaciju za teretanu.

Alat mora sve da pogađa: članovi ili osoblje? Časovi ili lični trening? Plaćanja? Dobićete nešto što izgleda kao sajt teretane i ne radi ono što vam treba.

Poslije:

Napravi aplikaciju za rezervaciju časova za mali studio joge. Članovi vide časove ove sedmice (naziv, instruktor, vrijeme, slobodna mjesta) i rezervišu mjesto, a otkazati mogu najkasnije dva sata prije časa. Članovi se prijavljuju e-adresom i lozinkom. Vlasnik studija se prijavljuje da dodaje časove, vidi ko je rezervisao i označava prisustvo. Čuvaj časove, članove i rezervacije u bazi podataka. Miran, svijetao dizajn koji dobro radi na telefonima. Još bez plaćanja.

Druga verzija je i dalje kratka. Samo odgovara na pitanja iz tabele iznad.

Opišite ponašanje, a ne implementaciju

Često ćete dobiti bolje rezultate ako opišete šta se treba dogoditi, a ne kako to napraviti.

Prije:

Dodaj useEffect koji učitava rezervacije i modalnu komponentu za izmjenu.

Poslije:

Kada vlasnik klikne na rezervaciju, neka se otvori panel gdje može promijeniti vrijeme ili je otkazati. Promjene se odmah prikazuju u listi.

Prvi upit zaključava AI u određenu tehniku koja možda ne odgovara načinu na koji je aplikacija već građena. Drugi mu govori ishod i ostavlja mu da izabere pravi pristup za kod koji je već napisao. Ako ste programer i imate snažnu preferenciju, recite je, ali je uparite sa ishodom.

Budite konkretni o pravilima

Poslovna pravila su mjesto gdje aplikacije napravljene AI-jem najčešće pogriješe, jer su vama očigledna, a AI ih ne vidi. Navedite ih eksplicitno.

• Ograničenja: "Član može imati najviše tri buduće rezervacije."
• Rokovi: "Otkazivanja se zatvaraju dva sata prije početka časa."
• Rubni slučajevi: "Ako je čas pun, prikaži dugme za listu čekanja umjesto Rezerviši."
• Dozvole: "Instruktori vide prisustvo na svojim časovima, ali ne i na tuđim."

Svako od ovih je jedna rečenica. Ako neko od njih izostavite, aplikacija ili neće sprovoditi pravilo ili će izmisliti svoju verziju.

Nakon prve verzije: jedna promjena po poruci

Kada nešto radi u pregledu, prelazite s opisivanja cijelog proizvoda na traženje malih promjena koje se mogu provjeriti.

Prije:

Dizajn nije dobar, rezervacija ne radi kako treba i želim prikaz kalendara i e-poštu.

Poslije (kao četiri zasebne poruke):

1. Kada rezervišem posljednje mjesto na času, na njemu i dalje piše "1 mjesto slobodno". Treba da piše "Popunjeno" i da sakrije dugme Rezerviši.
2. Dodaj prikaz kalendara po sedmici na stranici rasporeda, jedna kolona po danu. Zadrži trenutni prikaz liste kao opciju.
3. Učini kartice časova kompaktnijim na telefonima: manji razmak, ime instruktora u istom redu kao vrijeme.
4. Pošalji članu potvrdnu e-poštu kada rezerviše.

Zašto ovo funkcioniše:

• Svaka promjena je dovoljno mala da je AI tačno uradi u jednom prolazu.
• Možete testirati svaku prije nego što pređete na sljedeću.
• Ako neka pođe po zlu, možete vratiti samo taj korak, bez gubitka ostalih.

Recite šta treba sačuvati

Kada tražite promjenu nečega što već radi, recite šta ne smije da se mijenja. Ovo je najlakši način da spriječite regresije (stvari koje su ranije radile pa se pokvare nakon izmjene).

Preuredi gornji dio početne stranice s većim naslovom i fotografijom s desne strane. Zadrži navigaciju, boje i sve ispod gornjeg dijela potpuno isto.

Isto važi i za podatke: "Dodaj polje za broj telefona članovima. Ne briši niti preimenuj postojeća polja."

Koristite snimke ekrana i tačan tekst

Riječi poput "ono gore" su nejasne. Većina AI alata za aplikacije prihvata slike, a snimak ekrana sa kratkom napomenom brži je od pasusa opisa.

• Priložite snimak ekrana i recite "dugme zaokruženo crveno preklapa meni na telefonima".
• Zalijepite tačan tekst svake poruke o grešci umjesto parafraze.
• Navedite tačno oznake sa ekrana: "dugme Sačuvaj promjene na stranici Podešavanja".

Za greške konkretno, koristite ovaj oblik:

Na stranici rezervacija kliknuo sam Otkaži na rezervaciju za sutra. Očekivao sam da nestane sa liste. Umjesto toga, ništa se nije desilo i rezervacija je i dalje tu nakon osvježavanja. Popravi to i provjeri da otkazivanje radi.

Naš vodič o tome kako debagovati aplikaciju napravljenu AI-jem detaljnije ide u ovu temu.

Planirajte prije velikih promjena

Za sve što dira mnogo dijelova aplikacije — dodavanje korisničkih računa aplikaciji koja ih nije imala, dodavanje plaćanja, promjena načina na koji su podaci strukturirani — zatražite plan prije nego što se kod promijeni.

Prije nego što mijenjaš bilo šta, objasni kako bi dodao timske račune: koje nove tabele, koje stranice se mijenjaju i šta se dešava s postojećim korisnicima. Još ne mijenjaj kod.

Pročitajte plan. Ako nešto pogrešno razumije, ispravljanje paragrafa je mnogo jeftinije od ispravljanja gotove funkcije. Mnogi alati imaju poseban režim za to; u Mythexu je to režim Plan, uz Build i Ask.

Čega se kloniti

Za API ključeve: ako vam treba servis za plaćanje ili e-poštu, stavite njegove ključeve u tajne projekta, a ne u upit. Ako vam je to novo, pogledajte šta su varijable okruženja i tajne.

Šabloni za ponovnu upotrebu

Prilagodite ih zamjenom zagrada.

Nova aplikacija:

Napravi [vrsta aplikacije] za [ko]. Oni [glavni tok, korak po korak]. [Drugi tip korisnika] se prijavljuje da [šta radi]. Čuvaj [podaci] u bazi podataka. [Izgled i osjećaj]. Izostavi [stvari za kasnije].

Nova funkcija:

Dodaj [funkcija] na [stranica]. Kada [korisnik] uradi [radnja], neka se dogodi [šta]. Samo [ko] može [to uraditi]. Zadrži [postojeće stvari] kakve jesu.

Promjena dizajna:

Na [stranica], promijeni [konkretan element] u [konkretna promjena]. Zadrži [šta treba ostati]. Provjeri da izgleda dobro na ekranu širine telefona.

Greška:

Na [stranica] uradio sam [koraci]. Očekivao sam [očekivano]. Umjesto toga [stvarno, plus tačan tekst greške]. Popravi i provjeri da tok radi.

Pitanje bez promjena:

Ne mijenjaj nikakav kod. Objasni kako radi [dio aplikacije] i gdje se čuvaju [podaci].

Pisanje dužeg opisa

Za veće projekte može pomoći da prije toga napišete jednostranični brif i zalijepite ga kao početni upit: korisnike, osnovne tokove, podatke, pravila i šta je van obima. Možete čak zamoliti AI da vam pomogne da ga napišete; naš vodič o pisanju dokumenta o zahtjevima proizvoda uz AI pokazuje kako. Samo držite prvi zahtjev za izgradnju na osnovnom toku, a ostalo dodajte korak po korak.

Upitivanje u Mythexu

Sve iznad radi i u Mythexu. Nekoliko specifičnih stvari koje pomažu:

• Režimi Build, Plan i Ask. Koristite Plan za velike ili rizične promjene, a Ask kada želite objašnjenje bez izmjena.
• Checkpointi. Nakon svake uspješne promjene Mythex čuva checkpoint, a Revert to this point na odgovoru vraća projekat unazad. Takođe možete izmijeniti raniju poruku i ponovo je poslati da pokušate drugi upit od te tačke.
• Kartica s tajnama. Kada agentu treba API ključ, traži ga kroz karticu u chatu, pa se vrijednost čuva kao tajna projekta, a ne upisuje u vašu poruku.
• Slike. Priložite snimke ekrana ili makete i agent će ih pogledati.

Dokumentacija ima kratku stranicu o efikasnim upitima i jednu o iteriranju bez ponovne izgradnje. Ako počinjete od nule, kako napraviti aplikaciju uz AI prolazi kroz cijeli projekat, a kako dizajnirati dobro izgledajuću aplikaciju uz AI pokriva upite za vizuelno doterivanje.

Pitanja