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

በድረ ገጽዎ ላይ የAI ውይይት ረዳት እንዴት ማከል ይችላሉ?

የተዘጋጀ የግል ውይይት ቦት በኮድ ጻፊ ረዳት እገዛ ያስነሱ፤ የክትትል ጥያቄው ቀድሞውን ውይይት እንደሚጠቀምና ጥያቄ ሲከሽፍ ይዘቱ እንደሚቆይ ይፈትሹ።

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

ይህ ለማን ነው?

በትንሽ ድረ ገጽ ላይ የውይይት ረዳት ለሚጨምሩ ሰዎች። ፕሮጀክቱ ተሰጥቷል፤ የመልእክት ማስተናገጃ ኮድ ከመጻፍ ይልቅ ባህሪውን ይመራሉ፣ ይፈትሹታልም።

ከመጀመርዎ በፊት

የራስዎ Google AI Studio API መዳረሻና የተሰጠው የተለየ server-function ፕሮጀክት ያስፈልጋሉ። ካስፈለገ የAPI ቁልፍ ትምህርቱ የግል ማዋቀርን ያስረዳል። በመጀመሪያ የሚገኙ ሞዴሎችን፣ የአጠቃቀም ገደቦችንና ሊኖሩ የሚችሉ ክፍያዎች ያረጋግጡ። ምናባዊ መልዕክቶችና ባለቤቱ የሚይዘውን የልምምድ ኮድ ይጠቀሙ፤ ከይፋዊ አጠቃቀም በፊት የማንነት ማረጋገጫ፣ ዘላቂ የአጠቃቀም ገደቦችና የበጀት ክትትል ያስፈልጋሉ።

ግምታዊ ጊዜ: 20–32 ደቂቃ

ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። እውነተኛ ጥያቄዎች የተዋቀረውን የመለያዎን ኮታ ይጠቀማሉ። ይፋዊ ማንነት ማረጋገጥ፣ ዘላቂ ገደቦችና የግላዊነት ግምገማ የተለየ ሥራ ናቸው።

ምን ይማራሉ?

  • የመጀመሪያ እውነተኛ የAI መልስ ያስነሱ።
  • በቀድሞው መልእክት ላይ የሚመሠረት የክትትል ጥያቄ ይፈትሹ።
  • ያልተላከው መልእክት እንደገና ለመሞከር እንዲቆይ ያድርጉ።

የልምምድ ፋይሎች

ደረጃ 1

ለመፈተሽ ትንሽ ውይይት ይምረጡ

ሁለተኛው መልእክት በመጀመሪያው ላይ መመሥረት አለበት።

የተዘጋጀውን የውይይት ቦት ፕሮጀክት ከረዳትዎ ጋር ይክፈቱ። ቀላል የፈጠራ ርዕስና የቀድሞውን መልስ የሚያመለክት የክትትል ጥያቄ ይምረጡ፤ እንዲህ ውይይቱ ተያይዞ መቀጠሉን ሊገምግሙ ይችላሉ።

አንድ ብቻውን ጥሩ መልስ የሚሠራ ውይይት መኖሩን አያረጋግጥም። ሁለቱን መልእክቶችና መካከላቸው ያለውን ግንኙነት ለመመርመር ያቅዱ።

ተጨባጭ ምሳሌ

አጭር ማብራሪያ ይጠይቁ፣ ከዚያም ያንኑ ማብራሪያ ቀለል ባለ መልኩ እንዲያቀርብ ይጠይቁ።

የተሰጠውን የውይይት ቦት ፕሮጀክት ተጠቀም፣ በrun-locally.txt ያለውን የግል ውቅር ምራኝ። የመግቢያ ምስጢሮችንና የሞዴል መመሪያዎችን በአገልጋዩ ላይ አቆይ። የመጀመሪያ ጥያቄ እንድጠይቅ፣ በዚያው ርዕስ እንድቀጥልና የተጻፈው መልእክት ሳይጠፋ ያልተሳካ ጥያቄ እንድፈትሽ እርዳኝ። ድረ ገጹን እንደገና አትገንባ፣ ከመጀመሪያው መልስ ብቻም ውይይቱ ይሠራል አትበል።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

