
Somo fupi 17 kati ya 30 · Unganisha data na AI
Chagua mazungumzo mafupi ya kujaribu
Somo hili ni la nani?
Kwa watu wanaoongeza msaidizi wa mazungumzo kwenye tovuti ndogo. Mradi umetolewa; unaelekeza tabia yake na kuijaribu badala ya kuandika msimbo wa kushughulikia ujumbe.
Ujumbe wa pili utegemee wa kwanza.
Utakachojifunza katika somo hili
- Pata jibu halisi la kwanza la AI.
- Kagua swali linalofuata linalotegemea ujumbe wa awali.
- Weka ujumbe ulioshindwa upatikane kwa kujaribu tena.
Maelezo, mfano uliotatuliwa na zoezi
Kabla ya kuanza
Unahitaji Google AI Studio API yako na mradi tofauti kamili wa server functions. Somo la ufunguo linaeleza usanidi binafsi ukihitaji. Hakiki modeli, mipaka na gharama kwanza. Tumia ujumbe wa kubuni na msimbo wa mwenyewe; uthibitishaji wa akaunti, mipaka ya kudumu na ufuatiliaji wa bajeti vinahitajika kabla ya matumizi ya umma.
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.
Muda unaokadiriwa: 20–32 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. Maombi halisi hutumia kikomo cha akaunti uliyosanidi. Uthibitishaji wa umma, mipaka inayodumu na uhakiki wa faragha ni kazi tofauti.
Elewa wazo
Fungua mradi tayari wa chatbot na msaidizi wako. Chagua mada rahisi ya kubuni na swali linalorejelea jibu la awali, ili uweze kuhukumu kama mazungumzo yanaendelezwa.
Jibu zuri moja halithibitishi mazungumzo yanayofanya kazi. Panga kukagua ujumbe wote miwili na uhusiano wake.
Mfano halisi
Omba maelezo mafupi, kisha uombe toleo rahisi zaidi la maelezo hayohayo.
Tumia mradi wa chatbot uliotolewa na uongoze usanidi binafsi kwenye run-locally.txt. Weka taarifa za kuingia na maagizo ya modeli kwenye seva. Nisaidie kuuliza swali la kwanza, kufuatilia mada ileile na kujaribu ombi lililoshindwa bila kupoteza ujumbe nilioandika. Usijenge tovuti upya au kudai mazungumzo yanafanya kazi kutokana na jibu la kwanza pekee.Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Utajaribu swali gani la kwanza na swali gani linalolitegemea?
Onyesha mfano wa suluhisho
Mfano wa maswali mawili: “Seva ya tovuti hufanya nini?” kisha “Rahisisha maelezo hayo kwa anayejenga tovuti yake ya kwanza.” Jibu la pili lirahisishe jukumu lilelile, si kuanza mada nyingine.
Huu ni mpango wa jaribio, si nakala ya mazungumzo. Nitapima mwendelezo baada ya jibu halisi la kwanza na kubadili swali la kufuatia kama jibu linahitaji ufafanuzi mwingine.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatoa swali la kwanza maalumu na la kufuatia linalohusu jibu lake.
- Anaeleza ishara ya mwendelezo wa mazungumzo badala ya kutosheka na jibu moja zuri.
Jinsi inavyofanya kazi (si lazima)
Ongeza chatbot inayoweza kuendeleza mazungumzo
Mfumo wa mazungumzo wenye manufaa lazima usome ujumbe wa mwisho wa mwanafunzi na muktadha wake.
Somo linatengeneza mwalimu mdogo wa tovuti. Mgeni anaweza kuuliza, kusoma jibu na kuuliza swali la kufuatilia. Kivinjari hutuma mazungumzo yaliyokubaliwa kwa kila ujumbe mpya; seva huita Gemini na kurudisha jibu halisi la modeli.
Modeli haikumbuki ombi lako la awali la HTTP moja kwa moja. Tunahifadhi historia fupi kwenye kumbukumbu ya kichupo hiki. Kupakia upya huifuta, na warsha husimama baada ya mizunguko minne iliyofaulu ya swali na jibu ili mazoezi yabaki na mipaka.
Mfano uliotatuliwa
Uliza “What is DNS?” kisha “Explain that using a street-address example.”, yaani DNS ni nini kisha ielezwe kwa mfano wa anwani ya mtaa. Ombi la pili linahitaji swali na jibu la awali kujua “that” inarejelea nini.
Zoezi la ziada la utekelezaji
Kwa nini jibu la mzunguko wa pili linaweza kuonekana halihusiani hata API ikifaulu?
Onyesha mfano wa suluhisho
Mfumo unaweza kuwa umetuma swali la jumla pekee au kuacha historia. Kagua array ya messages inayotumwa na uhakikishe ina mizunguko ya awali iliyokubaliwa na swali jipya kwa mpangilio.
- Anakagua kama ujumbe wa awali ulijumuishwa.
- Anakagua kama ujumbe wa mwisho wa mtumiaji ulihifadhiwa.

