Isomo rigufi · Kinyarwanda

Uko wakongeramo AI chatbot ku rubuga rwawe

Koresha chatbot y'ibanga yiteguye uri kumwe n'umufasha wo kwandika kode, ugerageze niba ikibazo gikurikiyeho gikoresha ikiganiro kandi ntigipfe iyo ubusabe bwananiranye.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

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

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.

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.

Ibyo uziga

  • Koresha igisubizo nyacyo cya mbere cya AI.
  • Genzura ikibazo gikurikiyeho gishingiye ku butumwa bwabanje.
  • Gumana ubutumwa bwananiranye bushobora kongera kugeragezwa.

Dosiye z'imyitozo

Intambwe 1

Hitamo ikiganiro gito cyo kugerageza

Ubutumwa bwa kabiri bugomba gushingira ku bwa mbere.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 2

Tangiza chatbot watanzwe

Saba umufasha gukora igenamiterere ry'ibanga rya seriveri.

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.

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

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Komeza ikiganiro ugerageze kunanirwa

Rinda ubutumwa bwanditswe igihe ubusabe bwananiranye.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Hererekanya imyitwarire y'ikiganiro

Koresha ubutumwa bwinshi aho gukoresha igisubizo kimwe gishimishije.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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.

Komeza kwiga

Reba andi masomo