ውይይት መቀጠል የሚችል ረዳት ያክሉ

ጠቃሚ የውይይት ውህደት የተማሪውን የመጨረሻ መልዕክትና አውዱን ማንበብ አለበት።

ይህ ትምህርት ትንሽ የድረ ገጽ አስተማሪ ይሠራል። ጎብኚ ጥያቄ መጠየቅ፣ መልሱን ማንበብና ተከታይ ጥያቄ መጠየቅ ይችላል። አሳሹ ከእያንዳንዱ አዲስ መልዕክት ጋር የተቀበለውን ውይይት ይልካል፤ አገልጋዩ Geminiን ይጠራል፣ እውነተኛ የmodel ምላሽም ይመልሳል።

Model የቀድሞውን የHTTP ጥያቄዎን በራሱ አያስታውስም። በዚህ ትር ማህደረ ትውስታ አጭር ታሪክ እንይዛለን። እንደገና መጫን ያጸዳዋል፣ ልምምዱም የተገደበ እንዲሆን ከአራት የተሳኩ ልውውጦች በኋላ ይቆማል።

የተሠራ ምሳሌ

«DNS ምንድን ነው?» ከዚያ «ያንን በመንገድ አድራሻ ምሳሌ አብራራ» ይበሉ። ሁለተኛው ጥያቄ «ያንን» ምን እንደሚል ለመወሰን የቀድሞውን ጥያቄና መልስ ይፈልጋል።

Extra implementation exercise

የAPI ጥሪው ቢሳካም የሁለተኛው ዙር መልስ ለምን ያልተዛመደ ሊመስል ይችላል?

የተሠራ መፍትሔ ያሳዩ

ውህደቱ አጠቃላይ ጥያቄ ብቻ ልኮ ወይም ታሪኩን አስቀርቶ ሊሆን ይችላል። ወጪውን messages array ይመርምሩ፣ የቀድሞ የተቀበሉ ዙሮችንና አዲሱን ጥያቄ በቅደም ተከተል መያዙን ያረጋግጡ።

  • የቀድሞ መልዕክቶች መካተታቸውን ይፈትሻል።
  • የመጨረሻው የተጠቃሚ መልዕክት መጠበቁን ይፈትሻል።

ደረጃ 2

የተሰጠውን የውይይት ቦት ያስነሱ

ረዳቱ የግል የአገልጋይ ውቅሩን እንዲሠራ ያድርጉ።

ከረዳትዎ ጋር run-locally.txtን ይከተሉ። መለያውን፣ ሞዴሉን እና የአጠቃቀም ውሎችን ያረጋግጡ፤ ከserver-env.example.txt በመነሳት የአገልጋዩን የግል ቅንብሮች ያስቀምጡ፣ ከዚያም የአካባቢው ፕሮክሲ ያሳየውን የመተግበሪያ አድራሻ ይክፈቱ። በቅጹ ውስጥ የተለየውን የሙከራ ኮድ ያስገቡ፤ የአቅራቢውን ቁልፍ ፈጽሞ አያስገቡ። ይህ ዝግጅት ያስፈልጋል፤ የአገልጋዩን ኮድ መጻፍ ግን አማራጭ ነው።

የአቅራቢው ቁልፍና አጠቃቀሙን የሚመሩ መመሪያዎች በአገልጋዩ ላይ ይቆያሉ። መለያዎ ወይም ሞዴሉ ካልተገኘ ገጹን በሐሰት መልስ ከመሙላት ይልቅ ያንኑ ትክክለኛ ደረጃ ይግለጹ።

ተጨባጭ ምሳሌ

በድረ ገጽ ያለ መስክ ጎብኚው የእርስዎን የግል የአቅራቢ መግቢያ መረጃ እንዲመርጥ መፍቀድ የለበትም።

Gemini፦ generateContent API · Gemini፦ የAPI ቁልፎች · Gemini፦ ወቅታዊ model IDዎችና ችሎታዎች · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

አሳሹን ከተገደበ የአገልጋይ function ጋር ያገናኙ

የመግቢያ መረጃዎችንና የአስተማሪውን ሚና በአገልጋይ ቁጥጥር ያቆዩ።

