نمای کلی
اگر مدیر فضای کاری ChatGPT هستید و می‌خواهید قالب برنامهٔ GitHub Enterprise را برای سازمان خود راه‌اندازی کنید، از این راهنما استفاده کنید. قالب، برنامهٔ نهایی‌ای نیست که اعضا از آن استفاده می‌کنند. قالب در واقع روندی برای راه‌اندازی است که پس از وارد کردن تنظیمات لازم GitHub Enterprise، پیش‌نویس برنامه‌ای مختص فضای کاری ایجاد می‌کند.
در مورد GitHub Enterprise، این راه‌اندازی ChatGPT را به میزبان GitHub Enterprise سازمان شما متصل می‌کند. یک برنامهٔ GitHub ایجاد می‌کنید، نشانی بازگشت ChatGPT را ثبت می‌کنید، اطلاعات احراز هویت را تولید می‌کنید و سپس این مقادیر را در روند راه‌اندازی قالب ChatGPT جای‌گذاری می‌کنید. پس از اینکه ChatGPT پیش‌نویس برنامه را ایجاد کرد، می‌توانید آن را منتشر کنید و مانند سایر برنامه‌های فضای کاری مدیریت کنید.
برای آشنایی با پیمایش در فضای کاری و دسترسی به برنامه، ببینید: کنترل‌های مدیریتی، امنیت و انطباق برای افزونه‌ها و برنامه‌ها.
آنچه راه‌اندازی می‌کنید
شما در حال ایجاد یک برنامهٔ GitHub Enterprise مختص فضای کاری در ChatGPT هستید. این برنامه از موارد زیر استفاده می‌کند:
یک برنامهٔ GitHub که روی میزبان GitHub Enterprise شما ثبت شده است.
شناسه و رمز محرمانهٔ کلاینت برنامهٔ GitHub برای اعطای مجوز کاربر از طریق OAuth.
کلید خصوصی برنامهٔ GitHub تا ChatGPT بتواند توکن‌های نصب را برای عملیات محل نگهداری صادر کند.
رمز محرمانه و نشانی وب‌هوک تا GitHub Enterprise بتواند رویدادهای نصب و محل نگهداری را به ChatGPT ارسال کند.
نام میزبان GitHub Enterprise شما؛ مثلاً
github.example.com.
یک برنامهٔ GitHub ایجاد کنید، نه یک برنامهٔ مستقل OAuth در GitHub. راه‌اندازی قالب ChatGPT به اطلاعات احراز هویت برنامهٔ GitHub، یک کلید خصوصی و تنظیمات وب‌هوک نیاز دارد.
پیش از شروع
به موارد زیر نیاز دارید:
دسترسی مدیر یا مالک فضای کاری ChatGPT.
دسترسی مدیر GitHub Enterprise یا مالک سازمان، با امکان ایجاد و نصب برنامه‌های GitHub.
فقط نام میزبان GitHub Enterprise، بدون
https://یا مسیر.تصمیم‌گیری دربارهٔ اقداماتی که ChatGPT باید برای محل نگهداری پشتیبانی کند؛ مانند جست‌وجوی فقط‌خواندنی در محل نگهداری، گردش‌کارهای pull request، گردش‌کارهای ایشو، ویرایش فایل‌ها، GitHub Actions یا گردش‌کارهای گسترده‌تر Codex.
محلی امن برای نگهداری و کار با کلید خصوصی و رمز محرمانهٔ کلاینت برنامهٔ GitHub.
ChatGPT و GitHub Enterprise را در زبانه‌های جداگانه باز نگه دارید. نشانی بازگشت را خودتان نسازید. نشانی بازگشت نمایش‌داده‌شده در ChatGPT را دقیقاً کپی کنید.
مقادیری که باید آماده کنید
نام میزبان GitHub Enterprise: مثلاً
github.example.com.نشانی بازگشت: آن را از روند راه‌اندازی قالب ChatGPT کپی کنید.
شناسهٔ کلاینت برنامهٔ GitHub.
رمز محرمانهٔ کلاینت برنامهٔ GitHub.
کلید خصوصی برنامهٔ GitHub با قالب PEM.
رمز محرمانهٔ وب‌هوک که ChatGPT تولید می‌کند.
نشانی وب‌هوک که پس از ایجاد پیش‌نویس برنامه در ChatGPT تولید می‌شود.
راه‌اندازی قالب را در ChatGPT شروع کنید
در ChatGPT، به فضای کاری‌ای بروید که برنامه باید در آن در دسترس باشد.
تنظیمات فضای کاری > برنامه‌ها را باز کنید. همچنین می‌توانید به کنسول مدیریت بروید، فضای کاری موردنظر در ChatGPT را انتخاب کنید و افزونه‌ها را باز کنید. مدیریت برنامه‌های قدیمی را انتخاب کنید تا صفحهٔ برنامه‌ها که همچنان حفظ شده است باز شود.
فهرست را انتخاب کنید.
GitHub Enterprise را جست‌وجو کنید.
قالب برنامهٔ GitHub Enterprise را انتخاب کنید و راه‌اندازی را شروع کنید.
نام و توضیحی روشن برای برنامه وارد کنید؛ مثلاً GitHub Enterprise یا GitHub Enterprise - مهندسی.
نام میزبان GitHub Enterprise را وارد کنید؛ مثلاً
github.example.com.نشانی بازگشتی را که در ChatGPT نمایش داده می‌شود کپی کنید. این زبانه را باز نگه دارید.
اگر رمز محرمانهٔ وب‌هوکِ تولیدشده در طول راه‌اندازی نمایش داده شد، آن را کپی کنید.
نمونهٔ نشانی بازگشت: https://chatgpt.com/connector/oauth/<callback_id>
شناسهٔ بازگشت را حذف نکنید، به انتهای نشانی اسلش اضافه نکنید و آن را با یک نشانی عمومی ChatGPT جایگزین نکنید.
ایجاد برنامهٔ GitHub در GitHub Enterprise
نشانی میزبان GitHub Enterprise خود، مانند
https://github.example.com، را باز کنید.به سازمان یا حسابی بروید که قرار است مالک برنامه باشد.
تنظیمات > تنظیمات توسعه‌دهنده > برنامه‌های GitHub را باز کنید.
برنامهٔ جدید GitHub را انتخاب کنید.
نامی گویا برای برنامه وارد کنید، مانند ChatGPT GitHub Enterprise.
نشانی اینترنتی صفحهٔ اصلی را وارد کنید. اگر صفحهٔ داخلی اختصاصی وجود ندارد، از نشانی اینترنتی سازمان در GitHub Enterprise استفاده کنید.
در قسمت «نشانی بازگشت»، نشانی بازگشتی را که از ChatGPT کپی کرده‌اید، بدون هیچ تغییری جای‌گذاری کنید.
گزینهٔ «منقضی شدن توکن‌های مجوز کاربر» را فعال نگه دارید، مگر اینکه تیم امنیت شما دلیل مشخصی برای تغییر آن داشته باشد.
گزینهٔ «درخواست مجوز از کاربر هنگام نصب» را فعال کنید تا کاربران بتوانند در فرایند نصب یا اتصال، به برنامه مجوز بدهند.
در بخش «این برنامهٔ GitHub را کجا می‌توان نصب کرد؟»، محدودترین گزینه‌ای را انتخاب کنید که با برنامهٔ استقرار شما سازگار است.
برنامهٔ GitHub را ایجاد کنید.
مجوزها و رویدادها را پیکربندی کنید
حداقل مجوزهای لازم را برای اقداماتی که می‌خواهید در ChatGPT فعال کنید انتخاب کنید.
برای کشف محل‌های نگهداری و پرسش‌وپاسخ به‌صورت فقط‌خواندنی، با مجوزهای خواندن مانند موارد زیر شروع کنید:
فراداده: فقط‌خواندنی. GitHub دسترسی به فراداده را برای برنامه‌های GitHub الزامی می‌داند.
محتوا: فقط‌خواندنی، برای دسترسی به فایل‌ها و محتوای محل نگهداری.
ایشوها: فقط‌خواندنی، در صورت نیاز به جست‌وجو یا خواندن ایشوها.
Pull requests: فقط‌خواندنی، در صورت نیاز به جست‌وجوی pull request یا اطلاعات زمینه‌ای برای بازبینی.
اقدامات: فقط‌خواندنی، در صورت نیاز به وضعیت اجرای گردش‌کار، کارها، گزارش‌ها یا خروجی‌های تولیدشده.
برای گردش‌کارهایی که عملیات نوشتن دارند، مجوز نوشتن را فقط در بخش‌های لازم، مانند محتوا، Pull requests، ایشوها، اقدامات یا گردش‌کارها اضافه کنید. از محدودترین مجوزهایی استفاده کنید که اقدامات موردنظر در ChatGPT را پشتیبانی می‌کنند.
رویدادهای وب‌هوک باید با گردش‌کارهایی که پشتیبانی می‌کنید مطابقت داشته باشند. رویدادهای رایج شامل نصب، محل‌های نگهداری نصب، ارسال تغییرات، Pull request، ایشوها، نظر روی ایشو، اجرای گردش‌کار و کارِ گردش‌کار هستند.
اطلاعات احراز هویت برنامهٔ GitHub را تولید و کپی کنید
در تنظیمات برنامهٔ GitHub، شناسهٔ کلاینت را کپی کنید.
یک رمز محرمانهٔ کلاینت تولید کنید و بلافاصله آن را کپی کنید.
در بخش کلیدهای خصوصی، یک کلید خصوصی تولید کنید.
فایل .pem را دانلود کنید و آن را در محلی امن نگه دارید.
فایل .pem را روی دستگاه خود باز کنید و متن کامل PEM، از جمله خطوط آغاز و پایان، را کپی کنید.
کلید خصوصی اطلاعاتی حساس است. مانند اطلاعات احراز هویت از آن محافظت کنید. اگر کلید افشا شد، کلید خصوصی جدیدی تولید کنید، تنظیمات برنامه در ChatGPT را به‌روز کنید و کلید افشاشده را در GitHub Enterprise حذف کنید.
راه‌اندازی را در ChatGPT تکمیل کنید
به زبانهٔ راه‌اندازی قالب در ChatGPT برگردید.
شناسهٔ کلاینت برنامهٔ GitHub را در شناسهٔ کلاینت OAuth جای‌گذاری کنید.
رمز محرمانهٔ کلاینت برنامهٔ GitHub را در رمز محرمانهٔ کلاینت OAuth جای‌گذاری کنید.
محدوده‌های دسترسی را تغییر ندهید، مگر اینکه سازمانتان مشخصاً نیاز داشته باشد مقادیر پیش‌فرض قالب را بازنویسی کند.
مطمئن شوید مقدار واردشده برای نام میزبان GitHub Enterprise فقط شامل نام میزبان است؛ مثلاً
github.example.com.کلید خصوصی برنامهٔ GitHub با قالب PEM را در قسمت «کلید خصوصی برنامهٔ GitHub» جای‌گذاری یا بارگذاری کنید.
مطمئن شوید رمز محرمانهٔ وب‌هوکِ تولیدشده موجود است.
پیش‌نویس برنامه را ایجاد کنید.
جزئیات پیش‌نویس برنامهٔ ایجادشده را در ChatGPT باز کنید و نشانی وب‌هوکِ تولیدشده را کپی کنید.
نشانی وب‌هوک باید به این شکل باشد: https://connectors.api.openai.org/connectors/<connector_id>/webhook
راه‌اندازی وب‌هوک را در GitHub Enterprise تکمیل کنید
به تنظیمات برنامهٔ GitHub در GitHub Enterprise برگردید.
تنظیمات عمومی برنامهٔ GitHub را باز کنید.
اگر گزینهٔ «وب‌هوک‌های فعال» از قبل فعال نیست، آن را فعال کنید.
نشانی وب‌هوک ChatGPT را در قسمت «نشانی وب‌هوک» جای‌گذاری کنید.
رمز محرمانهٔ وب‌هوک ChatGPT را در قسمت «رمز محرمانهٔ وب‌هوک» جای‌گذاری کنید.
تأیید SSL را فعال نگه دارید.
مطمئن شوید رویدادهای وب‌هوک که برای دریافتشان مشترک شده‌اید با مجوزها و اقداماتی که فعال کرده‌اید مطابقت دارند.
تغییرات را ذخیره کنید.
انتشار و مدیریت برنامه در ChatGPT
ایجاد نسخهٔ پیش‌نویس برنامه، آن را به‌طور خودکار در دسترس اعضا قرار نمی‌دهد. پس از بررسی پیش‌نویس:
نسخهٔ پیش‌نویس برنامه را منتشر کنید.
در تنظیمات فضای کاری، صفحهٔ برنامه‌ها و سپس بخش فعال‌شده را باز کنید و مطمئن شوید برنامه در فهرست نمایش داده می‌شود. همچنین می‌توانید از طریق گزینهٔ «مدیریت برنامه‌های قدیمی» در کنسول مدیریت > افزونه‌ها، صفحهٔ برنامه‌ها را باز کنید.
در Enterprise و Edu، از بخش دسترسی کاربران برای انتخاب نقش‌هایی که می‌توانند از برنامه استفاده کنند بهره بگیرید. در Business، در دسترس بودن برنامه را در سراسر فضای کاری مدیریت کنید.
بخش کنترل عملیات را برای عملیات خواندن و نوشتن بررسی کنید.
بخش مجوزهای برنامه را بررسی کنید تا تعیین کنید ChatGPT چه زمانی پیش از استفاده از برنامه از اعضا اجازه بگیرد.
از یک کاربر آزمایشی که مجوز دسترسی دارد بخواهید برنامه‌ها در ChatGPT را باز کند و مطمئن شود برنامه نمایش داده می‌شود.
این مجوزهای برنامه در گفتگوهای ChatGPT اعمال می‌شوند. عامل‌های فضای کاری از تنظیمات کنترلی مختص هر عامل که سازندهٔ آن تعیین کرده است استفاده می‌کنند تا مشخص شود کدام عملیات برنامه در دسترس است و چه زمانی از کاربران نهایی خواسته می‌شود آن‌ها را تأیید کنند. برای آشنایی با نحوهٔ عملکرد عامل، به عامل‌های فضای کاری ChatGPT برای Enterprise و Business مراجعه کنید.
برنامهٔ GitHub را نصب و آزمایش کنید
در GitHub Enterprise، برنامهٔ GitHub را روی سازمان یا حساب نصب کنید.
بنا بر خط‌مشی فضای کاری، همهٔ محل‌های نگهداری یا محل‌های نگهداری منتخب را انتخاب کنید.
به‌عنوان کاربری با دسترسی مجاز، روند اتصال را از ChatGPT شروع کنید.
وقتی درخواست نمایش داده شد، به برنامهٔ GitHub مجوز بدهید.
ابتدا یک اقدام خواندن ساده انجام دهید؛ مثلاً فهرست کردن محل‌های نگهداری قابل‌دسترسی یا دریافت یک pull request مشخص.
اگر اقدامات نوشتن فعال‌اند، پیش از عرضهٔ گسترده‌تر، آن‌ها را روی یک محل نگهداری کم‌خطر آزمایش کنید.
نام میزبان و نحوهٔ عملکرد OAuth
ChatGPT از نام میزبان برای تعیین نشانی نقاط پایانی GitHub Enterprise استفاده می‌کند. فقط نام میزبان را وارد کنید؛ مثلاً github.example.com یا octocorp.ghe.com.
مسیر API یا مسیر محل نگهداری را وارد نکنید. github.com را نیز وارد نکنید، مگر اینکه دقیقاً میزبان GitHub Enterprise این برنامه باشد.
عیب‌یابی
عدم تطابق URI هدایت مجدد: مطمئن شوید نشانی بازگشت برنامهٔ GitHub دقیقاً با نشانی بازگشت نمایش‌داده‌شده در ChatGPT مطابقت دارد.
ChatGPT نمی‌تواند پیش‌نویس برنامه را ایجاد یا ذخیره کند: مطمئن شوید همهٔ فیلدهای الزامی، از جمله نام میزبان، شناسهٔ کلاینت OAuth، رمز محرمانهٔ کلاینت OAuth، کلید خصوصی و رمز محرمانهٔ وب‌هوک تکمیل شده‌اند.
احراز هویت موفق است، اما فراخوانی‌های محل نگهداری ناموفق‌اند: مطمئن شوید برنامهٔ GitHub نصب شده و به محل نگهداری دسترسی دارد.
API خطای ۴۰۳ یا ناکافی بودن مجوزها را برمی‌گرداند: مجوز لازم را به برنامهٔ GitHub اضافه کنید و اگر درخواست تأیید نمایش داده شد، از مالک نصب بخواهید مجوزهای به‌روزشده را تأیید کند.
هیچ محل نگهداری‌ای نمایش داده نمی‌شود: مطمئن شوید نصب برنامه شامل محل‌های نگهداری موردنظر است و کاربری که در ChatGPT مجوز می‌دهد به آن‌ها دسترسی دارد.
تحویل وب‌هوک‌ها ناموفق است: مطمئن شوید نشانی و رمز محرمانهٔ وب‌هوک با مقادیر ChatGPT مطابقت دارند، تأیید SSL را فعال نگه دارید و مطمئن شوید میزبان GitHub Enterprise می‌تواند به
connectors.api.openai.orgمتصل شود.خطاهای کلید خصوصی: مطمئن شوید محتوای کامل PEM، از جمله خطوط آغاز و پایان، کپی شده است.