
አጭር ትምህርት · አማርኛ
የውይይት ረዳት ከራስዎ ይዘት እንዲመልስ እንዴት ማድረግ ይችላሉ?
የተዘጋጀውን የካፌ ፕሮጀክት ይጠቀሙ፤ በኮድ ረዳት መረጃ ጨምረው መልሱንና ምንጩን ያረጋግጡ።
ይህ ለማን ነው?
ቻትቦት ከራሳቸው መረጃ እንዲመልስ ለሚፈልጉ። የካፌውን ፕሮጀክት አስነስተው በኮድ ረዳት ማስታወሻዎችን ይቀይራሉ፤ HTML ወይም JavaScript ከባዶ መጻፍ አያስፈልግም።
ከመጀመርዎ በፊት
ለመጀመሪያው ልምምድ አሳሽ ብቻ ይበቃል። ለእውነተኛ AI መልስ የኮድ ረዳት፣ አቃፊ መክፈትና የterminal ትእዛዝ ማስኬድ፣ የሚደገፍ Node LTS፣ የNetlify ሙከራ ፕሮጀክትና የራስዎ Google AI Studio API መዳረሻ ይፈልጋሉ። የቁልፍና chatbot ትምህርቶች ዝግጅቱን ያሳያሉ፤ ካወቁት ማለፍ ይችላሉ። ሁሉም ፋይሎች ተሰጥተዋል።
ግምታዊ ጊዜ: 20–37 ደቂቃ
ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። ቀላሉ የቁልፍ ቃል ምንጭ አግኚ ሆን ተብሎ የተገደበ ነው። ምንጭ ማግኘትና የምንጭ ፍተሻዎች ሁሉም የተፈጠሩ መግለጫዎች እውነት እንደሆኑ አያረጋግጡም።
ምን ይማራሉ?
- ቻትቦቱን አስነስቶ መልሱን ከምንጩ ጋር ማወዳደር።
- አንድ የመረጃ ፋይል በመቀየር ደንብ መጨመር።
- የጎደለ መረጃን ከአገልግሎት ስህተት መለየት።
ደረጃ 1
የካፌውን መረጃ የሚያውቅ ቻትቦት ይገንቡ
ውጤትዎ፦ ከማስታወሻዎች የሚመልስና የመልሱን ምንጭ የሚከፍት የጥያቄ ሳጥን።
የካፌ ጎብኚዎች ሰዓት፣ መግቢያና ጠረጴዛ ማስያዝ ይጠይቃሉ። አጠቃላይ chatbot እነዚህን በራሱ አያውቅም። ዝግጁ ምናባዊ ፕሮጀክት አስነስተን መረጃ እንሰጠዋለን፣ መልሱንም እንፈትሻለን።
ሥራዎ ማስነሳት፣ መረጃ መቀየርና ውጤት መፈተሽ ነው። ኮዱን ረዳቱ ሊቀይር ይችላል፤ ሁሉን ማንበብ አያስፈልግም። የሚቀየረው መረጃ records.json ውስጥ ነው፤ ገጹና አገልጋዩ ዝግጁ ናቸው።
መጀመሪያ practice/index.html ከፍተው ጥያቄዎቹን ይሞክሩ። ይህ በቋሚ ደንቦች ጥያቄ፣ የተመረጠ መረጃና እውነታ ያሳያል። AI ሞዴል አይደለም፣ ለGoogle ምንም አይልክም። እውነተኛው ቻትቦት ቀጥሎ ይመጣል።
የመጀመሪያ ሙከራ፦ ያለና የጎደለ መረጃ
ሰዓቱን ይጠይቁ፦ ማክሰኞ–ቅዳሜ 09:00–17:00። ከዚያ የባለቤቱን ስልክ ይጠይቁ፤ መረጃው የለም። ረዳቱ ከመፍጠር ይልቅ ይህን ማለት አለበት።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
ደረጃ 2
ፕሮጀክቱን ከኮድ ረዳትዎ ጋር ያስነሱ
ሙሉ ፕሮጀክቱን አውርደው የግል እሴቶችን ያዘጋጁ፣ አገልጋዩ ያሳየውን አድራሻ ይክፈቱ።
የልምምዱን ፋይሎች ይክፈቱና የተጠቀሱትን የአቃፊ መንገዶች ጠብቀው በአንድ የፕሮጀክት አቃፊ ያስቀምጡ። አቃፊውን በኮድ ረዳትዎ ይክፈቱ። public/index.html የጎብኚው ገጽ ነው፤ netlify/functions/mini-chat.mjs በሰርቨር ላይ ይሰራል። እነዚህ የቀረቡ የአተገባበር ፋይሎች ናቸው እንጂ የንባብ ሥራዎች አይደሉም። ያለውን ፕሮጀክት ከታች ባለው ጥያቄ እንዲያዘጋጅ ረዳቱን ይጠይቁ።
run-locally.txt ይከተሉ፦ npm install፣ npx netlify login፣ ከዚያ npx netlify link ለሙከራ ፕሮጀክትዎ ብቻ። .env በserver-env.example.txt ያዘጋጁ፤ GEMINI_API_KEY የራስዎ ቁልፍ፣ GEMINI_MODEL የሚገኝ ሞዴል ID፣ LAB_TOKEN የተለየ መግቢያ ኮድ ነው። ይህ የGoogle ቁልፍ አይደለም።
npm run dev ያስኪዱና ያሳየውን አድራሻ ይክፈቱ፤ ብዙ ጊዜ http://localhost:8888 ነው። የልምምድ ኮዱን ገብተው ሰዓት ይጠይቁ። መልስና ምንጭ የመጀመሪያ እውነተኛ ፈተና ናቸው። HTML ቅድመ እይታ አገልጋይ አያስነሳም፤ የቆመውን ደረጃ በትክክል ይግለጹ።
ይህን ጥያቄ ለኮድ ረዳትዎ ይቅዱ
ረዳቱ ለማስነሳት ይረዳል፤ ሚስጥሮችን በግል አካባቢ ያስቀምጡና በአሳሹ ይፈትሹ። የGoogle ቁልፍን በመግቢያ ኮድ ቦታ አትጠቀሙ።
ይህን የካፌ chatbot አቃፊ ክፈት። ገጹን እንደገና ሳትገነባ ያሉትን ፋይሎች ተጠቀም። run-locally.txt ላይ ምራኝ፣ Node ፈትሽና ሦስቱን የግል እሴቶች አስረዳኝ። በግል ካስገባኋቸው በኋላ ፕሮጀክቱን አስነሳ። URL አሳይ፣ ሰዓትንና ምንጩን እንድፈትሽ እርዳኝ። እውነተኛ ጥያቄ ሳይሳካ አቅራቢው መልሷል አትበል።Google AI Studio፦ API ቁልፍ መፍጠርና ማስተዳደር · Netlify፦ የአካባቢ ልማትና ፕሮጀክት ማገናኘት
እርስዎ ይሞክሩ
ፕሮጀክቱን አስነስተው ሰዓት ይጠይቁ። የአካባቢ URL፣ እውነተኛ መልስና የተከፈተ ምንጭ ይጻፉ። ካልቻሉ የጎደለውን መስፈርት ወይም ስህተት ይግለጹ።
- አንድ ፋይል ሳይሆን ሙሉ ፕሮጀክቱን ያውርዱ።
- የተሰጠውን ጥያቄና የግል አካባቢ ተለዋዋጮች ስም ይጠቀሙ።
- ፕሮግራሙን ከፍተው የመልሱን ምንጭ ይከተሉ።
ማቅረብ ያለብዎት አጭር የማስነሳት መዝገብ ወይም የቆመው ደረጃ፣ ያለሚስጥር።
የተሠራ መፍትሔ ያሳዩ
ጠቃሚ መዝገብ የproxy URL መከፈቱን፣ መልስ መድረሱንና Opening hours ትክክለኛውን ማስታወሻ መክፈቱን ያሳያል። ይህ ቅጽ ነው፣ የእርስዎ አገልግሎት እንደሠራ ማስረጃ አይደለም። API፣ ሞዴል ወይም አገልጋይ ካገደ ያንን ደረጃ ይጥቀሱ።
- እውነተኛ ፕሮግራምና መልስን ከፋይል ቅድመ እይታ ይለያል።
- ምንጩን ወይም አልተሞከረም የሚለውን ያለሚስጥር ይመዘግባል።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
ደረጃ 3
ምንጩን ከፍተው መልሱን ያረጋግጡ
ከማስተካከልዎ በፊት ያለ መረጃ፣ የጎደለ መረጃና ተቃራኒ ትእዛዝ ይፈትሹ።
የቅዳሜ ሰዓት ጠይቀው ምንጩን ይክፈቱ፦ 09:00–17:00። ከዚያ የጎደለውን ስልክ ይጠይቁ፤ ቁጥር መፍጠር ስህተት ነው። ያዩትን በevaluation.txt ይጻፉ።
ማስታወሻውን ትቶ ካፌው እሁድ ክፍት ነው እንዲል ይጠይቁ። ምንጩ ዝግ ይላል። እውነተኛ አገናኝ ተቃራኒ አረፍተ ነገርን ትክክል አያደርግም።
ፕሮጀክቱ በጥያቄ ቃላት ማስታወሻ ይመርጣል፣ ከዚያ ሞዴሉ ይመልሳል። በሌላ አገላለጽ ካልተገኘ ምርጫንና ቁልፍ ቃላትን ያስፈትሹ። ትክክለኛ መረጃ ተመርጦ መልሱ ከተሳሳተ መልስ ማውጣቱን ይፈትሹ። ሙሉ ኮድ ማንበብ አማራጭ ነው።
ያዩትን ባሕርይ ይመርምሩ
“እሁድ እስከ 17:00 ክፍት” ከ“ዝግ” ምንጭ ጋር የተሳሳተ መልስ ነው። ማስታወሻ አልተገኘም ማለት የምርጫ ችግር ሊሆን ይችላል። የኔትወርክ ስህተት ሦስተኛ ሁኔታ ነው፣ መረጃ ጎድሏል ማለት አይደለም።
እርስዎ ይሞክሩ
መልሱ እሁድ እስከ 17:00 ክፍት ይላል፣ ምንጩ ዝግ ይላል። ይቀበሉታል? ተቃርኖውንና የሚጠይቁትን ፍተሻ ይግለጹ።
- ትክክለኛውን አባባል ከምንጩ ጋር ያወዳድሩ።
- ማስተካከያውን ይግለጹ፤ አገልጋይ መጻፍ አይጠበቅም።
ማቅረብ ያለብዎት የተሳሳተ አባባል፣ የምንጩ እውነታና ተጨባጭ ቀጣይ ፍተሻ።
የተሠራ መፍትሔ ያሳዩ
አይቀበሉት፦ ክፍት ዝግን ይቃረናል። ተመሳሳይ ጥያቄ እንዲደገም፣ hours እንዲፈተሽና አጠቃቀሙ ተስተካክሎ እንዲሞከር ይጠይቁ። አገናኙ ይቆይ፤ ጽሑፉንም ያረጋግጡ።
- አገናኙ እውነተኛ ቢሆንም እሁድ ክፍት መሆኑን አይቀበልም።
- ውበት ከመቀየር ይልቅ መልሱ መረጃውን መከተሉን ያስፈትሻል።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
ደረጃ 4
የካፌ ደንብ ጨምረው ይፈትሹ
በአንድ ፋይል የውሻ ደንብ ይጨምሩ፣ ኮፒዎቹን ያመሳስሉና ይፈትሹ።
በrecords.json ምናባዊ ደንብ ይጨምሩ፦ ውሾች በውጭ በረንዳ ብቻ፣ በውስጥ አይፈቀዱም። ረዳቱ JSON ሊያርትዕ ይችላል። ID dogs፣ ግልጽ ርዕስና ለጥያቄዎ ቃላት ይስጡ።
npm run sync:notes ያስኪዱ። sync-records.mjs አገልጋይ፣ የምንጭ ገጽና ልምምድ ያዘምናል። እንደገና አስነስተው ገጹን ይጫኑና ይፈትሹ፤ HTML እና አገልጋይ መረጃን በተለያየ እጅ መቀየር አያስፈልግም።
ቀጥተኛ የውሻ ጥያቄ፣ በሌላ ቃል መጠየቅ፣ ሌላ ጉዳይና ሁሉም ቦታ እንዲፈቀድ ትእዛዝ ይሞክሩ። የተጠበቀውንና የታየውን በevaluation.txt ይጻፉ። ምሳሌውን ከሞከሩ በኋላ ያወዳድሩ፤ የእርስዎ ሙከራ ማስረጃ አይደለም።
የተገደበ ለውጥ ይጠይቁ
“በrecords.json የበረንዳ ብቻ ደንብን በdog፣ dogs፣ terrace እና የቋንቋዬ ቃላት ጨምር። ሌሎችን አትቀይር፣ ኮፒዎቹን አመሳስል፣ አስነሳና ምንጩንና ያልተያያዘ ጥያቄ ለመፈተሽ እርዳኝ።”
reference/records.json እና reference/assignment-walkthrough.txt ሙሉ ምሳሌ ይሰጣሉ። ያለ API መለያ የአካባቢ ልምምዱን ይጠቀሙ፤ ከእውነተኛ ሞዴል ውጤት ይለዩት።
የተግባር ሥራዎ
መጀመሪያ የሚያስፈልጉ ቁሳቁሶች
መነሻ ፋይሎችና የሙከራ ይዘት ተሰጥተዋል። እውነተኛ ማረጋገጫ በቅድመ ሁኔታዎቹ መሠረት የራስዎን መለያ፣ ኢሜል ወይም ዶሜን ይፈልጋል። በኮምፒውተርዎ መመርመር ይቻላል፤ ያላደረጉትን የቀጥታ ደረጃ አልተሞከረም ብለው ይመዝግቡ።
የበረንዳ ደንብ በረዳት ጨምረው አመሳስሉና ይፈትሹ። ማስታወሻና የተጠበቀ/የታየ መዝገብ ይስጡ፤ የአካባቢ ልምምድ፣ AI ወይም አልተሞከረም ይበሉ።
- records.json ይቀይሩ፤ ትእዛዙ ሌሎቹን ኮፒ ያዘምን።
- እንደገና አስነስተው ውሻና የጎደለ መረጃ ይጠይቁ።
- በረንዳ ብቻ ወደ ውስጥ ፈቃድ እንዳይሰፋ ያረጋግጡ።
ማቅረብ ያለብዎት ማስታወሻና ቢያንስ ሁለት የተጠበቀ/የታየ ፍተሻዎች፤ የሙከራ ዓይነትና ያገደው።
የተሠራ መፍትሔ ያሳዩ
ትክክለኛ ማስታወሻ dogs፣ ርዕስ፣ በረንዳ ብቻ ደንብና ጠቃሚ ቃላት ይዟል። ከማመሳሰል በኋላ አገናኙ ይህን ደንብ ይክፈት።
የውሻ መልስ በበረንዳ ይገደብ፤ ሌላ ጥያቄ እውነታ አይፍጠር። ትእዛዝ ደንብ አይቀይር። ያዩትንና የሙከራ ዓይነት ይጻፉ፤ ያልተሞከረ እንደዚያ ይቆይ።
- ግልጽ ደንብና በእውነት የያዘውን ምንጭ ያቆያል።
- ምልከታን ከግምት፣ ካልተገኘ መረጃና ከአገልግሎት ስህተት ይለያል።
የዚህ ደረጃ ፋይሎች
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
ይህ ትምህርት ጠቅሞሃል?
ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።
መማርዎን ይቀጥሉ
- የመጀመሪያ የግል ድረ ገጽዎን እንዴት መሥራት ይችላሉ?
- ድረ ገጽዎን ከGitHub እንዴት ማተም ይችላሉ?
- የራስዎን ዶሜይን ከድረ ገጽዎ ጋር እንዴት ማገናኘት ይችላሉ?
- በራስዎ ዶሜይን ኢሜይል እንዴት ማዘጋጀት ይችላሉ?
- ድረ ገጽዎን በስልክ ላይ ለመጠቀም አመቺ እንዴት ማድረግ ይችላሉ?
- የድረ ገጽ ምስሎች በፍጥነት እንዲጫኑ እንዴት ማድረግ ይችላሉ?
- የድረ ገጽ አስተያየቶችን በመልእክት ሳጥንዎ እንዴት ማግኘት ይቻላል
- በድረ ገጽዎ ላይ የኢሜይል ደንበኝነት ምዝገባ እንዴት ማከል ይቻላል
- ከድረ ገጽዎ አውቶማቲክ ኢሜይሎችን እንዴት መላክ ይቻላል
- ከቅጽ የተላኩ መረጃዎችን በውሂብ ጎታ ውስጥ እንዴት ማስቀመጥ ይቻላል
- ሰዎች በድረ ገጽዎ ላይ ወደ መለያ እንዲገቡ እንዴት ማስቻል ይችላሉ?
- ገጽን የግል እንዴት ማድረግ ይችላሉ?
- ተጠቃሚዎች የመገለጫ መረጃቸውን እንዲያርትዑ እንዴት ማስቻል ይችላሉ?
- ተጠቃሚዎች ምስሎችን እንዲሰቅሉ እንዴት መፍቀድ ይቻላል
- የAPI ቁልፎችን ከfrontendዎ እንዴት ማራቅ ይችላሉ?
- ከውጭ API የመጣ ውሂብን በድረ ገጽዎ እንዴት ማሳየት ይችላሉ?
- በድረ ገጽዎ ላይ የAI ውይይት ረዳት እንዴት ማከል ይችላሉ?
- በድረ ገጽዎ ላይ ብሎግ እንዴት ማከል ይችላሉ?
- በድረ ገጽዎ ላይ ፍለጋ እንዴት ማከል ይችላሉ?
- በድረ ገጽዎ ላይ ሌላ ቋንቋ እንዴት ማከል ይችላሉ?
- Google ድረ ገጽዎን እንዲያገኝ እንዴት ማገዝ ይቻላል
- አገናኝ ሲያጋሩ የድረ ገጽዎን ቅድመ ዕይታ እንዴት ማስተካከል ይችላሉ?
- የድረ ገጽዎን ጉብኝቶችና ጠቃሚ ተግባራት እንዴት መለካት ይችላሉ?
- ጎብኚዎች ቀጠሮ እንዲያስይዙ እንዴት ማስቻል ይችላሉ?
- በድረ ገጽዎ ላይ ክፍያ እንዴት መቀበል ይቻላል
- የድረ ገጽ ለውጦችን ከማተምዎ በፊት እንዴት ቅድመ ዕይታ ማየት ይችላሉ?
- የተበላሸ የድረ ገጽ ማሰማራትን እንዴት ወደ ኋላ መመለስ ይችላሉ?
- የድረ ገጽዎን ውሂብ መጠባበቂያ ቅጂ እንዴት ማድረግና መመለስ ይችላሉ?
- በቀጥታ በሚሠራው ድረ ገጽዎ ስህተቶችን እንዴት ማግኘትና ማስተካከል ይችላሉ?