አጭር ትምህርት · አማርኛ

የውይይት ረዳት ከራስዎ ይዘት እንዲመልስ እንዴት ማድረግ ይችላሉ?

የተዘጋጀውን የካፌ ፕሮጀክት ይጠቀሙ፤ በኮድ ረዳት መረጃ ጨምረው መልሱንና ምንጩን ያረጋግጡ።

ተግባቦታዊውን ትምህርት ይጀምሩየትምህርቱን ማስታወሻዎች ያንብቡ

ይህ ለማን ነው?

ቻትቦት ከራሳቸው መረጃ እንዲመልስ ለሚፈልጉ። የካፌውን ፕሮጀክት አስነስተው በኮድ ረዳት ማስታወሻዎችን ይቀይራሉ፤ 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። ከዚያ የባለቤቱን ስልክ ይጠይቁ፤ መረጃው የለም። ረዳቱ ከመፍጠር ይልቅ ይህን ማለት አለበት።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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፦ የአካባቢ ልማትና ፕሮጀክት ማገናኘት

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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 ክፍት” ከ“ዝግ” ምንጭ ጋር የተሳሳተ መልስ ነው። ማስታወሻ አልተገኘም ማለት የምርጫ ችግር ሊሆን ይችላል። የኔትወርክ ስህተት ሦስተኛ ሁኔታ ነው፣ መረጃ ጎድሏል ማለት አይደለም።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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 መለያ የአካባቢ ልምምዱን ይጠቀሙ፤ ከእውነተኛ ሞዴል ውጤት ይለዩት።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

ይህ ትምህርት ጠቅሞሃል?

ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።

መማርዎን ይቀጥሉ

ሌሎች ትምህርቶችን ይመልከቱ