
Isomo rigufi 15 kuri 30 · Konti n'uburenganzira bwo kugera ku makuru
Menya agaciro kagomba kuguma ari ibanga
Ibi bigenewe nde?
Abahuza urubuga na AI cyangwa indi serivisi ifite uburenganzira bwihariye. Umufasha wo kwandika kode ashobora guhuza umushinga witeguye; ukeneye gusobanukirwa aho ibanga ryawe ryakoreshwa, si kwandika kode ya seriveri.
Mushakisha igomba gukoresha igikorwa cyawe itakiriye ibanga rya serivisi.
Intego y'iri somo
- Shyira ibanga rya serivisi mu bidukikije by'ibanga bya seriveri gusa.
- Koresha igikorwa watanzwe uteretse abashyitsi urufunguzo.
- Genzura amagerageza yo kugeraho yatsinze n'ayanzwe.
Ibisobanuro, urugero rusobanuye n'imyitozo
Mbere yo gutangira
API yawe ya Google AI Studio n’umushinga wa Netlify-function wihariye wo kwitoza. Koresha umufasha wo kwandika kode hamwe n’umwitozo wuzuye no gutegura ibidukikije by’ibanga. Emeza imbibi za model n’ikoreshwa rya konti, harimo amafaranga ashoboka, mbere y’ubusabe. Umwitozo ukoresha kode yihariye ibitswe na nyirawo; si serivisi ya AI rusange yiteguye.
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.
- Uko wasohora urubuga rwawe uhereye kuri GitHub
Huza ububiko bw'umwitozo na serivisi yakira imbuga.
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. Gutegura serivisi/konti bishobora gufata igihe kirekire. Ikoreshwa rigengwa n'amabwiriza n'umubare ntarengwa bigezweho bya konti yawe.
Sobanukirwa igitekerezo
Fungura umushinga watanzwe uri kumwe n'umufasha. Menya urufunguzo rwa serivisi nk'agaciro k'ibanga ka konti, na kode y'umwitozo itandukanye nk'igenzura ry'uburenganzira bwa nyir'umushinga muri uyu mwitozo muto.
Kwita dosiye .env ntibihagije niba kuyubaka bikoporora agaciro kayo muri scripts rusange. Saba umufasha gusuzuma dosiye nyazo zigera ku mushyitsi.
Urugero rufatika
Umwanya w'ifishi uhishwe uracyari uwa mushakisha kandi ntushobora guhisha urufunguzo rwa serivisi.
Fungura uyu mwitozo witeguye w'imfunguzo za API uyobore gutegura ukurikije run-locally.txt. Gumana urufunguzo rwa serivisi n'ihitamo rya model kuri seriveri, ukoreshe kode y'umwitozo itandukanye yo kugeraho. Ntushyire amabanga muri dosiye rusange cyangwa ngo unsabe kuyashyira mu butumwa busangizwa. Mfasha gusuzuma ibyo mushakisha yakira no kugerageza ubusabe bwemewe n'ubwanzwe. Sobanura gihamya igaragara aho kunsaba gushyira endpoint mu bikorwa.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 akahe gaciro kagomba kuguma hanze y'urupapuro rw'umushyitsi, kandi ni iyihe gihamya uzasaba umufasha gusuzuma?
Erekana igisubizo gisobanuye
Gahunda y’ibanga y’icyitegererezo: “GEMINI_API_KEY ni ibanga rya konti ya serivisi. LAB_TOKEN ni kode y’umwitozo itandukanye, si irindi zina ry’urwo rufunguzo. Umufasha azagenzura scripts rusange zitangwa n’ubusabe bwa mushakisha ashake niba ibanga ryagaragaye ku makosa.”
Izina ry’ibanga rya dosiye ryonyine si gihamya: build ishobora gukoporora ibiyirimo mu bisohoka rusange. Indangagaciro nyazo ntizizajya mu mafoto ya ecran no mu nyandiko zisangizwa.
Ibigize igisubizo gikwiye
- Agaragaza urufunguzo rwa serivisi nk’ibanga, na kode yo kwemerera umwitozo nk’undi mupaka wawo wihariye.
- Avuga dosiye rusange n’ubusabe bwa mushakisha nk’ahagenzurwa niba urufunguzo rwagaragaye ku makosa.
Uko bikora (si itegeko)
Gumisha imfunguzo za API zifite uburenganzira bukomeye hanze ya kode ya mushakisha
Mushakisha y'usura ishobora gusuzuma buri dosiye uyoherereza.
Ibanga rya serivisi rishobora kwemerera gukoresha amafaranga cyangwa ibikorwa by'uburenganzira bukomeye. Kurishyira muri JavaScript ya rusange, umwanya uhishe cyangwa variable y'ibidukikije isimbuzwa igihe frontend yubakwa biracyaryohereza muri mushakisha.
Urugero rusobanuye rubaza Gemini ikibazo kimwe kidahinduka cyo kwiga binyuze muri function yawe ya seriveri. Mushakisha yakira igisubizo; urufunguzo rwa serivisi ruguma mu bidukikije bya seriveri. Si buri rufunguzo ari ibanga: imfunguzo za Supabase publishable zagenewe gukoresha muri mushakisha hamwe n'amategeko y'uburenganzira, naho imfunguzo zayo za secret si uko.
Urugero rusobanuye
Fungura insecure-example.txt. Agaciro k'igihimbano karagaragara kuko kari muri kode yatanzwe. Kugabanya iyo kode (minify) byatuma igorana gusoma ariko ntibyahindura uyakira.
Undi mwitozo wa tekiniki
Urufunguzo rubitswe muri .env, hanyuma rugashyirwa muri JavaScript bundle ya rusange igihe cya build. Ni ibanga ku basura?
Erekana igisubizo gisobanuye
Oya. Aho dosiye yabanje kuba ntibigira icyo bihindura nyuma yo kurushyira muri bundle ya rusange. Nimurira igikorwa cy'uburenganzira bukomeye muri function ya seriveri kandi ugumishe agaciro aho.
- Urufunguzo rukurikiranwa kugeza muri bundle yatanzwe.
- Ibidukikije bya seriveri bitandukanywa no gusimbuza muri frontend.

