በChatGPT መተግበሪያዎች SDK እቃዎች ስንልክ የተማርናቸው ነገሮች

• በቅርቡ በChatGPT ውስጥ የሥራ ፍሰት ከፈለጉ ወይም በራስዎ የወኪል ስብስብ ላይ ኢንቨስት ከማድረግዎ በፊት መሣሪያዎችዎን እዚያ መሞከር ከፈለጉ፣ የመተግበሪያዎች SDK ተግባራዊ አማራጭ ነው። ወኪሉ የሚያደርገውን እያንዳንዱን ደረጃ መቆጣጠር ከፈለጉ ግን ብዙውን ጊዜ ተስማሚ አይደለም።

• ChatGPT ዋናው መገናኛ እንዲሆንና ሙሉ የውይይት ምርት ሳይገነቡ መሣሪያዎችን ከጥቂት የUI ክፍሎች ጋር መጠቀም ሲፈልጉ የመተግበሪያዎች SDKን ይምረጡ። በፍሰት፣ በማህደረ ትውስታ፣ በጥያቄዎችና በመጻፍ ላይ ጥብቅ ቁጥጥር ሲፈልጉ የራስዎን የወኪል ስብስብ ይምረጡ።

• የመተግበሪያዎች SDK ውይይትን ከጥቂት አጭር የUI ደረጃዎች ጋር ለሚያጣምሩ ምርቶች ተስማሚ ነው። በፍጥነት ይልካሉ፤ አንዳንድ ቁጥጥርን ግን ይተዋሉ።

• ለእኛ የሠራው ግልጽ መሣሪያዎች፣ ግልጽ የዊጅት ባህሪና ግልጽ ቀጣይ ደረጃዎች ነበሩ። ፍሰቱን ለመወሰን በእነዚህ ላይ እንጂ በLLM ላይ አልተመካንም። ሞዴሉ ከሁሉ የበለጠ ጠቃሚ የነበረው ስርዓቱ አስቀድሞ የመረጣቸውን ውጤቶች ሲያብራራ ነበር።

• ከዚህ በታች፦ እንዴት እንደሚመረጥ፣ ከዚያም የሠራውና ያልሠራው።

አብዛኞቹ ቡድኖች አሁንም የAI ሙከራዎችን ያካሂዳሉ ወይም AIን አነስተኛ ስጋትና ጥቅም ላላቸው የጎንዮሽ አጠቃቀሞች ያሰማራሉ። ተጠቃሚዎች በየሳምንቱ የሚጠቀሙበትን ለንግድ ወሳኝ የሆነ ምርት የሚያቀርቡት ጥቂቶች ናቸው። ግብዎ ሙሉ ረዳቱን በራስዎ መገንባት ሳይሆን በChatGPT ውስጥ መግባት ከሆነ፣ የChatGPT መተግበሪያዎች SDK ይህን ክፍተት ለመድፈን አንዱ መንገድ ነው።

የተማርናቸው ትምህርቶች፣ መስፈርቶቹ ChatGPTን ዋና መገናኛ እንዲሆንና ደንበኛው ሙሉ ለሙሉ ብጁ የውይይት ምርት እንዳይደግፍ ፈጣን መንገድ እንዲኖር ከጠቆሙበት የደንበኛ ፕሮጀክት የተገኙ ናቸው።

ደንበኛው የሚከተሉትን ስለፈለገ የመተግበሪያዎች SDK ከአጭር መግለጫው ጋር ተስማምቷል፦

• የሚገነባና የሚስተናገድ የተለየ የውይይት ምርት አለመኖር—የፈለጉት በChatGPT ውስጥ ተደራሽነትን እንጂ ሌላ ገለልተኛ የተለየ መተግበሪያ አልነበረም።

• ውይይት ከአነስተኛና ለተግባር የተዘጋጀ UI ጋር—በሥራ ፍሰቱ ውስጥ ሁለተኛ ሙሉ ምርት ሳይሆን ጥቂት ያተኮሩ የዊጅት ደረጃዎች።

• በMCP መሣሪያዎች በኩል የሚቀርብ የጀርባ ስርዓት ባህሪ—ከጫፍ እስከ ጫፍ በባለቤትነት የሚተዳደር ብጁ የወኪል ማስኬጃ ሳይሆን መደበኛ የመሣሪያ ጥሪ።

• በChatGPT ውስጥ መገኘት—ተጠቃሚዎች የሥራ ፍሰቱን ቀድሞውኑ በሚሠሩበት ቦታ ማግኘት አለባቸው።

