
አጭር ትምህርት 15 ከ 30 · መለያዎችና መዳረሻ
የትኛው እሴት የግል መቆየት እንዳለበት ይወቁ
ይህ ለማን ነው?
ድረ ገጽን ከAI ወይም ልዩ ፈቃድ ከሚፈልግ ሌላ አገልግሎት ጋር ለሚያገናኙ ሰዎች። የኮድ ጻፊ ረዳት ዝግጁውን ፕሮጀክት ሊያገናኝ ይችላል፤ እርስዎ ማወቅ ያለብዎት ሚስጥሩ የት ሊጠቀም እንደሚችል እንጂ የአገልጋይ ኮድ መጻፍ አይደለም።
አሳሹ የአገልግሎት ሰጪውን ሚስጥር ሳይቀበል ተግባርዎን መጠቀም አለበት።
የዚህ ትምህርት ዓላማ
- የአገልግሎት ሰጪውን ሚስጥር በግል የአገልጋይ አካባቢ ብቻ ያስቀምጡ።
- ቁልፉን ለጎብኚዎች ሳያጋልጡ የተሰጠውን ተግባር ያስኪዱ።
- የተሳኩና የተከለከሉ የመዳረሻ ሙከራዎችን ይፈትሹ።
ማብራሪያ፣ የተሠራ ምሳሌ እና ልምምድ
ከመጀመርዎ በፊት
የራስዎ Google AI Studio API መዳረሻና የተለየ የNetlify-function ልምምድ ፕሮጀክት ያስፈልጋሉ። ሙሉ ጥቅሉንና የግል አካባቢ ማዋቀሩን ከኮድ ረዳት ጋር ይጠቀሙ። ጥያቄ ከመላክ በፊት የሞዴልና የመለያ አጠቃቀም ገደቦችን፣ ሊኖሩ የሚችሉ ክፍያዎችንም ጨምሮ፣ ያረጋግጡ። ልምምዱ ባለቤቱ የሚይዘውን የተለየ ኮድ ይጠቀማል፤ ዝግጁ ይፋዊ የAI አገልግሎት አይደለም።
የመነሻ ችሎታዎን ይፈትሹ
እነዚህ ጠቃሚ ችሎታዎች ናቸው፤ መጀመሪያ ሌላ ትምህርት እንዲያጠናቅቁ አያስገድዱም። ካወቋቸው ከዚህ ይጀምሩ፤ ካልሆነ የተያያዘውን ዝግጅት ይክፈቱ። መነሻ ፋይሎች ስለተሰጡ የቀድሞ ድረ ገጽ አያስፈልግም።
- ድረ ገጽዎን ከGitHub እንዴት ማተም ይችላሉ?
የልምምድ ማከማቻን ከማስተናገጃ ጋር ያገናኙ።
ግምታዊ ጊዜ: 20–32 ደቂቃ
ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። የአቅራቢ/መለያ ዝግጅት የበለጠ ጊዜ ሊወስድ ይችላል። አጠቃቀም በመለያዎ ወቅታዊ ውሎችና ኮታ ይገዛል።
ሐሳቡን ይረዱ
የተሰጠውን ፕሮጀክት ከረዳትዎ ጋር ይክፈቱ። የአገልግሎት ሰጪው ቁልፍ የግል የመለያ እሴት መሆኑን፣ የተለየው የልምምድ ኮድ ደግሞ ለዚህ ትንሽ ልምምድ የባለቤቱ የመዳረሻ መቆጣጠሪያ መሆኑን ይለዩ።
የግንባታ ሂደቱ የፋይሉን እሴት ወደ ይፋዊ ስክሪፕቶች ከቀዳው፣ ፋይሉ .env መባሉ ብቻ በቂ አይደለም። ረዳቱ ለጎብኚው የሚላኩትን እውነተኛ ፋይሎች እንዲመረምር ይጠይቁ።
ተጨባጭ ምሳሌ
የተደበቀ የቅጽ መስክም የአሳሹ ክፍል ነው፤ የአገልግሎት ሰጪውን ቁልፍ መደበቅ አይችልም።
ይህን ዝግጁ የAPI ቁልፍ ልምምድ ክፈትና የrun-locally.txt ማዋቀሪያውን ምራኝ። የአገልግሎት ሰጪውን ቁልፍና የሞዴል ምርጫ በአገልጋዩ ላይ አቆይ፣ የተለየ የልምምድ መዳረሻ ኮድም ተጠቀም። ሚስጥሮችን በይፋዊ ፋይሎች አታስቀምጥ፣ በሚጋሩ መልዕክቶች ውስጥ እንድለጥፋቸውም አትጠይቀኝ። አሳሹ የሚቀበለውን ለመመርመርና የተፈቀዱና የተከለከሉ ጥያቄዎችን ለመፈተሽ እርዳኝ። የጥያቄ መቀበያውን እኔ እንድተገብር ከመጠየቅ ይልቅ በእይታ የሚረጋገጠውን ማስረጃ አብራራልኝ።የዚህ ደረጃ ፋይሎች
ከታች ያሉትን ፋይሎች ይክፈቱ ወይም አንድ በአንድ ያውርዱ። ፕሮጀክቱን ሲያስቀምጡ በፋይል ስሞቹ የሚታየውን የአቃፊ አወቃቀር ይጠብቁ።
እርስዎ ይሞክሩ
የትኛው እሴት ከጎብኚው ገጽ መራቅ አለበት፣ ረዳቱስ የትኛውን ማስረጃ እንዲመረምር ይጠይቃሉ?
የተሠራ መፍትሔ ያሳዩ
የግላዊነት ዕቅድ ምሳሌ፦ “GEMINI_API_KEY የግል የአቅራቢ መግቢያ መረጃ ነው። LAB_TOKEN የተለየ የልምምድ መዳረሻ ኮድ ነው፣ ለዚያ ቁልፍ የተቀየረ ስም አይደለም። ረዳቱ መግቢያ መረጃ በስህተት ወጥቷል ወይ ብሎ የተላኩትን ይፋዊ scriptsና የአሳሽ ጥያቄዎች ይመረምራል።”
የግል የፋይል ስም ብቻ ማስረጃ አይደለም፦ build ይዘቱን ወደ ይፋዊ ውጤት ሊቀዳ ይችላል። እውነተኛ እሴቶቹን ከማያ ምስሎችና ከሚጋሩ ማስታወሻዎች ውጭ አስቀምጣለሁ።
ትክክለኛ መልስ የሚያካትተው
- የአቅራቢውን ቁልፍ ሚስጥር፣ የልምምድ መዳረሻ ኮዱን ደግሞ የተለየ የልምምድ ድንበር ብሎ ይለያል።
- ቁልፉ በስህተት መውጣቱን ለመፈተሽ ይፋዊ ፋይሎችንና የአሳሽ ጥያቄዎችን ይጠቅሳል።
እንዴት ይሠራል? (አማራጭ)
ከፍተኛ ፈቃድ ያላቸውን የAPI ቁልፎች ከአሳሽ ኮድ ያርቁ
የጎብኚው አሳሽ የሚልኩለትን እያንዳንዱን ፋይል ሊመረምር ይችላል።
የአቅራቢ ሚስጥር ወጪን ወይም ከፍተኛ ፈቃድ ያላቸውን ተግባራት ሊፈቅድ ይችላል። በይፋዊ JavaScript፣ በተደበቀ መስክ ወይም frontend ሲገነባ በሚተካ የአካባቢ ተለዋዋጭ ማስቀመጥ አሁንም ወደ አሳሹ ይልከዋል።
የተሠራው ምሳሌ በአገልጋይ functionዎ በኩል Geminiን አንድ ቋሚ ትምህርታዊ ጥያቄ ይጠይቃል። አሳሹ መልሱን ይቀበላል፤ የአቅራቢው ቁልፍ በአገልጋይ አካባቢ ይቀጥላል። ሁሉም ቁልፎች ሚስጥር አይደሉም፦ የSupabase publishable ቁልፎች በመዳረሻ ፖሊሲዎች ጋር ለአሳሽ አጠቃቀም የታሰቡ ናቸው፣ secret ቁልፎቹ ግን አይደሉም።
የተሠራ ምሳሌ
insecure-example.txt ይክፈቱ። የፈጠራው እሴት የሚታየው በተላከው ኮድ ስላለ ነው። ያንኑ መስመር በminify ማሳጠር ለማንበብ ያስቸግረዋል፣ ግን ማን እንደሚቀበለው አይቀይርም።
ተጨማሪ የአተገባበር ልምምድ
ቁልፍ በ.env ይቀመጣል፣ በbuild ጊዜም በይፋዊ JavaScript bundle ይገባል። ከጎብኚዎች የተደበቀ ነው?
የተሠራ መፍትሔ ያሳዩ
አይደለም። በይፋዊ bundle ከገባ በኋላ የመጀመሪያው የፋይል ቦታ አያስፈልግም። ከፍተኛ ፈቃድ ያለውን ተግባር ወደ አገልጋይ function ያዛውሩ፣ እሴቱንም እዚያ ያቆዩ።
- ቁልፉን እስከተላከው bundle ይከታተላል።
- የአገልጋይ አካባቢን ከfrontend መተካት ይለያል።

