Ako písať výzvy pre AI nástroje na tvorbu aplikácií (s príkladmi pred a po)
Dobrá výzva pre AI nástroj na tvorbu aplikácií opisuje produkt, nie kód: kto ho používa, čo robí krok za krokom, aké údaje uchováva a kto ich smie vidieť. Keď prvá verzia existuje, žiadajte jednu konkrétnu zmenu v správe, povedzte, čo musí zostať rovnaké, a problémy opisujte ako „urobil som X, očakával som Y, dostal som Z“. Tieto tri návyky opravia väčšinu sklamaných výsledkov.
Zvyšok tohto návodu ukazuje vzory podrobnejšie, s príkladmi pred a po, ktoré si môžete prispôsobiť.
Prečo je písanie výziev pre nástroj na tvorbu aplikácií iné ako rozhovor s AI
Keď sa opýtate chatovacieho asistenta na otázku, vágna výzva dostane vágnu odpoveď a vy idete ďalej. Keď píšete výzvu pre AI nástroj na tvorbu aplikácií, odpoveďou je bežiaci program. Každá medzera vo vašom opise sa doplní odhadom a tieto odhady sa stanú kódom, databázovými tabuľkami a obrazovkami, s ktorými potom musíte žiť alebo ich vrátiť späť.
Cieľ výzvy preto nie je znieť múdro. Ide o to, nechať na náhodu čo najmenej dôležitých rozhodnutí. Na to nepotrebujete technický slovník. Potrebujete byť konkrétni v tom, čo viete len vy: o vašich používateľoch, pracovnom postupe a pravidlách.
Čo uviesť v prvej výzve
Pred písaním čohokoľvek odpovedzte na tieto otázky. Každá zatvára medzeru, do ktorej by AI inak hádala.
| Uviesť | Prečo na tom záleží | Príklad |
|---|---|---|
| Produkt jednou vetou | Nastaví rámec pre všetky ďalšie rozhodnutia | „Rezervačný web pre holičstvo s dvoma kreslami“ |
| Kto ho používa | Určí obrazovky a tón | „Zákazníci bez objednávky na telefónoch a majiteľ na notebooku“ |
| Hlavný tok krok za krokom | To, čo musí fungovať ako prvé | „Vyberiem službu, vyberiem čas, zadám meno a telefón, dostanem potvrdenie“ |
| Údaje, ktoré uchováva | Stane sa návrhom databázy | „Služby, rezervácie, zákazníci“ |
| Kto čo môže vidieť alebo meniť | Určí prihlásenie a oprávnenia | „Všetky rezervácie vidí iba majiteľ“ |
| Vzhľad a dojem, stručne | Zabráni všeobecnému predvolenému štýlu | „Tmavé, jednoduché, veľké tlačidlá“ |
| Čo zatiaľ vynechať | Udrží prvú verziu malú | „Zatiaľ bez platieb a recenzií“ |
Tento posledný riadok sa podceňuje. Keď poviete, čo nechcete, AI nepridá blog, cenník a registráciu na newsletter, o ktoré ste nežiadali.
Pred a po: prvá výzva
Pred:
Urob mi aplikáciu pre moju posilňovňu.
Nástroj musí hádať všetko: členovia alebo zamestnanci? Skupinové hodiny alebo osobný tréning? Platby? Dostanete niečo, čo vyzerá ako web posilňovne a nerobí nič, čo potrebujete.
Po:
Postav aplikáciu na rezerváciu hodín pre malé štúdio jogy. Členovia vidia hodiny tohto týždňa (názov, lektor, čas, voľné miesta), rezervujú si miesto a môžu rezerváciu zrušiť najneskôr dve hodiny pred začiatkom. Členovia sa registrujú e-mailom a heslom. Majiteľ štúdia sa prihlási, aby pridal hodiny, videl, kto je prihlásený, a označil účasť. Ulož hodiny, členov a rezervácie do databázy. Pokojný, svetlý dizajn, ktorý dobre funguje na telefónoch. Zatiaľ bez platieb.
Druhá verzia je stále krátka. Len odpovedá na otázky z tabuľky vyššie.
Opisujte správanie, nie implementáciu
Často dostanete lepšie výsledky, keď opíšete, čo sa má stať, namiesto toho, ako to postaviť.
Pred:
Pridaj useEffect, ktorý načíta rezervácie, a komponent modálneho okna na úpravu.
Po:
Keď majiteľ klikne na rezerváciu, otvorí sa panel, kde môže zmeniť čas alebo ju zrušiť. Zmeny sa majú hneď ukázať v zozname.
Prvá výzva zamkne AI na konkrétnu techniku, ktorá nemusí sedieť na to, ako je aplikácia postavená. Druhá jej povie výsledok a nechá ju zvoliť správny prístup pre kód, ktorý už napísala. Ak ste vývojár a máte silnú preferenciu, povedzte ju, ale spárujte ju s výsledkom.
Buďte konkrétni v pravidlách
Obchodné pravidlá sú miesto, kde aplikácie postavené s AI najčastejšie zlyhávajú, pretože sú zjavné pre vás a neviditeľné pre AI. Napíšte ich presne.
- Limity: „Člen môže mať naraz najviac tri budúce rezervácie.“
- Časovanie: „Zrušenie je možné do dvoch hodín pred začiatkom hodiny.“
- Okrajové prípady: „Ak je hodina plná, namiesto Rezervovať zobraz tlačidlo čakacej listiny.“
- Oprávnenia: „Lektori vidia účasť na svojich hodinách, ale nie na hodinách iných lektorov.“
Každé z toho je jedna veta. Keď niektorú vynecháte, aplikácia buď pravidlo nevynúti, alebo si vymyslí vlastnú verziu.
Po prvej verzii: jedna zmena v správe
Keď je niečo spustené v náhľade, prejdite od opisu celého produktu k žiadaniu malých, overiteľných zmien.
Pred:
Dizajn nesedí, rezervácia nefunguje správne a chcem zobrazenie kalendára a e-maily.
Po (ako štyri samostatné správy):
- Keď rezervujem posledné miesto v hodine, hodina stále ukazuje „1 voľné miesto“. Má ukázať „Plné“ a skryť tlačidlo Rezervovať.
- Pridaj na stránku rozvrhu kalendár v týždennom zobrazení, jeden stĺpec na každý deň. Zachovaj súčasné zobrazenie zoznamu ako možnosť.
- Na telefónoch zhusti karty hodín: menší odsek, meno lektora na tom istom riadku ako čas.
- Pošli členovi potvrdzujúci e-mail, keď si rezervuje.
Prečo to funguje:
- Každá zmena je dostatočne malá, aby ju AI zvládla na prvý pokus.
- Každú môžete otestovať, skôr než pokračujete.
- Ak jedna dopadne zle, viete vrátiť späť len tento krok bez straty ostatných.
Povedzte, čo zachovať
Keď žiadate zmenu niečoho, čo už funguje, povedzte AI, čo sa nesmie zmeniť. Je to najjednoduchší spôsob, ako zastaviť regresie (veci, ktoré predtým fungovali a po úprave sa pokazia).
Prerob úvodnú časť domovskej stránky s väčším nadpisom a fotkou napravo. Navigáciu, farby a všetko pod úvodnou časťou nechaj presne tak, ako sú.
Rovnako to platí pre dáta: „Pridaj členom pole pre telefónne číslo. Neodstraňuj ani nepremenúvaj žiadne existujúce polia.“
Používajte screenshoty a presný text
Slová ako „tá vec hore“ sú nejednoznačné. Väčšina AI nástrojov na tvorbu aplikácií prijíma obrázky a screenshot s krátkou poznámkou je rýchlejší než odsek opisu.
- Priložte screenshot a napíšte „tlačidlo označené červeným prekrýva menu na telefónoch“.
- Vložte presný text každej chybovej správy namiesto jej prerozprávania.
- Citujte popisky na obrazovke presne: „tlačidlo Uložiť zmeny na stránke Nastavenia“.
Pri chybách použite tento tvar:
Na stránke rezervácií som kliknul na Zrušiť pri rezervácii na zajtra. Očakával som, že zmizne zo zoznamu. Namiesto toho sa nestalo nič a rezervácia tam po obnovení stránky stále je. Oprav to a over, že zrušenie funguje.
Náš návod o tom, ako ladiť aplikáciu postavenú s AI, ide do tejto témy hlbšie.
Pri veľkých zmenách najprv plán
Pri čomkoľvek, čo sa dotýka mnohých častí aplikácie – pridávanie používateľských účtov do aplikácie, ktorú ich nemala, pridávanie platieb, zmena štruktúry dát – si pred akoukoľvek zmenou kódu vyžiadajte plán.
Predtým, než čokoľvek zmeníš, vysvetli, ako by si pridal tímové účty: aké nové tabuľky, ktoré stránky sa zmenia a čo sa stane s existujúcimi používateľmi. Zatiaľ kód neupravuj.
Prečítajte si plán. Ak niečomu nerozumie, oprava odseku stojí oveľa menej než oprava hotovej funkcie. Mnohé nástroje majú na to samostatný režim; v Mythex je to režim Plan, popri režimoch Build a Ask.
Čomu sa vyhnúť
| Vyhnite sa | Prečo | Namiesto toho |
|---|---|---|
| „Urob to lepšie“ / „Nech to zapáli“ | Žiadny cieľ, takže AI mení veci náhodne | Pomenujte zmenu: „viac priestoru medzi sekciami, väčšie nadpisy“ |
| Jedna obrovská výzva s desiatimi funkciami | Chyby sa násobia; ťažko sa testuje | Jedna funkcia v jednej správe |
| Vkladanie API kľúčov do chatu | Kľúče skončia v histórii chatu | Použite tajomstvá alebo nastavenia prostredia nástroja |
| Hádanie sa o pokazenom výsledku | Každá oprava sa nabalí na chybu | Vráťte sa späť a preformulujte |
| Predpisovanie kódu, ktorému nerozumiete | Zamkne zlé riešenie | Opíšte správanie, ktoré chcete |
| Žiadosť o „bezpečnosť na úrovni podniku“ | Nič konkrétne to neznamená | Vypíšte skutočné pravidlá: kto čo môže vidieť |
K API kľúčom: ak potrebujete platobnú alebo e-mailovú službu, uložte jej kľúče do tajomstiev projektu, nie do výzvy. Ak je to nové, pozrite si čo sú premenné prostredia a tajomstvá.
Opakovane použiteľné šablóny výziev
Prispôsobte ich nahradením častí v hranatých zátvorkách.
Nová aplikácia:
Postav [typ aplikácie] pre [pre koho]. Oni [hlavný tok krok za krokom]. [Druhý typ používateľa] sa prihlási, aby [čo robí]. Ulož [údaje] do databázy. [Vzhľad a dojem]. Zatiaľ vynechaj [veci na neskôr].
Nová funkcia:
Pridaj [funkciu] na [stránku]. Keď [používateľ] urobí [akciu], [čo sa má stať]. Len [kto] môže [to urobiť]. [Existujúce veci] ponechaj tak, ako sú.
Zmena dizajnu:
Na stránke [stránka] zmeň [konkrétny prvok] na [konkrétna zmena]. Zachovaj [čo zachovať]. Skontroluj, či to vyzerá dobre na obrazovke so šírkou telefónu.
Chyba:
Na stránke [stránka] som [kroky]. Očakával som [očakávané]. Namiesto toho [skutočnosť, plus presný text chyby]. Oprav to a over, že tok funguje.
Otázka bez zmien:
Nemeň žiadny kód. Vysvetli, ako funguje [časť aplikácie] a kde sa ukladajú [údaje].
Písanie dlhšej špecifikácie
Pri väčších projektoch môže pomôcť najprv napísať jednostranový brief a vložiť ho ako úvodnú výzvu: používatelia, hlavné toky, údaje, pravidlá a to, čo je mimo rozsahu. Návrh môže pomôcť vytvoriť aj AI – náš návod ako napísať dokument o požiadavkach na produkt s AI to vysvetľuje. Len prvú požiadavku na stavbu obmedzte na hlavný tok a zvyšok pridávajte krok za krokom.
Výzvy v Mythex
Všetko vyššie funguje aj v Mythex. Niekoľko konkrétnych tipov, ktoré pomôžu:
- Režimy Build, Plan a Ask. Použite Plan pri veľkých alebo rizikových zmenách a Ask, keď chcete vysvetlenie bez úprav.
- Kontrolné body. Po každej úspešnej zmene Mythex uloží kontrolný bod a Vrátiť sa k tomuto bodu pri odpovedi vráti projekt späť. Môžete tiež upraviť skoršiu správu a poslať ju znova, ak chcete z daného miesta vyskúšať inú výzvu.
- Karta tajomstiev. Keď agent potrebuje API kľúč, opýta sa cez kartu v chate, takže hodnota sa uloží ako tajomstvo projektu a nezapíše sa do vašej správy.
- Obrázky. Priložte screenshoty alebo makety a agent sa na ne pozrie.
Dokumentácia má krátku stránku o účinných výzvach a jednu o iterovaní bez prestavby. Ak začínate od nuly, ako postaviť aplikáciu s AI prejde celým projektom a ako navrhnúť pekne vyzerajúcu aplikáciu s AI sa venuje výzvam pre vizuálne doladenie.
Otázky
Ako dlhá má byť výzva pre AI nástroj na tvorbu aplikácií?
Pri prvej verzii zvyčajne stačí krátky odsek so štyrmi až ôsmimi vetami: kto aplikáciu používa, hlavný tok, údaje, ktoré uchováva, a kto čo môže vidieť. Potom fungujú lepšie kratšie výzvy, ktoré žiadajú jednu zmenu naraz, než dlhé.
Mám AI povedať, aký framework alebo jazyk má použiť?
Len ak na to máte dôvod, napríklad ak kód prevezme vývojár alebo služba funguje iba s jedným technológiou. Inak opíšte produkt a nechajte nástroj zvoliť rozumné predvolené nastavenia.
Prečo AI stále mení veci, ktoré som nežiadal zmeniť?
Zvyčajne preto, že výzva bola príliš všeobecná („urob to lepšie“) alebo nehovorila, čo zachovať. Pomenujte presne, čo zmeniť, povedzte, čo musí zostať rovnaké, a žiadajte jednu zmenu v správe.
Je lepšie opraviť zlý výsledok ďalšími výzvami, alebo začať odznova?
Ak posledná zmena veci zhoršila, vráťte sa k verzii pred ňou a preformulujte výzvu, namiesto aby ste na ňu skladali ďalšie opravy. Nový projekt začnite len vtedy, keď sa zmenil samotný nápad.