Kako pisati pozive za orodja za izdelavo aplikacij z AI (s primeri pred in po)

Dober poziv za orodje za izdelavo aplikacij z AI opisuje izdelek, ne kode: kdo ga uporablja, kaj ti ljudje počnejo korak za korakom, kakšne podatke hrani in kdo sme videti kaj. Ko prva različica obstaja, zahtevajte eno specifično spremembo na sporočilo, povejte, kaj mora ostati enako, in težave opišite kot »naredil sem X, pričakoval Y, dobil Z«. Te tri navade odpravijo večino razočaranj.

Preostanek tega vodnika prikazuje vzorce podrobneje, s primeri pred in po, ki jih lahko prilagodite.

Zakaj je pozivanje orodja za izdelavo aplikacij drugačno od klepeta z AI

Ko klepetalnemu pomočniku postavite vprašanje, nejasen poziv dobi nejasen odgovor in greste naprej. Ko pozivate orodje za izdelavo aplikacij, je odgovor delujoč program. Vsaka vrzel v vašem opisu se zapolni z ugibanjem, ta ugibanja pa postanejo koda, tabele podatkov in zasloni, s katerimi morate potem živeti ali jih razveljaviti.

Cilj poziva torej ni zveneti pametno. Cilj je pustiti manj pomembnih odločitev slučaju. Tehničnega besedišča za to ne potrebujete. Potrebujete natančnost pri stvareh, ki jih poznate samo vi: vaši uporabniki, vaš delovni tok in vaša pravila.

Kaj vključiti v prvi poziv

Preden kaj napišete, odgovorite na ta vprašanja. Vsako zapolni vrzel, ki bi jo sicer AI ugibal.

Zadnja vrstica je podcenjena. Če poveste, kaj ne želite, AI ne bo dodal bloga, strani s cenami in prijave na glasilo, ki jih nikoli niste zahtevali.

Primer: prvi poziv pred in po

Pred:

Naredi mi aplikacijo za mojo telovadnico.

Orodje mora ugibati vse: člani ali osebje? Skupinske vadbe ali osebni trening? Plačila? Dobili boste nekaj, kar izgleda kot spletna stran telovadnice in ne naredi ničesar, kar potrebujete.

Po:

Zgradi aplikacijo za rezervacije vadb za majhen studio joge. Člani vidijo vadbe tega tedna (ime, učitelj, čas, prosta mesta) in si rezervirajo mesto ter jo odpovejo do dve uri pred začetkom. Člani se prijavijo z e-pošto in geslom. Lastnik studia se prijavi, da doda vadbe, vidi, kdo je prijavljen, in označi prisotnost. Shranjuj vadbe, člane in rezervacije v bazi podatkov. Miren, svetel dizajn, ki dobro deluje na telefonih. Še brez plačil.

Drugi poziv je še vedno kratek. Samo odgovarja na vprašanja iz zgornje tabele.

Opišite vedenje, ne izvedbe

Pogosto dobite boljše rezultate, če opišete, kaj naj se zgodi, namesto kako naj se zgradi.

Pred:

Dodaj useEffect, ki pridobi rezervacije, in modalno komponento za urejanje.

Po:

Ko lastnik klikne rezervacijo, odpri okno, kjer lahko spremeni čas ali jo odpove. Spremembe naj se takoj pokažejo na seznamu.

Prvi poziv AI zaklene v določeno tehniko, ki morda ne ustreza, kako je aplikacija zgrajena. Drugi mu pove rezultat in pusti, naj izbere pravi pristop za kodo, ki jo je že napisal. Če ste razvijalec in imate močno željo, jo povejte, a jo združite z rezultatom.

Bodite konkretni glede pravil

Poslovna pravila so mesto, kjer aplikacije, zgrajene z AI, najpogosteje odpovejo, ker so vam očitna, AI pa jih ne vidi. Zapišite jih.

• Omejitve: »Član lahko ima največ tri prihodnje rezervacije.«
• Časovni roki: »Odpovedi se zaprejo dve uri pred začetkom vadbe.«
• Robni primeri: »Če je vadba polna, pokaži gumb za čakalni seznam namesto Rezerviraj.«
• Dovoljenja: »Učitelji vidijo prisotnost na svojih vadbah, ne pa na tujih.«

Vsako od teh je en stavek. Če katerega izpustite, aplikacija pravila ali ne bo uveljavila ali bo izmislila svojo različico.

Po prvi različici: ena sprememba na sporočilo

Ko nekaj teče v predogledu, preklopite z opisovanja celotnega izdelka na zahtevanje majhnih sprememb, ki jih lahko preverite.

Pred:

Oblikovanje ni v redu, rezervacija ne deluje pravilno in želim pogled koledarja ter e-pošto.

Po (kot štiri ločena sporočila):

1. Ko rezerviram zadnje mesto na vadbi, še vedno piše »1 prosto mesto«. Moralo bi pisati »Polno« in skriti gumb Rezerviraj.
2. Na strani urnika dodaj tedenski koledar, en stolpec na dan. Ohrani trenutni seznam kot možnost.
3. Naredi kartice vadb na telefonih bolj zbite: manjši zamiki, ime učitelja v isti vrstici kot čas.
4. Članu pošlji potrditev po e-pošti, ko rezervira.

Zakaj to deluje:

• Vsaka sprememba je dovolj majhna, da jo AI zadane v enem prehodu.
• Vsako lahko preizkusite, preden greste naprej.
• Če ena spodleti, lahko samo ta korak razveljavite, ne da bi izgubili druge.

