Jinsi ya Kuandika Maagizo kwa Zana za AI za Kujenga Programu (Pamoja na Mifano ya Kabla na Baada)
Maagizo mazuri kwa zana ya AI ya kujenga programu yanaeleza bidhaa, si msimbo: nani anaitumia, anafanya nini hatua kwa hatua, inahifadhi data gani, na nani anaruhusiwa kuona nini. Baada ya toleo la kwanza kuwepo, omba mabadiliko moja mahususi kwa kila ujumbe, sema kipi lazima kibaki kile kile, na eleza matatizo kama “Nilifanya X, nilitarajia Y, nikapata Z”. Tabia hizo tatu zinarekebisha matokeo mengi yanayokatisha tamaa.
Sehemu iliyobaki ya mwongozo huu inaonyesha mifumo hiyo kwa undani, ikiwa na mifano ya kabla na baada unayoweza kuirekebisha.
Kwa nini kuomba zana ya kujenga programu ni tofauti na kuzungumza na AI
Unapomuuliza msaidizi wa gumzo swali, maagizo yasiyo wazi hupata jibu lisilo wazi nawe unaendelea. Unapoomba zana ya AI ya kujenga programu, jibu ni programu inayofanya kazi. Kila pengo kwenye maelezo yako linajazwa na dhana, na dhana hizo zinakuwa msimbo, jedwali za hifadhidata na skrini unazolazimika kuishi nazo au kuzifuta.
Kwa hiyo lengo la maagizo si kuonekana mwerevu. Ni kuacha maamuzi machache muhimu kwa bahati. Huhitaji msamiati wa kiufundi kwa hilo. Unahitaji kuwa mahususi kuhusu mambo ambayo wewe pekee unayajua: watumiaji wako, mtiririko wako wa kazi na sheria zako.
Nini cha kujumuisha kwenye maagizo ya kwanza
Kabla ya kuandika chochote, jibu maswali haya. Kila moja linafunga pengo ambalo AI ingeweza kukisia.
| Jumuisha | Kwa nini ni muhimu | Mfano |
|---|---|---|
| Bidhaa kwa sentensi moja | Huweka mfumo wa maamuzi yote yanayofuata | “Tovuti ya kuhifadhi nafasi kwa duka la kinyozi lenye viti viwili” |
| Nani anaitumia | Huamua skrini na mtindo | “Wateja wanaoingia bila miadi kwenye simu, na mmiliki kwenye kompyuta ya mkono” |
| Mtiririko mkuu, hatua kwa hatua | Kitu kinachopaswa kufanya kazi kwanza | “Chagua huduma, chagua muda, weka jina na simu, pata uthibitisho” |
| Data inayohifadhiwa | Inakuwa muundo wa hifadhidata | “Huduma, uhifadhi, wateja” |
| Nani anaweza kuona au kubadilisha nini | Huamua kuingia na ruhusa | “Mmiliki pekee ndiye anaona uhifadhi wote” |
| Mwonekano na hisia, kwa ufupi | Huepuka mtindo wa jumla wa chaguo-msingi | “Giza, rahisi, vitufe vikubwa” |
| Kinachoachwa nje kwa sasa | Huweka toleo la kwanza dogo | “Hakuna malipo wala maoni bado” |
Safu ya mwisho haithaminiwi vya kutosha. Kusema kile usichokitaka kunazuia AI kuongeza blogu, ukurasa wa bei na fomu ya jarida ambavyo hukuviomba.
Kabla na baada: maagizo ya kwanza
Kabla:
Nitengenezee app ya gym yangu.
Zana inalazimika kukisia kila kitu: wanachama au wafanyakazi? Madarasa au mafunzo binafsi? Malipo? Utapata kitu kinachofanana na tovuti ya gym lakini hakifanyi kile unachohitaji.
Baada:
Jenga app ya kuhifadhi madarasa kwa studio ndogo ya yoga. Wanachama wanaona madarasa ya wiki hii (jina, mwalimu, muda, nafasi zilizobaki), wanahifadhi nafasi, na wanaweza kughairi hadi saa mbili kabla. Wanachama wanajisajili kwa barua pepe na nenosiri. Mmiliki wa studio anaingia ili kuongeza madarasa, kuona nani amehifadhi, na kuweka mahudhurio. Hifadhi madarasa, wanachama na uhifadhi kwenye hifadhidata. Muundo tulivu na mwepesi unaofanya kazi vizuri kwenye simu. Hakuna malipo bado.
Maagizo ya pili bado ni mafupi. Yanajibu tu maswali yaliyo kwenye jedwali hapo juu.
Eleza tabia, si utekelezaji
Mara nyingi utapata matokeo bora ukieleza kinachopaswa kutokea badala ya jinsi ya kukijenga.
Kabla:
Ongeza useEffect inayopakua uhifadhi na kipengele cha modal cha kuhariri.
Baada:
Mmiliki akibofya uhifadhi, fungua paneli ambapo anaweza kubadilisha muda au kughairi. Mabadiliko yanapaswa kuonekana papo hapo kwenye orodha.
Maagizo ya kwanza yanamfunga AI kwenye mbinu mahususi ambayo huenda isifae jinsi app ilivyojengwa. La pili linamwambia matokeo na kumwacha achague mbinu sahihi kwa msimbo ambao tayari ameandika. Ikiwa wewe ni msanidi na una mapendeleo makubwa, sema, lakini yaambatanishe na matokeo.
Kuwa mahususi kuhusu sheria
Kanuni za biashara ndipo programu zilizojengwa kwa AI mara nyingi huenda vibaya, kwa sababu ni dhahiri kwako lakini hazionekani kwa AI. Ziandike waziwazi.
- Mipaka: “Mwanachama anaweza kuwa na uhifadhi wa baadaye usiozidi tatu.”
- Muda: “Kughairi kunafungwa saa mbili kabla ya darasa kuanza.”
- Kesi maalum: “Darasa likiwa limejaa, onyesha kitufe cha orodha ya kusubiri badala ya Hifadhi.”
- Ruhusa: “Walimu wanaweza kuona mahudhurio ya madarasa yao wenyewe lakini si ya walimu wengine.”
Kila moja ni sentensi moja. Ukiacha yoyote kati ya hizi, app itashindwa kutekeleza kanuni hiyo au itabuni toleo lake yenyewe.
Baada ya toleo la kwanza: mabadiliko moja kwa kila ujumbe
Mara kitu kinapofanya kazi kwenye onyesho la kukagua, badilisha kutoka kuelezea bidhaa nzima hadi kuomba mabadiliko madogo yanayoweza kukaguliwa.
Kabla:
Muundo hauko sawa, uhifadhi hauendi vizuri na nataka mwonekano wa kalenda pamoja na barua pepe.
Baada (kama ujumbe nne tofauti):
- Ninapohifadhi nafasi ya mwisho kwenye darasa, bado linaonyesha “nafasi 1 imebaki”. Lipaswa kuonyesha “Limejaa” na kuficha kitufe cha Hifadhi.
- Ongeza mwonekano wa kalenda ya wiki kwenye ukurasa wa ratiba, safu moja kwa kila siku. Weka mwonekano wa orodha wa sasa kama chaguo.
- Fanya kadi za madarasa ziwe ndogo zaidi kwenye simu: nafasi ndogo ya ndani, jina la mwalimu kwenye mstari mmoja na muda.
- Mtume mwanachama uthibitisho kwa barua pepe anapohifadhi.
Kwa nini hii inafanya kazi:
- Kila mabadiliko ni dogo vya kutosha AI kuyapata sawa kwa pitio moja.
- Unaweza kujaribu kila moja kabla ya kuendelea.
- Ikiwa moja linaenda vibaya, unaweza kurudisha hatua hiyo pekee bila kupoteza nyingine.
Eleza kipi cha kubaki
Unapoomba mabadiliko ya kitu ambacho tayari kinafanya kazi, mwambie AI kipi lazima kisibadilike. Hii ndiyo njia rahisi zaidi ya kuzuia regressions (vitu vilivyokuwa vikifanya kazi na kuvunjika baada ya kuhariri).
Badilisha muundo wa sehemu ya juu ya ukurasa wa nyumbani kwa kichwa kikubwa zaidi na picha upande wa kulia. Hifadhi menyu, rangi na kila kitu chini ya sehemu hiyo jinsi kilivyo.
Hii inatumika pia kwa data: “Ongeza sehemu ya namba ya simu kwa wanachama. Usiondoe wala kubadilisha jina la sehemu zilizopo.”
Tumia picha za skrini na maandishi halisi
Maneno kama “kitu kilicho juu” hayaeleweki. Zana nyingi za AI za kujenga programu zinakubali picha, na picha ya skrini yenye maelezo mafupi ni haraka kuliko aya ya maelezo.
- Ambatanisha picha ya skrini na sema “kitufe kilichozungushwa kwa nyekundu kinaingiliana na menyu kwenye simu”.
- Bandika maandishi halisi ya ujumbe wowote wa hitilafu badala ya kuyafafanua kwa maneno yako.
- Nukuu lebo zilizo kwenye skrini kwa usahihi: “kitufe cha Hifadhi mabadiliko kwenye ukurasa wa Mipangilio”.
Kwa hitilafu hasa, tumia muundo huu:
Kwenye ukurasa wa uhifadhi, nilibofya Ghairi kwa uhifadhi wa kesho. Nilitarajia uhifadhi utoweke kwenye orodha yangu. Badala yake hakuna kilichotokea na uhifadhi bado upo baada ya kuonyesha upya ukurasa. Irekebishe na uhakiki kwamba kughairi kunafanya kazi.
Mwongozo wetu wa jinsi ya kutatua app iliyojengwa kwa AI unaingia ndani zaidi kwenye hili.
Panga kwanza kwa mabadiliko makubwa
Kwa chochote kinachogusa sehemu nyingi za app — kuongeza akaunti za watumiaji kwenye app isiyokuwa nazo, kuongeza malipo, kubadilisha muundo wa data — omba mpango kabla msimbo haujabadilika.
Kabla ya kubadilisha chochote, eleza jinsi ungeongeza akaunti za timu: jedwali mpya zipi, kurasa zipi zinabadilika, na nini kinatokea kwa watumiaji waliopo. Usihariri msimbo bado.
Soma mpango. Ikiwa umeelewa vibaya kitu, kusahihisha aya moja ni nafuu zaidi kuliko kusahihisha kipengele kilichokamilika. Zana nyingi zina hali maalum kwa hili; kwenye Mythex ni hali ya Plan, pamoja na Build na Ask.
Vitu vya kuepuka
| Epuka | Kwa nini | Badala yake |
|---|---|---|
| “Ifanye iwe bora” / “Ifanye ing'ae” | Hakuna lengo, kwa hiyo AI inabadilisha mambo kwa kubahatisha | Taja mabadiliko: “nafasi zaidi kati ya sehemu, vichwa vikubwa zaidi” |
| Maagizo moja makubwa yenye vipengele kumi | Makosa yanaongezeka; ni vigumu kujaribu | Kipengele kimoja kwa kila ujumbe |
| Kubandika funguo za API kwenye gumzo | Funguo zinaishia kwenye historia ya gumzo | Tumia siri za zana au mipangilio ya mazingira |
| Kubishana na matokeo mabaya | Kila marekebisho yanarundika juu ya hitilafu | Rudi nyuma, kisha andika upya ombi |
| Kubainisha msimbo usioelewa | Hufunga suluhisho lisilofaa | Eleza tabia unayotaka |
| Kuomba “usalama wa kiwango cha biashara” | Haimaanishi kitu mahususi | Orodhesha sheria halisi: nani anaona nini |
Kuhusu funguo za API: ikiwa unahitaji huduma ya malipo au barua pepe, weka funguo zake kwenye siri za mradi badala ya kwenye maagizo. Angalia mazingira ya kutofautiana na siri ni nini ikiwa hilo ni geni kwako.
Violezo vya maagizo vinavyoweza kutumika tena
Vibadilishe kwa kubadilisha sehemu zilizo ndani ya mabano.
App mpya:
Jenga [aina ya app] kwa ajili ya [nani]. Wao [mtiririko mkuu, hatua kwa hatua]. [Aina ya pili ya mtumiaji] anaingia ili [anachofanya]. Hifadhi [data] kwenye hifadhidata. [Mwonekano na hisia]. Acha [mambo ya baadaye] nje.
Kipengele kipya:
Ongeza [kipengele] kwenye [ukurasa]. [Mtumiaji] akifanya [kitendo], [kinachopaswa kutokea]. [Nani] pekee ndiye anaweza [kufanya hivyo]. Weka [vilivyopo] kama vilivyo.
Mabadiliko ya muundo:
Kwenye [ukurasa], badilisha [kipengele mahususi] kuwa [mabadiliko mahususi]. Weka [kinachopaswa kubaki]. Hakikisha kinaonekana sawa kwenye skrini ya upana wa simu.
Hitilafu:
Kwenye [ukurasa], nilifanya [hatua]. Nilitarajia [inayotarajiwa]. Badala yake [halisi, pamoja na maandishi kamili ya hitilafu]. Irekebishe na uthibitishe mtiririko unafanya kazi.
Swali bila mabadiliko:
Usibadilishe msimbo wowote. Eleza jinsi [sehemu ya app] inavyofanya kazi na [data] inahifadhiwa wapi.
Kuandika maelezo marefu zaidi
Kwa miradi mikubwa, inaweza kusaidia kuandika muhtasari wa ukurasa mmoja kwanza na kuubandika kama maagizo yako ya kwanza: watumiaji, mitiririko mikuu, data, sheria na kile kilicho nje ya upeo. Unaweza hata kumwomba AI akusaidie kuuandaa — mwongozo wetu wa kuandika hati ya mahitaji ya bidhaa kwa AI unaeleza jinsi. Weka tu ombi la kwanza la ujenzi kwenye mtiririko mkuu, kisha ongeza mengine hatua kwa hatua.
Kuomba kwenye Mythex
Kila kilichoelezwa hapo juu kinafanya kazi kwenye Mythex. Mambo machache mahususi yanayosaidia:
- Hali za Build, Plan na Ask. Tumia Plan kwa mabadiliko makubwa au hatari, na Ask unapotaka maelezo bila kuhariri.
- Vituo vya ukaguzi. Baada ya kila mabadiliko yaliyofanikiwa Mythex huhifadhi kituo cha ukaguzi, na Revert to this point kwenye jibu hurudisha mradi nyuma. Unaweza pia kuhariri ujumbe wa awali na kuutuma tena ili kujaribu ombi tofauti kuanzia hapo.
- Kadi ya siri. Wakala anapohitaji funguo ya API, anauliza kupitia kadi kwenye gumzo ili thamani ihifadhiwe kama siri ya mradi badala ya kuandikwa kwenye ujumbe wako.
- Picha. Ambatanisha picha za skrini au michoro na wakala ataziangalia.
Nyaraka zina ukurasa mfupi kuhusu maagizo madhubuti na mwingine kuhusu kurudia bila kujenga upya. Ukianza kutoka mwanzo, jinsi ya kujenga app kwa AI inapitia mradi kamili, na jinsi ya kubuni app nzuri kwa AI inashughulikia maagizo ya umaridadi wa muonekano.
Maswali
Maagizo ya zana ya AI ya kujenga programu yanapaswa kuwa marefu kiasi gani?
Kwa toleo la kwanza, aya fupi ya sentensi nne hadi nane kwa kawaida inatosha: nani anatumia programu, mtiririko mkuu, data inayohifadhiwa na nani anaweza kuona nini. Baada ya hapo, maagizo mafupi yanayoomba mabadiliko moja kwa wakati yanafanya kazi vizuri kuliko marefu.
Je, nimwambie AI ni framework au lugha gani itumike?
Ni kwa sababu maalum tu, kama msanidi atakayechukua msimbo baadaye au huduma inayofanya kazi na mfumo mmoja tu. La sivyo, eleza bidhaa na umwache zana achague chaguo-msingi zinazofaa.
Kwa nini AI inaendelea kubadilisha vitu nisivyoomba vibadilishwe?
Mara nyingi ni kwa sababu ombi lilikuwa pana (“ifanye iwe bora zaidi”) au halikusema kipi kibaki. Taja kitu kamili cha kubadilisha, sema kipi lazima kibaki kile kile, na omba mabadiliko moja kwa kila ujumbe.
Ni bora kurekebisha matokeo mabaya kwa maagizo zaidi au kuanza upya?
Ikiwa mabadiliko ya mwisho yamefanya mambo kuwa mabaya zaidi, rudi kwenye toleo lililotangulia na uandike upya ombi, badala ya kurundika marekebisho juu ya mengine. Anza mradi mpya tu wakati wazo lenyewe limebadilika.