ደረጃ 1 · የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?
የተሰጠውን የተጠበቀ ተግባር ያስጀምሩ
ያለውን የአገልጋይ መንገድ ረዳቱ እንዲያዋቅር ያድርጉ።
ማብራሪያ፣ የተሠራ ምሳሌ እና ልምምድ
ሐሳቡን ይረዱ
run-locally.txt እና server-env.example.txt ከረዳቱ ጋር ይከተሉ። የታሰበውን መለያ/ሞዴልና የአጠቃቀም ውሎች ያረጋግጡ፣ የአቅራቢውን ቁልፍ በግል በአገልጋዩ ያስቀምጡ፣ የተለየ የልምምድ ኮድ ይፍጠሩ። ሙሉ ፕሮጀክቱን አስኪደው የአካባቢውን መተግበሪያ URL ይክፈቱ። እነዚህ የማዋቀር ፍተሻዎች የግድ ናቸው፤ የfunction ኮድ መጻፍ ግን አማራጭ ነው።
አሳሹ የአገልጋይዎን ተግባር ሲያነጋግር፣ አገልጋዩ ደግሞ አገልግሎት ሰጪውን በግል ማነጋገር አለበት። በማዋቀር፣ በመዳረሻ ወይም በአጠቃቀም ገደብ ምክንያት ችግር ካጋጠመ፣ ምላሽ ከመፍጠር ይልቅ ያንን ደረጃ ያሳውቁ።
ተጨባጭ ምሳሌ
የቅጹ የልምምድ ኮድ የGoogle አገልግሎት ሰጪ ቁልፍ አይደለም።
የዚህ ደረጃ ፋይሎች
ከታች ያሉትን ፋይሎች ይክፈቱ ወይም አንድ በአንድ ያውርዱ። ፕሮጀክቱን ሲያስቀምጡ በፋይል ስሞቹ የሚታየውን የአቃፊ አወቃቀር ይጠብቁ።
እርስዎ ይሞክሩ
ተግባሩ ተካሂዷል? የትኛው የግል ማዋቀሪያ ወይም የአገልግሎት ሰጪ ደረጃ አሁንም ታግዷል?
የተሠራ መፍትሔ ያሳዩ
የዝግጁነት ውጤት ምሳሌ፦ “ሙሉ ፕሮጀክቱ በአካባቢ proxy URL ተከፈተ። በልምምድ መዳረሻ ኮዱ፣ የአገልጋዩ ተግባር የድረ ገጽ አገልጋይን አጭር ማብራሪያ መለሰ። የአቅራቢ መግቢያ መረጃና የሞዴል ምርጫ በግል አካባቢው ቀሩ።”
የታገደ ምሳሌ “መተግበሪያው ይሠራል፣ ግን አቅራቢው quota የለም ይላል፤ የተሳካ ምላሽ አልታየም” ነው። ጥያቄ ከመድገምዎ በፊት በመለያዎ የተፈቀዱ ሞዴሎችን፣ ገደቦችንና ሊኖሩ የሚችሉ ክፍያዎች ይፈትሹ፤ ይህ ትምህርት ነጻ ወይም ያልተገደበ ጥሪ አይሰጥም።
ትክክለኛ መልስ የሚያካትተው
- እውነተኛውን የአካባቢ መተግበሪያ አድራሻና አንድ የተፈቀደ ተግባር፣ ወይም ትክክለኛ የቅንብር/አቅራቢ እንቅፋት ይመዘግባል።
- የአቅራቢውን መግቢያ መረጃ/ሞዴል በአገልጋዩ ያስቀምጣል፣ ከመጥራት በፊትም የመለያ አጠቃቀም ውሎችን ይፈትሻል።
እንዴት ይሠራል? (አማራጭ)
የአቅራቢውን ጥሪ ከራስዎ endpoint በስተጀርባ ያስቀምጡ
አገልጋዩን ያዋቅሩ፣ ከዚያ ባህሪው የሚፈልገውን ትንሽ ጥያቄ ብቻ ይላኩ።
netlify/functions/mini-explain.mjs ያንብቡ፣ የተለየውን ፕሮጀክት ያሰማሩ፣ GEMINI_API_KEY፣ GEMINI_MODEL እና LAB_TOKENንም በአገልጋዩ ያዘጋጁ። ከመመሪያ አሮጌ የmodel ስም ከመቅዳት ይልቅ፣ በመለያዎ የሚደገፍ የጽሑፍ model ይምረጡ።
የተለየውን የልምምድ ኮድ በቅጹ ያስገቡ። አሳሹ /.netlify/functions/mini-explainን ይጠራል፤ ያ function በx-goog-api-key የGoogleን ቋሚ HTTPS endpoint ይጠራል። ኮዱ ለባለቤቱ ብቻ የሆነ የልምምድ ገደብ ነው፣ የGemini የመግቢያ መረጃ ወይም ሙሉ ይፋዊ የኮታ ስርዓት አይደለም።
GEMINI_MODEL በራስዎ API መለያ የሚገኝ ትክክለኛ model ID ነው፣ ከማያ ፎቶ የተቀዳ የማሳያ ስም አይደለም። generate በተመሳሳይ የአገልጋይ function ፋይል ያለ helper ነው። የአቅራቢው ቁልፍም ሆነ ያ helper በpublic/ መሆን የለባቸውም። አቅራቢው ኮታ ከሌለው ወይም ካልተገኘ፣ ትክክለኛ ጥያቄም አሁንም ላይሳካ ይችላል።
ለሙሉው በኮምፒውተርዎ የማስኬድ ቅደም ተከተል run-locally.txt ይክፈቱ፦ በፕሮጀክቱ ዋና አቃፊ ውስጥ ባለው የግል .env ፋይል የአገልጋይ ቅንብሮችን ያዘጋጁ፣ ከpublic/ ውጭ እና በGit የማይከታተል መሆኑን ያረጋግጡ፣ የልምምድ ፕሮጀክቱን ብቻ ያገናኙ፣ የNetlify function proxyንም ያስነሱ። server-env.example.txt የተለዋዋጭ ስሞችን ያለ እውነተኛ ሚስጥሮች ይዘረዝራል። HTMLን ብቻ መክፈት አገልጋዩን ማስኬድ አይችልም።
ከታች ያለውን ወቅታዊ የmodel መመሪያ ይጠቀሙ፣ ወይም በራስዎ አካባቢ ከግል የልምምድ ሥር list-text-models.mjs ያስኪዱ። ቁልፉን ሳያትም መለያው የሚያያቸውን የgenerateContent እጩዎች ይዘረዝራል። የሚደገፍ የጽሑፍ model ይምረጡ፣ ውሎቹን/ኮታውን ይፈትሹ፣ ከዚያ ትክክለኛ API IDውን በአገልጋይ GEMINI_MODEL ቅንብር ይቅዱ።
ከመጀመሪያው የfunction ጥያቄ በፊት የmodel ዝርዝር helperን ያስኪዱ፣ እዚህ የሚጠቀሙትን የgenerateContent ጥያቄ መስኮች፣ systemInstructionን ጨምሮ፣ የሚደግፍ ወቅታዊ የጽሑፍ model ይምረጡ። ዝርዝሩ እጩዎችን ይለያል፣ ኮታን ወይም ሁሉንም የmodel ችሎታ አይደለም። ሙሉው netlify/functions/mini-explain.mjs ፋይል በአገልጋይ ይሠራል፤ public/app.js ለእያንዳንዱ ጎብኚ ይላካል። የማስተናገጃ ዕቅዱን የfunction ጊዜ ገደብም ይፈትሹ፦ የአቅራቢው የ20 ሰከንድ ገደብ ከዚያ ያነሰ የአስተናጋጅ ገደብ ማራዘም አይችልም።
የተሠራ ምሳሌ
የአቅራቢው ጥያቄ በአገልጋይ ላይ ቋሚ ነው፣ ስለዚህ ጠሪ ይህን መንገድ ወደ ማንኛውም ትልቅ ጥያቄ ማስተላለፊያ መቀየር አይችልም። functionው ውጤቱንም ይገድባል፣ ለአቅራቢ ጥያቄውም ቢበዛ 20 ሰከንዶች ይጠብቃል።
Gemini፦ generateContent API · Gemini፦ የAPI ቁልፎች · Gemini፦ ወቅታዊ model IDዎችና ችሎታዎች · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ
ተጨማሪ የአተገባበር ልምምድ
የትኞቹን ሁለት ጥያቄዎች ማየት አለብዎት፣ የትኛውስ በአሳሽ Network መሣሪያዎች መታየት የለበትም?
የተሠራ መፍትሔ ያሳዩ
አሳሹ ወደ functionዎ ያደረገውን ጥሪና የተመለሰውን መልስ ያሳያል። አገልጋዩ የአቅራቢውን ጥያቄ ያደርጋል፤ የመግቢያ መረጃ የያዘው የGoogle ጥሪ እንደ አሳሽ ጥያቄ መታየት የለበትም።
- ወደ የራስ ድረ ገጽ function የሚሄደውን የአሳሽ ጥያቄ ያያል።
- በማንነት የተረጋገጠውን የGoogle ጥያቄ በአገልጋይ ያቆያል።

