ወደ ትምህርቱ ይመለሱ

የመጀመሪያው የሚሠራ ፋይል

START-HERE.txt

ኮዱ እና የሚሠሩ ምሳሌ ገጾች የመጀመሪያ መለያዎቻቸውንና የምሳሌ ጽሑፋቸውን ይይዛሉ። ትምህርቱ እና የፋይል መመሪያዎች በእርስዎ ቋንቋ ያብራሯቸዋል።

ተግባራዊ መንገድ

የአገልግሎት አቅራቢውን ቁልፍ ከጎብኚው አሳሽ ውጭ ለማቆየት የተሰጠውን በአገልጋይ የሚሠራ ምሳሌ ይጠቀሙ፤ የሚፈቀዱና የሚከለከሉ ጥያቄዎችንም ያረጋግጡ።

የእርስዎ ድርሻ፦ የመለያውን እሴቶች በግል ያስገቡ፣ የታሰበውን ውቅር ያጽድቁ፣ በአሳሹና በአገልግሎቱ የታየውን ውጤት ይፈትሹ።

1. የተሰጠውን ፕሮጀክት ይጠቀሙ፤ የኮድ ጻፊ ረዳትዎ አተገባበሩን እንዲሠራ ይጠይቁ። HTML፣ JavaScript ወይም SQL ራስዎ መጻፍ አያስፈልግዎትም።
2. የአሁኑን ትምህርት ደረጃዎች ይከተሉ፣ ለመጠቀም ፈቃድ ያለዎትን የራስዎን መለያዎች ብቻ ያዋቅሩ፣ በእውነተኛው ገጽ ወይም አቅራቢ ውስጥም ውጤቱን ይፈትሹ።
3. የተጠበቁትንና በእውነት የታዩትን ውጤቶች ለይተው ይያዙ። በቀጥታ መፈተሽ ካልቻሉ የተቋረጠውን ትክክለኛ ደረጃ ይመዝግቡ።

ከታች ያሉት ዝርዝር የውቅር መመሪያዎች ለእርስዎና ለረዳትዎ ይገኛሉ። የኮድ ማብራሪያዎችና ተጨማሪ የአተገባበር ልምምዶች አማራጭ ናቸው፤ አስፈላጊ የመዳረሻና የግላዊነት ፍተሻዎች ግን የተግባራዊው ትምህርት አካል ናቸው።

--- አስፈላጊ ማዋቀር (ኮዱን ማንበብ አማራጭ ነው) ---
ይህ የተለየ የልምምድ ፕሮጀክት ነው። public/ የድረ ገጽ አቃፊ ነው፤ netlify/functions/ በአገልጋይ ብቻ የሚሠሩ functions ይዟል። በኮምፒውተር functions ለመፈተሽ Node እና Netlify CLI ይጫኑ፣ ወይም ይህን ፕሮጀክት ወደ ራስዎ Netlify መለያ ያሰማሩ። እውነተኛ የመግቢያ መረጃዎችን በአገልጋይ የአካባቢ ተለዋዋጮች እንጂ በpublic/ ወይም Git ፈጽሞ አያስቀምጡ። እነዚህን ፋይሎች መክፈት ብቻ ምንም የአቅራቢ ጥያቄ አያስኬድም። የመለያ ደረጃዎችና እውነተኛ ማድረስ በራስዎ መለያ መፈተሽ አለባቸው።
GEMINI_API_KEY፣ GEMINI_MODEL (ከራስዎ AI Studio መለያ የሚገኝ የጽሑፍ model) እና ቢያንስ 24 ቁምፊዎች ያሉት ሊገመት የማይችል LAB_TOKEN ያዘጋጁ። የልምምድ ኮዱ በባለቤቱ ይገባል፣ በbundle አይካተትም። ሰው ሠራሽ መልዕክቶች ብቻ ይጠቀሙ፦ ወደ Google ይላካሉ። ወቅታዊ የመለያ ዋጋዎችን፣ ኮታንና የውሂብ ውሎችን መጀመሪያ ይፈትሹ። ይህ ለባለቤቱ የተገደበ ልምምድ ይፋዊ የውይይት አገልግሎት አይደለም፤ ከይፋ አጠቃቀም በፊት የተጠቃሚ ማንነት ማረጋገጫ፣ ዘላቂ የአጠቃቀም ገደቦች፣ ክትትልና የግላዊነት ማሳወቂያ ያክሉ። የጡረታ የወጣ ቋሚ model ወይም ያልተገደበ ነጻ ዕቅድ ቃል የለም።
ይህ ትምህርት አንድ ቋሚ ጥያቄ ይልካል፣ ማንኛውንም የጎብኚ ጥያቄዎች አይደለም። public/ እና netlify/functions/ን ያሰማሩ። ዝውውሩ ተጠናቋል ከማለትዎ በፊት የአቅራቢውን ቁልፍ በይፋዊ ፋይሎችና በአሳሽ ጥያቄዎች ይፈልጉ።
ለትክክለኛ የኮምፒውተር ትዕዛዞችና የግል አካባቢ ስሞች run-locally.txt እና server-env.example.txt ያንብቡ።

የጡረታ የወጣ ስም በኮድ ሳይጽፉ፣ መለያው የሚያያቸውን ወቅታዊ model IDዎች ለመመርመር ያስኪዱ፦ node --env-file=.env list-text-models.mjs
ይህ helper የmodel ገላጭ መረጃ ይዘረዝራል፣ ስሞችን ብቻ ያትማል፤ የተፈጠረ መልስ አይጠይቅም። በአሁኑ ጊዜ የሚደገፍ የጽሑፍ እጩ ይምረጡ፣ GEMINI_MODELን ከማዘጋጀትዎም በፊት ዋጋ/ኮታ ይፈትሹ። ወቅታዊ የmodel መመሪያ፦ https://ai.google.dev/gemini-api/docs/models