Hatua 1 · Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
Anzisha chatbot iliyotolewa
Mruhusu msaidizi ashughulikie usanidi binafsi wa seva.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Fuata run-locally.txt na msaidizi. Hakiki akaunti/modeli na masharti, weka thamani binafsi za server-env.example.txt, kisha ufungue URL iliyotolewa na proxy. Ingiza msimbo tofauti wa zoezi kwenye fomu, si ufunguo wa mtoa huduma. Usanidi huu ni wa lazima; kuandika seva ni hiari.
Ufunguo wa mtoa huduma na maagizo yanayotawala tabia yabaki kwenye seva. Akaunti au modeli yako isipatikane, ripoti hatua hiyo kamili badala ya kujaza ukurasa kwa jibu la uongo.
Mfano halisi
Sehemu ya tovuti isimruhusu mgeni kuchagua taarifa zako binafsi za mtoa huduma.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Programu inayoendeshwa ilitoa jibu halisi la kwanza, au usanidi ulisimama wapi?
Onyesha mfano wa suluhisho
Rekodi ya mfano ya ombi la kwanza: “Programu kamili ilifunguka kwenye URL ya proxy. Niliingiza msimbo tofauti na kupata maelezo kutoka modeli iliyosanidiwa. Ufunguo wa Google ulibaki katika mazingira binafsi ya seva.”
Mfano uliokwama ni “Ukurasa wa ndani ulifunguka, lakini seva haikupata jibu la modeli.” Andika hatua halisi ya usanidi/ufikiaji/mgao na ukague gharama kabla ya kurudia. Mwonekano tuli wa faili hauhakikishi jibu halisi.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatambua programu ya proxy na jibu halisi la kwanza la mtoa huduma au kikwazo kamili.
- Anatofautisha msimbo wa zoezi na ufunguo binafsi na kukagua mipaka ya akaunti/modeli.
Jinsi inavyofanya kazi (si lazima)
Unganisha kivinjari na function ya seva yenye mipaka
Weka funguo na jukumu la mwalimu chini ya udhibiti wa seva.
Chapisha folda zilizotolewa na usanidi vigezo katika START-HERE.txt. public/app.js hutuma ujumbe wa user/assistant kwa function yako ya mini-chat. Function hukubali majukumu yanayopishana tu, maandishi yenye kikomo na historia ndogo.
Seva hubadilisha assistant kuwa jukumu la model la Gemini na kutoa maagizo tofauti ya system. Mwombaji hawezi kuchagua URL ya huduma au kubadilisha maagizo kwa jukumu la system la kivinjari. Msimbo wa mmiliki huweka mipaka ya zoezi; hauchukui nafasi ya uthibitishaji wa umma na udhibiti wa matumizi unaodumu.
generate ni function saidizi ndani ya netlify/functions/mini-chat.mjs, si huduma nyingine iliyochapishwa. Kubadili jukumu la mwalimu kwenye kazi, hariri maandishi ya maagizo yanayopelekwa kwa generate katika faili hili la seva. Kuweka kigezo cha frontend cha .env si mbadala: thamani inayoingizwa kwenye msimbo wa kivinjari huwa ya umma.
Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.
Tumia mwongozo wa sasa wa modeli hapa chini au endesha list-text-models.mjs kwenye mzizi wa siri wa warsha kwa mazingira yako. Inaorodhesha modeli zinazoweza kutumia generateContent na kuonekana kwenye akaunti bila kuchapisha ufunguo. Chagua modeli ya maandishi inayoungwa mkono, kagua masharti/kikomo na unakili ID yake halisi ya API kwenye GEMINI_MODEL ya seva.
Mfano uliotatuliwa
Kihakiki cha historia hukataa ujumbe ulioingizwa wenye jukumu la system kabla ya kuita huduma. Hakiwezi kufanya modeli isiwe na makosa, lakini kinaweka muundo wa ombi na usanidi wenye mamlaka chini ya udhibiti wako.
Gemini generateContent API · Funguo za Gemini API · Gemini: ID na uwezo wa sasa wa modeli · Node.js: hali ya usaidizi wa matoleo
Zoezi la ziada la utekelezaji
Je, kivinjari kichague GEMINI_API_KEY au kitume ujumbe wa system kubadilisha mwalimu?
Onyesha mfano wa suluhisho
Hakuna kati ya hayo. Sanidi ufunguo na jukumu kwenye seva. Hakiki majukumu na ukubwa wa ujumbe; majibu ya modeli bado yanahitaji kupimwa kwa usahihi.
- Anahifadhi siri za huduma kwenye seva.
- Anachukulia ujumbe wa kivinjari kuwa ingizo la mazungumzo lisiloaminika.

