አጠቃላይ እይታ

የስራ ቦታ አስተዳዳሪዎች የተሰኪ ገበያን ከGitHub ወደ የስራ ቦታቸው ማውጫ ማስመጣት ይችላሉ። ገበያ የሚመጡትን ተሰኪዎች የሚዘረዝር የJSON ካታሎግ ነው። ከማስመጣት በኋላ፣ ዕለታዊ ማመሳሰል በማከማቻው ላይ የሚደረጉ ለውጦችን በመተግበር ተሰኪዎቹ የተዘመኑ እንዲሆኑ ያደርጋል።


የገበያ ማመሳሰል የተሰኪ ይዘትን ያስመጣል፤ የስራ ቦታ አባላትን መለያዎች አያገናኝም፣ በተሰኪው ውስጥ ላሉ መተግበሪያዎችም የመዳረሻ ፈቃድ አይሰጥም።


ስለ ተሰኪዎችና በውስጣቸው ስላሉ መተግበሪያዎች መግቢያ ለማግኘት፣ ተሰኪዎች በChatGPT እና Codex ውስጥ የሚለውን ይመልከቱ።

ከመጀመርዎ በፊት

• የገበያውን ማከማቻና በማጣቀሻ የሚያካትተውን እያንዳንዱን ሌላ ማከማቻ ማንበብ የሚችል የGitHub መለያ ይጠቀሙ። በgithub.com ላይ ያሉ ይፋዊና የግል ማከማቻዎች ይደገፋሉ።

• የሚያስመጣው መለያ እነዚያን ማከማቻዎች መድረስ እንዲችል፣ የሚያስፈልገውን የGitHub ድርጅት ፈቃድ የማግኘት ሂደት ያጠናቅቁ።

• የማከማቻውን ይዘት ይገምግሙ። የማስመጣት ሂደቱ ለእያንዳንዱ የተለየ የማጽደቅ እርምጃ ሳያስፈልግ ሁሉንም ትክክለኛ ተሰኪዎች ያስመጣል፤ የወደፊት ማመሳሰሎችም አዳዲስ ተሰኪዎችን ሊጨምሩ ይችላሉ።

አዳዲስ ተሰኪዎች ሲጀምሩ የመጫን ቅንብራቸው ይገኛል ይሆናል፣ ማንነት ማረጋገጥም በመጫን ጊዜ ይከናወናል። በአዳዲስ ገበያዎች ላይ ራስ-ሰር ዕለታዊ ማመሳሰል ነቅቶ ይመጣል። ከማስመጣት በኋላ፣ የእያንዳንዱን ተሰኪ የስራ ቦታ ቅንብሮችና የሚያስፈልጉትን መተግበሪያዎች ይገምግሙ።

ገበያ ያስመጡ

1. ወደ የአስተዳዳሪ መቆጣጠሪያ ይሂዱ፣ የሚፈልጉትን የChatGPT የስራ ቦታ ይምረጡና ተሰኪዎችን ይክፈቱ። ከዚያ አክልን ይምረጡና ገበያ አስመጣን ይምረጡ።

2. በምንጭ ውስጥ የማከማቻውን URL ያስገቡ፤ ለምሳሌ https://github.com/example/team-plugins። የቅርንጫፍ ወይም የአቃፊ URL ሳያካትቱ፣ የማከማቻውን URL ብቻ ይጠቀሙ።

3. ገበያው በንዑስ ማውጫ ውስጥ ከሆነ፣ ያንን ማውጫ በመንገድ ውስጥ ያስገቡ። ለምሳሌ፣ ለteam-tools/.agents/plugins/marketplace.json፣ team-tools ያስገቡ። ለማከማቻው ስር ማውጫ፣ መንገድን ባዶ ይተዉት። የመገለጫ ፋይሉን ስም አያስገቡ።

4. ከፈለጉ ቅርንጫፍ፣ መለያ ወይም ኮሚት ያስገቡ። የማከማቻውን ነባሪ ቅርንጫፍ ለመጠቀም ባዶ ይተዉት። የወደፊት ኮሚቶችን ለመቀበል ቅርንጫፍ ይጠቀሙ። የተወሰነ ኮሚት ከመረጡ፣ በዚያው ስሪት ይቆያል።

5. ገበያ አስመጣን ይምረጡ፤ ሲጠየቁም የGitHub መዳረሻ ፈቃድ ይስጡ።

