সংক্ষিপ্ত বিবরণ

ওয়ার্কস্পেসের প্রশাসকেরা GitHub থেকে তাঁদের ওয়ার্কস্পেস ডিরেক্টরিতে একটি প্লাগইন মার্কেটপ্লেস আমদানি করতে পারেন. মার্কেটপ্লেস হলো একটি JSON ক্যাটালগ, যাতে আমদানি করার জন্য প্লাগইনগুলোর তালিকা থাকে. আমদানির পর প্রতিদিন সিঙ্ক করার মাধ্যমে রিপোজিটরির পরিবর্তন অনুযায়ী প্লাগইনগুলো হালনাগাদ রাখা হয়.


মার্কেটপ্লেস সিঙ্ক প্লাগইনের বিষয়বস্তু আমদানি করে—এটি ওয়ার্কস্পেসের সদস্যদের অ্যাকাউন্ট সংযুক্ত করে না বা প্লাগইনে থাকা অ্যাপগুলো ব্যবহারের অনুমতি দেয় না.


প্লাগইন ও সেগুলোতে থাকা অ্যাপের পরিচিতি জানতে দেখুন: ChatGPT ও Codex-এ প্লাগইন.

শুরু করার আগে

• এমন একটি GitHub অ্যাকাউন্ট ব্যবহার করুন, যেটির মার্কেটপ্লেস রিপোজিটরি ও তাতে রেফারেন্স দেওয়া অন্য প্রতিটি রিপোজিটরি পড়ার অনুমতি আছে. github.com-এর উন্মুক্ত ও ব্যক্তিগত রিপোজিটরিগুলো সমর্থিত.

• আমদানির জন্য ব্যবহৃত অ্যাকাউন্ট থেকে ওই রিপোজিটরিগুলোতে অ্যাক্সেস পেতে GitHub সংস্থার কোনো অনুমোদন প্রয়োজন হলে তা নেওয়ার প্রক্রিয়া সম্পন্ন করুন.

• রিপোজিটরির বিষয়বস্তু পর্যালোচনা করুন. আমদানির সময় প্রতিটি প্লাগইনের জন্য আলাদা অনুমোদনের ধাপ ছাড়াই সব বৈধ প্লাগইন প্রক্রিয়া করা হয় এবং ভবিষ্যতের সিঙ্কে নতুন প্লাগইন যোগ হতে পারে.

নতুন প্লাগইনের ক্ষেত্রে শুরুতে ইনস্টলেশন নীতি উপলব্ধ থাকে এবং ইনস্টলের সময় পরিচয় যাচাইকরণ করা হয়. নতুন মার্কেটপ্লেসে স্বয়ংক্রিয় দৈনিক সিঙ্ক চালু থাকে. আমদানির পর প্রতিটি প্লাগইনের ওয়ার্কস্পেস সেটিংস ও প্রয়োজনীয় অ্যাপগুলো পর্যালোচনা করুন.

মার্কেটপ্লেস আমদানি করুন

1. প্রশাসনিক কনসোল-এ যান, কাঙ্ক্ষিত ChatGPT ওয়ার্কস্পেস নির্বাচন করুন এবং প্লাগইন খুলুন. এরপর যোগ করুন নির্বাচন করে মার্কেটপ্লেস আমদানি করুন বেছে নিন.

2. উৎস ঘরে রিপোজিটরির ইউআরএল লিখুন, যেমন https://github.com/example/team-plugins. শুধু রিপোজিটরির ইউআরএল ব্যবহার করুন, কোনো ব্রাঞ্চ বা ফোল্ডারের ইউআরএল নয়.

3. মার্কেটপ্লেসটি কোনো সাবডিরেক্টরিতে থাকলে পাথ ঘরে সেই ডিরেক্টরি লিখুন. উদাহরণস্বরূপ, team-tools/.agents/plugins/marketplace.json-এর জন্য team-tools লিখুন. রিপোজিটরির মূল ডিরেক্টরি ব্যবহার করতে পাথ ঘরটি খালি রাখুন. ম্যানিফেস্ট ফাইলের নাম লিখবেন না.

4. চাইলে ব্রাঞ্চ, ট্যাগ বা কমিট লিখুন. রিপোজিটরির পূর্বনির্ধারিত ব্রাঞ্চ ব্যবহার করতে ঘরটি খালি রাখুন. ভবিষ্যতের কমিটগুলো পেতে একটি ব্রাঞ্চ ব্যবহার করুন. নির্দিষ্ট কোনো কমিট বেছে নিলে সেটি ওই সংস্করণেই থাকে.

5. মার্কেটপ্লেস আমদানি করুন নির্বাচন করুন এবং অনুরোধ করা হলে GitHub অ্যাক্সেসের অনুমতি দিন.

6. আমদানির ফলাফল পর্যালোচনা করুন, তারপর আমদানি করা প্রতিটি প্লাগইন খুলে সেটির ইনস্টলেশন নীতি ও প্রয়োজনীয় অ্যাপগুলো কনফিগার করুন.

খুব বড় মার্কেটপ্লেসের ক্ষেত্রে প্রথমবার আমদানি করতে ১ ঘণ্টা পর্যন্ত সময় লাগতে পারে. পরবর্তী দৈনিক সিঙ্কগুলোতে সাধারণত কয়েক মিনিট সময় লাগে.

কোনো প্লাগইন আমদানি করা না গেলে প্রতিবেদনে ত্রুটির ব্যাখ্যা দেওয়া হয়. তারপরও অন্য বৈধ প্লাগইনগুলো আমদানি করা যায়.

সমর্থিত বিন্যাস

নির্বাচিত ডিরেক্টরিতে একটি সমর্থিত ম্যানিফেস্ট থাকতে হবে:

• 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. এর ইউআরএলে /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 ইউআরএল ব্যবহার করলেও.


শুধু .app.json রেফারেন্স যোগ করলেই শুধু ডেস্কটপের জন্য লেবেলটি সরে যায় না. রেফারেন্স দেওয়া যেকোনো অ্যাপ সদস্যের ভূমিকার জন্য উপলব্ধ থাকতে হবে এবং সেটির স্বাভাবিক অ্যাক্সেস ও পরিচয় যাচাইকরণের শর্তগুলো প্রযোজ্য থাকবে.