Kako pisati upite za AI alate za izradu aplikacija (s primjerima prije i poslije)

Dobar upit za AI alat za izradu aplikacija opisuje proizvod, a ne kod: tko ga koristi, što korisnik radi korak po korak, koje podatke čuva i tko smije što vidjeti. Nakon što postoji prva verzija, tražite jednu konkretnu promjenu po poruci, recite što mora ostati isto i opišite probleme kao "Učinio sam X, očekivao sam Y, dobio sam Z". Ta tri navika riješe većinu razočaravajućih rezultata.

Ostatak ovog vodiča pokazuje obrasce detaljno, s primjerima prije i poslije koje možete prilagoditi.

Zašto je upit za alat za izradu aplikacija drugačiji od razgovora s AI-jem

Kad postavite pitanje chat asistentu, nejasan upit daje nejasan odgovor i idete dalje. Kad upitate AI alat za izradu aplikacija, odgovor je program koji radi. Svaka praznina u vašem opisu popunjava se pretpostavkom, a te pretpostavke postaju kod, tablice baze podataka i ekrani s kojima onda morate živjeti ili ih poništiti.

Dakle cilj upita nije zvučati pametno. Cilj je ostaviti manje važnih odluka slučaju. Za to ne trebate tehnički rječnik. Trebate biti precizni u stvarima koje znate samo vi: vaši korisnici, vaš tijek rada i vaša pravila.

Što uključiti u prvi upit

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

Taj zadnji red je podcijenjen. Kad kažete što ne želite, sprječavate 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 pogađati sve: članovi ili osoblje? Grupni treninzi ili personal trening? Plaćanja? Dobit ćete nešto što izgleda kao web-stranica teretane i ne radi ništa što vam treba.

Poslije:

Napravi aplikaciju za rezervaciju grupnih treninga za mali studio joge. Članovi vide grupne treninge ovog tjedna (naziv, trener, vrijeme, slobodna mjesta), rezerviraju mjesto i otkazuju najkasnije dva sata prije početka. Članovi se registriraju e-adresom i lozinkom. Vlasnik studija prijavljuje se kako bi dodao treninge, vidio tko je prijavljen i označio dolazak. Treninge, članove i rezervacije spremi u bazu podataka. Mirni, svijetli dizajn koji dobro radi na telefonima. Još bez plaćanja.

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

Opišite ponašanje, a ne implementaciju

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

Prije:

Dodaj useEffect koji dohvaća rezervacije i modalnu komponentu za uređivanje.

Poslije:

Kad vlasnik klikne na rezervaciju, neka se otvori panel u kojem može promijeniti vrijeme ili je otkazati. Promjene se odmah trebaju pokazati na popisu.

Prvi upit zaključava AI u određenu tehniku koja možda ne odgovara načinu na koji je aplikacija izgrađena. Drugi mu kaže ishod i pušta ga da odabere pravi pristup za kod koji je već napisao. Ako ste programer i imate snažnu preferenciju, recite je, ali je uz ishod.

Budite konkretni u pravilima

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

• Ograničenja: "Član može imati najviše tri buduće rezervacije."
• Rokovi: "Otkazivanje se zatvara dva sata prije početka treninga."
• Rubni slučajevi: "Ako je grupni trening pun, umjesto gumba Rezerviraj prikaži gumb za listu čekanja."
• Dopuštenja: "Treneri vide dolazak na svojim treninzima, ali ne i na tuđima."

Svako od ovoga je jedna rečenica. Ako bilo koje izostavite, aplikacija ili neće provoditi pravilo ili će izmisliti svoju verziju.

Nakon prve verzije: jedna promjena po poruci

Kad nešto radi u pregledu, prijeđite s opisivanja cijelog proizvoda na traženje malih promjena koje se mogu provjeriti.

Prije:

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

Poslije (kao četiri zasebne poruke):

1. Kad rezerviram zadnje mjesto na treningu, piše i dalje "1 mjesto slobodno". Treba pisati "Popunjeno" i sakriti gumb Rezerviraj.
2. Dodaj prikaz kalendara po tjednima na stranicu rasporeda, jedan stupac po danu. Zadrži trenutni prikaz popisa kao opciju.
3. Učini kartice treninga kompaktnijima na telefonima: manji razmaci, ime trenera u istom retku kao vrijeme.
4. Pošalji članu potvrdu e-poštom kad napravi rezervaciju.

Zašto ovo radi:

