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