እየገነባን ሳለን እነዚህን ምርጫዎች ከደንበኛው ጋር አረጋግጠናል። ይህ የሚከፈለው ዋጋ አሁንም አለ፦ ChatGPT ክፍለ ጊዜውን ሲያስተናግድ የውጭው ማስኬጃ የእርስዎ አይደለም። ይመሩታል፤ ሙሉ በሙሉ ግን አይቆጣጠሩትም።

የመተግበሪያዎች SDK መተግበሪያ ሦስት ነገሮችን ያገናኛል፦

1. የChatGPT ወኪል ማስኬጃ

2. የእርስዎ MCP መሣሪያዎች

3. የእርስዎ የዊጅት UI

በተግባር ያለው ፍሰት፦

1. ተጠቃሚው ChatGPTን አንድ ነገር ይጠይቃል።

2. ChatGPT ከMCP መሣሪያዎችዎ አንዱን ሊጠራ ይችላል።

3. አገልጋይዎ የተዋቀረ የመሣሪያ ውጤት ይመልሳል።

4. ChatGPT ውጤቱን አንብቦ ቀጣዩን ደረጃ ይወስናል፦ ተጨማሪ የመሣሪያ ጥሪዎች፣ ለተጠቃሚው ምላሽ ወይም ሁለቱንም። ከዚያ መሣሪያ ጋር ዊጅት ካያያዙ፣ በዚህ ዙር ሊታይ ይችላል።

5. ተጠቃሚው በውይይቱ ወይም በዊጅቱ ይቀጥላል፤ ተከታይ ጽሑፍ፣ ምርጫ ወይም በዊጅቱ የተነሳ የመሣሪያ ጥሪ ሊሆን ይችላል። ይህ የውይይቱን ሰንሰለት ያዘምናል፤ ChatGPT ሌላ ዙር ያካሂዳል፣ ተግባሩም እስኪጠናቀቅ ደረጃ 2–4 ይደገማሉ።

ዋናው ነገር ይህ የውይይት፣ የጀርባ ስርዓት እርምጃዎችና የአጭር UI ደረጃዎች ድብልቅ ነው። ይህ ደግሞ በቀላሉ ሊበላሹ የሚችሉት ክፍሎች በውይይት፣ በመሣሪያዎችና በUI መካከል ያሉ ርክክቦች መሆናቸውን ያሳያል።

የውይይት UIን፣ የመሣሪያ ግንኙነትን፣ የማረጋገጫ ንድፎችን ወይም የዊጅት ባዶ ፍሬም ከመጀመሪያው አይገነቡም። ለብዙ ምርቶች ይህ የግንባታ ጊዜን በእጅጉ ስለሚቀንስ፣ በዘርፉ አመክንዮና በደኅንነት ገደቦች ላይ ማተኮር ይችላሉ።

በChatGPT ውስጥ መገንባት የራስዎን ወኪል ከማስኬድ ጋር አንድ አይደለም። በፕሮጀክቱ ላይ አስቸጋሪው ክፍል የእርምጃ ዘዴዎች አልነበሩም። ሞዴሉና UIው ተጣጥመው እንዲቆዩ፣ መሣሪያዎችን፣ ዊጅቶችንና ቀጣይ ደረጃዎችን በቂ ግልጽ ማድረግ ነበር።

የመተግበሪያዎች SDK ከተለመደው የፊት ገጽዎ የተለየ የምርት ቅርጽ ይሰጣል፤ ለየትኞቹ ሁኔታዎች ተስማሚ እንደሆነ ማወቅ ግን አስፈላጊ ነው።

የሚከተሉትን ሲፈልጉ የመተግበሪያዎች SDKን ይጠቀሙ

• የChatGPT የሥራ ፍሰትን በፍጥነት ማቅረብ።

• ChatGPT ውይይቱን እንዲያስተናግድ ማድረግ።

• ተፈጥሯዊ ቋንቋን ከጥቂት ያተኮሩ የUI ደረጃዎች ጋር ማጣመር።

• የራስዎን የውይይት በይነገጽ፣ የወኪል መያዣና የመገኘት ስርዓት ከመገንባት መቆጠብ።

ተጠቃሚዎችዎ ቀድሞውኑ ChatGPTን አዘውትረው የሚጠቀሙ ከሆነ፣ ያ የመጨረሻው ነጥብ አስፈላጊ ነው።

የሚከተሉት ሲያስፈልጉዎት የራስዎን ወኪል ይገንቡ

• በኮድ ማስፈጸም የሚችሉት ቋሚ የደረጃ በደረጃ ፍሰት።

