
Somo fupi · Kiswahili
Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
Tumia mfano uliotolewa unaotegemea seva kuweka ufunguo wa mtoa huduma nje ya kivinjari cha mgeni na uhakiki maombi yanayoruhusiwa na kukataliwa.
Somo hili ni la nani?
Kwa watu wanaounganisha tovuti na AI au huduma nyingine yenye ruhusa maalumu. Msaidizi wa programu anaweza kuunganisha mradi ulio tayari; unahitaji kuelewa mahali siri yako inaruhusiwa kutumiwa, si kuandika msimbo wa seva.
Kabla ya kuanza
Unahitaji ufikiaji wako wa Google AI Studio API na mradi tofauti wa Netlify Functions. Tumia msaidizi na faili kamili pamoja na mazingira binafsi. Thibitisha modeli na mipaka ya akaunti, pamoja na gharama zozote, kabla ya kutuma maombi. Zoezi lina msimbo tofauti wa mwenyewe; si huduma ya AI tayari kwa umma.
Muda unaokadiriwa: 20–32 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Usanidi wa huduma/akaunti unaweza kuchukua muda zaidi. Matumizi yanafuata masharti na kikomo cha sasa cha akaunti yako.
Utakachojifunza
- Weka siri ya mtoa huduma kwenye mazingira binafsi ya seva pekee.
- Endesha kitendo kilichotolewa bila kufichua ufunguo kwa wageni.
- Kagua majaribio ya ufikiaji yaliyofaulu na yaliyokataliwa.
Hatua 1
Jua thamani inayopaswa kubaki binafsi
Kivinjari kitumie kipengele chako bila kupokea siri ya mtoa huduma.
Fungua mradi uliotolewa na msaidizi wako. Tambua ufunguo wa mtoa huduma kama thamani binafsi ya akaunti na msimbo tofauti wa mazoezi kama kidhibiti cha mwenye mradi cha ufikiaji kwa maabara hii ndogo.
Faili kuitwa .env haitoshi ikiwa ujenzi wa programu unanakili thamani yake kwenye hati za umma. Mwombe msaidizi akague faili halisi zinazomfikia mgeni.
Mfano halisi
Sehemu iliyofichwa ya fomu bado ni ya kivinjari na haiwezi kuficha ufunguo wa mtoa huduma.
Fungua warsha hii tayari ya ufunguo wa API na uongoze usanidi wa run-locally.txt. Weka ufunguo wa mtoa huduma na uchaguzi wa modeli kwenye seva na utumie msimbo tofauti wa ufikiaji wa mazoezi. Usiweke siri kwenye faili za umma au kuniomba nizibandike kwenye ujumbe unaoshirikiwa. Nisaidie kuchunguza kinachopokelewa na kivinjari na kujaribu maombi yanayoruhusiwa na kukataliwa. Eleza ushahidi unaoonekana badala ya kunitaka nitekeleze endpoint.Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Weka funguo za siri za API nje ya msimbo wa kivinjari
Kivinjari cha mgeni kinaweza kukagua kila faili unalokitumia.
Siri ya huduma inaweza kuruhusu gharama au vitendo vya mamlaka ya juu. Kuiweka kwenye JavaScript ya umma, sehemu iliyofichwa au kigezo cha mazingira kinachoingizwa wakati wa build ya frontend bado huituma kwenye kivinjari.
Mfano huuliza Gemini swali moja la kufundishia lililowekwa kwenye function yako ya seva. Kivinjari hupokea jibu; ufunguo wa huduma hubaki kwenye mazingira ya seva. Si kila ufunguo ni wa siri: funguo za publishable za Supabase zimekusudiwa kwa kivinjari pamoja na sera za ufikiaji, lakini funguo zake za siri hazijakusudiwa hivyo.
Mfano uliotatuliwa
Fungua insecure-example.txt. Thamani ya bandia inaonekana kwa sababu imo kwenye msimbo uliotumwa. Kufupisha msimbo huo kungefanya usomeke kwa shida zaidi, lakini hakubadilishi anayepokea.
Extra implementation exercise
Ufunguo unahifadhiwa kwenye .env kisha kuingizwa kwenye kifurushi cha JavaScript cha umma wakati wa build. Je, wageni hawawezi kuuona?
Onyesha mfano wa suluhisho
Hapana. Eneo lake la awali halina maana baada ya kuingizwa kwenye kifurushi cha umma. Hamisha kitendo chenye mamlaka kwenye function ya seva na ubakishe thamani huko.
- Anafuatilia ufunguo hadi kifurushi kinachotumwa.
- Anatofautisha mazingira ya seva na kuingiza thamani kwenye frontend.
Kosa linalofanywa mara nyingi
Kuchukulia kila kigezo kinachoitwa SECRET kuwa cha siri bila kuangalia kinapotumwa.
Hatua 2
Anzisha kitendo kilicholindwa kilichotolewa
Mruhusu msaidizi asanidi njia iliyopo ya seva.
Fuata run-locally.txt na server-env.example.txt kwa msaada. Thibitisha akaunti/modeli na masharti, weka ufunguo kwa faragha seva na zalisha msimbo tofauti. Endesha mradi kamili na ufungue URL ya ndani. Maandalizi haya ni ya lazima; kuandika function ni hiari.
Kivinjari kiwasiliane na kipengele chako cha seva huku seva ikiita mtoa huduma kwa faragha. Usanidi, ufikiaji au mgao ukishindwa, ripoti hatua hiyo badala ya kubuni jibu.
Mfano halisi
Msimbo wa mazoezi wa fomu si ufunguo wa mtoa huduma Google.
Gemini generateContent API · Funguo za Gemini API · Gemini: ID na uwezo wa sasa wa modeli · Node.js: hali ya usaidizi wa matoleo
Jaribu mwenyewe
Kitendo kilifanya kazi, na ni hatua ipi ya usanidi binafsi au mtoa huduma bado imekwama?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Matokeo ya mfano: “Mradi kamili ulifunguka kwenye URL ya proxy. Kwa msimbo wa zoezi, tendo la seva lilirudisha maelezo mafupi ya seva ya tovuti. Siri na uchaguzi wa modeli vilibaki katika mazingira binafsi.”
Mfano uliokwama ni “Programu inaendeshwa, lakini mtoa huduma anasema mgao haupo; hakuna jibu lililofaulu lililoonekana.” Kagua modeli, mipaka na gharama kabla ya kurudia; somo hili haliahidi maombi ya bure au yasiyo na kikomo.
- Anaandika anwani halisi ya programu ya ndani na tendo lililoruhusiwa au kikwazo kamili cha usanidi/mtoa huduma.
- Anahifadhi siri/modeli kwenye seva na kukagua masharti ya akaunti kabla ya kuita.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Weka ombi kwa huduma nyuma ya endpoint yako
Sanidi seva kisha utume ombi dogo linalohitajika na kipengele pekee.
Soma netlify/functions/mini-explain.mjs, chapisha mradi tofauti na uweke GEMINI_API_KEY, GEMINI_MODEL na LAB_TOKEN kwenye seva yake. Chagua modeli ya maandishi inayoungwa mkono katika akaunti yako badala ya kunakili jina la zamani kutoka mafunzo.
Ingiza msimbo tofauti wa mazoezi kwenye fomu. Kivinjari huita /.netlify/functions/mini-explain; function huita endpoint ya HTTPS iliyowekwa ya Google kwa x-goog-api-key. Msimbo ni mpaka wa mmiliki wa zoezi, si ufunguo wa Gemini wala mfumo kamili wa kikomo cha matumizi ya umma.
GEMINI_MODEL ni ID halisi ya modeli inayopatikana kwa akaunti yako ya API, si lebo ya kuonyesha iliyonakiliwa kutoka picha. generate ni function saidizi kwenye faili lilelile la seva. Ufunguo na function saidizi visiwe kwenye public/. Ombi sahihi linaweza bado kushindwa kikomo kikiisha au huduma isipatikane.
Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.
Tumia mwongozo wa sasa wa modeli hapa chini au endesha list-text-models.mjs kwenye mzizi wa siri wa warsha kwa mazingira yako. Inaorodhesha modeli zinazoweza kutumia generateContent na kuonekana kwenye akaunti bila kuchapisha ufunguo. Chagua modeli ya maandishi inayoungwa mkono, kagua masharti/kikomo na unakili ID yake halisi ya API kwenye GEMINI_MODEL ya seva.
Kabla ya ombi la kwanza, endesha zana ya orodha na uchague modeli ya maandishi ya sasa inayoruhusu sehemu za ombi la generateContent zinazotumiwa hapa, ikijumuisha systemInstruction. Orodha hutoa chaguo, si kikomo wala kila uwezo wa modeli. Faili lote la netlify/functions/mini-explain.mjs huendesha kwenye seva; public/app.js hutumwa kwa kila mgeni. Kagua pia muda wa juu wa functions kwenye hosting: muda wa sekunde 20 wa huduma hauwezi kuongeza kikomo kifupi zaidi cha hosting.
Mfano uliotatuliwa
Swali la huduma limewekwa kwenye seva, kwa hiyo mwombaji hawezi kugeuza njia hii kuwa maswali makubwa yoyote. Function pia huweka kikomo cha jibu na husubiri ombi kwa huduma kwa sekunde 20 tu.
Gemini generateContent API · Funguo za Gemini API · Gemini: ID na uwezo wa sasa wa modeli · Node.js: hali ya usaidizi wa matoleo
Extra implementation exercise
Ni maombi gani mawili yaliyopo katika mchakato, na lipi lisitokee kwenye zana za Network za kivinjari?
Onyesha mfano wa suluhisho
Kivinjari huonyesha ombi kwa function yako na jibu lililorudi. Seva ndiyo hufanya ombi kwa huduma; ombi la Google lenye ufunguo wake lisitokee kuwa ombi la kivinjari.
- Anaona ombi la kivinjari kwa function ya tovuti yake.
- Anahifadhi ombi la Google lenye ufunguo kwenye seva.
Kosa linalofanywa mara nyingi
Kunakili function saidizi ya seva kwenye public/ kurekebisha kosa la njia.
Hatua 3
Kagua faragha na kushindwa pamoja
Jibu lenye manufaa halihalalishi ufunguo uliofichuliwa.
Mwombe msaidizi akusaidie kuchunguza faili za umma zilizowasilishwa na maombi ya kivinjari kutafuta siri ya mtoa huduma bila kuionyesha kwenye kumbukumbu zinazoshirikiwa. Jaribu msimbo usio sahihi wa mazoezi na hali ya usanidi uliokosekana kwenye mradi wa kutupwa.
Ufunguo halisi usionekane kwenye faili au maombi ya kivinjari. Maombi yaliyokataliwa au yasiyopatikana yabaki kuwa hitilafu, yakiwa na njia inayotumika ya kujaribu tena.
Mfano halisi
Jibu la kuaminisha pamoja na ufunguo uliofichuliwa kwenye app.js bado ni jukumu lisilokamilika.
Jaribu mwenyewe
Ukaguzi wa matokeo ya umma na jaribio lililokataliwa vilionyesha nini kweli?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya faragha/kosa ya mfano: “Msaidizi alikagua matokeo ya umma na ombi la kivinjari kwa seva yangu; ufunguo haukuwepo. Msimbo batili ulikataliwa. Usanidi binafsi ulipoondolewa katika mradi wa kufutika, tendo lilishindwa badala ya kuonyesha maelezo ya kubuni.”
Hii inarekodi mpaka uliokaguliwa, si ukaguzi wote wa usalama. Ufunguo ukipatikana kwenye matokeo ya umma, acha kushiriki build hiyo na ubadilishe siri iliyovuja kwa mtoa huduma kabla ya kuitumia tena.
- Anataja matokeo/maombi ya umma yaliyokaguliwa bila kuonyesha siri ya mtoa huduma.
- Anaandika ombi la ufikiaji lililokataliwa na lisilo na usanidi kama kushindwa.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Hakikisha mpaka na jibu vyote
Jibu lililofaulu pekee halithibitishi ufunguo umebaki wa siri.
Tafuta ufunguo halisi wa huduma kwenye HTML na skripti za umma zilizochapishwa bila kuubandika kwenye picha au rekodi zinazoshirikiwa. Kagua maombi ya kivinjari: msimbo wa mazoezi unaweza kuonekana kwa mmiliki, lakini ufunguo wa Gemini usionekane.
Jaribu msimbo usio sahihi na usanidi wa huduma unaokosekana katika mradi wa mazoezi. Kushindwa kubaki kushindwa. Hali 429 ya huduma inaweza kueleza kikomo cha matumizi/kasi; 401 au 403 zinaweza kueleza tatizo la ufikiaji/usanidi. Usizigeuze zote kuwa jibu la AI la kubuni.
Mfano uliotatuliwa
Msimbo sahihi wa mazoezi na mipangilio sahihi ya huduma vinapaswa kutoa jibu halisi. Endpoint hiyo hiyo yenye msimbo usio sahihi ikatae kabla ya ombi lolote kwa huduma.
Extra implementation exercise
Jibu linafanya kazi lakini ufunguo pia unaonekana kwenye public/app.js. Je, kazi imekamilika?
Onyesha mfano wa suluhisho
Hapana. Ondoa ufunguo kwenye faili za umma, ubatilishe na ubadilishe kwa sababu ulifichuliwa, sasisha mpangilio wa seva na ukague deployment mpya na historia ya repository kwa ufichuzi unaobaki.
- Hakubali jibu lililofaulu kuwa ushahidi unaotosha.
- Anaondoa uvujaji na kubatilisha na kubadilisha ufunguo uliofichuliwa.
Kosa linalofanywa mara nyingi
Kuficha thamani iliyovuja kwenye kiolesura huku ikibaki katika skripti inayopakuliwa.
Hatua 4
Fanya badiliko moja lenye mipaka kwa usalama
Hifadhi mpaka uleule wa siri unapobadilisha kipengele.
Mwombe msaidizi abadilishe operesheni isiyobadilika iliyotolewa ieleze DNS kwa ufupi. Hifadhi mipangilio ya modeli na ufunguo kwenye seva na mpaka wa mazoezi wa mwenye mradi pekee.
Jaribu tena jibu lililokusudiwa na msimbo batili wa ufikiaji. Kabla ya matumizi ya umma, amua kuhusu uthibitishaji halisi, vidhibiti vya matumizi vya kudumu na ufuatiliaji wa bajeti ya mtoa huduma wako.
Mfano halisi
Kubadilisha mada ya jibu kusihamishe thamani binafsi za akaunti kwenda ukurasa.
Jaribu mwenyewe
Vifaa vya kuanzia
Faili na maudhui ya majaribio yametolewa. Uthibitishaji halisi bado unahitaji akaunti, barua au kikoa chako kama masharti yanavyoeleza. Unaweza kuchunguza ndani ya kompyuta; andika hatua za mtandaoni ambazo hujafanya kama hazijajaribiwa.
Toa kitendo kilichobadilishwa na ukaguzi wa faragha, maombi halali na batili uliofanya kweli.
Unachopaswa kuandaa Rekodi iliyofichwa taarifa nyeti ya mpaka wa ufunguo na maombi halali na batili ya kitendo kilichotolewa.
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Tendo sasa linaeleza DNS kwa sentensi mbili. Ombi halali lilirudisha mada hiyo; msimbo batili ulikataliwa; ukaguzi wa umma haukuona ufunguo wa mtoa huduma.”
“Kabla ya kuifungulia watu nisiowajua, nahitaji uthibitishaji halisi wa akaunti, mipaka ya kudumu ya matumizi na ufuatiliaji wa bajeti.” Msimbo wa pamoja ni mpaka mdogo wa zoezi, si ushahidi wa huduma kamili ya umma.
- Anabadilisha mada ya jibu la kudumu kuwa DNS huku ufunguo/modeli vikibaki seva pekee.
- Anapima tena maombi halali na yaliyokataliwa na kutaja udhibiti wa gharama/ufikiaji unaohitajika kwa umma.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Kazi yako: hamisha kitendo cha pili kilichowekwa wazi
Rudia mpaka kwa makusudi badala ya kuupanua kwa bahati.
Badilisha swali lililowekwa kwenye seva lieleze DNS kwa sentensi mbili. Weka funguo, chaguo la modeli na kikomo cha jibu kwenye seva; kivinjari kisiujue ufunguo wa huduma.
Rekodi matokeo kwa msimbo sahihi na usio sahihi. Eleza utakachoongeza kabla ya ufikiaji wa umma: watumiaji waliothibitishwa au mpaka mwingine wa maana wa ufikiaji, vikomo vya matumizi vinavyodumu na ufuatiliaji wa bajeti ya huduma.
Mfano uliotatuliwa
Kubadilisha swali lililowekwa huthibitisha unaelewa tabia ya huduma inadhibitiwa wapi. Kukubali modeli, endpoint au kikomo cha jibu chochote kutoka kivinjari kungeondoa udhibiti huo.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Extra implementation exercise
Tengeneza toleo la DNS na rekodi fupi ya kujaribu mpaka.
Onyesha mfano wa suluhisho
Katika function ya seva pekee ya mini-explain, badilisha swali la seva ya tovuti kuwa “Explain DNS in two sentences for a beginner.”, yaani eleza DNS kwa sentensi mbili kwa anayeanza. Weka ufunguo/modeli kwenye vigezo vya mazingira ya seva; function kamili ya marejeo inaonyesha badiliko halisi.
Kagua skripti zinazotumwa kwa kivinjari na maombi ya Network. Kivinjari hutuma ombi kwa function yako; kisitume GEMINI_API_KEY kwa Google chenyewe. Msimbo wa zoezi unaoingizwa na mmiliki ni tofauti na ufunguo wa huduma.
Jaribu msimbo usio sahihi: tarajia kukataliwa kabla ya ombi lolote kwa huduma. Kushindwa kwa kikomo/mtandao kubaki kushindwa kwa uaminifu, si jibu la mafanikio lililoandaliwa. Siri halisi ikifichuliwa, iondoe na uibadilishe; kupuuza faili baadaye hakubatilishi ufichuzi.
- Hakuna siri ya huduma inayotumwa kwenye kivinjari.
- Ufikiaji usio sahihi hukataliwa na kushindwa halisi kwa huduma huonekana.
Kosa linalofanywa mara nyingi
Kuita warsha yenye mipaka kuwa huduma ya AI ya umma iliyo tayari kwa uzalishaji.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuwaruhusu watumiaji kupakia picha
- Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kupokea malipo kwenye tovuti yako
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma