AmasomoUko wakongeramo AI chatbot ku rubuga rwawe

Isomo rigufi 17 kuri 30 · Guhuza amakuru n'ubwenge bukorano

Hitamo ikiganiro gito cyo kugerageza

Ibi bigenewe nde?

Abongera umufasha uganira ku rubuga ruto. Umushinga uratanzwe; uyobora imyitwarire yawo ukawugerageza aho kwandika kode itunganya ubutumwa.

Ubutumwa bwa kabiri bugomba gushingira ku bwa mbere.

Intego y'iri somo

  • Koresha igisubizo nyacyo cya mbere cya AI.
  • Genzura ikibazo gikurikiyeho gishingiye ku butumwa bwabanje.
  • Gumana ubutumwa bwananiranye bushobora kongera kugeragezwa.
Ibisobanuro, urugero rusobanuye n'imyitozo

Mbere yo gutangira

API yawe ya Google AI Studio n’umushinga wihariye wa server-function watanzwe. Isomo ry’urufunguzo rwa API risobanura gutegura ibanga niba bikenewe. Banza wemeze model ushobora gukoresha, imbibi z’ikoreshwa n’amafaranga ashoboka. Koresha ubutumwa bw’impimbano na kode y’umwitozo ibitswe na nyirawo; kwemeza umwirondoro, imbibi z’ikoreshwa zibikwa no kugenzura ingengo y’imari birakenewe mbere yo gukoresha ku karubanda.

Reba ubumenyi bwo gutangiriraho

Ni ubumenyi bw’ingirakamaro, si amasomo utegetswe kubanza kurangiza. Niba ubuzi, tangirira hano; niba utabwuzi, fungura amasomo y’imyiteguro. Dosiye zo gutangira ziratanzwe; ntukeneye urubuga rwawe wari usanganywe.

  1. Uko wakumira imfunguzo za API muri frontend yawe

    Shyira ibanga rya serivisi mu bidukikije by'ibanga bya seriveri gusa.

Igihe kigereranyijwe: 20–32 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Ibyifuzo nyakuri bikoresha quota ya konti wagenye. Kwemeza abakoresha ba rusange, imbibi ziramba n'isuzuma ry'amakuru bwite ni akazi ukwako.

Sobanukirwa igitekerezo

Fungura umushinga wa chatbot witeguye uri kumwe n'umufasha. Hitamo ingingo yoroshye y'impimbano n'ikibazo gikurikiyeho kivuga ku gisubizo cyabanje, kugira ngo usuzume niba ikiganiro gikomezanywa.

Igisubizo cyiza cyonyine nticyemeza ko ikiganiro gikora. Teganya gusuzuma ubutumwa bwombi n'isano buri hagati yabwo.

Urugero rufatika

Saba ibisobanuro bigufi, hanyuma usabe verisiyo yoroshye kurushaho y'ibisobanuro bimwe.

Koresha umushinga wa chatbot watanzwe uyobore igenamiterere ry'ibanga muri run-locally.txt. Gumana amabanga yo kwinjira n'amabwiriza ya model kuri seriveri. Mfasha kubaza ikibazo cya mbere, kugikurikiza ikindi ku ngingo imwe no kugerageza ubusabe bwananiranye ntatakaze ubutumwa nanditse. Ntukubake urubuga bundi bushya cyangwa ngo uvuge ko ikiganiro gikora ushingiye ku gisubizo cya mbere gusa.

Dosiye z'iyi ntambwe

Tangirira hanoDosiye z'imyitozo

Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.

Gerageza ubwawe

Ni ikihe kibazo cya mbere n'igikurikiyeho kigishingiraho uzagerageza?

Erekana igisubizo gisobanuye

Ibibazo bibiri by’igerageza ry’icyitegererezo: “Seriveri y’urubuga ikora iki?” hagakurikiraho “Byorohereze umuntu uri gukora urubuga rwe rwa mbere.” Igisubizo cya kabiri kigomba koroshya ya nshingano imwe aho gutangira indi ngingo idafitanye isano.