6. የማስመጣት ውጤቶችን ይገምግሙ፤ ከዚያም የእያንዳንዱን የመጫን ፖሊሲና የሚያስፈልጉ መተግበሪያዎች ለማዋቀር የመጣውን ተሰኪ ይክፈቱ።

በጣም ትላልቅ ገበያዎችን ለመጀመሪያ ጊዜ ማስመጣት እስከ 1 ሰዓት ሊወስድ ይችላል። ከዚያ በኋላ የሚደረጉ ዕለታዊ ማመሳሰሎች በአብዛኛው ጥቂት ደቂቃዎችን ይወስዳሉ።

ተሰኪን ማስመጣት ካልተቻለ፣ ሪፖርቱ ስህተቱን ያብራራል። ሌሎች ትክክለኛ ተሰኪዎች ግን አሁንም ሊመጡ ይችላሉ።

የሚደገፉ ቅርጸቶች

የተመረጠው ማውጫ የሚደገፍ መገለጫ ሊይዝ ይገባል፦

• ለCodex ገበያ፣ .agents/plugins/marketplace.json።

• ከClaude ጋር ለሚስማማ ገበያ፣ .claude-plugin/marketplace.json።

• የገበያ መገለጫ በማይኖርበት ጊዜ፣ ለብቻው ለሚሰራ የClaude ተሰኪ .claude-plugin/plugin.json።

የገበያ ግቤቶች በዚያው ማከማቻ ውስጥ ያሉ የተሰኪ አቃፊዎችን ወይም የሚደገፉ የGitHub ማከማቻ ምንጮችን በማጣቀሻ ሊያካትቱ ይችላሉ። ወደ የስራ ቦታ ማስመጣት ሌሎች የGit ማስተናገጃዎችንና እንደ npm ያሉ የጥቅል መዝገብ ምንጮችን አይደግፍም።

ስለሚደገፉ ቅርጸቶች፣ የJSON ምሳሌዎችና የምንጭ መስኮች፣ የተሰኪ አስተዳደር የሚለውን ይመልከቱ።

የስራ ቦታ መዳረሻን ያዋቅሩ

GitHub የተሰኪውን ይዘት ያቀርባል፤ የስራ ቦታ ቅንብሮች ደግሞ መጫንንና የማንነት ማረጋገጥን ይቆጣጠራሉ። ማስመጣትና ማመሳሰል እንደ AVAILABLE ወይም ON_USE ያሉ የማከማቻ ፖሊሲ እሴቶችን አይተገብሩም። በየስራ ቦታዎ ውስጥ ላለ እያንዳንዱ ተሰኪ እነዚህን ቅንብሮች ያዋቅሩ።


ለእያንዳንዱ ብቁ ሚና ይገኛል ወይም ተጭኗል የሚለውን ለመምረጥ የመጫን ፖሊሲን ይጠቀሙ። የሚያስፈልጉ መተግበሪያዎችም መንቃት አለባቸው፤ አባላት የተገናኘውን አገልግሎት የመጠቀም ፈቃድ ሊኖራቸውና የሚያስፈልገውን የማንነት ማረጋገጫ ማጠናቀቅ ይገባቸዋል።


የተሰኪ ዝማኔን ማመሳሰል ወይም ነባር ተሰኪን ወደ GitHub አስተዳደር ማዛወር የስራ ቦታ ፖሊሲዎቹን አይቀይርም። ተሰኪን ማስመጣት የመተግበሪያ መዳረሻ ፈቃድ አይሰጥም ወይም የአባላትን መለያዎች አያገናኝም።


ስለ የስራ ቦታ አሰሳ፣ የመተግበሪያ መዳረሻና የስራ ቦታ መቆጣጠሪያዎች፣ ለተሰኪዎችና መተግበሪያዎች የአስተዳዳሪ መቆጣጠሪያዎች፣ ደህንነትና ተገዢነት የሚለውን ይመልከቱ።

ተሰኪዎችን ወቅታዊ ያድርጉ

አዳዲስ ገበያዎች በየቀኑ ዝማኔዎች መኖራቸውን ያረጋግጣሉ። ራስ-ሰር ማመሳሰልን ሳይጠብቁ ዝማኔ ለመጠየቅ፦

1. ወደ የአስተዳዳሪ መቆጣጠሪያ ይሂዱ፣ የሚፈልጉትን የChatGPT የስራ ቦታ ይምረጡና ተሰኪዎችን ይክፈቱ።

2. ገበያዎችን ይክፈቱና ገበያውን ይምረጡ።