የተሰጡትን አቃፊዎች ያሰማሩ፣ በSTART-HERE.txt ያሉትንም ተለዋዋጮች ያዋቅሩ። public/app.js የuser/assistant መልዕክቶችን ወደ ራስዎ mini-chat function ይልካል። functionው ተፈራራቂ ሚናዎችን፣ ገደብ ያለው ጽሑፍና ትንሽ ታሪክ ብቻ ይቀበላል።

አገልጋዩ assistantን ከGemini model ሚና ጋር ያዛምዳል፣ የተለየ system instructionም ያቀርባል። ጠሪው የአቅራቢ URL መምረጥ ወይም ያንን መመሪያ በደንበኛ በተሰጠ system ሚና መተካት አይችልም። የባለቤት ኮዱ ይህን ልምምድ ይገድባል፤ ይፋዊ ማንነት ማረጋገጥንና ዘላቂ የወጪ ቁጥጥርን አይተካም።

የgenerate function በnetlify/functions/mini-chat.mjs ውስጥ ያለ የፕሮጀክቱ helper ነው፣ ሌላ የተሰማራ አገልግሎት አይደለም። ለተግባሩ የአስተማሪውን ሚና ለመቀየር፣ በዚህ የአገልጋይ ፋይል ወደ generate የሚሰጠውን የመመሪያ ጽሑፍ ያርትዑ። የfrontend .env ተለዋዋጭ ማዘጋጀት አማራጭ አይደለም፦ በአሳሽ ኮድ የተተካ እሴት ይፋዊ ይሆናል።

ለሙሉው በኮምፒውተርዎ የማስኬድ ቅደም ተከተል 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 ቅንብር ይቅዱ።

የተሠራ ምሳሌ

የታሪክ ማረጋገጫው አቅራቢውን ከመጥራቱ በፊት የተጨመረ system-role መልዕክትን ይከለክላል። የmodel ውጤት ፈጽሞ አይሳሳትም ሊለው አይችልም፣ ግን የጥያቄ ቅርጽንና ከፍተኛ ፈቃድ ያለውን ቅንብር በእርስዎ ቁጥጥር ያቆያል።

Gemini፦ generateContent API · Gemini፦ የAPI ቁልፎች · Gemini፦ ወቅታዊ model IDዎችና ችሎታዎች · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

Extra implementation exercise

አሳሹ GEMINI_API_KEY መምረጥ ወይም አስተማሪውን ለመቀየር system መልዕክት መላክ አለበት?

የተሠራ መፍትሔ ያሳዩ

ሁለቱም አይደሉም። ቁልፉንና ሚናውን በአገልጋይ ያዋቅሩ። የደንበኛ ሚናዎችንና መጠኖችን ያረጋግጡ፤ የmodel መልሶች አሁንም ለትክክለኛነት ግምገማ ይፈልጋሉ።

  • የአቅራቢ ሚስጥሮችን በአገልጋይ ያቆያል።
  • የደንበኛ መልዕክቶችን የማይታመኑ የውይይት ግቤቶች አድርጎ ይወስዳል።

ደረጃ 3

ውይይቱን ያስቀጥሉ፣ አለመሳካትንም ይሞክሩ

ጥያቄው ሲከሽፍ የተጻፈው መልእክት እንዳይጠፋ ያድርጉ።

በቀድሞው ውይይት ላይ የሚመሠረተውን የክትትል ጥያቄ ይላኩ፣ መልሱንም ከቀደመው ውይይት ጋር ያወዳድሩ። ረዳትዎ ለልምምድ ብቻ በተዘጋጀው ፕሮጀክት አንድ ያልተሳካ ጥያቄ እንዲያስመስል ወይም እንደገና እንዲፈጥር ይጠይቁ።

የክትትሉ መልስ ከውይይትዎ ጋር የተያያዘ መሆን አለበት፤ ያልተሳካ ላክም ረቂቁንና የቀድሞ መልእክቶችን እንደገና ለመሞከር ማቆየት አለበት።

ተጨባጭ ምሳሌ

በሁለተኛው መልእክት የተፈጠረ ስህተት አሁን የጻፉትን ጥያቄ ማጥፋት የለበትም።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