Intambwe 1 · Uko wakumira imfunguzo za API muri frontend yawe
Tangiza igikorwa kirinzwe watanzwe
Reka umufasha ashyireho inzira ya seriveri isanzweho.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Kurikiza run-locally.txt na server-env.example.txt ufashijwe n’umufasha. Emeza konti, model n’amategeko y’ikoreshwa, shyira urufunguzo rwa serivisi mu ibanga kuri seriveri, ukore kode y’umwitozo itandukanye. Tangiza umushinga wose ufungure URL ya porogaramu yo kuri mudasobwa. Aya magenzura arasabwa; kwandika kode ya function ni ubushake.
Mushakisha igomba kuvugana n'igikorwa cya seriveri yawe, seriveri igahamagara serivisi mu ibanga. Niba gutegura, uburenganzira cyangwa umugabane w'ikoreshwa byanze, vuga icyo cyiciro aho guhimba igisubizo.
Urugero rufatika
Kode y'umwitozo yo mu ifishi si urufunguzo rwa serivisi ya Google.
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
Igikorwa cyarakoze, kandi ni ikihe cyiciro cy'igenamiterere ry'ibanga cyangwa cya serivisi kigihagaze?
Erekana igisubizo gisobanuye
Iby’imyiteguro by’icyitegererezo: “Umushinga wose wafungukiye kuri URL ya proxy yo kuri mudasobwa. Nkoresheje kode y’umwitozo, igikorwa cya seriveri cyagaruye ibisobanuro bigufi bya seriveri y’urubuga. Amabanga ya serivisi n’ihitamo rya model byagumye mu bidukikije by’ibanga.”
Urugero rw’inzitizi ni “Porogaramu irakora, ariko serivisi ivuga ko quota itaboneka; nta gisubizo cyatsinze cyabonetse.” Genzura model zemewe muri konti, imbibi n’amafaranga ashoboka mbere yo gusubiramo ubusabe; iri somo ntirisezeranya guhamagara ku buntu cyangwa nta mbibi.
Ibigize igisubizo gikwiye
- Yandika aderesi nyayo ya porogaramu yo kuri mudasobwa n’igikorwa kimwe cyemewe cyangwa inzitizi nyayo y’igenamiterere cyangwa serivisi.
- Agumana ibanga rya serivisi na model kuri seriveri kandi akagenzura amategeko y’ikoreshwa rya konti mbere yo guhamagara serivisi.
Uko bikora (si itegeko)
Shyira umuhamagaro wa serivisi inyuma ya endpoint yawe
Tegura seriveri, hanyuma wohereze gusa icyifuzo gito igikorwa gikeneye.
Soma netlify/functions/mini-explain.mjs, usohore umushinga wihariye kandi ushyire GEMINI_API_KEY, GEMINI_MODEL na LAB_TOKEN kuri seriveri yawo. Hitamo text model ishyigikiwe muri konti yawe aho gukoporora izina rya model ya kera mu nyigisho.
Injiza kode yihariye yo kwitoza muri fomu. Mushakisha ihamagara /.netlify/functions/mini-explain; iyo function igahamagara HTTPS endpoint idahinduka ya Google ikoresheje x-goog-api-key. Kode ni inzitizi y'imyitozo ya nyirayo gusa, si icyangombwa cya Gemini kandi si uburyo bwuzuye bwo kugena umubare w'ikoreshwa rya rusange.
GEMINI_MODEL ni model ID nyayo iboneka muri konti yawe ya API, si izina rigaragara wakoporoye ku ifoto ya ekara. generate ni helper iri muri dosiye imwe ya function ya seriveri. Urufunguzo rwa serivisi na helper nta na kimwe gikwiye kuba muri public/. Icyifuzo cyemewe gishobora gukomeza kunanirwa igihe serivisi itagifite quota cyangwa itaboneka.
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.
Mbere y'icyifuzo cya function cya mbere, koresha helper y'urutonde rwa model kandi uhitemo text model iriho ishyigikira imyanya ya generateContent request ikoreshwa hano, harimo systemInstruction. Urutonde rugaragaza amahitamo, si quota cyangwa buri bushobozi bwa model. Dosiye yose ya netlify/functions/mini-explain.mjs ikorera kuri seriveri; public/app.js itangwa kuri buri usura. Reba kandi igihe ntarengwa cya function muri gahunda ya hosting: igihe ntarengwa cy'amasegonda 20 cya serivisi ntigishobora kongera igipimo kigufi cya host.
Urugero rusobanuye
Ikibazo cya serivisi ntigihinduka kuri seriveri, bityo usaba ntashobora guhindura iyi nzira ngo ibe iyo kohereza ibibazo binini ibyo ari byo byose. Function igena kandi imbibi z'igisubizo ikanategereza igihe kitarenze amasegonda 20 ku cyifuzo cya serivisi.
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
Ni ibihe byifuzo bibiri ugomba kubona, kandi ni ikihe kigomba kutagaragara mu bikoresho bya Network bya mushakisha?
Erekana igisubizo gisobanuye
Mushakisha yerekana umuhamagaro wayo ujya kuri function yawe n'igisubizo cyasubijwe. Seriveri ni yo isaba serivisi; umuhamagaro wayo wa Google urimo ibyangombwa ntugomba kugaragara nk'icyifuzo cya mushakisha.
- Hagaragara icyifuzo cya mushakisha kijya kuri function y'urubuga rwayo.
- Icyifuzo cya Google cyemejwe kigumishwa kuri seriveri.

