Огляд
Шаблони застосунків — це спосіб налаштування для керованих робочих просторів, яким потрібна окрема версія застосунку або конектора ChatGPT для певного робочого простору. Адміністратори та власники робочого простору можуть знайти шаблони в доступному інтерфейсі адміністрування Застосунків або Плагінів, додати конфігурацію своєї організації та створити чернетку застосунку для перевірки. Шаблони керованих застосунків не відображаються в особистих робочих просторах.
Шаблони корисні, коли OpenAI може забезпечити спільну логіку роботи застосунку, але кожен робочий простір має надати конфігурацію для конкретного постачальника. Залежно від шаблону ця конфігурація може містити ім’я клієнта або хоста, облікові дані клієнта OAuth, URL-адреси зворотного виклику, області доступу, дані вебхуків, URL-адреси керованих серверів MCP або інші налаштування постачальника. Наприклад, шаблон GitHub Enterprise може створити конектор для певного робочого простору, який Codex використовуватиме для доступу до хоста GitHub Enterprise цієї організації.
Після налаштування учасники не використовують початковий шаблон. Вони використовують створений із нього опублікований застосунок робочого простору. Після цього адміністратори можуть керувати застосунком так само, як іншими застосунками ChatGPT, зокрема налаштовувати доступ за ролями, керування діями, дозволи застосунку й авторизацію в постачальника.
Плагіни можуть містити шаблони застосунків або застосунки, створені з шаблонів. Якщо плагін містить шаблон застосунку, адміністратор або власник робочого простору має створити й опублікувати застосунок для цього робочого простору, перш ніж учасники зможуть підключити його в ChatGPT або використовувати через плагін. Плагін використовує екземпляр застосунку, доступний у цьому робочому просторі; учасники не налаштовують початковий шаблон.
У цій статті описано загальний процес роботи із шаблоном. Інструкції з налаштування для конкретних постачальників:
Поширені причини використовувати шаблон:
URL-адреса постачальника містить ім’я хоста клієнта, облікового запису, організації або робочого простору компанії.
Організація має використовувати власний клієнт OAuth або облікові дані постачальника.
Постачальник вимагає налаштувати URL-адресу зворотного виклику окремо для кожного клієнта.
Застосунок має використовувати ту саму схему реалізації, а кожен робочий простір — окремо керувати доступом, діями й налаштуваннями безпеки.
Чим шаблони відрізняються від звичайних застосунків
Звичайний застосунок зазвичай можна ввімкнути безпосередньо. Натомість шаблон запускає процес налаштування адміністратором робочого простору.
Звичайний процес:
Залежно від доступного інтерфейсу адміністратор знаходить шаблон в інтерфейсі адміністрування Застосунків або Плагінів робочого простору.
Адміністратор вводить необхідну конфігурацію для робочого простору.
ChatGPT створює чернетку застосунку для робочого простору.
Адміністратор перевіряє та публікує чернетку.
Адміністратор налаштовує доступ і параметри дій для опублікованого застосунку.
Учасники використовують опублікований застосунок робочого простору, а не початковий шаблон.
Пошук і налаштування шаблону застосунку
Наведені нижче процедури стосуються інтерфейсу адміністрування Застосунків. Якщо у вашому робочому просторі використовується розділ Адміністрування > Плагіни, відкрийте відповідний плагін або шаблон і виконайте запропоновані кроки налаштування. Докладніше про навігацію робочим простором див. у статті Керування адміністратором, безпека й відповідність вимогам для плагінів і застосунків.
Перейдіть до розділу Налаштування робочого простору > Застосунки.
Виберіть Каталог.
Знайдіть назву постачальника або застосунку.
Знайдіть елементи, позначені як шаблони.
Виберіть Увімкнути, щоб розпочати налаштування.
Під час налаштування потрібно вказати дані, необхідні для створення застосунку для цього робочого простору. Точний перелік полів залежить від шаблону.
Наприклад, шаблон GitHub Enterprise може запитувати такі дані:
Назва й опис застосунку.
Ім’я хоста GitHub Enterprise.
Конфігурація URL-адреси зворотного виклику.
Ідентифікатор і секрет клієнта OAuth.
Закритий ключ GitHub App.
Запитувані області доступу.
Дані для налаштування вебхука.
Уважно перевірте кожне поле, перш ніж створювати чернетку. Якщо ваша організація централізовано керує OAuth або обліковими даними постачальника, узгодьте дії з командою, яка відповідає за ці дані.
Інструкції з налаштування для конкретних постачальників: GitHub Enterprise, Snowflake і Databricks.
Налаштування клієнта OAuth
Для деяких шаблонів організація має використовувати власний клієнт OAuth. Якщо це необхідно, створіть або налаштуйте застосунок OAuth у консолі адміністрування зовнішнього постачальника, а потім скопіюйте URL-адресу зворотного виклику з ChatGPT у налаштування URL-адреси переспрямування або зворотного виклику постачальника.
Вводьте ідентифікатор і секрет клієнта OAuth у ChatGPT лише після того, як переконаєтеся, що конфігурація постачальника відповідає інструкціям із налаштування шаблону.
Якщо шаблон містить стандартні області доступу, не змінюйте їх, якщо ваша організація не перевірила дозволи постачальника й не має чіткої причини для змін.
Створення чернетки
Після введення необхідних даних виберіть Створити чернетку.
Створення чернетки не робить застосунок автоматично доступним для учасників. Перевірте й опублікуйте чернетку, а також налаштуйте доступ і параметри дій, перш ніж просити учасників використовувати застосунок.
Публікація та керування створеним застосунком
Після публікації керуйте застосунком для цього робочого простору в доступних налаштуваннях робочого простору Застосунки або Плагіни.
Рекомендовані перевірки після публікації:
Переконайтеся, що застосунок відображається в розділі Увімкнені застосунки.
Налаштуйте Доступ за ролями для ролей, які мають використовувати застосунок.
Перевірте в розділі Дії дії читання й запису.
Перевірте Дозволи застосунку, щоб визначити, коли ChatGPT має запитувати згоду учасників перед використанням застосунку.
Попросіть авторизованого тестового користувача перейти до доступного розділу Застосунки або Плагіни й переконатися, що опублікований застосунок відображається.
Якщо застосунок вимагає автентифікації в постачальника, попросіть тестового користувача підключити свій обліковий запис постачальника.
Виконайте тестовий запит із низьким рівнем ризику, щоб переконатися, що застосунок працює належним чином.
Ці дозволи застосовуються до розмов у ChatGPT. Агенти робочого простору використовують окремі елементи керування, визначені розробником агента. Докладніше див. у статті Агенти робочого простору ChatGPT для Enterprise і Business.
Якщо шаблон можна використати лише один раз
Деякі шаблони можуть створювати лише один застосунок у кожному робочому просторі. Якщо шаблон уже використано, кнопка «Увімкнути» може бути недоступною. У такому разі керуйте наявною чернеткою або опублікованим застосунком, а не створюйте ще один із того самого шаблону.
Що бачать учасники
Учасники бачать опублікований застосунок, створений із шаблону. Можливість учасника бачити або використовувати його залежить від налаштувань робочого простору й авторизації в постачальника. Якщо застосунок входить до плагіна, учасники можуть отримати до нього доступ через цей плагін, але вимоги щодо доступу до робочого простору й авторизації в постачальника залишаються чинними.
Якщо для плагіна потрібен застосунок, створений із шаблону, плагін може повідомляти про необхідність налаштування, доки адміністратор не створить і не опублікує застосунок для цього робочого простору, не ввімкне його для відповідної ролі та не буде завершено всю необхідну авторизацію користувача або адміністратора в постачальника.
Перевірте, що:
Застосунок опубліковано.
Застосунок увімкнено для робочого простору.
Роль учасника в робочому просторі має доступ.
Учасник перебуває в потрібному робочому просторі.
Учасник має необхідні дозволи в зовнішнього постачальника.
Опубліковані застосунки відображаються в доступних налаштуваннях робочого простору Застосунки або Плагіни. Якщо застосунок входить до плагіна, він також може відображатися як обов’язковий або необов’язковий застосунок на сторінці відомостей про плагін.
Усунення проблем із шаблонами застосунків
Якщо налаштування не вдалося або застосунок не відображається, перевірте таке:
Ім’я хоста клієнта, облікового запису або робочого простору вказано правильно.
URL-адресу зворотного виклику точно скопійовано до конфігурації постачальника.
Ідентифікатор і секрет клієнта OAuth указано правильно.
Запитувані області доступу відповідають дозволам застосунку OAuth постачальника.
Чернетку створено.
Чернетку опубліковано.
Налаштування доступу за ролями дають тестовому користувачеві змогу бачити застосунок.
Дозволи на боці постачальника дають змогу працювати з даними або виконувати дію, що тестується.
Перевірка вимог безпеки
Вважайте секрети клієнта OAuth та облікові дані постачальника конфіденційною інформацією.
Перевірте запитувані області доступу, перш ніж створювати чернетку.
Після публікації використовуйте розділ Дії, щоб обмежити можливості застосунку.
У розділі Дозволи застосунку визначте, коли ChatGPT має запитувати згоду учасників перед використанням застосунку.
Зверніть увагу: дозволи постачальника продовжують діяти після ввімкнення застосунку в ChatGPT.