የመጀመሪያው የሚሠራ ፋይል
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 ወይም ያልተገደበ ነጻ ዕቅድ ቃል የለም።
ይህ በአሳሽ ማህደረ ትውስታ ያለ የአራት ልውውጥ ውይይት ነው። እንደገና መጫን ያጸዳዋል። የውሂብ ጎታ ወይም ደረጃ በደረጃ ምላሽ መላክ (streaming) አልተካተተም። የመጀመሪያውን ሰላምታ ብቻ ሳይሆን ሁለተኛውን ዙር ይፈትሹ።
ለትክክለኛ የኮምፒውተር ትዕዛዞችና የግል አካባቢ ስሞች 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