ቀጣይነትንና አለመሳካትን ይፈትሹ

ሁለተኛውን ዙር የማጠናቀቂያ ፍተሻዎ ክፍል ያድርጉት።

የDNS ምሳሌውን ይጠይቁ፣ ከዚያም እሱን የሚጠቅስ ተከታይ ጥያቄ ያቅርቡ። በአሳሽ መሣሪያዎች የጥያቄውን body ይመርምሩ፣ መልሱንም ከእውነተኛው የመጨረሻ ጥያቄ ጋር ያወዳድሩ። ረጅም በደንብ የተጻፈ ምላሽ የተዛማጅነት ማስረጃ አይደለም።

ለቀጣዩ ማስገባት የተሳሳተ የመዳረሻ ኮድ ይሞክሩ። ረቂቁ በtextarea ይቀጥላል፣ ያልተሳካ ልውውጥም ወደ የተቀበለው ታሪክ አይጨመርም። መዳረሻውን ካስተካከሉ በኋላ ይድገሙ። Enter ይልካል፤ Shift+Enter አዲስ መስመር ይፈጥራል። በመጠበቅ ጊዜ አዝራሩ ይሰናከላል።

የተሠራ ምሳሌ

የጊዜ ገደብ መድረስ ወይም ያልተሟላ የአቅራቢ ምላሽ የሚታይ አለመሳካት ያመጣል። አሳሹ ባዶ የassistant መልዕክት ጨምሮ ውይይቱ ቀጥሏል አይልም።

Extra implementation exercise

የመጀመሪያው መልስዎ ጥሩ ነው፣ ሁለተኛው ጥያቄ ግን አልተሳካም። የተጻፈው መልዕክትና ታሪኩ ምን መሆን አለባቸው?

የተሠራ መፍትሔ ያሳዩ

ረቂቁንና የቀድሞ የተቀበሉ ዙሮችን ያቆዩ። አለመሳካቱን በእውነት ያሳዩ፣ የመላኪያ መቆጣጠሪያዎችን ይመልሱ፣ ትክክለኛ መልስ ከደረሰ በኋላ ብቻ አዲሱን ጥንድ ያክሉ።

  • ረቂቁን ለድጋሚ ሙከራ ይጠብቃል።
  • ሙከራው ከከሸፈ በኋላ፣ assistant በእውነት ያልሰጠውን የሐሰት ምላሽ ፈጥሮ አይመዘግብም።

ደረጃ 4

የውይይቱን ባህሪ ያስረክቡ

አንድ ማራኪ መልስ ብቻ ሳይሆን ብዙ መልእክቶችን ይጠቀሙ።

በፈጠራ ርዕስዎ ሦስት ጥያቄና መልስ ያሉትን ሙከራ ያጠናቅቁ፣ ሚስጥራዊ መረጃ የተወገደበትንም የውይይት መዝገብ ይያዙ። ከማንኛውም ጥገና በኋላ ከያልተሳካ ላክ ማገገሙን እንደገና ይፈትሹ።

እንደገና መላክ ረቂቅ እንዳያጠፋ ወይም የተሳካ ልውውጥ እንዳይደግም ያረጋግጡ። ያልተቻሉ ሙከራዎችን አልተካሄዱም ብለው ይመዝግቡ። ይህ ምሳሌ የታመኑ የድረ ገጽ ማስታወሻዎችን አያመጣም፣ የመልስ ትክክለኛነትንም አያረጋግጥም፤ የሚቀጥለው content-chatbot ትምህርት የተሰጡ ምንጮችን የመጠቀምና የማረጋገጥ ልምምድ ይጨምራል።

ተጨባጭ ምሳሌ

ማስረጃዎ ጎብኚው ምን እንደጠየቀ፣ ምን እንደተመለሰና ያልተሳካው ጥያቄ እንዴት እንደተመለሰ ማሳየት አለበት።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

ተግባርዎ፦ ለመቀጠል የሚጠቅም አስተማሪ ይሥሩ

የተሳኩ ጥያቄዎችን ብቻ ከመቁጠር ይልቅ ተዛማጅነትን ይገምግሙ።

