አጠቃላይ እይታ
የChatGPT የስራ ቦታ አስተዳዳሪ ሆነው የGitHub Enterprise መተግበሪያ ቴምፕሌትን ለድርጅትዎ እያዋቀሩ ከሆነ ይህን መመሪያ ይጠቀሙ። ቴምፕሌት አባላት የሚጠቀሙበት የመጨረሻ መተግበሪያ አይደለም። የሚፈለገውን የGitHub Enterprise ውቅር ካቀረቡ በኋላ ለየስራ ቦታው የሆነ ረቂቅ መተግበሪያ የሚፈጥር የማዋቀር ሂደት ነው።
ለGitHub Enterprise፣ ማዋቀር ChatGPTን ከድርጅትዎ GitHub Enterprise አስተናጋጅ ጋር ያገናኛል። GitHub App ይፈጥራሉ፣ የChatGPT callback URLን ይመዘግባሉ፣ ምስክርነቶችን ያመነጫሉ፣ ከዚያም እነዚያን እሴቶች ወደ ChatGPT ቴምፕሌት ማዋቀር ሂደት ይለጥፋሉ። ChatGPT ረቂቅ መተግበሪያውን ከፈጠረ በኋላ፣ እንደ ሌሎች የስራ ቦታ መተግበሪያዎች ማተም እና ማስተዳደር ይችላሉ።
እያዋቀሩት ያለው ነገር
በChatGPT ውስጥ ለየስራ ቦታው የሆነ GitHub Enterprise መተግበሪያ እየፈጠሩ ነው። መተግበሪያው የሚጠቀመው፦
በGitHub Enterprise አስተናጋጅዎ ላይ የተመዘገበ GitHub App።
ለተጠቃሚ OAuth ፈቃድ የGitHub App client ID እና client secret።
ChatGPT ለማከማቻ ስራዎች የመጫኛ tokenዎችን እንዲፈጥር የGitHub App የግል ቁልፍ።
GitHub Enterprise የመጫኛ እና የማከማቻ ክስተቶችን ወደ ChatGPT መልሶ እንዲልክ የwebhook ሚስጥር እና webhook URL።
የGitHub Enterprise አስተናጋጅ ስምዎ፣ ለምሳሌ
github.example.com።
በተናጠል የሚቆም GitHub OAuth App ሳይሆን GitHub App ይፍጠሩ። የChatGPT ቴምፕሌት ማዋቀር የGitHub App ምስክርነቶች፣ የግል ቁልፍ እና የwebhook ቅንብሮችን ይፈልጋል።
ከመጀመርዎ በፊት
የሚያስፈልግዎ፦
የChatGPT የስራ ቦታ አስተዳዳሪ ወይም ባለቤት መዳረሻ።
GitHub Appsን መፍጠር እና መጫን የሚችል የGitHub Enterprise አስተዳዳሪ ወይም የድርጅት ባለቤት መዳረሻ።
ያለ
https://ወይም መንገድ፣ የGitHub Enterprise አስተናጋጅ ስም ብቻ።ChatGPT የትኞቹን የማከማቻ እርምጃዎች መደገፍ እንዳለበት ውሳኔ፤ ለምሳሌ ንባብ-ብቻ የማከማቻ ፍለጋ፣ የጥያቄን ይጎትቱ workflows፣ የissue workflows፣ የፋይል አርትዖቶች፣ GitHub Actions ወይም ሰፊ የCodex workflows።
የGitHub App የግል ቁልፍን እና client secretን ለመያዝ ደህንነቱ የተጠበቀ ቦታ።
ChatGPT እና GitHub Enterpriseን በተለያዩ ትሮች ክፍት ያቆዩ። የcallback URLን አትፍጠሩ። በChatGPT የሚታየውን ትክክለኛ callback URL ይቅዱ።
ለማዘጋጀት ያሉ እሴቶች
የGitHub Enterprise አስተናጋጅ ስም፦ ለምሳሌ
github.example.com።Callback URL፦ ይህን ከChatGPT ቴምፕሌት ማዋቀር ሂደት ይቅዱ።
የGitHub App client ID።
የGitHub App client secret።
የGitHub App የግል ቁልፍ PEM።
በChatGPT የተፈጠረ webhook ሚስጥር።
በChatGPT ውስጥ ረቂቅ መተግበሪያው ከተፈጠረ በኋላ የሚፈጠር webhook URL።
በChatGPT ውስጥ የቴምፕሌት ማዋቀርን ይጀምሩ
በChatGPT ውስጥ፣ መተግበሪያው መገኘት ወዳለበት የስራ ቦታ ይቀይሩ።
የስራ ቦታ ቅንብሮች > መተግበሪያዎችን ይክፈቱ።
ማውጫን ይምረጡ።
GitHub Enterpriseን ይፈልጉ።
የGitHub Enterprise መተግበሪያ ቴምፕሌትን ይምረጡና ማዋቀርን ይጀምሩ።
ግልጽ የመተግበሪያ ስም እና መግለጫ ያስገቡ፤ ለምሳሌ GitHub Enterprise ወይም GitHub Enterprise - Engineering።
የGitHub Enterprise አስተናጋጅ ስም ያስገቡ፤ ለምሳሌ
github.example.com።በChatGPT የሚታየውን የcallback URL ይቅዱ። ይህን ትር ክፍት ያቆዩት።
በማዋቀር ጊዜ ከታየ፣ የተፈጠረውን የwebhook ሚስጥር ይቅዱ።
የcallback URL ምሳሌ፦ https://chatgpt.com/connector/oauth/<callback_id>
የcallback IDን አታስወግዱ፣ በመጨረሻ ስላሽ አትጨምሩ፣ ወይም በአጠቃላይ ChatGPT URL አትተኩት።
በGitHub Enterprise ውስጥ GitHub Appን ይፍጠሩ
የGitHub Enterprise አስተናጋጅዎን ይክፈቱ፤ ለምሳሌ
https://github.example.com።መተግበሪያውን ሊያዝ ወደሚገባው ድርጅት ወይም መለያ ይሂዱ።
Settings > Developer settings > GitHub Apps ይክፈቱ።
New GitHub Appን ይምረጡ።
ግልጽ የመተግበሪያ ስም ያስገቡ፤ ለምሳሌ ChatGPT GitHub Enterprise Connector።
የመነሻ ገጽ URL ያስገቡ። የተለየ የውስጥ ገጽ ከሌለ፣ የGitHub Enterprise ድርጅት URLን ይጠቀሙ።
በCallback URL ውስጥ፣ ከChatGPT የተቀዳውን ትክክለኛ callback URL ይለጥፉ።
የደህንነት ቡድንዎ ለመቀየር የተለየ ምክንያት ካልኖረው በስተቀር፣ Expire user authorization tokens እንደነቃ ያቆዩ።
ተጠቃሚዎች በመጫን ወይም በማገናኘት ሂደት መተግበሪያውን እንዲፈቅዱ በመጫን ጊዜ Request user authorization ያንቁ።
Where can this GitHub App be installed? በሚለው ስር፣ ለስርጭትዎ የሚስማማውን በጣም ጠባብ አማራጭ ይምረጡ።
GitHub Appን ይፍጠሩ።
ፈቃዶችን እና ክስተቶችን ያዋቅሩ
ለማንቃት ለሚያቅዷቸው የChatGPT እርምጃዎች የሚያስፈልጉትን ዝቅተኛ ፈቃዶች ይምረጡ።
ለንባብ-ብቻ የማከማቻ ግኝት እና ጥያቄ እና መልስ፣ እንደሚከተሉት ያሉ የንባብ ፈቃዶች ይጀምሩ፦
Metadata፦ ንባብ-ብቻ። GitHub ለGitHub Apps metadata ይፈልጋል።
Contents፦ ንባብ-ብቻ፣ ለፋይል እና ለማከማቻ ይዘት መዳረሻ።
Issues፦ ንባብ-ብቻ፣ የissue ፍለጋ ወይም የissue ንባብ ካስፈለገ።
Pull requests: ንባብ-ብቻ፣ የጥያቄን ይጎትቱ ፍለጋ ወይም የግምገማ አውድ ካስፈለገ።
Actions: ንባብ-ብቻ፣ የworkflow ሩጫ ሁኔታ፣ ስራዎች፣ ሎጎች ወይም አርቲፋክቶች ካስፈለጉ።
ለመጻፍ workflows፣ እንደ Contents፣ Pull requests፣ Issues፣ Actions ወይም Workflows ባሉ አስፈላጊ ቦታዎች ብቻ የመጻፍ ፈቃዶችን ያክሉ። የታሰቡትን የChatGPT እርምጃዎች የሚደግፉ በጣም ጠባብ ፈቃዶችን ይጠቀሙ።
የWebhook ክስተቶች ከሚደግፏቸው workflows ጋር መዛመድ አለባቸው። የተለመዱ ክስተቶች Installation፣ Installation repositories፣ Push፣ Pull request፣ Issues፣ Issue comment፣ Workflow run እና Workflow jobን ያካትታሉ።
የGitHub App ምስክርነቶችን ያመንጩ እና ይቅዱ
በGitHub App ቅንብሮች ውስጥ፣ Client IDን ይቅዱ።
Client secret ያመንጩ እና ወዲያውኑ ይቅዱት።
በPrivate keys ስር፣ የግል ቁልፍ ያመንጩ።
.pem ፋይሉን ያውርዱ እና በደህና ያስቀምጡት።
.pem ፋይሉን በአካባቢዎ ይክፈቱ እና የመጀመሪያ እና የመጨረሻ መስመሮችን ጨምሮ ሙሉውን PEM ጽሑፍ ይቅዱ።
የግል ቁልፉ ስሱ ነው። እንደ ምስክርነት ይያዙት። ከተጋለጠ፣ አዲስ የግል ቁልፍ ያመንጩ፣ የChatGPT መተግበሪያ ማዋቀርን ያዘምኑ፣ እና በGitHub Enterprise ውስጥ የተጎዳውን ቁልፍ ይሰርዙ።
በChatGPT ውስጥ ማዋቀርን ያጠናቅቁ
ወደ ChatGPT ቴምፕሌት ማዋቀር ትር ይመለሱ።
የGitHub App Client IDን ወደ OAuth client ID ይለጥፉ።
የGitHub App Client secretን ወደ OAuth client secret ይለጥፉ።
ድርጅትዎ በሆን ብሎ የቴምፕሌት ነባሪዎችን መቀየር ካልፈለገ በስተቀር፣ Scopesን ሳይቀይሩ ይተዉት።
የGitHub Enterprise አስተናጋጅ ስም አስተናጋጅ-ብቻ መሆኑን ያረጋግጡ፤ ለምሳሌ
github.example.com።የGitHub App የግል ቁልፍ PEMን ወደ GitHub App private key ይለጥፉ ወይም ይስቀሉ።
የተፈጠረው የwebhook ሚስጥር መኖሩን ያረጋግጡ።
ረቂቅ መተግበሪያውን ይፍጠሩ።
በChatGPT ውስጥ የተፈጠረውን የረቂቅ መተግበሪያ ዝርዝር ይክፈቱ እና የተፈጠረውን የwebhook URL ይቅዱ።
የwebhook URL እንዲህ መምሰል አለበት፦ https://connectors.api.openai.org/connectors/<connector_id>/webhook
በGitHub Enterprise ውስጥ የwebhook ማዋቀርን ያጠናቅቁ
በGitHub Enterprise ውስጥ ወደ GitHub App ቅንብሮች ይመለሱ።
የGitHub App አጠቃላይ ቅንብሮችን ይክፈቱ።
Active webhooks አስቀድመው ካልነቁ፣ ያንቁዋቸው።
የChatGPT webhook URLን ወደ Webhook URL ይለጥፉ።
የChatGPT webhook ሚስጥርን ወደ Webhook secret ይለጥፉ።
የSSL ማረጋገጫ እንደነቃ ያቆዩ።
የተመዘገቡባቸው የwebhook ክስተቶች ካነቃችኋቸው ፈቃዶች እና እርምጃዎች ጋር መዛመዳቸውን ያረጋግጡ።
ለውጦችን ያስቀምጡ።
በChatGPT ውስጥ መተግበሪያውን ያትሙ እና ያስተዳድሩ
ረቂቅ መተግበሪያውን መፍጠር ለአባላት በራስ-ሰር አያደርገውም። ረቂቁን ከገመገሙ በኋላ፦
ረቂቅ መተግበሪያውን ያትሙ።
መተግበሪያው በየስራ ቦታ ቅንብሮች > መተግበሪያዎች > ነቅቷል ውስጥ መታየቱን ያረጋግጡ።
ሊጠቀሙበት ለሚገባቸው ሚናዎች User accessን ያዋቅሩ።
ለንባብ እና ለመጻፍ እርምጃዎች Action controlን ይገምግሙ።
ChatGPT መተግበሪያውን ከመጠቀሙ በፊት አባላትን መቼ እንደሚጠይቅ ለመምረጥ App permissionsን ይገምግሙ።
የተፈቀደለትን የሙከራ ተጠቃሚ በChatGPT ውስጥ መተግበሪያዎችን እንዲከፍት እና መተግበሪያው መታየቱን እንዲያረጋግጥ ይጠይቁ።
እነዚህ የመተግበሪያ ፈቃዶች ለChatGPT ውይይቶች ይተገበራሉ። የስራ ቦታ ወኪሎች የትኞቹ የመተግበሪያ እርምጃዎች እንደሚገኙ እና የመጨረሻ ተጠቃሚዎች መቼ እንዲያጸድቁ እንደሚጠየቁ ለመወሰን በወኪሉ ገንቢ የተቀመጡ በወኪል-ደረጃ መቆጣጠሪያዎችን ይጠቀማሉ። ለወኪል ባህሪ፣ ይመልከቱ፦ ChatGPT Workspace Agents for Enterprise and Business።
GitHub Appን ይጫኑ እና ይፈትኑ
በGitHub Enterprise ውስጥ፣ GitHub appን በድርጅቱ ወይም በመለያው ላይ ይጫኑ።
በየስራ ቦታ ፖሊሲው መሰረት ሁሉንም ማከማቻዎች ወይም የተመረጡ ማከማቻዎችን ይምረጡ።
እንደ ተፈቀደለት ተጠቃሚ ከChatGPT የማገናኘት ሂደትን ይጀምሩ።
ሲጠየቁ GitHub appን ይፍቀዱ።
መጀመሪያ ትንሽ የንባብ እርምጃ ያሂዱ፤ ለምሳሌ ሊደረስባቸው የሚችሉ ማከማቻዎችን መዘርዘር ወይም የታወቀ ጥያቄን ይጎትቱ ማምጣት።
የመጻፍ እርምጃዎች ከነቁ፣ በሰፊ ስርጭት በፊት በዝቅተኛ-አደጋ ማከማቻ ይፈትኑ።
የአስተናጋጅ ስም እና OAuth ባህሪ
ChatGPT የGitHub Enterprise መጨረሻ ነጥቦችን ለማውጣት የአስተናጋጅ ስሙን ይጠቀማል። አስተናጋጁን ብቻ ያስገቡ፤ ለምሳሌ github.example.com ወይም octocorp.ghe.com።
ለዚህ መተግበሪያ ትክክለኛው የGitHub Enterprise አስተናጋጅ ካልሆነ በስተቀር፣ የAPI መንገድ፣ የማከማቻ መንገድ ወይም github.com አታስገቡ።
ችግር መፍታት
Redirect URI አለመዛመድ፦ የGitHub App callback URL በChatGPT ከሚታየው callback URL ጋር በትክክል መዛመዱን ያረጋግጡ።
ChatGPT ረቂቅ መተግበሪያውን መፍጠር ወይም ማስቀመጥ አይችልም፦ አስተናጋጅ ስም፣ OAuth client ID፣ OAuth client secret፣ የግል ቁልፍ እና webhook ሚስጥርን ጨምሮ ሁሉም የሚፈለጉ መስኮች መኖራቸውን ያረጋግጡ።
ማረጋገጫ ይሳካል ግን የማከማቻ ጥሪዎች ይከሽፋሉ፦ GitHub App መጫኑን እና ወደ ማከማቻው መዳረሻ እንዳለው ያረጋግጡ።
API 403 ወይም በቂ ያልሆኑ ፈቃዶችን ይመልሳል፦ የጎደለውን የGitHub App ፈቃድ ያክሉ እና ከተጠየቀ የመጫኛው ባለቤት የተዘመኑ ፈቃዶችን እንዲያጸድቅ ያድርጉ።
ምንም ማከማቻዎች አይታዩም፦ የመተግበሪያው መጫኛ የሚጠበቁትን ማከማቻዎች ማካተቱን እና በChatGPT ውስጥ ፈቃድ የሚሰጠው ተጠቃሚ መዳረሻ እንዳለው ያረጋግጡ።
የWebhook ማድረሻዎች ይከሽፋሉ፦ webhook URL እና webhook ሚስጥር ከChatGPT እሴቶች ጋር መዛመዳቸውን ያረጋግጡ፣ የSSL ማረጋገጫን እንደነቃ ያቆዩ፣ እና የGitHub Enterprise አስተናጋጅ
connectors.api.openai.orgሊደርስበት መቻሉን ያረጋግጡ።የግል ቁልፍ ስህተቶች፦ የመጀመሪያ እና የመጨረሻ መስመሮችን ጨምሮ ሙሉው የPEM ይዘት መቀዳቱን ያረጋግጡ።