ደረጃ 2 · የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?
ግላዊነትንና ውድቀትን በአንድነት ይፈትሹ
ጠቃሚ ምላሽ የተጋለጠ ቁልፍን ተቀባይነት ያለው አያደርገውም።
ማብራሪያ፣ የተሠራ ምሳሌ እና ልምምድ
ሐሳቡን ይረዱ
ረዳቱ የአገልግሎት ሰጪው ሚስጥር በተላኩ ይፋዊ ፋይሎችና በአሳሽ ጥያቄዎች ውስጥ መኖሩን እንዲፈትሽ እርዳታ ይጠይቁ፤ ሚስጥሩን በሚጋሩ የሥራ መዝገቦች ላይ አያሳዩ። በጊዜያዊው ፕሮጀክት የተሳሳተ የልምምድ ኮድና የጎደለ ውቅር ያለበትን ሁኔታ ይሞክሩ።
እውነተኛው ቁልፍ በአሳሹ ፋይሎችና ጥያቄዎች ውስጥ መታየት የለበትም። የተከለከሉ ወይም አገልግሎቱ የማይገኝላቸው ጥያቄዎች ሊጠቀሙበት የሚችሉ የዳግም ሙከራ መንገድ እያላቸው ያልተሳኩ ሆነው መቆየት አለባቸው።
ተጨባጭ ምሳሌ
አሳማኝ መልስ እያለ ቁልፉ በapp.js ውስጥ ከተጋለጠ፣ ሥራው አሁንም ያልተጠናቀቀ ነው።
የዚህ ደረጃ ፋይሎች
ከታች ያሉትን ፋይሎች ይክፈቱ ወይም አንድ በአንድ ያውርዱ። ፕሮጀክቱን ሲያስቀምጡ በፋይል ስሞቹ የሚታየውን የአቃፊ አወቃቀር ይጠብቁ።
እርስዎ ይሞክሩ
የይፋዊ ውጤት ፍተሻውና የተከለከለው ሙከራ በእውነት ምን አሳዩ?
የተሠራ መፍትሔ ያሳዩ
የግላዊነት/ስህተት መዝገብ ምሳሌ፦ “ረዳቱ ይፋዊ ውጤቱንና ከአሳሽ ወደ ራሴ አገልጋይ ያለውን ጥያቄ መረመረ፤ የአቅራቢ ቁልፉ አልነበረም። የተሳሳተ የልምምድ ኮድ ተከለከለ። በሚሰረዘው ማዋቀር የግል የአቅራቢ ቅንብርን ሳስወግድ፣ የተፈጠረ ማብራሪያ ከማሳየት ይልቅ ተግባሩ ከሸፈ።”
ይህ የተመረመረውን ድንበር ይመዘግባል እንጂ ሙሉ የደህንነት ኦዲት አይደለም። ቁልፍ በይፋዊ ውጤት ከተገኘ፣ ያንን build ማጋራት ያቁሙና እንደገና ከመጠቀምዎ በፊት የወጣውን መግቢያ ቁልፍ በአቅራቢው ይተኩ።
ትክክለኛ መልስ የሚያካትተው
- የአቅራቢውን ሚስጥር ሳይደግም የትኞቹ ይፋዊ ውጤቶች/ጥያቄዎች እንደተመረመሩ ይገልጻል።
- የተከለከለ የመዳረሻ ሙከራና ያልተገኘ ቅንብር ሙከራን እንደ ውድቀቶች ይመዘግባል።
እንዴት ይሠራል? (አማራጭ)
ድንበሩንም ሆነ መልሱን ያረጋግጡ
የተሳካ መልስ ብቻ ቁልፉ የግል ሆኖ መቆየቱን አያረጋግጥም።
በማያ ፎቶዎች ወይም በጋራ logs ሳይለጥፉት፣ እውነተኛውን የአቅራቢ ቁልፍ በተሰማራው ይፋዊ HTML እና scripts ይፈልጉ። የአሳሽ ጥያቄዎችን ይመርምሩ፦ የልምምድ ኮዱ ለባለቤቱ ሊታይ ይችላል፣ የGemini ቁልፍ ግን መታየት የለበትም።
በሊሰረዝ የሚችል ፕሮጀክት የተሳሳተ የልምምድ ኮድና የጎደለ የአቅራቢ ቅንብር ይፈትሹ። አለመሳካት አለመሳካት ሆኖ መቀጠል አለበት። የአቅራቢ ሁኔታ 429 የኮታ/የጥያቄ ፍጥነት ገደቦችን ሊያመለክት ይችላል፤ 401 ወይም 403 የመዳረሻ/ቅንብር ችግሮችን ሊያመለክቱ ይችላሉ። እነዚህን ሁሉ ለመደበቅ፣ በእውነት ከአቅራቢው ያልተመለሰ የሐሰት የAI መልስ አይፍጠሩ።
የተሠራ ምሳሌ
ትክክለኛ የአቅራቢ ቅንብሮች ያሉት ትክክለኛ የልምምድ ኮድ እውነተኛ መልስ መመለስ አለበት። ተመሳሳዩ endpoint ከተሳሳተ ኮድ ጋር ከማንኛውም የአቅራቢ ጥያቄ በፊት መከልከል አለበት።
ተጨማሪ የአተገባበር ልምምድ
መልሱ ይሠራል፣ የአቅራቢው ቁልፍ ግን በpublic/app.jsም ይታያል። ተግባሩ ተጠናቋል?
የተሠራ መፍትሔ ያሳዩ
አልተጠናቀቀም። ቁልፉን ከይፋዊ ፋይሎች ያስወግዱ፣ ስለተጋለጠ ይተኩት፣ የአገልጋዩን ቅንብር ያዘምኑ፣ አዲሱን deployment እና የማከማቻ ታሪክም የቀረ መጋለጥ እንዳለ ይፈትሹ።
- የተሳካ ውጤትን እንደ በቂ ማስረጃ አይቀበልም።
- ፍሳሹን ያስወግዳል፣ የተጋለጠውንም ቁልፍ ይተካል።