Intambwe 2 · Uko wakumira imfunguzo za API muri frontend yawe
Genzura ibanga no kunanirwa hamwe
Igisubizo gifasha ntigituma urufunguzo rwagaragajwe rwemerwa.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Saba umufasha kugufasha gusuzuma dosiye rusange zoherejwe n'ubusabe bwa mushakisha ushakamo ibanga rya serivisi ataryerekana mu nyandiko zisangizwa. Gerageza kode y'umwitozo itari yo n'igenamiterere ribuze mu mushinga ushobora kujugunywa.
Urufunguzo nyarwo ntirugomba kugaragara muri dosiye cyangwa ubusabe bwa mushakisha. Ubusabe bwanzwe cyangwa serivisi itaboneka bigomba kuguma ari kunanirwa, bifite inzira yo kongera kugerageza ikoreshwa.
Urugero rufatika
Igisubizo cyumvikana hamwe n'urufunguzo rugaragara muri app.js biracyari umurimo utarangiye.
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
Igenzura ry'ibisohoka rusange n'igerageza ryanzwe byerekanye iki koko?
Erekana igisubizo gisobanuye
Inyandiko y’ibanga n’amakosa y’icyitegererezo: “Umufasha yasuzumye ibisohoka rusange n’ubusabe bwa mushakisha kuri seriveri yanjye; urufunguzo rwa serivisi ntirwarimo. Kode y’umwitozo itari yo yaranzwe. Nakuyeho igenamiterere ry’ibanga rya serivisi mu mushinga ushobora gusibwa, igikorwa kiranga aho kwerekana ibisobanuro byahimbwe.”
Ibi byandika umupaka wasuzumwe, si igenzura ry’umutekano ryose. Niba urufunguzo rubonetse mu bisohoka rusange, hagarika gusangiza iyo build usimbuze ibanga ryagaragaye muri serivisi mbere yo kurikoresha nanone.
Ibigize igisubizo gikwiye
- Avuga ibisohoka rusange n’ubusabe yasuzumye atongeye kwerekana ibanga rya serivisi.
- Yandika igerageza ryo kugeraho ryanzwe n’iry’igenamiterere ritabonetse nk’ibyanze.
Uko bikora (si itegeko)
Genzura umupaka n'igisubizo byombi
Igisubizo cyagenze neza cyonyine nticyemeza ko urufunguzo rwagumye ari ibanga.
Shakisha urufunguzo nyarwo rwa serivisi muri HTML na scripts za rusange zasohowe utarushyize mu mafoto ya ekara cyangwa logs zisangiwe. Suzuma ibyifuzo bya mushakisha: kode yo kwitoza ishobora kugaragarira nyirayo, ariko urufunguzo rwa Gemini ntirugomba kugaragara.
Gerageza kode itari yo yo kwitoza n'igenamiterere rya serivisi ribura mu mushinga ushobora gukuraho. Kunanirwa bigomba gukomeza kuba kunanirwa. Status ya serivisi ya 429 ishobora kwerekana imbibi za quota/umubare w'ibyifuzo; 401 cyangwa 403 bishobora kwerekana ibibazo by'uburenganzira/igenamiterere. Ntuzihindure zose igisubizo cya AI cyahimbwe.
Urugero rusobanuye
Kode ikwiye yo kwitoza ifite igenamiterere rya serivisi ryemewe igomba gusubiza igisubizo nyacyo. Endpoint imwe ifite kode itari yo igomba kwanga mbere y'icyifuzo icyo ari cyo cyose cya serivisi.
Undi mwitozo wa tekiniki
Igisubizo kirakora, ariko urufunguzo rwa serivisi na rwo ruri muri public/app.js. Igikorwa cyarangiye?
Erekana igisubizo gisobanuye
Oya. Kura urufunguzo muri dosiye za rusange, urusimbuze kuko rwashyizwe hanze, uvugurure igenamiterere rya seriveri kandi usuzume deploy nshya n'amateka y'ububiko bwa kode urebe niba hari ahagisigaye ibanga.
- Igisubizo cyagenze neza nticyemerwa nk'ikimenyetso gihagije.
- Ahavuye ibanga harakosorwa kandi urufunguzo rwashyizwe hanze rugasimbuzwa.