Iyi ni gahunda yo kugerageza, si inyandiko y’ikiganiro cyabaye. Ndagenzura uko ikiganiro gikomeza nyuma y’igisubizo cya mbere nyacyo, mpindure ikibazo gikurikira niba icyo gisubizo gikeneye ikindi gisobanuro.

Ibigize igisubizo gikwiye

  • Atanga ikibazo cya mbere gifatika n’ikigikurikira kivuga ku gisubizo cyacyo.
  • Asobanura icyerekana ko ikiganiro gikomeza aho gufata igisubizo kimwe cyiza nk’igihagije.
Uko bikora (si itegeko)

Ongeramo chatbot ishobora gukomeza ikiganiro

Guhuza chat kw'ingirakamaro bigomba gusoma ubutumwa bushya bw'umunyeshuri n'aho bushingiye.

Iri somo rikora umwarimu muto w'urubuga. Usura ashobora kubaza ikibazo, gusoma igisubizo no kubaza ikindi gikurikiraho. Mushakisha yohereza ikiganiro cyemewe kuri buri butumwa bushya; seriveri ihamagara Gemini kandi igasubiza igisubizo nyacyo cya model.

Model ntihita yibuka icyifuzo cya HTTP wohereje mbere. Tugumana amateka magufi muri memory y'iyi tab. Kongera kuyifungura birayasiba, kandi imyitozo ihagarara nyuma y'incuro enye zikurikirana zo kubaza no kubona igisubizo mu kiganiro kimwe kugira ngo igerageza rigire imbibi.

Urugero rusobanuye

Baza «DNS ni iki?» hanyuma «Bisobanure ukoresheje urugero rwa aderesi yo ku muhanda.» Icyifuzo cya kabiri gikeneye ikibazo n'igisubizo bya mbere kugira ngo bigaragaze icyo «bi» yerekeza ku cyo.

Undi mwitozo wa tekiniki

Kuki igisubizo cy'ubutumwa bwa kabiri gishobora kumvikana nk'ikidafitanye isano nubwo umuhamagaro wa API watsinze?

Erekana igisubizo gisobanuye

Uburyo bwo guhuza bushobora kuba bwarohereje gusa ikibazo rusange cyangwa bugasiba amateka. Suzuma messages array yoherezwa kandi wemeze ko irimo ubutumwa bwabanje bwemewe n'ikibazo gishya bikurikiranye.

  • Hasuzumwa niba ubutumwa bwabanje bwashyizwemo.
  • Hasuzumwa niba ubutumwa bushya bw'ukoresha bwagumishijwe.

Intambwe 1 · Uko wakongeramo AI chatbot ku rubuga rwawe

Tangiza chatbot watanzwe

Saba umufasha gukora igenamiterere ry'ibanga rya seriveri.

Ibisobanuro, urugero rusobanuye n'imyitozo

Sobanukirwa igitekerezo

Kurikiza run-locally.txt ufashijwe n’umufasha. Emeza konti, model n’amategeko y’ikoreshwa, ushyireho indangagaciro z’ibanga za seriveri zivuye muri server-env.example.txt, hanyuma ufungure URL ya porogaramu proxy yo kuri mudasobwa yerekanye. Shyira mu ifishi kode y’umwitozo itandukanye, ntushyiremo urufunguzo rwa serivisi. Uku gutegura kurasabwa; kwandika kode ya seriveri ni ubushake.

Urufunguzo rwa serivisi n'amabwiriza ayobora biguma kuri seriveri. Niba konti cyangwa model yawe itaboneka, vuga icyo cyiciro nyacyo aho kuzuza urupapuro igisubizo cy'impimbano.

Urugero rufatika

Umwanya wo ku rubuga ntugomba kwemerera umushyitsi guhitamo amabanga yawe yo kwinjira muri serivisi.

