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.

Anza somo shirikishiSoma maelezo ya somo

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.

Faili za mazoezi

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

Start hereFaili za mazoezi

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.

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

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.

Endelea kujifunza

Angalia masomo mengine