MasomoJinsi ya kuongeza chatbot ya AI kwenye tovuti yako

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.

  1. 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

Anza hapaFaili za mazoezi

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

Anza hapaFaili za mazoezi

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

Anza hapaFaili za mazoezi

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

Anza hapaFaili za mazoezi

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.