Dosiye z'iyi ntambwe

Tangirira hanoDosiye z'imyitozo

Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.

Gerageza ubwawe

Porogaramu ikora yatanze igisubizo cya mbere nyacyo, cyangwa gutegura byahagaze he?

Erekana igisubizo gisobanuye

Inyandiko y’ubusabe bwa mbere y’icyitegererezo: “Porogaramu yose yafungukiye kuri URL ya proxy. Nashyizemo kode y’umwitozo itandukanye nakira ibisobanuro bivuye kuri model ya serivisi yateguwe. Urufunguzo rwa Google rwagumye mu bidukikije by’ibanga bya seriveri.”

Urugero rw’inzitizi ni “Urupapuro rwa hafi rwafungutse ariko seriveri ntiyashoboye kubona igisubizo cya model.” Andika icyiciro nyacyo cy’igenamiterere, uburenganzira cyangwa quota, urebe amafaranga ya konti mbere yo kongera. Kurebera dosiye gusa ntibyemeza igisubizo cya serivisi nyayo.

Ibigize igisubizo gikwiye

  • Agaragaza porogaramu ya proxy kuri mudasobwa n’igisubizo cya mbere nyacyo cya serivisi, cyangwa inzitizi nyirizina.
  • Atandukanya kode y’umwitozo n’urufunguzo rw’ibanga rwa serivisi akagenzura imbibi z’ikoreshwa rya konti na model.
Uko bikora (si itegeko)

Huza mushakisha na function ya seriveri ifite imbibi

Gumisha ibyangombwa n'uruhare rw'umwarimu bigenzurwa na seriveri.

Sohora ububiko bwatanzwe kandi ugenere variables zo muri START-HERE.txt. public/app.js yohereza user/assistant messages kuri function yawe ya mini-chat. Function yemera gusa uruhare rusimburana, inyandiko zifite imbibi n'amateka magufi.

Seriveri ihindura assistant ikaba uruhare rwa model rwa Gemini kandi igatanga system instruction yihariye. Usaba ntashobora guhitamo URL ya serivisi cyangwa gusimbuza ayo mabwiriza uruhare rwa system rutanzwe na client. Kode ya nyirawo igabanya uburenganzira bw'iyi myitozo; ntisimbura kwemeza abakoresha ba rusange n'igenzura ry'amafaranga riramba.

Function ya generate ni helper yo muri netlify/functions/mini-chat.mjs, si indi serivisi yasohowe. Guhindura uruhare rw'umwarimu ku mukoro, hindura inyandiko y'amabwiriza ihabwa generate muri iyi dosiye ya seriveri. Gushyiraho variable ya .env ya frontend si ubundi buryo: agaciro gasimbujwe muri kode ya mushakisha kaba aka rusange.

Ku ruhererekane rwuzuye rwo kuri mudasobwa yawe, fungura run-locally.txt: tegura igenamiterere ry'ibanga rya seriveri muri dosiye .env iri mu bubiko shingiro bw'umushinga, hanze ya public/ kandi idakurikiranwa na Git; huza gusa umushinga wo kwitoza kandi utangize proxy ya Netlify functions. server-env.example.txt itondeka amazina ya variables idafite amabanga nyayo. Gufungura HTML gusa ntibishobora gukoresha seriveri.

Koresha ubuyobozi bugezweho bwa model buri hasi, cyangwa ukoreshe list-text-models.mjs ku mizi y'ibanga y'imyitozo ufite ibidukikije byawe. Itanga urutonde rw'amahitamo ya generateContent abonwa na konti itanditse urufunguzo. Hitamo text model ishyigikiwe, usuzume amabwiriza/quota yayo, hanyuma ukoporore API ID yayo nyayo muri GEMINI_MODEL ya seriveri.

Urugero rusobanuye