Hatua 2 · Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
Endeleza mazungumzo na ujaribu kushindwa
Linda ujumbe ulioandikwa ombi linaposhindwa.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Tuma swali linalotegemea la kwanza na ulinganishe jibu lake na mazungumzo ya awali. Mwombe msaidizi akusaidie kuiga au kurudia ombi moja lililoshindwa kwenye mradi wa kutupwa.
Swali linalofuata libaki kwenye mazungumzo yenu, na utumaji ulioshindwa uhifadhi rasimu na ujumbe uliopita kwa kujaribu tena.
Mfano halisi
Hitilafu ya ujumbe wa pili isifute swali ambalo umeandika sasa.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Nini kilitokea kwa swali linalofuata na kwa njia ya utumaji ulioshindwa na kujaribu tena?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Baada ya maelezo ya seva, ombi langu la kurahisisha lilibaki kwenye maelezo hayo. Kisha nilitumia msimbo batili kwa makusudi; rasimu na ujumbe wa awali vilibaki kuonekana. Kurudisha msimbo halali kuliniruhusu kujaribu tena.”
Kukataliwa kwa msimbo ni jaribio la ndani la makusudi, si mtoa huduma kukatika. Rasimu ikipotea au jibu lililofaulu likirudiwa mara mbili, mazungumzo hayajawa tayari.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Analinganisha jibu la kufuatia na mazungumzo ya awali ili kuona mwendelezo wa mada.
- Anajaribu kosa lililowekwa alama wazi na kuhakiki rasimu na ujumbe uliotangulia vinabaki kwa kurudia.
Jinsi inavyofanya kazi (si lazima)
Jaribu kuendelea na kushindwa
Fanya mzunguko wa pili uwe sehemu ya jaribio la kukamilisha.
Uliza mfano wa DNS, kisha swali linalorejelea jibu hilo. Kagua mwili wa ombi kwenye zana za kivinjari na ulinganishe jibu na swali halisi la mwisho. Jibu refu linalotiririka si ushahidi wa kuhusiana.
Jaribu msimbo usio sahihi kwa ujumbe unaofuata. Rasimu inabaki kwenye textarea na hakuna mzunguko ulioshindwa unaoongezwa kwenye historia iliyokubaliwa. Baada ya kusahihisha ufikiaji, jaribu tena. Enter hutuma; Shift+Enter huanza mstari mpya. Kitufe huzima wakati wa kusubiri.
Mfano uliotatuliwa
Kuisha kwa muda au jibu lisilokamilika la huduma hutoa kushindwa kunakoonekana. Kivinjari hakiongezi ujumbe tupu wa assistant na kujifanya mazungumzo yameendelea.
Zoezi la ziada la utekelezaji
Jibu la kwanza ni zuri lakini ombi la pili linashindwa. Nini kifanyike kwa ujumbe ulioandikwa na historia?
Onyesha mfano wa suluhisho
Hifadhi rasimu na mizunguko ya awali iliyokubaliwa. Onyesha kosa kwa uaminifu, rudisha vidhibiti vya kutuma na ongeza jozi mpya baada tu ya jibu sahihi kufika.
- Anahifadhi rasimu ili kujaribu tena.
- Harekodi jibu la msaidizi la kubuni.

