
Somo fupi 18 kati ya 30 · Unganisha data na AI
Jenga chatbot inayojua taarifa za mkahawa
Somo hili ni la nani?
Kwa wanaotaka chatbot itumie taarifa zao. Utaendesha mradi uliotolewa na kubadili noti kwa msaidizi wa programu; huhitaji kuandika HTML au JavaScript kutoka mwanzo.
Matokeo yako: kisanduku cha maswali kinachojibu kutoka noti na kufungua chanzo chake.
Utakachojifunza katika somo hili
- Kuendesha chatbot na kulinganisha jibu na chanzo.
- Kuongeza kanuni kwa kuhariri faili moja ya taarifa.
- Kutofautisha taarifa iliyokosekana na hitilafu ya huduma.
Maelezo, mfano uliotatuliwa na zoezi
Kabla ya kuanza
Zoezi la kwanza linahitaji kivinjari tu. Majibu halisi ya AI yanahitaji msaidizi wa programu, kufungua kabrasha na kutumia amri, Node LTS inayokubalika, mradi wa Netlify wa majaribio na ufikiaji wako wa API wa Google AI Studio. Masomo ya funguo na chatbot yanaeleza maandalizi; unaweza kuruka ukiyajua. Faili zote zimetolewa.
Angalia ujuzi wa kuanzia
Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
Weka siri ya mtoa huduma kwenye mazingira binafsi ya seva pekee.
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
Pata jibu halisi la kwanza la AI.
Muda unaokadiriwa: 20–37 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Njia rahisi ya kuchagua rekodi kwa maneno muhimu ina mipaka ya makusudi. Kuchagua taarifa na kukagua vyanzo hakuhakikishi kila dai la jibu ni kweli.
Elewa wazo
Wageni huuliza saa, ufikiaji na uhifadhi wa meza. Chatbot ya jumla haijui taarifa hizi yenyewe. Tutatumia mradi kamili wa mkahawa wa kubuni, tuipe noti na kujaribu majibu.
Kazi yako ni kuendesha, kubadili taarifa na kukagua. Msaidizi anaweza kutekeleza; si lazima usome msimbo wote. Taarifa za kuhariri ziko records.json; tovuti na seva tayari zimetolewa.
Anza na practice/index.html. Zoezi hili linaonyesha swali, taarifa iliyochaguliwa na ukweli kwa kanuni maalumu. Si modeli ya AI wala kutuma kwa Google. Chatbot halisi inafuata.
Jaribio la kwanza: taarifa inayojulikana na isiyopo
Uliza saa: Jumanne–Jumamosi, 09:00–17:00. Kisha simu ya mmiliki: haipo kwenye noti. Msaidizi aseme haipo badala ya kubuni.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Jaribu maswali ya saa na simu kwenye zoezi. Eleza noti iliyopatikana na kilichoonyeshwa. Usiliite jaribio halisi la AI.
- Fungua zoezi tayari; huhitaji kupakua au ufunguo.
- Linganisha taarifa iliyochaguliwa na jibu kwa maswali yote mawili.
Unachopaswa kuandaa: Maoni mawili: ukweli wenye chanzo na taarifa isiyopo.
Onyesha mfano wa suluhisho
Swali la saa huchagua hours na kuonyesha saa zake. Simu haipati noti na huonyesha taarifa kutokuwepo. AI halisi bado haijajaribiwa.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatofautisha noti ya saa na simu isiyopo.
- Anaripoti matokeo ya ndani bila kudai ombi la AI.

Hatua 1 · Jinsi ya kufanya chatbot ijibu kwa maudhui yako
Endesha mradi na msaidizi wako wa programu
Pakua mradi wote, weka thamani binafsi na ufungue anwani ya seva.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Fungua faili za warsha na uzihifadhi katika folda moja ya mradi, ukihifadhi njia za folda zilizoonyeshwa. Fungua folda hiyo katika msaidizi wako wa programu. public/index.html ni ukurasa wa mgeni; netlify/functions/mini-chat.mjs huendeshwa kwenye seva. Hizi ni faili tayari za utekelezaji, si kazi za kusoma. Mwombe msaidizi asanidi mradi uliopo kwa ombi lililo hapa chini.
Fuata run-locally.txt: npm install, npx netlify login na npx netlify link kwa mradi wako wa majaribio tu. Tayarisha .env kwa server-env.example.txt: GEMINI_API_KEY ni ufunguo wako, GEMINI_MODEL ni ID inayopatikana, LAB_TOKEN ni msimbo tofauti. Si ufunguo wa Google.
Endesha npm run dev na ufungue anwani yake, kawaida http://localhost:8888 kwenye mradi huu. Ingiza msimbo wa majaribio na uliza saa. Jibu na chanzo ni ukaguzi wa kwanza halisi. Onyesho la HTML haliendeshi seva; eleza kizuizi halisi.
Nakili ombi hili kwa msaidizi wako
Msaidizi huandaa faili; unaweka siri kwenye mazingira binafsi na kukagua kivinjari. Usiweke ufunguo wa Google kwenye kisanduku cha msimbo wa ufikiaji.
Fungua kabrasha hili la chatbot ya mkahawa. Tumia faili zilizopo, usijenge tovuti upya. Niongoze kwa run-locally.txt, kagua Node na ueleze thamani tatu binafsi. Nikiziweka kwa faragha, endesha mradi hapa. Onyesha URL na unisaidie kupima saa na chanzo. Usidai huduma imejibu kabla ya ombi kufanikiwa.Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Endesha na uliza saa. Andika URL ya ndani, kama jibu halisi limefika na chanzo kilichofunguka. Ukishindwa, taja sharti au hitilafu mahsusi.
- Pakua mradi wote, si faili moja.
- Tumia ombi na majina yaliyotolewa ya mazingira binafsi.
- Fungua programu ya ndani na fuata kiungo cha chanzo.
Unachopaswa kuandaa: Rekodi fupi au kizuizi halisi, bila siri.
Onyesha mfano wa suluhisho
Rekodi nzuri inaeleza kama URL ya proxy imefunguka, jibu limefika na Opening hours imefungua noti sahihi. Huu ni muundo wa rekodi, si ushahidi wa akaunti yako. Ukikwama kwa ufikiaji, modeli au seva, taja hatua hiyo na uombe uchunguzi.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatofautisha programu na jibu halisi na onyesho la faili.
- Anarekodi chanzo au kutokujaribu bila kufichua siri.