Igenzura ry'amateka ryanga ubutumwa bwashyizwemo uruhare rwa system mbere yo guhamagara serivisi. Ntirishobora gutuma ibisubizo bya model bitajya bibeshya, ariko rigumisha imiterere y'icyifuzo n'igenamiterere ry'uburenganzira bukomeye mu maboko yawe.

Gemini: API ya generateContent · Gemini: imfunguzo za API · Gemini: ID n'ubushobozi bwa models ziriho · Node.js: imimerere y'uburyo busohotse bushyigikiwe

Undi mwitozo wa tekiniki

Mushakisha ikwiye guhitamo GEMINI_API_KEY cyangwa kohereza system message kugira ngo ihindure umwarimu?

Erekana igisubizo gisobanuye

Nta na kimwe. Gena urufunguzo n'uruhare kuri seriveri. Genzura uruhare n'ingano bitanzwe na client; ibisubizo bya model biracyakeneye gusuzumwa niba ari byo.

  • Amabanga ya serivisi agumishwa kuri seriveri.
  • Ubutumwa bwa client bufatwa nk'ibyinjizwa mu kiganiro bitizerwa.

Intambwe 2 · Uko wakongeramo AI chatbot ku rubuga rwawe

Komeza ikiganiro ugerageze kunanirwa

Rinda ubutumwa bwanditswe igihe ubusabe bwananiranye.

Ibisobanuro, urugero rusobanuye n'imyitozo

Sobanukirwa igitekerezo

Ohereza ikibazo gishingiye ku cya mbere ugereranye igisubizo cyacyo n'ikiganiro cyabanje. Saba umufasha kugufasha gukora ikigereranyo cyangwa gusubiramo ubusabe bumwe bwananiranye mu mushinga ushobora kujugunywa.

Ikibazo gikurikiyeho kigomba kuguma ku kiganiro cyawe, kandi kohereza bwananiranye bigomba kugumana umushinga w'ubutumwa n'ubutumwa bwabanje kugira ngo wongere ugerageze.

Urugero rufatika

Kunanirwa kw'ikibazo cya kabiri ntibigomba gusiba ikibazo umaze kwandika.

Dosiye z'iyi ntambwe

Tangirira hanoDosiye z'imyitozo

Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.

Gerageza ubwawe

Byagenze bite ku kibazo gikurikiyeho no ku nzira yo kohereza byanze no kongera kugerageza?

Erekana igisubizo gisobanuye

Inyandiko y’ikiganiro y’icyitegererezo: “Nyuma y’ibisobanuro bya seriveri, ubusabe bwanjye bwo kubyoroshya bwagumye kuri ibyo bisobanuro. Hanyuma nakoresheje kode y’umwitozo itari yo nkana ku kohereza; ubutumwa ntararangiza n’ubwabanje byagumye bigaragara. Gusubizamo kode yemewe byatumye nongera kugerageza.”

Kwanga kode itari yo ni igerageza rya hafi rikorwa nkana, si uguhagarara kwa serivisi. Niba ubutumwa butaroherezwa bubura cyangwa igice cy’ikiganiro cyatsinze kikisubiramo kabiri mu kongera, ikiganiro ntikiritegura.

Ibigize igisubizo gikwiye

  • Agereranya igisubizo cy’ikibazo gikurikira n’ikiganiro cyabanje kugira ngo arebe ko kigumye ku ngingo.
  • Agerageza ikibazo cyavuzwe neza akagenzura ko ubutumwa butaroherezwa n’ubwabanje bigumaho byo kongera kugerageza.
Uko bikora (si itegeko)

Gerageza gukomeza ikiganiro no kunanirwa

Gira ubutumwa bwa kabiri igice cy'igerageza ryo kwemeza ko warangije.

Baza urugero rwa DNS, hanyuma ubaze ikibazo kirukurikira kiruvugaho. Suzuma body y'icyifuzo mu bikoresho bya mushakisha kandi ugereranye igisubizo n'ikibazo cya nyuma nyacyo. Igisubizo kirekire kivuga neza si ikimenyetso ko gifitanye isano.