• Svaka promjena je dovoljno mala da je AI može ispravno napraviti u jednom prolazu.
• Možete testirati svaku prije nego što nastavite.
• Ako neka pođe po zlu, možete poništiti samo taj korak bez gubitka ostalih.

Recite što treba ostati isto

Kad tražite promjenu nečega što već radi, recite AI-ju što se ne smije mijenjati. To je najlakši način da zaustavite regresije (stvari koje su radile, a nakon izmjene prestanu).

Preoblikuj naslovni dio početne stranice s većim naslovom i fotografijom s desne strane. Zadrži navigaciju, boje i sve ispod naslovnog dijela točno kakvo je.

Isto vrijedi i za podatke: "Dodaj polje za broj telefona članovima. Ne uklanjaj niti preimenuj postojeća polja."

Koristite snimke zaslona i točan tekst

Riječi poput "ono gore" su nejasne. Većina AI alata za izradu aplikacija prihvaća slike, a snimka zaslona s kratkom napomenom brža je od odlomka opisa.

• Priložite snimku zaslona i napišite "gumb zaokružen crveno preklapa izbornik na telefonima".
• Zalijepite točan tekst svake poruke o grešci umjesto da je parafrazirate.
• Točno citirajte natpise na ekranu: "gumb Spremi promjene na stranici Postavke".

Za greške posebno koristite ovaj oblik:

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

Naš vodič o tome kako ispraviti grešku u aplikaciji izrađenoj AI-jem detaljnije to objašnjava.

Prvo planirajte velike promjene

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 išta promijeniš, objasni kako bih dodao timske račune: koje nove tablice, koje se stranice mijenjaju i što se događa s postojećim korisnicima. Još ne mijenjaj kod.

Pročitajte plan. Ako nešto pogrešno razumije, ispravak jednog odlomka puno je jeftiniji od ispravljanja gotove značajke. Mnogi alati imaju poseban način rada za to; na Mythexu je to način Plan, uz Build i Ask.

Čega se kloniti

Za API ključeve: ako vam treba usluga za plaćanja ili e-poštu, stavite njezine ključeve u tajne projekta, a ne u upit. Pogledajte što su varijable okoline i tajne ako vam je to novo.

Predlošci za ponovnu upotrebu

Prilagodite ih zamjenom dijelova u uglatim zagradama.

Nova aplikacija:

Napravi [vrsta aplikacije] za [tko]. Oni [glavni tijek, korak po korak]. [Druga vrsta korisnika] prijavljuje se kako bi [što radi]. Podatke [podaci] spremi u bazu podataka. [Izgled i dojam]. Izostavi [što ostavljamo za kasnije].

Nova značajka:

Dodaj [značajka] na stranicu [stranica]. Kad [korisnik] napravi [radnja], neka se dogodi [što treba]. Samo [tko] može [to učiniti]. Zadrži [postojeće stvari] kakve jesu.

Promjena dizajna:

Na stranici [stranica] promijeni [određeni element] u [konkretna promjena]. Zadrži [što zadržati]. Provjeri da izgleda dobro na ekranu širine telefona.

Greška:

Na stranici [stranica] napravio sam [koraci]. Očekivao sam [očekivano]. Umjesto toga [stvarno, uz točan tekst greške]. Popravi to i provjeri da tijek radi.

Pitanje bez promjena:

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

Pisanje dužeg opisa

Za veće projekte može pomoći da prvo napišete kratki brief od jedne stranice i zalijepite ga kao početni upit: korisnike, osnovne tijekove, podatke, pravila i što je izvan opsega. Možete čak i uz pomoć AI-ja napraviti nacrt. Naš vodič o pisanju dokumenta o zahtjevima proizvoda uz AI objašnjava kako. Samo zadržite prvi zahtjev za izradom na osnovnom tijeku, a ostalo dodajte korak po korak.

Pisanje upita u Mythexu

Sve gore navedeno radi u Mythexu. Nekoliko specifičnosti koje pomažu:

• Načini Build, Plan i Ask. Koristite Plan za velike ili rizične promjene, a Ask kad želite objašnjenje bez izmjena.
• Checkpointi. Nakon svake uspješne promjene Mythex sprema checkpoint, a Revert to this point na odgovoru vraća projekt unatrag. Možete i urediti raniju poruku i poslati je ponovno da isprobate drugačiji upit od te točke.
• Kartica s tajnama. Kad agent treba API ključ, pita kroz karticu u chatu, pa se vrijednost sprema kao tajna projekta, a ne upisuje u vašu poruku.
• Slike. Priložite snimke zaslona ili makete i agent će ih pogledati.

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

Pitanja