Hatua 3 · Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
Kabidhi tabia ya mazungumzo
Tumia mazungumzo kadhaa badala ya jibu moja linalovutia.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Kamilisha jaribio la maswali na majibu mara tatu kwa mada yako ya kubuni na uhifadhi nakala iliyofichwa taarifa nyeti. Rudia urejeshaji baada ya utumaji ulioshindwa baada ya marekebisho yoyote.
Hakiki kujaribu tena hakupotezi rasimu wala kurudia mazungumzo yaliyofaulu. Andika majaribio yasiyopatikana hayajafanywa. Mfano huu hautafuti maelezo ya tovuti yanayoaminika wala kuahidi majibu sahihi; somo linalofuata content-chatbot linaongeza zoezi la vyanzo na ukaguzi.
Mfano halisi
Ushahidi wako uonyeshe mgeni aliuliza nini, kilichorudi na jinsi ombi lililoshindwa lilivyorejeshwa.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Toa nakala ya mazungumzo na uchunguzi halisi wa hitilafu na kujaribu tena.
Unachopaswa kuandaa: Nakala fupi ya mazungumzo yenye ujumbe kadhaa na matokeo uliyoyaona ya kushindwa na kujaribu tena, siri zikiwa zimeondolewa.
Onyesha mfano wa suluhisho
Mfano wa mabadilishano matatu: “1. Eleza seva ya tovuti. 2. Rahisisha jibu hilo. 3. Toa mfano mmoja wa seva hiyo kusaidia tovuti hii.” Rekodi kamili ingekuwa na majibu halisi pembeni ili uhusiano wake upimwe.
Maelezo ya mfano ya kujaribu tena: “Ombi lililokataliwa makusudi liliweka rasimu; kujaribu tena kuliongeza jibu moja lililofaulu, si mawili.” Kabla ya umma, mfano huu wa mwenyewe bado unahitaji uthibitishaji halisi, udhibiti wa kudumu na ufuatiliaji wa gharama; si mfumo wa majibu yanayotegemea vyanzo.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anajumuisha mabadilishano matatu yanayohusiana na muktadha wa kutosha kupima majibu.
- Anaandika kupona kwa ombi lililoshindwa bila rasimu kupotea au jibu lililofaulu kurudiwa.
Jinsi inavyofanya kazi (si lazima)
Kazi yako: tengeneza mwalimu anayefaa kuendeleza mazungumzo
Pima kuhusiana kwa majibu badala ya kuhesabu maombi yaliyofaulu tu.
Badilisha maagizo ya seva yawe ya mwalimu wa HTML/CSS anayejibu kwa ufupi. Fanya mizunguko mitatu: uliza kuhusu kiungo cha ndani kilichoharibika, pendekeza href/id zisizolingana na uulize kwa nini zinashindwa. Tumia msimbo wa kubuni wa majaribio, si chanzo cha siri.
Hifadhi nakala ya mazungumzo iliyofichwa taarifa nyeti na uandike kama kila jibu linashughulikia ujumbe wa mwisho. Rudia ombi moja lililoshindwa na uonyeshe kurudia kunahifadhi uhusiano wa mazungumzo. Kabla ya ufikiaji wa umma, panga uthibitishaji halisi, kikomo cha kudumu cha kila mtumiaji na maelezo ya ujumbe hutumwa wapi.
Mfano uliotatuliwa
Mwalimu mwenye manufaa hutaja href/id zipi hazilingani. Ushauri wa jumla wa majina ya vigezo ungekosa jibu mahsusi la mwanafunzi hata ukiwa sahihi kiufundi.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Zoezi la ziada la utekelezaji
Toa nakala ya mizunguko mitatu na uchunguzi mmoja wa kushindwa/kurudia.
Onyesha mfano wa suluhisho
Hariri maagizo kwenye function ya seva kuwa mwalimu wa HTML/CSS anayejibu kwa ufupi. Usibadili kigezo cha frontend wala kuhamisha generate kwenda folda ya umma. Function ya marejeo ni toleo kamili lenye maagizo mapya.
Mfano wa tathmini: mtumiaji anauliza kwa nini <a href='#work'> haifikii <section id='projects'>. Jibu linalohusika hutaja kutolingana huko kwa href/id. Mtumiaji anayefuata anapendekeza href='#projects'; jibu la kufuatilia likague marekebisho hayo mahsusi. Ushauri wa jumla wa majina ya vigezo ungeshindwa hata hali ya HTTP ikiwa 200.
Tuma kwa msimbo usio sahihi kwenye mzunguko wa baadaye. Mazungumzo yaliyokubaliwa yabaki sawa na textarea ihifadhi rasimu isiyotumwa. Sahihisha ufikiaji na urudie; ongeza user/assistant mpya baada tu ya jibu sahihi. Nakala hii ni mwongozo wa tathmini, si dai la jibu lililozalishwa moja kwa moja.
- Maswali ya kufuatilia yanajibiwa kwa ujumbe halisi uliotangulia.
- Kushindwa kunahifadhi rasimu/historia na ufunguo wa huduma unabaki wa siri.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.