3. አሁን አመሳስልን ይምረጡ።

ማመሳሰል በገበያው ውስጥ አዳዲስ ግቤቶችን ሊጨምርና ነባር ተሰኪዎችን ሊያዘምን ይችላል። ራስ-ሰር ማመሳሰል ሌላ የማስመጣት እርምጃ ሳያስፈልግ አዳዲስ ተሰኪዎችን ሊያስመጣ ስለሚችል፣ የማከማቻ ለውጦችን ከማዋሃድዎ በፊት ይገምግሙ።

የማመሳሰል ውጤቶችን ይገምግሙ

ከማመሳሰል በኋላ፣ ሁኔታውንና የተቀመጠውን ሪፖርት ይገምግሙ። ተጠናቋል — N ስህተቶች ማለት ማመሳሰሉ አልቋል፣ ነገር ግን አንዳንድ ተሰኪዎችን ማስኬድ አልተቻለም ማለት ነው።


ለነባር ተሰኪ የመጣ ዝማኔ ልክ ካልሆነ፣ በትክክል ይሰራ የነበረው የመጨረሻ ስሪት እንዳለ ይቆያል። ሌሎች ትክክለኛ ዝማኔዎች ግን አሁንም ሊጠናቀቁ ይችላሉ። ሪፖርት የተደረገውን ችግር በGitHub ውስጥ ያስተካክሉ፤ ከዚያ እንደገና ለመሞከር አሁን አመሳስልን ይምረጡ።


በአስተዳዳሪ እይታዎ ውስጥ ለብቻው ለመጣ ተሰኪ አድስ የሚለው ከታየ፣ ተሰኪውን ለማደስ ይጠቀሙበት። የተሰኪ ዝርዝርን አድስ የሚታየውን ዝርዝር ብቻ እንደገና ይጭናል፤ ከGitHub ጋር አያመሳስልም።

የማስወገድና የመሰረዝ ልዩነትን ይረዱ

ግቤትን ከማከማቻው ማስወገድ ወደ የስራ ቦታ የመጣውን ቅጂ አይሰርዘውም። ተሰኪው ከእንግዲህ በምንጩ ውስጥ የለም ተብሎ ምልክት ይደረግበታል።


ገበያውን በChatGPT ውስጥ መሰረዝ ከእሱ የመጡትን ሁሉንም ተሰኪዎች ይሰርዛል። GitHubን እንደገና ለማገናኘት ወይም ባለቤትነትን ለመቀየር ገበያን አይሰርዙ።

የGitHub መዳረሻን እንደገና ያገናኙ ወይም ይቀይሩ

የገበያ ማመሳሰል ገበያውን ያስመጣውን አስተዳዳሪ የGitHub ግንኙነት ይጠቀማል። ያ መለያ የገበያውን ማከማቻና በማጣቀሻ የተካተቱ ማከማቻዎችን የመድረስ ፈቃድ እንዳለው መቀጠል አለበት።

የመጀመሪያውን መለያ እንደገና ያገናኙ

1. ለማስመጣት የተጠቀሙበት የGitHub መለያ አሁንም ሁሉንም አስፈላጊ ማከማቻዎች የመድረስ ፈቃድ እንዳለው ያረጋግጡ።

2. ገበያውን መጀመሪያ ያስመጣውን አስተዳዳሪ፣ በChatGPT ውስጥ የGitHub ተሰኪን ከፍቶ መለያውን እንደገና እንዲያገናኝ ይጠይቁት።

ወደ አዲስ አስተዳዳሪ ያስተላልፉ

አዲሱ የስራ ቦታ አስተዳዳሪ የራሱን የGitHub ግንኙነት በመጠቀም ያንኑ ገበያ ማስመጣት ይችላል፦

1. ወደ የአስተዳዳሪ መቆጣጠሪያ ይሂዱ፣ የሚፈልጉትን የChatGPT የስራ ቦታ ይምረጡና ተሰኪዎችን ይክፈቱ። ከዚያ አክል > ገበያ አስመጣን ይምረጡ።

2. ለነባሩ ገበያ የተጠቀሙባቸውን የምንጭ፣ የመንገድ እና የቅርንጫፍ፣ መለያ ወይም ኮሚት እሴቶች ሳይቀይሩ ያስገቡ።

3. ገበያ አስመጣን ይምረጡ፤ ሲጠየቁም የGitHub መዳረሻ ፈቃድ ይስጡ።