የአገልጋዩን መመሪያ አጭር መልስ ወደሚሰጥ HTML/CSS አስተማሪ ይቀይሩ። ሦስት ልውውጦች ያካሂዱ፦ ስለተበላሸ anchor ይጠይቁ፣ የተሳሳተ href/id ጥንድ ያቅርቡ፣ ለምን እንደማይሠራም ይጠይቁ። የግል ምንጭ ሳይሆን ሰው ሠራሽ ኮድ ይጠቀሙ።

ሚስጥራዊ መረጃው የተወገደ የውይይት መዝገብ ያቆዩ፣ መልሱ እያንዳንዱን የመጨረሻ መልዕክት ይመልስ እንደሆነም ማስታወሻ ያክሉ። አንድ ያልተሳካ ማስገባት ይድገሙ፣ ዳግም ሙከራም ውይይቱን ወጥ እንደሚያቆይ ያሳዩ። ከይፋ መዳረሻ በፊት እውነተኛ ማንነት ማረጋገጥ፣ ዘላቂ የእያንዳንዱ ተጠቃሚ ኮታና መልዕክቶች ወዴት እንደሚላኩ ማብራሪያ ያቅዱ።

የተሠራ ምሳሌ

ጠቃሚ አስተማሪ የትኞቹ href/id እንደማይስማሙ ይናገራል። አጠቃላይ የተለዋዋጭ ስያሜ ምክር በቴክኒክ ትክክል ቢሆንም፣ የተማሪውን የተወሰነ መልስ ያመልጠዋል።

ሙሉው የማጣቀሻ መመሪያ በreference/assignment-walkthrough.txt ይገኛል። ደረጃዎቹን ከራስዎ ውጤት ጋር ያወዳድሩ፤ የፍተሻ መዝገቡን በራስዎ ፕሮጀክት ያዩትን ተጠቅመው ይሙሉ።

Extra implementation exercise

የሦስት ልውውጥ መዝገብና አንድ የአለመሳካት/ዳግም ሙከራ ምልከታ ያቅርቡ።

የተሠራ መፍትሔ ያሳዩ

በአገልጋይ function ውስጥ ያለውን የመመሪያ ጽሑፍ አጭር መልስ ወደሚሰጥ HTML/CSS አስተማሪ ያርትዑ። የfrontend ተለዋዋጭ አይቀይሩ ወይም generateን ወደ ይፋዊ አቃፊ አያዛውሩ። የማጣቀሻው function ከተቀየረው መመሪያ ጋር የተሟላ ቅጂ ነው።

የግምገማ ምሳሌ፦ ተጠቃሚው <a href='#work'> ለምን <section id='projects'> እንደማይደርስ ይጠይቃል። ተዛማጅ መልስ ያንን የhref/id አለመዛመድ ይጠቅሳል። ቀጣዩ ተጠቃሚ href='#projects' ያቀርባል፤ ተዛማጅ ተከታይ መልስ ያንን የተወሰነ እርማት ይፈትሻል። አጠቃላይ የተለዋዋጭ ስያሜ ምክር የHTTP ሁኔታ 200 ቢሆንም ይህን ፍተሻ አያልፍም።

በቀጣይ ዙር የተሳሳተ የልምምድ ኮድ ይዘው ያስገቡ። የተቀበለው ውይይት ሳይበላሽ መቀጠል አለበት፣ textareaም ያልተላከውን ረቂቅ መያዝ አለበት። መዳረሻን ያስተካክሉና ይድገሙ፤ ትክክለኛ ምላሽ ከመጣ በኋላ ብቻ አዲስ user/assistant ጥንድ ያክሉ። ይህ የምሳሌ ውይይት የግምገማ መመሪያ ነው፣ በቀጥታ የተፈጠረ ውጤት አለ የሚል መግለጫ አይደለም።

  • ተከታይ መልሶች እውነተኛዎቹን የቀድሞ መልዕክቶች ይመልሳሉ።
  • አለመሳካት ረቂቅን/ታሪክን ይጠብቃል፣ የአቅራቢውም ቁልፍ የግል ይቀጥላል።

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

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

መማርዎን ይቀጥሉ

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