
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.
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.
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
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.
Ikosa rikunze gukorwa
Kwita uruhererekane rw'ibisubizo byateguwe mbere bidafitanye isano ikiganiro.
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
Gerageza ubwawe
Porogaramu ikora yatanze igisubizo cya mbere nyacyo, cyangwa gutegura byahagaze he?
Ganira ku gisubizo cyawe n’umufasha w’isomo
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.
- 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.
Dosiye z'iyi ntambwe
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.
Ikosa rikunze gukorwa
Kwizera uruhare rutanzwe na client kubera ko UI isanzwe itarwerekana.
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.
Gerageza ubwawe
Byagenze bite ku kibazo gikurikiyeho no ku nzira yo kohereza byanze no kongera kugerageza?
Ganira ku gisubizo cyawe n’umufasha w’isomo
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.
- 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.
Dosiye z'iyi ntambwe
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.
Ikosa rikunze gukorwa
Kugerageza «muraho» gusa ukemeza ko ikiganiro cyose gikora.
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.
Gerageza ubwawe
Ibikoresho byo gutangiriraho
Dosiye n’amakuru yo kugerageza byaratanzwe. Kugenzura serivisi nyayo bisaba konti, imeli cyangwa domene yawe nk’uko ibisabwa bibivuga. Ushobora gusuzuma kuri mudasobwa; intambwe yo kuri serivisi utakoze uyandike ko itarageragejwe.
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.
Ganira ku gisubizo cyawe n’umufasha w’isomo
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.
- 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.
Dosiye z'iyi ntambwe
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.
Ikosa rikunze gukorwa
Gupima agaciro ko guhuza AI uhereye gusa ku ntsinzi ya HTTP.
Iri somo ryagufashije?
Kanda ko urikunze, cyangwa urisangize uwo ryafasha.
Komeza kwiga
- Uko wakora urubuga rwawe rwa mbere
- Uko wasohora urubuga rwawe uhereye kuri GitHub
- Uko wahuza domeni yawe n'urubuga rwawe
- Uko wategura imeli kuri domeni yawe
- Uko watuma urubuga rwawe rukoreshwa kuri telefoni
- Uko watuma amafoto y'urubuga afunguka vuba
- Uko wakwakira ibitekerezo byo ku rubuga muri inbox yawe
- Uko wakongeramo kwiyandikisha kwakira email ku rubuga rwawe
- Uko wakohereza emails zikora ku buryo bwikora ziva ku rubuga rwawe
- Uko wabika ibyoherejwe binyuze muri fomu muri database
- Uko wakwemerera abantu kwinjira muri konti ku rubuga rwawe
- Uko wagumisha urupapuro ari ibanga
- Uko wakwemerera abakoresha guhindura amakuru y'umwirondoro wabo
- Uko wakwemerera abakoresha kohereza amashusho
- Uko wakumira imfunguzo za API muri frontend yawe
- Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe
- Uko watuma chatbot isubiza ishingiye ku birimo byawe
- Uko wakongeramo blog ku rubuga rwawe
- Uko wakongeramo ishakisha ku rubuga rwawe
- Uko wakongeramo urundi rurimi ku rubuga rwawe
- Uko wafasha Google kubona urubuga rwawe
- Uko wakosora iyerekanwa ry'urubuga rwawe igihe usangiza umurongo
- Uko wapima gusurwa n'ibikorwa by'ingirakamaro ku rubuga rwawe
- Uko wakwemerera abarusura gufata gahunda yo guhura nawe
- Uko wakwakira ubwishyu ku rubuga rwawe
- Uko wareba impinduka z'urubuga mbere yo kuzisohora
- Uko wasubira inyuma nyuma yo gusohora urubuga rwangiritse
- Uko wakora kopi y’ingoboka kandi ugasubizaho amakuru y’urubuga rwawe
- Uko wabona kandi ugakosora amakosa ku rubuga rwawe ruri ku murongo