از ۹ ژوئیهٔ ۲۰۲۶، فهرست اپها را به فهرست افزونهها منتقل کردهایم. افزونهها راه اصلی کشف قابلیتهای گردشکار در ChatGPT و Codex هستند. یک افزونه میتواند شامل مهارتها، اپها و الگوهای اپ باشد؛ اپها همچنان همان یکپارچهسازیهایی هستند که ChatGPT یا Codex را به دادهها و اقدامهای خارجی وصل میکنند، در حالی که افزونهها فعالسازی گردشکارها را در ChatGPT آسانتر میکنند. اتصالهای موجود اپها تحت تأثیر قرار نمیگیرند و کاربران میتوانند افزونههای جدید را از فهرست افزونهها اضافه کنند و مانند قبل اپ زیربنایی را متصل و احراز هویت کنند. ادمینهای فضای کاری نصب افزونه را در تنظیمات Workspace > Plugins مدیریت میکنند و میتوانند دسترسی و مجوزهای هر اپ زیربنایی را از داخل پیکربندی افزونه یا از تنظیمات Workspace > Apps مدیریت کنند.
نمای کلی
الگوهای اپ مسیری برای راهاندازی در فضاهای کاری مدیریتشده هستند که به نسخهای مخصوص همان فضای کاری از یک اپ یا رابط ChatGPT نیاز دارند. ادمینها و مالکان فضای کاری الگوها را در تنظیمات Workspace > Apps > Directory پیدا میکنند، پیکربندی مخصوص سازمان را اضافه میکنند و برای بازبینی یک پیشنویس اپ میسازند. الگوهای اپ مدیریتشده در فضاهای کاری شخصی نمایش داده نمیشوند.
الگوها زمانی مفیدند که OpenAI بتواند رفتار مشترک اپ را فراهم کند، اما هر فضای کاری باید پیکربندی مخصوص ارائهدهنده را خودش ارائه کند. بسته به الگو، این پیکربندی میتواند شامل نام مستأجر یا میزبان، اعتبارنامههای کلاینت OAuth، URLهای callback، محدودهها، جزئیات webhook، URLهای سرور MCP مدیریتشده یا سایر تنظیمات ارائهدهنده باشد. برای مثال، یک الگوی GitHub Enterprise ممکن است رابط مخصوص فضای کاری را بسازد که Codex برای دسترسی به میزبان GitHub Enterprise آن سازمان از آن استفاده میکند.
پس از راهاندازی، اعضا از الگوی اصلی استفاده نمیکنند. آنها از اپ منتشرشدهٔ فضای کاری که از آن ساخته شده است استفاده میکنند. سپس ادمینها میتوانند آن اپ را مانند سایر اپهای ChatGPT مدیریت کنند، از جمله دسترسی نقشها، کنترلهای اقدام، مجوزهای اپ و مجوزدهی ارائهدهنده.
افزونهها نیز میتوانند شامل الگوهای اپ یا اپهای ساختهشده از الگوها باشند. اگر یک افزونه شامل الگوی اپ باشد، همچنان لازم است ادمین یا مالک فضای کاری پیش از آنکه اعضا بتوانند آن را در ChatGPT متصل کنند یا از طریق آن افزونه استفاده کنند، اپ مخصوص فضای کاری را بسازد و منتشر کند. وقتی افزونه اجرا میشود، بهجای اینکه از اعضا بخواهد خودشان الگوی اصلی را پیکربندی کنند، از نمونهٔ اپ موجود در همان فضای کاری استفاده میکند. اگر الگوی موردنیاز هنوز راهاندازی نشده باشد، ممکن است اعضا ابتدا به ادمینی نیاز داشته باشند که راهاندازی را کامل کند. افزونه بهتنهایی نمیتواند از الگوی اپ استفاده کند.
برای روند کلی الگو از این مقاله استفاده کنید. برای راهاندازی مخصوص ارائهدهنده، ببینید:
الگوها زمانی مفیدند که یک الگوی پیادهسازی یکسان بتواند برای سازمانهای زیادی کار کند، اما هر سازمان به پیکربندی خودش نیاز داشته باشد.
نمونههای رایج عبارتاند از:
URL ارائهدهنده شامل نام میزبان مستأجر، حساب، سازمان یا فضای کاری شرکت است.
سازمان باید کلاینت OAuth یا اعتبارنامههای ارائهدهندهٔ خودش را بیاورد.
ارائهدهنده به راهاندازی URL callback مخصوص مشتری نیاز دارد.
اپ باید از الگوی پیادهسازی یکسانی استفاده کند، در حالی که هر فضای کاری دسترسی، اقدامها و تنظیمات امنیتی را جداگانه کنترل میکند.
تفاوت الگوها بااپهای معمولی
یک اپ معمولی را اغلب میتوان مستقیماً فعال کرد. اما یک الگو، روند راهاندازی توسط ادمین فضای کاری را آغاز میکند.
روند معمول این است:
ادمین یک الگو را در تنظیمات Workspace > Apps > Directory پیدا میکند.
ادمین پیکربندی لازم و مخصوص فضای کاری را وارد میکند.
ChatGPT یک پیشنویس اپ برای فضای کاری ایجاد میکند.
ادمین پیشنویس را بازبینی و منتشر میکند.
ادمین دسترسی و تنظیمات اقدام را برای اپ منتشرشده پیکربندی میکند.
اعضا از اپ منتشرشدهٔ فضای کاری استفاده میکنند، نه از الگوی اصلی.
پیدا کردن و راهاندازی الگوی اپ
Workspace settings > Apps را باز کنید.
Directory را انتخاب کنید.
نام ارائهدهنده یا اپ را جستوجو کنید.
بهدنبال ورودیهایی باشید که بهعنوان الگو علامتگذاری شدهاند.
برای شروع روند راهاندازی، Enable را انتخاب کنید.
روند راهاندازی، جزئیات لازم برای ساخت اپ مخصوص فضای کاری را درخواست میکند. فیلدهای دقیق به الگو بستگی دارد.
برای مثال، یک الگوی GitHub Enterprise ممکن است جزئیاتی مانند اینها را بخواهد:
نام و توضیحات اپ.
نام میزبان GitHub Enterprise.
پیکربندی URL callback.
شناسهٔ کلاینت OAuth و رمز محرمانهٔ کلاینت.
کلید خصوصی GitHub App.
محدودههای درخواستشده.
جزئیات راهاندازی webhook.
پیش از ایجاد پیشنویس، هر فیلد را با دقت بررسی کنید. اگر سازمان شما OAuth یا اعتبارنامههای ارائهدهنده را بهصورت متمرکز مدیریت میکند، با تیم مالک آن اعتبارنامهها هماهنگ کنید.
دستورالعملهای مخصوص اپ را ببینید:GitHub،Snowflake، وDatabricks.
راهاندازی کلاینت OAuth
برخی الگوها از سازمان شما میخواهند کلاینت OAuth خودش را بیاورد. وقتی این مورد لازم باشد، اپ OAuth را در کنسول ادمین ارائهدهندهٔ خارجی بسازید یا پیکربندی کنید، سپس URL callback را از ChatGPT در تنظیمات URL تغییرمسیر یا callback ارائهدهنده کپی کنید.
شناسه و رمز محرمانهٔ کلاینت OAuth را فقط پس از تأیید اینکه پیکربندی ارائهدهنده با دستورالعملهای راهاندازی الگو مطابقت دارد، در ChatGPT وارد کنید.
اگر الگو شامل محدودههای پیشفرض است، پیشفرضها را نگه دارید مگر اینکه سازمان شما مجوزهای ارائهدهنده را بررسی کرده باشد و دلیل روشنی برای تغییر آنها داشته باشد.
ایجاد پیشنویس
پس از وارد کردن اطلاعات لازم، Create draft را انتخاب کنید.
ایجاد پیشنویس بهطور خودکار اپ را در دسترس اعضا قرار نمیدهد. پیش از آنکه از اعضا بخواهید از آن استفاده کنند، پیشنویس را بازبینی و منتشر کنید و تنظیمات دسترسی و اقدام را پیکربندی کنید.
انتشار و مدیریت اپ حاصل
پس از انتشار، اپ مخصوص فضای کاری را از Workspace settings > Apps > Enabled مدیریت کنید.
بررسیهای پیشنهادی پس از انتشار:
تأیید کنید اپ در Enabled apps نمایش داده میشود.
User access را برای نقشهایی که باید از اپ استفاده کنند تنظیم کنید.
Action control را برای اقدامهای خواندن و نوشتن بررسی کنید.
App permissions را بررسی کنید تا انتخاب کنید ChatGPT چه زمانی پیش از استفاده از اپ از اعضا سؤال کند.
از یک کاربر آزمایشی مجاز بخواهید Apps را در ChatGPT باز کند و تأیید کند اپ نمایش داده میشود.
اگر اپ به احراز هویت نزد ارائهدهنده نیاز دارد، از کاربر آزمایشی بخواهید حساب ارائهدهندهٔ خود را متصل کند.
برای تأیید اینکه اپ مطابق انتظار کار میکند، یک اعلان آزمایشی کمریسک اجرا کنید.
این مجوزهای اپ برای گفتگوهای ChatGPT اعمال میشوند. عاملهای فضای کاری از کنترلهای جداگانهٔ هر عامل که سازندهٔ آن تنظیم میکند استفاده میکنند تا مشخص شود کدام اقدامهای اپ در دسترساند و چه زمانی از کاربران نهایی خواسته میشود آنها را تأیید کنند. برای رفتار عامل، ببینید:عاملهای فضای کاری ChatGPT برای Enterprise و Business.
اگر یک الگو فقط یکبار قابل استفاده باشد
برخی الگوها ممکن است در هر فضای کاری فقط یک اپ ایجاد کنند. اگر یک الگو قبلاً استفاده شده باشد، ممکن است دکمهٔ Enable در دسترس نباشد. در این حالت، بهجای ساختن اپی دیگر از همان الگو، پیشنویس یا اپ منتشرشدهٔ موجود را مدیریت کنید.
اعضا چه میبینند
اعضا اپ منتشرشدهای را میبینند که از الگو ساخته شده است. اینکه یک عضو بتواند آن را ببیند یا استفاده کند، به تنظیمات فضای کاری و مجوزدهی ارائهدهنده بستگی دارد. اگر اپ در یک افزونه گنجانده شده باشد، اعضا ممکن است از طریق همان افزونه با آن روبهرو شوند، اما همچنان همان الزامات دسترسی فضای کاری و مجوزدهی ارائهدهنده اعمال میشود.
اگر یک افزونه به اپی نیاز داشته باشد که از یک الگو ساخته شده است، ممکن است نشان دهد که راهاندازی لازم است تا زمانی که ادمین اپ مخصوص فضای کاری را بسازد و منتشر کند، آن را برای نقش مربوطه فعال کند، و هرگونه مجوزدهی لازم کاربر یا ادمین نزد ارائهدهنده کامل شود.
بررسی کنید که:
اپ منتشر شده باشد.
اپ برای فضای کاری فعال شده باشد.
نقش عضو در فضای کاری دسترسی داشته باشد.
عضو در فضای کاری درست باشد.
عضو مجوزهای لازم را در ارائهدهندهٔ خارجی داشته باشد.
اپهای منتشرشده در تنظیمات Workspace > Apps > Enabled نمایش داده میشوند. اگر اپ بخشی از یک افزونه باشد، ممکن است در صفحهٔ جزئیات افزونه نیز بهعنوان اپ الزامی یا اختیاری نمایش داده شود.
عیبیابی
اگر راهاندازی ناموفق بود یا اپ نمایش داده نشد، موارد زیر را تأیید کنید:
نام میزبان مستأجر، حساب یا فضای کاری درست باشد.
URL callback دقیقاً در پیکربندی ارائهدهنده کپی شده باشد.
شناسهٔ کلاینت OAuth و رمز محرمانهٔ کلاینت درست باشند.
محدودههای درخواستشده با آنچه اپ OAuth ارائهدهنده اجازه میدهد مطابقت داشته باشد.
یک پیشنویس ایجاد شده باشد.
پیشنویس منتشر شده باشد.
دسترسی نقش به کاربر آزمایشی اجازه دهد اپ را ببیند.
مجوزهای سمت ارائهدهنده، داده یا اقدامی را که آزمایش میشود مجاز کند.
نکات امنیتی
رمزهای محرمانهٔ کلاینت OAuth و اعتبارنامههای ارائهدهنده را اطلاعات حساس تلقی کنید.
پیش از ایجاد پیشنویس، محدودههای درخواستشده را بررسی کنید.
پس از انتشار، از کنترل اقدام استفاده کنید تا کارهایی را که اپ میتواند انجام دهد محدود کنید.
از مجوزهای اپ استفاده کنید تا تعیین کنید ChatGPT چه زمانی پیش از استفاده از اپ از اعضا سؤال کند.
توجه داشته باشید که پس از فعال شدن اپ در ChatGPT، مجوزهای ارائهدهنده همچنان اعمال میشوند.