• ከጫፍ እስከ ጫፍ የሚቆጣጠሩት ብጁ UIና የማረጋገጫ ሂደት።

• የራስዎ የማህደረ ትውስታና የሁኔታ ሞዴል።

• በእያንዳንዱ ማስኬድ ሊተነበይ የሚገባው ባህሪ።

• ለወኪሉ የክትትል መዝገቦች፣ ሎጎችና መለኪያዎች።

እቅድ አውጪው፣ የስርዓት እርምጃዎችና ሙሉው የሥራ ፍሰት የምርትዎ ዋና ክፍል ከሆኑ፣ ብጁ ስብስብ ብዙውን ጊዜ የተሻለ ነው።

በፕሮጀክታችን ወቅት ደጋግሞ የተነሳው ቃል «ቁጥጥር» ነበር፦ በአንድ በኩል ፍጥነትና የተለመደ አስተናጋጅ፤ በሌላ በኩል ደግሞ የማስኬጃው ከፊል ባለቤትነት። ደንበኛው የሙሉውን ስብስብ ባለቤትነት ከመያዝ ይልቅ ተጠቃሚዎችን በChatGPT ውስጥ ለማግኘት ቅድሚያ ሲሰጥ ይህንን ዋጋ ተቀብሏል።

ትክክለኛው ፍሰት ቀላል ይመስላል፦ ተጠቃሚው ይጠይቃል፣ መሣሪያው ይሠራል፣ ውሂቡ ይመለሳል፣ ምርጫ ሲያስፈልግም ዊጅቱ ይታያል።

በተግባር ግን ችግሩ ርክክቦቹ ነበሩ። ዊጅት ጌጥ አይደለም። አንዴ በማያ ገጹ ላይ ከታየ፣ ሞዴሉ የሚያየውንና ቀጥሎ የሚያደርገውን ይለውጣል። የዊጅት እርምጃዎችን እንደ ግልጽ ስም ያላቸው ክስተቶች ይመልከቱ፤ እንደ ልቅ ውይይት አይደለም።

በፕሮጀክቱ ላይ የተጠቀምነው ስብስብ ቀላል ነበር፦ FastMCP፣ Pydantic፣ React፣ TypeScript። እነዚህን ማዋሃድ ችግር አልነበረውም። ዋናው ሥራ ሞዴሉ፣ መሣሪያዎቹና UIው ቀጥሎ በሚሆነው ነገር ላይ እንዲስማሙ ማድረግ ነበር።

እያንዳንዱን ርክክብ ግልጽ ያድርጉ

የመሣሪያ ውጤቶችን እንደ ጥሬ የጀርባ ስርዓት ውሂብ መመልከታችንን አቆምን። እያንዳንዱ መልስ ርክክብ ሆነ።

ጥሩ የመሣሪያ ውጤት፦

• ዊጅቱ ለማሳየት የሚያስፈልገውን ይሰጠዋል።

• ChatGPT ምላሹን የሚመሠርትባቸውን የተዋቀሩ እውነታዎች ይሰጠዋል።

• ፍሰቱ ሲፈልገው፣ ሞዴሉ መገመት እንዳይኖርበት ቀጥሎ ምን መሆን እንዳለበት ይገልጻል።

የዊጅት እርምጃዎች ግልጽ ያልሆነ ጽሑፍ ወደ ውይይቱ መላክ የለባቸውም። ተጠቃሚው ምን እንዳደረገና ቀጥሎ ምን መሆን እንዳለበት መግለጽ አለባቸው።

ርክክቦቹ ግልጽ ከሆኑ በኋላ አስተማማኝነቱ ጨመረ።

አጭርና ግልጽ መመሪያዎች በመሣሪያው ውጤትና በዊጅት እርምጃዎች ውስጥ ሲካተቱ ሞዴሉ ይከተላቸዋል።

ከዚህ በታች የተጠቀምንበት አነስተኛ የPydantic መዋቅር አለ። የውጤት መስኩ ዊጅት ሲያሳዩ ዊጅቱ የሚፈልገውን የተዋቀረ ውሂብና ChatGPT በክፍለ ጊዜው የሚጠቀምባቸውን እውነታዎች ይይዛል። agent_directions መስኩ ረዳቱ ቀጥሎ ምን ማድረግ እንዳለበት የሚገልጽ አጭር መስመር ይይዛል። Reason አማራጭ ነው።

1from typing import Generic, TypeVar2
3from pydantic import BaseModel4
5T = TypeVar("T")6
7class AgentDirections(BaseModel):8 assistant_instruction: str9 reason: str | None = None10
11class ToolResults(BaseModel, Generic[T]):12 agent_directions: AgentDirections13 output: T