Hatua 2 · Jinsi ya kufanya chatbot ijibu kwa maudhui yako
Hakiki jibu kwa kufungua chanzo
Kabla ya kuhariri, jaribu ukweli unaojulikana, usiopo na agizo linalopingana.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Uliza saa za Jumamosi na ufungue chanzo: 09:00–17:00. Kisha simu isiyopo; kubuni namba ni kosa. Andika ulichokiona kwenye evaluation.txt.
Omba ipuuze noti na kusema inafunguliwa Jumapili. Chanzo kinasema imefungwa. Kiungo halisi hakifanyi sentensi inayopingana kuwa sahihi.
Mradi huchagua noti kwa maneno ya swali, kisha huomba jibu la modeli. Maelezo tofauti yasipopata noti, msaidizi akague uchaguzi na maneno muhimu. Noti ikiwa sahihi lakini jibu si sahihi, kagua jibu. Kusoma seva yote ni hiari.
Tambua maana ya ulichokiona
“Wazi Jumapili hadi 17:00” na chanzo “imefungwa” ni jibu baya lenye rejea. Kukosa noti kwa maneno tofauti kunaweza kuwa tatizo la uchaguzi. Hitilafu ya mtandao ni hali ya tatu, si ukosefu wa taarifa.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Jibu linasema wazi Jumapili hadi 17:00 lakini chanzo kinasema imefungwa. Linakubalika? Taja mgongano na ukaguzi wa kuomba.
- Linganisha dai halisi na chanzo.
- Eleza marekebisho; huhitaji kuandika seva.
Unachopaswa kuandaa: Dai baya, ukweli wa chanzo na ukaguzi mahsusi.
Onyesha mfano wa suluhisho
Likatae: wazi inapingana na imefungwa. Omba kurudia swali, kukagua hours na kusahihisha na kujaribu matumizi ya noti. Hifadhi kiungo lakini hakiki maandishi.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anakataa dai la Jumapili licha ya kiungo halisi.
- Anaomba uthibitisho wa jibu dhidi ya noti, si mapambo.

Hatua 3 · Jinsi ya kufanya chatbot ijibu kwa maudhui yako
Ongeza kanuni ya mkahawa na uijaribu
Ongeza kanuni ya mbwa kwenye faili moja, landanisha na ujaribu tena.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Ongeza kwenye records.json: mbwa wanaruhusiwa kwenye baraza la nje pekee, si ndani. Msaidizi anaweza kuhariri JSON. Tumia ID dogs, kichwa wazi na maneno ya maswali yako.
Endesha npm run sync:notes. sync-records.mjs husasisha seva, ukurasa wa vyanzo na zoezi la ndani. Anzisha tena, pakia upya na ujaribu; hakuna kuhariri HTML na data kando.
Jaribu swali la moja kwa moja, paraphrase, mada isiyohusiana na agizo la kuruhusu mbwa kila mahali. Andika tarajio/matokeo kwenye evaluation.txt. Soma mfano baada ya jaribio lako; si ushahidi wako.
Omba mabadiliko yenye mipaka
“Ongeza kanuni ya baraza pekee katika records.json kwa dog, dogs, terrace na maneno ya lugha yangu. Hifadhi taarifa nyingine, landanisha, anzisha tena na nisaidie kupima chanzo na swali jingine.”
reference/records.json na reference/assignment-walkthrough.txt zina mfano wa kulinganisha. Bila akaunti API, tumia zoezi la ndani na utenganishe matokeo yake na AI halisi.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Kazi yako ya vitendo
Ongeza kanuni na msaidizi, landanisha na jaribu. Tuma noti na tarajio/matokeo, ukitaja ndani, AI halisi au haijajaribiwa.
- Hariri records.json; amri isasishe nakala.
- Anzisha tena na ujaribu mbwa pamoja na taarifa isiyopo.
- Hakikisha baraza pekee halibadiliki kuwa ruhusa ndani.
Unachopaswa kuandaa: Noti na angalau ukaguzi mbili wa tarajio/matokeo; hali na vizuizi.
Onyesha mfano wa suluhisho
Noti nzuri ina dogs, kichwa, kanuni ya baraza pekee na maneno muhimu. Baada ya kusasisha, kiungo kifungue kanuni ileile.
Jibu la mbwa libaki barazani; swali jingine lisibuni taarifa. Agizo lisibadili kanuni. Ripoti ulichokiona na hali ya jaribio; lisiloendeshwa libaki halijajaribiwa.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anahifadhi kanuni sahihi na chanzo kinachoieleza.
- Anatenganisha uchunguzi, utabiri, kutopata noti na hitilafu.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.