Gerageza kode y'uburenganzira itari yo mu kohereza gukurikira. Inyandiko itaroherezwa iguma muri textarea kandi nta kibazo n'igisubizo by'igerageza ryananiranye byongerwa ku mateka yemewe. Umaze gukosora uburenganzira, ongera ugerageze. Enter yohereza; Shift+Enter ikora umurongo mushya. Buto irazimwa mu gihe cyo gutegereza.

Urugero rusobanuye

Kurenga igihe ntarengwa cyangwa igisubizo cya serivisi kituzuye bitanga kunanirwa kugaragara. Mushakisha ntiyongeramo ubutumwa bwa assistant burimo ubusa ngo yigire nk'aho ikiganiro cyakomeje.

Undi mwitozo wa tekiniki

Igisubizo cya mbere ni cyiza ariko icyifuzo cya kabiri kirananiwe. Ni iki kigomba kuba ku butumwa bwanditswe n'amateka?

Erekana igisubizo gisobanuye

Gumana inyandiko itaroherezwa n'ubutumwa bwabanje bwemewe. Erekana kunanirwa mu kuri, wongere ufungure utugenzuzi two kohereza kandi wongere ubutumwa bushya bubiri gusa nyuma yo kubona igisubizo cyemewe.

  • Inyandiko itaroherezwa irabikwa kugira ngo yongere igeragezwe.
  • Nta gisubizo cya assistant gihimbwa ngo cyandikwe.

Intambwe 3 · Uko wakongeramo AI chatbot ku rubuga rwawe

Hererekanya imyitwarire y'ikiganiro

Koresha ubutumwa bwinshi aho gukoresha igisubizo kimwe gishimishije.

Ibisobanuro, urugero rusobanuye n'imyitozo

Sobanukirwa igitekerezo

Uzuza igerageza rifite ibibazo bitatu n'ibisubizo byabyo ku ngingo yawe y'impimbano, ubike inyandiko yakuwemo amakuru y'ibanga. Subiramo gukomeza nyuma yo kohereza byanze umaze gukosora.

Genzura ko kongera kugerageza bitabuza ubutumwa butaroherezwa cyangwa ngo byisubiremo ikiganiro cyatsinze. Andika ibitashobotse nk’ibitageragejwe. Uru rugero ntirushaka inyandiko zizewe z’urubuga kandi ntirwemeza ibisubizo by’ukuri; isomo content-chatbot rikurikira ryongeramo umurimo wo kugenzura inkomoko watanzwe.

Urugero rufatika

Gihamya yawe igomba kwerekana ibyo umushyitsi yabajije, ibyagarutse n'uko yakomeje nyuma y'ubusabe bwananiranye.

Dosiye z'iyi ntambwe

Tangirira hanoDosiye z'imyitozo

Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.

Gerageza ubwawe

Tanga inyandiko y'ikiganiro n'ibyo wiboneye koko ku kunanirwa no kongera kugerageza.

Ibyo ugomba gukora: Inyandiko ngufi y'ikiganiro cy'ibibazo byinshi n'igisubizo wiboneye ku kunanirwa no kongera kugerageza, byakuwemo amabanga.

Erekana igisubizo gisobanuye

Imbata y’ikiganiro cy’icyitegererezo: “1. Sobanura seriveri y’urubuga. 2. Koroshya icyo gisubizo. 3. Tanga urugero rumwe rw’uko iyo seriveri ifasha uru rubuga.” Inyandiko yarangiye iba irimo ibisubizo nyabyo iruhande rw’ibi bibazo kugira ngo isano ryabyo risuzumwe.