Povejte, kaj ohraniti

Ko zahtevate spremembo nečesa, kar že deluje, povejte, kaj ne sme spremeniti. To je najlažji način, da preprečite regresije (stvari, ki so delovale in se po urejanju pokvarijo).

Preoblikuj naslovno sekcijo domače strani z večjim naslovom in fotografijo na desni. Ohrani navigacijo, barve in vse pod naslovno sekcijo popolnoma tako, kot so.

Enako velja za podatke: »Dodaj polje za telefonsko številko članom. Ne odstranjuj in ne preimenuj nobenega obstoječega polja.«

Uporabite zaslonske slike in točno besedilo

Besede kot »stvar zgoraj« so dvoumne. Večina orodij za izdelavo aplikacij sprejema slike, zaslonska slika s kratkim opombo pa je hitrejša kot odstavek opisa.

• Priložite zaslonsko sliko in zapišite »gumb, obkrožen z rdečo, se na telefonih prekriva z menijem«.
• Prilepite točno besedilo napake, ne parafrazirajte ga.
• Navedite oznake na zaslonu dobesedno: »gumb Shrani spremembe na strani Nastavitve«.

Za napake posebej uporabite to obliko:

Na strani rezervacij sem kliknil Prekliči pri rezervaciji za jutri. Pričakoval sem, da bo izginila s seznama. Namesto tega se ni nič zgodilo in rezervacija je po osvežitvi še vedno tam. Popravi in preveri, da preklic deluje.

Kako razhroščiti aplikacijo, zgrajeno z AI, gre v to podrobneje.

Pri velikih spremembah najprej načrt

Za vse, kar se dotika mnogih delov aplikacije – dodajanje uporabniških računov aplikaciji, ki jih ni imela, dodajanje plačil, spreminjanje strukture podatkov – zahtevajte načrt, preden se spremeni kakršna koli koda.

Preden karkoli spremeniš, razloži, kako bi dodal ekipne račune: katere nove tabele, katere strani se spremenijo in kaj se zgodi z obstoječimi uporabniki. Še ne ureja kode.

Preberite načrt. Če nekaj narobe razume, je popravek odstavka veliko cenejši kot popravek dokončane funkcije. Mnoga orodja imajo namenski način za to; v Mythexu je to način Plan, poleg Build in Ask.

Čemu se izogibati

Glede API ključev: če potrebujete storitev za plačila ali e-pošto, shranite njene ključe v skrivnosti projekta, ne v poziv. Če vam je to novo, glejte kaj so okoljske spremenljivke in skrivnosti.

Predloge za ponovno uporabo

Prilagodite jih tako, da zamenjate oglate dele.

Nova aplikacija:

Zgradi [vrsta aplikacije] za [kdo]. [Glavni tok, korak za korakom]. [Druga vrsta uporabnika] se prijavi, da [kaj počne]. Shrani [podatki] v bazi podatkov. [Videz]. Izpusti [stvari za pozneje].

Nova funkcija:

Dodaj [funkcijo] na [stran]. Ko [uporabnik] naredi [dejanje], naj se zgodi [kaj]. Samo [kdo] lahko [to stori]. Ohrani [obstoječe stvari] kot so.

Oblikovalska sprememba:

Na [strani] spremeni [določen element] v [določena sprememba]. Ohrani [kaj ohraniti]. Preveri, da je videti prav na zaslonu širine telefona.

Napaka:

Na [strani] sem [koraki]. Pričakoval sem [pričakovano]. Namesto tega [dejansko, plus točno besedilo napake]. Popravi in preveri, da tok deluje.

Vprašanje brez sprememb:

Ne spreminjaj nobene kode. Razloži, kako deluje [del aplikacije] in kje so shranjeni [podatki].

Pisanje daljše specifikacije

Pri večjih projektih lahko pomaga, če najprej napišete enostranski opis in ga prilepite kot prvi poziv: uporabniki, osrednji tokovi, podatki, pravila in kaj je izven obsega. Osnutek lahko celo pripravi AI – naš vodnik za pisanje dokumenta o zahtevah izdelka z AI pojasni, kako. Samo prvo zahtevo za gradnjo omejite na osrednji tok, ostalo dodajajte korak za korakom.

Pozivanje v Mythexu

Vse zgoraj deluje v Mythexu. Nekaj posebnosti, ki pomagajo:

• Načini Build, Plan in Ask. Uporabite Plan za velike ali tvegane spremembe in Ask, ko želite razlago brez urejanja.
• Kontrolne točke. Po vsaki uspešni spremembi Mythex shrani kontrolno točko, gumb Vrni na to točko pod odgovorom pa vrne projekt nazaj. Lahko tudi uredite prejšnje sporočilo in ga ponovno pošljete, da preizkusite drugačen poziv od tam naprej.
• Kartica skrivnosti. Ko agent potrebuje API ključ, vpraša prek kartice v klepetu, tako da se vrednost shrani kot skrivnost projekta in ne v vaše sporočilo.
• Slike. Priložite zaslonske slike ali makete in agent jih bo pogledal.

V dokumentaciji sta kratka strani o učinkovitih pozivih in o iteriranju brez ponovne gradnje. Če začenjate od nule, kako zgraditi aplikacijo z AI vodi skozi celoten projekt, kako oblikovati dobro izgledajočo aplikacijo z AI pa pokriva pozive za vizualno dodelavo.

Vprašanja