ዊጅቶችን አነስተኛ ያድርጉ

የሠሩት ዊጅቶች አንድ ውሳኔ እንዲደረግ አድርገው ቁጥጥሩን ይመልሱ ነበር። ዊጅቱን ወደ አነስተኛ መተግበሪያ ከመለወጥ ይልቅ አጭር ዝርዝሮች፣ ማረጋገጫዎች ወይም የታመቀ የግምገማ ማያ ገጽ የተሻለ ሠሩ። ፍሰቱ የበለጠ ቋሚ እንዲሆን ስንፈልግ፣ እንደ ቀላል ማረጋገጫ ወይም ቋሚ ቀጣይ ደረጃ ያለ ጥቂት አመክንዮ በዊጅቱ ውስጥ ማካተት አሁንም ጠቃሚ ነበር።

በዊጅት መልዕክቶች ውስጥ ሦስተኛ መደብ

የዊጅት ተከታይ መልዕክቶችን ከተጠቃሚው የመጡ ውይይቶች አድርገን መጻፋችንን አቆምን (“I selected…,” “I confirmed…”)። ተጠቃሚው ስላደረገው ነገር እንደ አጭር ሪፖርት ጻፍናቸው (“The user selected…,” “The user confirmed…”)። ይህን አቀራረብ የሞከርነው ChatGPT የዊጅት መልዕክቶችን እንደ ተጠቃሚ መልዕክቶች ሳይሆን እንደ መሣሪያ መልዕክቶች ያክል ስለነበር ነው።

ቀጣዩ ደረጃ ግልጽ ሲሆን ቀጥተኛ እርምጃዎች

አንድ አዝራር ቀጣዩን የመሣሪያ ጥሪ በግልጽ የሚያመለክት ከሆነ፣ ሌላ የውይይት ዙር ከማስገደድ ይልቅ ዊጅቱ ጥሪውን በቀጥታ እንዲያስነሳ ማድረግ የተሻለ ሠራ። ይህ የሚሠራው ቀጣዩ የመሣሪያ ጥሪ ከChatGPT ግብዓት የማይፈልግ ከሆነ ብቻ ነው።

ይህ ቋሚ ፍሰቶችን ለማስፈጸም ረድቷል፤ ሌላ የውይይት ዙር በማስቀረትም መዘግየትን ቀንሷል።

ስህተትን መቆጣጠር

የመሣሪያ ጥሪ ሳይሳካ ሲቀር፣ ትክክለኛዎቹን የMCP ስህተት ኮዶችና ከመሣሪያው የመጡ አጭርና ግልጽ መልዕክቶችን እንመልስ ነበር። ከዚያ ChatGPT ያልተሳኩ ጥሪዎችን በተመለከተ የሚያነበው ትክክለኛ መረጃ ስለነበረው፣ ችግሩን ለተጠቃሚው ማስረዳት እና/ወይም ምክንያታዊ ቀጣይ ደረጃ መምረጥ ቻለ።

የመሣሪያ ዐውድ አስተዳደር

የክፍለ ጊዜውን ሁኔታ በአገልጋያችን ላይ አቆየን። ChatGPT ከመሣሪያ ጥሪዎች ጋር ለክፍለ ጊዜው የተወሰነ ዐውድ ይልካል፤ በFastMCP ውስጥ ተቆጣጣሪው ሁኔታውን ማንበብና ማዘመን እንዲችል ለእያንዳንዱ መሣሪያ አውድ መለኪያ ሰጠነው።

• ChatGPT በእያንዳንዱ ጥሪ እንደ መሣሪያ ነጋሪ እሴቶች እንደገና እንዲያስተላልፋቸው ከመጠየቅ ይልቅ፣ ቋሚ መታወቂያዎችና ቀደምት ውጤቶች በክፍለ ጊዜው ውስጥ ይቀመጡ ነበር።

• የመሣሪያ ጥሪ ዑደቶች ሲፈጠሩ፣ የተደጋገሙ ጥሪዎችን ለይተን በመሣሪያው ውጤት በኩል ግልጽ ስህተት መመለስ ችለናል።

• ለማረምና ለድጋፍ የክፍለ ጊዜ ሎጎች በእኛ በኩል ይቀመጡ ነበር።

መጀመሪያ ላይ ዊጅት አሳይተን፣ ሞዴሉ «እንደተረዳው» ገምተን ትክክለኛውን ተከታይ የመሣሪያ ጥሪ እንጠብቅ ነበር። አንዳንድ ጊዜ ይሳካ ነበር። ብዙ ጊዜ ግን አይሳካም ነበር።