Intambwe 3 · Uko wakumira imfunguzo za API muri frontend yawe
Kora impinduka imwe ifite imbibi mu mutekano
Gumana imbibi zimwe z'ibanga igihe uhindura igikorwa.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Saba umufasha guhindura igikorwa cyagenwe watanzwe kugira ngo gisobanure DNS mu magambo make. Gumana igenamiterere rya model n'urufunguzo kuri seriveri n'imbibi z'umwitozo ugenewe nyirawo gusa.
Ongera ugerageze igisubizo ugamije na kode itemewe yo kugeraho. Mbere yo gukoresha ku karubanda, hitamo iyemezwa nyaryo ry'umwirondoro, igenzura rihoraho ry'ikoreshwa n'ikurikirana ry'ingengo y'imari ya serivisi yawe.
Urugero rufatika
Guhindura ingingo y'igisubizo ntibigomba kwimura indangagaciro z'ibanga za konti mu rupapuro.
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 igikorwa cyahindutse n'amagenzura y'ibanga, ibyemewe n'ibitemewe wakoze koko.
Ibyo ugomba gukora: Inyandiko yakuwemo amakuru y'ibanga y'imbibi z'urufunguzo n'ubusabe bwemewe n'ubutemewe bw'igikorwa watanzwe.
Erekana igisubizo gisobanuye
Inyandiko y’impinduka y’icyitegererezo: “Igikorwa gihoraho ubu gisobanura DNS mu nteruro ebyiri. Ubusabe bwemewe bw’umwitozo bwagaruye iyo ngingo; kode itari yo yaranzwe; igenzura ry’ibisohoka rusange na n’ubu ntiryabonye urufunguzo rwa serivisi.”
“Mbere yo kubifungurira abo ntazi, ndacyakeneye kwemeza umwirondoro nyakuri, imbibi z’ikoreshwa zibikwa no gukurikirana ingengo y’imari ya serivisi.” Kode y’umwitozo isangiwe ni umupaka muto w’igerageza, si gihamya ya serivisi rusange yuzuye.
Ibigize igisubizo gikwiye
- Ahindura ingingo y’igisubizo gihoraho ikaba DNS, agumana igenamiterere ry’urufunguzo na model kuri seriveri gusa.
- Asubiramo ubusabe bwemewe n’ubwanzwe akavuga ibisigaye mu kugenzura amafaranga n’uburenganzira bwo gukoresha ku karubanda.
Uko bikora (si itegeko)
Umukoro wawe: nimura igikorwa cya kabiri kidahinduka
Subiramo umupaka ubigambiriye aho kuwagura ku bw'impanuka.
Hindura ikibazo kidahinduka cya seriveri gisobanure DNS mu nteruro ebyiri. Gumisha ibyangombwa, guhitamo model n'imbibi z'igisubizo kuri seriveri; mushakisha igume itazi urufunguzo rwa serivisi.
Andika igisubizo ufite kode yo kwitoza yemewe n'itemewe. Sobanura ibyo wakongeraho mbere y'uburenganzira bwa rusange: abakoresha bemejwe cyangwa undi mupaka nyawo w'uburenganzira, imbibi z'ikoreshwa ziramba no gukurikirana ingengo y'imari ya serivisi.
Urugero rusobanuye
Guhindura ikibazo kidahinduka byemeza ko wumva aho imyitwarire ya serivisi igenzurirwa. Kwakira models, endpoints cyangwa imbibi z'igisubizo ibyo ari byo byose biva muri mushakisha byakuraho iryo genzura.
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
Kora uburyo bwa DNS n'inyandiko ngufi y'igerageza ry'umupaka.
Erekana igisubizo gisobanuye
Muri function ya mini-explain ya seriveri gusa, simbuza ikibazo kidahinduka kijyanye na seriveri y'urubuga 'Explain DNS in two sentences for a beginner.', gisaba gusobanura DNS mu nteruro ebyiri ku utangiye. Gumisha urufunguzo/model muri variables z'ibidukikije bya seriveri; function yuzuye y'urugero yerekana impinduka nyayo.
Suzuma scripts zatanzwe kuri mushakisha n'ibyifuzo bya Network. Mushakisha yohereza icyifuzo kuri function yawe; ntigomba kwiyohereza GEMINI_API_KEY kuri Google. Kode y'imyitozo yinjijwe na nyirayo itandukanye n'urufunguzo rwa serivisi.
Gerageza kode yo kwitoza itari yo: tegereza kwangwa mbere y'umuhamagaro wa serivisi uwo ari wo wose. Kunanirwa kwa quota/urusobe bya serivisi bigomba kuguma ari kunanirwa kw'ukuri, aho kuba igisubizo cy'intsinzi cyateguwe mbere. Niba ibanga nyaryo ryarashyizwe hanze, rikureho kandi urisimbuze; kwirengagiza dosiye nyuma ntibitesha agaciro ibyashyizwe hanze.
- Nta banga rya serivisi ritangwa kuri mushakisha.
- Uburenganzira butari bwo burangwa kandi kunanirwa nyakuri kwa serivisi kuragaragara.
Iri somo ryagufashije?
Kanda ko urikunze, cyangwa urisangize uwo ryafasha.