সংক্ষিপ্ত বিবরণ
আপনি যদি 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.
GitHub App private key, যাতে ChatGPT রিপোজিটরি অপারেশনের জন্য installation token তৈরি করতে পারে.
একটি ওয়েবহুক সিক্রেট ও ওয়েবহুক URL, যাতে GitHub Enterprise ইনস্টলেশন ও রিপোজিটরি ইভেন্ট ChatGPT-তে ফেরত পাঠাতে পারে.
আপনার GitHub Enterprise হোস্টনেম, যেমন
github.example.com.
একটি GitHub App তৈরি করুন, standalone GitHub OAuth App নয়. ChatGPT টেমপ্লেট সেটআপের জন্য GitHub App ক্রেডেনশিয়াল, একটি private key, এবং ওয়েবহুক সেটিংস প্রয়োজন.
শুরু করার আগে
আপনার প্রয়োজন:
ChatGPT ওয়ার্কস্পেস অ্যাডমিন বা মালিক অ্যাক্সেস.
GitHub Enterprise অ্যাডমিন বা প্রতিষ্ঠান-মালিক অ্যাক্সেস, যা GitHub Apps তৈরি ও ইনস্টল করতে পারে.
শুধু GitHub Enterprise হোস্টনেম,
https://বা কোনো পাথ ছাড়া.ChatGPT কোন রিপোজিটরি অ্যাকশন সমর্থন করবে সে বিষয়ে সিদ্ধান্ত, যেমন শুধু-পঠন রিপোজিটরি অনুসন্ধান, pull request ওয়ার্কফ্লো, issue ওয়ার্কফ্লো, ফাইল সম্পাদনা, GitHub Actions, বা বিস্তৃত Codex ওয়ার্কফ্লো.
GitHub App private key ও 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 private key PEM.
ChatGPT দ্বারা তৈরি ওয়েবহুক সিক্রেট.
ChatGPT-তে ড্রাফট অ্যাপ তৈরি হওয়ার পর তৈরি হওয়া ওয়েবহুক URL.
ChatGPT-তে টেমপ্লেট সেটআপ শুরু করুন
ChatGPT-তে, অ্যাপটি যেখানে উপলভ্য হওয়া উচিত সেই ওয়ার্কস্পেসে যান.
Workspace settings > Apps খুলুন.
Directory নির্বাচন করুন.
GitHub Enterprise খুঁজুন.
GitHub Enterprise অ্যাপ টেমপ্লেট নির্বাচন করুন এবং সেটআপ শুরু করুন.
GitHub Enterprise বা GitHub Enterprise - Engineering-এর মতো একটি স্পষ্ট অ্যাপ নাম ও বিবরণ লিখুন.
GitHub Enterprise হোস্টনেম লিখুন, যেমন
github.example.com.ChatGPT-তে দেখানো callback URL কপি করুন. এই ট্যাবটি খোলা রাখুন.
সেটআপের সময় দেখানো হলে তৈরি হওয়া ওয়েবহুক সিক্রেট কপি করুন.
উদাহরণ 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-এর মতো একটি স্পষ্ট অ্যাপ নাম লিখুন.
একটি homepage URL লিখুন. কোনো নির্দিষ্ট অভ্যন্তরীণ পৃষ্ঠা না থাকলে, GitHub Enterprise প্রতিষ্ঠানের URL ব্যবহার করুন.
Callback URL-এ, ChatGPT থেকে কপি করা হুবহু callback URL পেস্ট করুন.
আপনার নিরাপত্তা দলের পরিবর্তনের নির্দিষ্ট কারণ না থাকলে Expire user authorization tokens চালু রাখুন.
ইনস্টল বা সংযোগ ফ্লো চলাকালে ব্যবহারকারীরা যাতে অ্যাপ অনুমোদন করতে পারেন, সেজন্য Request user authorization during installation চালু করুন.
Where can this GitHub App be installed?–এর অধীনে, আপনার রোলআউটের উপযোগী সবচেয়ে সীমিত বিকল্পটি বেছে নিন.
GitHub App তৈরি করুন.
অনুমতি ও ইভেন্ট কনফিগার করুন
আপনি যে ChatGPT অ্যাকশনগুলো চালু করার পরিকল্পনা করছেন, সেগুলোর জন্য প্রয়োজনীয় ন্যূনতম অনুমতি বেছে নিন.
শুধু-পঠন রিপোজিটরি আবিষ্কার ও প্রশ্নোত্তরের জন্য, এ ধরনের পঠন অনুমতি দিয়ে শুরু করুন:
Metadata: শুধু-পঠন. GitHub Apps-এর জন্য GitHub-এর মেটাডেটা প্রয়োজন.
Contents: ফাইল ও রিপোজিটরি কনটেন্টে অ্যাক্সেসের জন্য শুধু-পঠন.
Issues: ইস্যু খোঁজা বা ইস্যু পড়া দরকার হলে, শুধু-পঠন.
Pull requests: pull request খোঁজা বা রিভিউ প্রসঙ্গ দরকার হলে, শুধু-পঠন.
Actions: workflow run status, jobs, logs, বা artifacts দরকার হলে, শুধু-পঠন.
লিখন ওয়ার্কফ্লোর জন্য, যেখানে দরকার শুধু সেখানে Contents, Pull requests, Issues, Actions, বা Workflows-এর মতো লিখন অনুমতি যোগ করুন. উদ্দিষ্ট ChatGPT অ্যাকশনগুলো সমর্থন করে এমন সবচেয়ে সীমিত অনুমতি ব্যবহার করুন.
ওয়েবহুক ইভেন্টগুলো আপনার সমর্থিত ওয়ার্কফ্লোর সাথে মিলতে হবে. সাধারণ ইভেন্টের মধ্যে আছে Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run, এবং Workflow job.
GitHub App ক্রেডেনশিয়াল তৈরি ও কপি করুন
GitHub App সেটিংসে, Client ID কপি করুন.
একটি Client secret তৈরি করুন এবং সঙ্গে সঙ্গে কপি করুন.
Private keys-এর অধীনে, একটি private key তৈরি করুন.
.pem ফাইলটি ডাউনলোড করুন এবং নিরাপদে সংরক্ষণ করুন.
.pem ফাইলটি লোকালি খুলুন এবং begin ও end লাইনসহ সম্পূর্ণ PEM টেক্সট কপি করুন.
private key সংবেদনশীল. এটিকে ক্রেডেনশিয়ালের মতো বিবেচনা করুন. এটি প্রকাশ পেলে, নতুন private key তৈরি করুন, ChatGPT অ্যাপ সেটআপ আপডেট করুন, এবং GitHub Enterprise-এ ক্ষতিগ্রস্ত key মুছে দিন.
ChatGPT-তে সেটআপ শেষ করুন
ChatGPT টেমপ্লেট সেটআপ ট্যাবে ফিরে যান.
GitHub App Client ID OAuth client ID-তে পেস্ট করুন.
GitHub App Client secret OAuth client secret-তে পেস্ট করুন.
আপনার প্রতিষ্ঠান ইচ্ছাকৃতভাবে টেমপ্লেটের ডিফল্ট ওভাররাইড করতে না চাইলে Scopes অপরিবর্তিত রাখুন.
GitHub Enterprise হোস্টনেমটি শুধু হোস্টনেম কি না নিশ্চিত করুন, যেমন
github.example.com.GitHub App private key PEM GitHub App private key-তে পেস্ট বা আপলোড করুন.
তৈরি হওয়া ওয়েবহুক সিক্রেট উপস্থিত আছে নিশ্চিত করুন.
ড্রাফট অ্যাপ তৈরি করুন.
ChatGPT-তে তৈরি হওয়া ড্রাফট অ্যাপের বিবরণ খুলুন এবং তৈরি হওয়া ওয়েবহুক URL কপি করুন.
ওয়েবহুক URL এমন হওয়া উচিত: https://connectors.api.openai.org/connectors/<connector_id>/webhook
GitHub Enterprise-এ ওয়েবহুক সেটআপ শেষ করুন
GitHub Enterprise-এ GitHub App সেটিংসে ফিরে যান.
GitHub App General settings খুলুন.
Active webhooks আগে থেকে চালু না থাকলে চালু করুন.
ChatGPT ওয়েবহুক URL Webhook URL-এ পেস্ট করুন.
ChatGPT ওয়েবহুক সিক্রেট Webhook secret-এ পেস্ট করুন.
SSL যাচাইকরণ চালু রাখুন.
সাবস্ক্রাইব করা ওয়েবহুক ইভেন্টগুলো আপনার চালু করা অনুমতি ও অ্যাকশনের সাথে মেলে কি না নিশ্চিত করুন.
পরিবর্তনগুলো সেভ করুন.
ChatGPT-তে অ্যাপ প্রকাশ ও পরিচালনা করুন
ড্রাফট অ্যাপ তৈরি করলে তা সদস্যদের জন্য স্বয়ংক্রিয়ভাবে উপলভ্য হয় না. ড্রাফট পর্যালোচনার পর:
ড্রাফট অ্যাপটি প্রকাশ করুন.
অ্যাপটি Workspace settings > Apps > Enabled-এ দেখা যাচ্ছে নিশ্চিত করুন.
যে ভূমিকাগুলো এটি ব্যবহার করবে তাদের জন্য User access কনফিগার করুন.
পঠন ও লিখন অ্যাকশনের জন্য Action control পর্যালোচনা করুন.
অ্যাপ ব্যবহারের আগে ChatGPT কখন সদস্যদের জিজ্ঞাসা করবে তা বেছে নিতে App permissions পর্যালোচনা করুন.
অনুমোদিত একজন টেস্ট ব্যবহারকারীকে ChatGPT-এ Apps খুলতে বলুন এবং অ্যাপটি দেখা যাচ্ছে কি না নিশ্চিত করতে বলুন.
এই অ্যাপ অনুমতিগুলো ChatGPT কথোপকথনে প্রযোজ্য. Workspace Agents প্রতিটি এজেন্টের বিল্ডার দ্বারা সেট করা নিয়ন্ত্রণ ব্যবহার করে নির্ধারণ করে কোন অ্যাপ অ্যাকশন উপলভ্য এবং কখন শেষ ব্যবহারকারীদের সেগুলো অনুমোদন করতে বলা হবে. এজেন্টের আচরণের জন্য, দেখুন: Enterprise ও Business-এর জন্য ChatGPT Workspace Agents.
GitHub App ইনস্টল ও পরীক্ষা করুন
GitHub Enterprise-এ, প্রতিষ্ঠান বা অ্যাকাউন্টে GitHub অ্যাপটি ইনস্টল করুন.
ওয়ার্কস্পেস নীতি অনুযায়ী সব রিপোজিটরি বা নির্বাচিত রিপোজিটরি বেছে নিন.
অনুমোদিত ব্যবহারকারী হিসেবে ChatGPT থেকে সংযোগ ফ্লো শুরু করুন.
প্রম্পট দেখালে GitHub অ্যাপ অনুমোদন করুন.
প্রথমে একটি ছোট পঠন অ্যাকশন চালান, যেমন অ্যাক্সেসযোগ্য রিপোজিটরির তালিকা দেখা বা পরিচিত কোনো pull request আনা.
লিখন অ্যাকশন চালু থাকলে, বিস্তৃত রোলআউটের আগে কম ঝুঁকির রিপোজিটরিতে পরীক্ষা করুন.
হোস্টনেম ও OAuth আচরণ
ChatGPT GitHub Enterprise এন্ডপয়েন্ট নির্ধারণ করতে হোস্টনেম ব্যবহার করে. শুধু হোস্ট লিখুন, যেমন github.example.com বা octocorp.ghe.com.
এই অ্যাপের জন্য সেটিই হুবহু GitHub Enterprise হোস্ট না হলে কোনো API পাথ, রিপোজিটরি পাথ, বা github.com লিখবেন না.
সমস্যা সমাধান
Redirect URI mismatch: GitHub App callback URL ChatGPT-তে দেখানো callback URL-এর সাথে হুবহু মেলে কি না নিশ্চিত করুন.
ChatGPT cannot create or save the draft app: হোস্টনেম, OAuth client ID, OAuth client secret, private key, এবং ওয়েবহুক সিক্রেটসহ সব প্রয়োজনীয় ফিল্ড আছে কি না নিশ্চিত করুন.
Authentication succeeds but repository calls fail: GitHub App ইনস্টল করা আছে এবং রিপোজিটরিতে অ্যাক্সেস আছে কি না নিশ্চিত করুন.
API returns 403 or insufficient permissions: অনুপস্থিত GitHub App অনুমতি যোগ করুন এবং প্রম্পট দেখালে ইনস্টলেশনের মালিককে আপডেট করা অনুমতি অনুমোদন করতে বলুন.
No repositories appear: অ্যাপ ইনস্টলেশনে প্রত্যাশিত রিপোজিটরিগুলো আছে এবং ChatGPT-তে অনুমোদনকারী ব্যবহারকারীর সেগুলোতে অ্যাক্সেস আছে কি না নিশ্চিত করুন.
Webhook deliveries fail: ওয়েবহুক URL ও ওয়েবহুক সিক্রেট ChatGPT-এর মানের সাথে মেলে কি না নিশ্চিত করুন, SSL যাচাইকরণ চালু রাখুন, এবং GitHub Enterprise হোস্ট
connectors.api.openai.org-এ পৌঁছাতে পারে কি না নিশ্চিত করুন.Private key errors: begin ও end লাইনসহ সম্পূর্ণ PEM কনটেন্ট কপি করা হয়েছে কি না নিশ্চিত করুন.