ደረጃ 3 · የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?
አንድ ወሰን ያለው ለውጥ በጥንቃቄ ያድርጉ
ተግባሩን ሲቀይሩ ተመሳሳይ የሚስጥር ወሰን ይጠብቁ።
ማብራሪያ፣ የተሠራ ምሳሌ እና ልምምድ
ሐሳቡን ይረዱ
ረዳቱ የተሰጠውን ቋሚ ተግባር DNSን በአጭሩ እንዲያብራራ እንዲያስተካክል ይጠይቁ። የሞዴልና የቁልፍ ቅንብሮች በአገልጋዩ ላይ እንዲቆዩ፣ የልምምዱም መዳረሻ ለባለቤቱ ብቻ እንዲወሰን ይጠብቁ።
የታሰበውን ምላሽና ልክ ያልሆነ የመዳረሻ ኮድ እንደገና ይፈትሹ። ለሕዝብ ከመክፈትዎ በፊት እውነተኛ የማንነት ማረጋገጫ፣ ዘላቂ የአጠቃቀም ቁጥጥሮችና የአገልግሎት ሰጪውን በጀት መከታተያ ላይ ይወስኑ።
ተጨባጭ ምሳሌ
የመልሱን ርዕስ መቀየር የግል የመለያ እሴቶችን ወደ ገጹ ማዛወር የለበትም።
የዚህ ደረጃ ፋይሎች
ከታች ያሉትን ፋይሎች ይክፈቱ ወይም አንድ በአንድ ያውርዱ። ፕሮጀክቱን ሲያስቀምጡ በፋይል ስሞቹ የሚታየውን የአቃፊ አወቃቀር ይጠብቁ።
እርስዎ ይሞክሩ
የተለወጠውን ተግባርና በእውነት ያካሄዱትን የግላዊነት፣ የትክክለኛና የልክ ያልሆነ ጥያቄ ፍተሻዎች ያቅርቡ።
ማቅረብ ያለብዎት: ለተሰጠው ተግባር የቁልፉን ጥበቃና ትክክለኛ/የማይፈቀዱ ጥያቄዎችን ውጤት የሚያሳይ፣ ሚስጥራዊ መረጃ የተወገደበት መዝገብ።
የተሠራ መፍትሔ ያሳዩ
የለውጥ መዝገብ ምሳሌ፦ “ቋሚው ተግባር አሁን DNSን በሁለት አረፍተ ነገሮች ያስረዳል። የተፈቀደ የልምምድ ጥሪ ያንን ርዕስ መለሰ፤ የተሳሳተ የልምምድ ኮድ ተከለከለ፤ የይፋዊ ውጤት ፍተሻው አሁንም የአቅራቢ ቁልፍ አላገኘም።”
“ይህን ለማላውቃቸው ሰዎች ከመክፈቴ በፊት፣ እውነተኛ የማንነት ማረጋገጫ፣ ዘላቂ የአጠቃቀም ገደቦችና የአቅራቢ በጀት ክትትል ገና ያስፈልጉኛል።” የጋራው የልምምድ ኮድ ትንሽ የልምምድ ድንበር ነው እንጂ ሙሉ ይፋዊ አገልግሎት ማስረጃ አይደለም።
ትክክለኛ መልስ የሚያካትተው
- የአገልጋይ ብቻ ቁልፍ/ሞዴል ቅንብሮችን እንደጠበቀ የቋሚውን ምላሽ ርዕስ ወደ DNS ይቀይራል።
- የተፈቀዱና የተከለከሉ ጥሪዎችን ይደግማል፣ ለይፋዊ አጠቃቀም የቀሩ የወጪ/መዳረሻ መቆጣጠሪያዎችን ይጠቅሳል።
እንዴት ይሠራል? (አማራጭ)
ተግባርዎ፦ ሁለተኛ ቋሚ ተግባር ያዛውሩ
ድንበሩን በአጋጣሚ ከማስፋት ይልቅ በዓላማ ይድገሙት።
የአገልጋዩን ቋሚ ጥያቄ DNSን በሁለት ዓረፍተ ነገሮች እንዲያብራራ ይቀይሩ። የመግቢያ መረጃዎችን፣ የmodel ምርጫንና የውጤት ገደብን በአገልጋይ ያቆዩ፤ አሳሹ የአቅራቢ ቁልፉን እንዳያውቅ ያድርጉ።
በትክክለኛና በማይሠራ የልምምድ ኮድ ውጤቱን ይመዝግቡ። ይፋዊ መዳረሻ ከመስጠትዎ በፊት ምን እንደሚጨምሩ ያብራሩ፦ ማንነታቸው የተረጋገጠ ተጠቃሚዎች ወይም ሌላ ትርጉም ያለው የመዳረሻ ድንበር፣ ዘላቂ የአጠቃቀም ገደቦችና ከአቅራቢ በጀቱ አንጻር ክትትል።
የተሠራ ምሳሌ
ቋሚ ጥያቄን መቀየር የአቅራቢው ባህሪ የት እንደሚቆጣጠር መረዳትዎን ያረጋግጣል። ከአሳሹ ማንኛውንም models፣ endpoints ወይም የውጤት ገደቦች መቀበል ያንን ቁጥጥር ያጠፋል።
ሙሉው የማጣቀሻ መመሪያ በreference/assignment-walkthrough.txt ይገኛል። ደረጃዎቹን ከራስዎ ውጤት ጋር ያወዳድሩ፤ የፍተሻ መዝገቡን በራስዎ ፕሮጀክት ያዩትን ተጠቅመው ይሙሉ።
ተጨማሪ የአተገባበር ልምምድ
የDNS ቅጂውንና አጭር የድንበር ፍተሻ መዝገብ ያዘጋጁ።
የተሠራ መፍትሔ ያሳዩ
በአገልጋይ ብቻ በሚሠራው mini-explain function፣ ስለ ድረ ገጽ አገልጋይ ያለውን ቋሚ ጥያቄ 'Explain DNS in two sentences for a beginner.' በሚለው ይተኩ፣ ይህም DNSን ለጀማሪ በሁለት ዓረፍተ ነገሮች አብራራ ማለት ነው። ቁልፉን/modelን በአገልጋይ የአካባቢ ተለዋዋጮች ያቆዩ፤ ሙሉው የማጣቀሻ function ትክክለኛውን እርማት ያሳያል።
ለአሳሽ የሚላኩ scriptsንና Network ጥያቄዎችን ይመርምሩ። አሳሹ ጥያቄውን ወደ የራስዎ function ይልካል፤ GEMINI_API_KEYን ራሱ ወደ Google መላክ የለበትም። ባለቤቱ የሚያስገባው የልምምድ ኮድ ከአቅራቢው ቁልፍ የተለየ ነው።
የተሳሳተ የልምምድ ኮድ ይሞክሩ፦ ከማንኛውም የአቅራቢ ጥሪ በፊት መከልከልን ይጠብቁ። የአቅራቢ ኮታ/አውታረ መረብ አለመሳካት እውነተኛ አለመሳካት ሆኖ መቀጠል አለበት፣ ቀድሞ የተዘጋጀ የስኬት መልስ አይሁን። እውነተኛ ሚስጥር ከተጋለጠ፣ ያስወግዱትና ይተኩት፤ በኋላ ፋይሉን ችላ ማለት መጋለጡን አይሽርም።
- ምንም የአቅራቢ ሚስጥር ወደ አሳሹ አይላክም።
- የተሳሳተ መዳረሻ ይከለከላል፣ እውነተኛ የአቅራቢ አለመሳካትም ይታያል።
ይህ ትምህርት ጠቅሞሃል?
ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።