Inyandiko yo kuva mu kibazo y’icyitegererezo: “Kohereza kwanzwe nkana kwagumanye ubutumwa; kongera byongeye ikiganiro kimwe cyatsinze, si bibiri.” Mbere yo gukoresha ku karubanda, uru rugero rwa nyirawo gusa rukeneye kwemeza umwirondoro, kugenzura ikoreshwa bibikwa no gukurikirana amafaranga; si sisitemu y’ibisubizo bishingiye ku nkomoko.

Ibigize igisubizo gikwiye

  • Ashyiramo ibiganiro bitatu bifitanye isano n’ibisobanuro bihagije byo gusuzuma ibisubizo.
  • Yandika uko yavuye mu kunanirwa kohereza, ubutumwa butaroherezwa butabuze kandi ikiganiro cyatsinze kitisubiyemo kabiri.
Uko bikora (si itegeko)

Umukoro wawe: kora umwarimu ufite akamaro ko gukomeza ikiganiro

Suzuma isano y'igisubizo aho kubara gusa ibyifuzo byagenze neza.

Hindura amabwiriza ya seriveri abe ay'umwarimu wa HTML/CSS usubiza mu magambo make. Mu kiganiro kimwe, baza kandi ubone igisubizo incuro eshatu: baza kuri anchor yangiritse, utange href/id bidahuye, hanyuma ubaze impamvu bidakora. Koresha kode y'igihimbano, si kode y'ibanga.

Bika inyandiko y'ikiganiro yakuwemo amakuru y'ibanga kandi ushyireho niba igisubizo cyita kuri buri butumwa bushya. Ongera ugire kohereza kumwe kunanirwa kandi werekane ko kongera kugerageza bigumisha ikiganiro gihuje. Mbere y'uburenganzira bwa rusange, teganya kwemeza umwirondoro nyako, quota ziramba za buri ukoresha n'ibisobanuro by'aho ubutumwa bwoherezwa.

Urugero rusobanuye

Umwarimu w'ingirakamaro avuga href/id bidahuye ibyo ari byo. Inama rusange zo kwita variables zaba zititaye ku gisubizo cyihariye cy'umunyeshuri, nubwo ari zo tekiniki.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Undi mwitozo wa tekiniki

Tanga inyandiko y'ikiganiro kirimo ibibazo bitatu n'ibisubizo byabyo, hamwe n'icyo wabonye mu igerageza rimwe ryo kunanirwa no kongera kugerageza.

Erekana igisubizo gisobanuye

Hindura inyandiko y'amabwiriza muri function ya seriveri ibe iy'umwarimu wa HTML/CSS usubiza mu magambo make. Ntuhindure variable ya frontend cyangwa ngo wimurire generate mu bubiko bwa rusange. Function y'urugero ni uburyo bwuzuye bufite amabwiriza yahinduwe.

Urugero rw'isuzuma: ukoresha abaza impamvu <a href='#work'> itagera kuri <section id='projects'>. Igisubizo gihuye kivuga uko href/id bidahuye. Ubutumwa bukurikira bw'ukoresha butanga href='#projects'; igisubizo gikwiye gisuzuma iryo kosora ryihariye. Inama rusange zo kwita variables zananiwe iri gerageza nubwo status ya HTTP ari 200.

Ohereza ufite kode yo kwitoza itari yo ku butumwa bwo nyuma. Ikiganiro cyemewe kigomba kuguma kidahindutse kandi textarea ikagumana inyandiko itaroherejwe. Kosora uburenganzira wongere ugerageze; ongeraho user/assistant messages nshya ebyiri gusa umaze kubona igisubizo cyemewe. Iyi nyandiko y'urugero ni ubuyobozi bw'isuzuma, si ukwemeza ko hari igisubizo nyacyo cyakozwe na model.

  • Ibibazo bikurikiraho bisubizwa hashingiwe ku butumwa bwabanje nyabwo.
  • Kunanirwa bibika inyandiko n'amateka kandi urufunguzo rwa serivisi ruguma ari ibanga.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.