የወደፊት ማመሳሰሎች የአዲሱን አስተዳዳሪ የGitHub ግንኙነት ይጠቀማሉ። የአዲሱ አስተዳዳሪ መለያ የገበያውን ማከማቻና በማጣቀሻ የሚያካትተውን እያንዳንዱን ማከማቻ ማንበብ መቻል አለበት።

ያለን ተሰኪ በGitHub እንዲተዳደር ያድርጉ

እንደ ማህደር የተሰቀለ ወይም እስካሁን በGitHub ምንጭ የማይተዳደር ነባር የስራ ቦታ ተሰኪን ለማስተዳደር ገበያ መጠቀም ይችላሉ። ነባሩ ተሰኪ በዚያው የስራ ቦታ ውስጥ መሆንና ተመሳሳይ የተሰኪ ስም ሊኖረው ይገባል። በሌላ የGitHub ምንጭ የሚተዳደር ተሰኪ አስተዳደርን በዚህ መንገድ መረከብ አይቻልም።


ነባሩን ተሰኪ በገበያዎ ውስጥ ለመለየት፦

1. ወደ የአስተዳዳሪ መቆጣጠሪያ ይሂዱ፣ የሚፈልጉትን የChatGPT የስራ ቦታ ይምረጡና ተሰኪዎችን ይክፈቱ። ተሰኪውን ይክፈቱ።

2. በURLው ውስጥ ከ/admin/plugins/ በኋላ ያለውን የተሰኪ መለያ ይቅዱ።

3. በገበያው የplugins ድርድር ውስጥ በሚዛመደው ግቤት ላይ፣ ያንን መለያ ከname እና source ጎን እንደ pluginId ያክሉ። በተሰኪው plugin.json ፋይል ውስጥ አይጨምሩት።

ተሰኪው መለያውን፣ የማጋሪያ ቅንብሮቹንና የስራ ቦታ ፖሊሲዎቹን እንዳሉ ይይዛል። GitHub የወደፊት ዝማኔዎች ምንጭ ይሆናል፤ ስለዚህ በኋላ ማህደር በመስቀል ተሰኪውን መተካት አይቻልም።


ለማዛወር ምሳሌና መስፈርቶች፣ የተሰኪ አስተዳደር የሚለውን ይመልከቱ።

ያለን መተግበሪያ በማጣቀሻ ያካትቱ

ተሰኪ በስር ማውጫው ባለው .app.json ውስጥ ለነባር መተግበሪያ ማጣቀሻ ሊያስቀምጥ ይችላል። በፋይሉ ስም መጀመሪያ ያለውን ነጥብ ያካትቱ፤ ከተሰኪ መለያ ይልቅ የመተግበሪያውን መለያ ይጠቀሙ። ለቤተኛ ተሰኪ፣ በ.codex-plugin/plugin.json ውስጥ ያለውን የapps መስክ ወደ ./.app.json ያዘጋጁ።


ማጣቀሻው መተግበሪያ አይፈጥርም ወይም ተጨማሪ ፈቃዶችን አይሰጥም። የመተግበሪያው ነባር የስራ ቦታ መዳረሻ፣ የማንነት ማረጋገጫ፣ የእርምጃ መቆጣጠሪያዎችና የተገናኘው አገልግሎት ፈቃዶች እንደነበሩ ይቀጥላሉ።


ስለ JSON ቅርጸት፣ የተሰኪ አስተዳደር የሚለውን ይመልከቱ።

«ለዴስክቶፕ ብቻ» የሚለውን መለያ ይረዱ

ለዴስክቶፕ ብቻ ተብሎ ምልክት የተደረገበት ተሰኪ በድር ላይ ባለው ChatGPT ውስጥ መስራት አይችልም። የመጡ ተሰኪዎች የMCP አገልጋዮችን ሲገልጹ፣ ለምሳሌ በmcp.json ወይም .mcp.json ውስጥ፣ ይህን መለያ ሊያገኙ ይችላሉ፤ ይህም አገልጋዩ የርቀት HTTPS URL ሲጠቀም እንኳን ይሆናል።


የ.app.json ማጣቀሻ ማከል ብቻውን ለዴስክቶፕ ብቻ የሚለውን መለያ አያስወግድም። በማጣቀሻ የተካተተ ማንኛውም መተግበሪያ አሁንም ለአባሉ ሚና የተፈቀደ መሆን አለበት፤ መደበኛ የመዳረሻና የማንነት ማረጋገጫ መስፈርቶቹም ተፈጻሚ ይሆናሉ።