ግልጽ ርክክብ ከሌለ፣ እኛ እርምጃ ስንፈልግ ChatGPT ሊያጠቃልል፣ ተጠቃሚው ምርጫውን እንዲደግም ሊጠይቅ ወይም መቆም ሲገባው ማቀዱን ሊቀጥል ይችላል።

መፍትሔው ሞዴሉ እንዲገነዘበው ተስፋ ማድረግ ሳይሆን፣ ቀጣዩን ደረጃ በተዋቀሩ ውጤቶችና በዊጅት ውሂቦች ውስጥ በግልጽ መግለጽ ነበር።

በመተግበሪያዎች SDK ሰነድ መሠረት ምላሾችን በመሣሪያ ውጤት፣ በተደበቀ ዲበ ውሂብና በውይይት ጽሑፍ መካከል በዘዴ ለመከፋፈል ሞከርን። ነገር ግን በዊጅቶቹ ውስጥ የተደበቀውን ዲበ ውሂብ ማንበብ አልቻልንም። ስለዚህ ይህን መጠቀም አልቻልንም።

የመተግበሪያዎች SDK ሰነዶች፣ ወኪሉ እንዳይመርጣቸው ከመሣሪያ ዝርዝሩ ሊደበቁ የሚችሉ ነገር ግን ከዊጅቱ ሊጠሩ የሚችሉ መሣሪያዎችን ይገልጻሉ። ታይነቱን መተግበሪያ-ብቻ ስናደርግ፣ እነዚያ መሣሪያዎች ከወኪሉ ብቻ ሳይሆን ከዊጅቱም መገኘት አቆሙ። ወኪሉ መሣሪያውን ማየት ሳይችል ዊጅቱ ግን ማየት የሚችልበት ውቅረት ማግኘት አልቻልንም።

ምንም ጠቃሚ ነገር ሳይከሰት ዝምታ ወይም አጠቃላይ «ተሳክቷል» የሚል መልዕክት ከቀጥተኛ ስህተት የከፋ ነበር። ስለዚህ የመሣሪያና የዊጅት ውድቀቶችን እንደ ዋና ውጤቶች ያዝናቸው፦ አንድ ደረጃ መቀጠል ካልቻለ፣ በግልጽ ቋንቋ ገልጸን ግልጽ ስህተት እንመልስ ነበር፤ ተጠቃሚዎች የታየ ነገር ግን ወደፊት የማያራምዳቸውን ዊጅት እያዩ እንዲቀሩ አላደረግንም። ይህ አጠቃቀሙን አሻሽሎ የሞዴሉን ባህሪ የበለጠ አስተማማኝ አደረገው።

ግብዎ በChatGPT ውስጥ ያነሰ ብጁ የመድረክ ሥራ የሚፈልግ የሥራ ፍሰት ከሆነ፣ የመተግበሪያዎች SDK ይህን ለማሳካት ተግባራዊ መንገድ ነው። ፍጥነትን ለማግኘትና ተጠቃሚዎችን ቀድሞውኑ በሚሠሩበት ቦታ ለማግኘት አንዳንድ ቁጥጥርን ይተዋሉ።

የፍሰቱን እያንዳንዱን ቅርንጫፍ፣ UIውንና እያንዳንዱን ደረጃ ማን እንደሚወስን መቆጣጠር ከፈለጉ፣ ከመጀመሪያው የራስዎን የወኪል ስብስብ ያቅዱ። በChatGPT ውስጥ ብቻ መገንባት በመጨረሻ በቂ ላይሆንዎት ይችላል።

የውይይት፣ የማረጋገጫና የወኪል ግንኙነቶችን በራስዎ ከመገንባትዎ በፊት MCP አገልጋይዎን በChatGPT ውስጥ ለማስኬድ የመተገበሪያዎች SDKን መጠቀም፣ ከዚያም ምርቱ ሲፈልግ ወደ ራስዎ ስብስብ መዛወር ይችላሉ።

በተመሳሳይ ሁኔታ ላሉ ቡድኖች ቀጣዩ እርምጃ፦ ግልጽ ውጤት ያለውን አንድ የሥራ ፍሰት ይምረጡ፣ በውይይት፣ በመሣሪያዎችና በዊጅቶች መካከል ያሉትን ርክክቦች ይጻፉ፣ ከዚያም በእርምጃ ማስተካከያ ላይ ብዙ ጊዜ ከማሳለፍዎ በፊት ድጋሚ ሙከራዎችንና ስህተቶችን በጥብቅ ይፈትሹ።