Isomo rigufi · Kinyarwanda

Uko wakumira imfunguzo za API muri frontend yawe

Koresha urugero watanzwe rukoresha seriveri ugumane urufunguzo rwa serivisi hanze ya mushakisha y'umushyitsi, wemeze ubusabe bwemewe n'ubwanzwe.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

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.

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.

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.

Ibyo uziga

  • Shyira ibanga rya serivisi mu bidukikije by'ibanga bya seriveri gusa.
  • Koresha igikorwa watanzwe uteretse abashyitsi urufunguzo.
  • Genzura amagerageza yo kugeraho yatsinze n'ayanzwe.

Dosiye z'imyitozo

Intambwe 1

Menya agaciro kagomba kuguma ari ibanga

Mushakisha igomba gukoresha igikorwa cyawe itakiriye ibanga rya serivisi.

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

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)

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.

Extra implementation exercise

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 2

Tangiza igikorwa kirinzwe watanzwe

Reka umufasha ashyireho inzira ya seriveri isanzweho.

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.

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)

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

Extra implementation exercise

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 3

Genzura ibanga no kunanirwa hamwe

Igisubizo gifasha ntigituma urufunguzo rwagaragajwe rwemerwa.

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

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)

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.

Extra implementation exercise

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 4

Kora impinduka imwe ifite imbibi mu mutekano

Gumana imbibi zimwe z'ibanga igihe uhindura igikorwa.

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

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

Extra implementation exercise

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.

Komeza kwiga

Reba andi masomo