Огляд

Шаблони застосунків — це спосіб налаштування для керованих робочих просторів, яким потрібна версія застосунку або конектора ChatGPT для конкретного робочого простору. Адміністратори й власники робочого простору знаходять шаблони в розділі Налаштування робочого простору > Застосунки > Каталог, додають конфігурацію для своєї організації та створюють чернетку застосунку для перевірки. Шаблони керованих застосунків не відображаються в особистих робочих просторах.

Шаблони корисні, коли OpenAI може надати спільну поведінку застосунку, але кожен робочий простір має надати конфігурацію для свого провайдера. Залежно від шаблону така конфігурація може включати клієнт або ім’я хоста, облікові дані клієнта OAuth, URL-адреси зворотного виклику, області доступу, відомості про вебхуки, URL-адреси керованих серверів MCP або інші налаштування провайдера. Наприклад, шаблон GitHub Enterprise може створити конектор для робочого простору, який Codex використовує для доступу до хоста GitHub Enterprise цієї організації.

Після налаштування учасники не використовують початковий шаблон. Вони використовують опублікований застосунок робочого простору, створений із нього. Після цього адміністратори можуть керувати цим застосунком як іншими застосунками ChatGPT, зокрема доступом за ролями, керуванням діями, дозволами застосунку та авторизацією провайдера.


Плагіни також можуть містити шаблони застосунків або застосунки, створені із шаблонів. Якщо плагін містить шаблон застосунку, адміністратор або власник робочого простору все одно має створити й опублікувати застосунок для цього робочого простору, перш ніж учасники зможуть підключити його в ChatGPT або використовувати через цей плагін. Коли плагін запускається, він використовує екземпляр застосунку, доступний у цьому робочому просторі, а не просить учасників самостійно налаштувати початковий шаблон. Якщо потрібний шаблон ще не налаштовано, учасникам може знадобитися, щоб адміністратор спершу завершив налаштування. Плагін не може використовувати шаблон застосунку сам по собі.

Використовуйте цю статтю для загального процесу роботи із шаблонами. Налаштування для окремих провайдерів див. тут:

• GitHub Enterprise

• Snowflake

• Databricks

Шаблони корисні, коли один і той самий шаблон застосунку може працювати в багатьох організаціях, але кожній організації потрібна власна конфігурація.

Поширені приклади:

• URL-адреса провайдера містить клієнт, обліковий запис, організацію або ім’я хоста робочого простору компанії.

• Організація має надати власний клієнт OAuth або облікові дані провайдера.

• Провайдер вимагає налаштування URL-адреси зворотного виклику для конкретного клієнта.

• Застосунок має використовувати той самий шаблон реалізації, а кожен робочий простір окремо керує доступом, діями та налаштуваннями безпеки.

Чим шаблони відрізняються відзвичайних застосунків

Звичайний застосунок зазвичай можна ввімкнути напряму. Натомість шаблон запускає процес налаштування для адміністратора робочого простору.

Зазвичай процес такий:

• Адміністратор знаходить шаблон у розділі Налаштування робочого простору > Застосунки > Каталог.

• Адміністратор вводить потрібну конфігурацію для конкретного робочого простору.

• ChatGPT створює чернетку застосунку для робочого простору.

• Адміністратор переглядає й публікує чернетку.

• Адміністратор налаштовує доступ і параметри дій для опублікованого застосунку.

Учасники використовують опублікований застосунок робочого простору, а не початковий шаблон.

Знайдіть і налаштуйте шаблон застосунку

• Відкрийте Налаштування робочого простору > Застосунки.

• Виберіть Каталог.

• Знайдіть провайдера або назву застосунку.

• Шукайте записи, позначені як шаблони.

• Виберіть Увімкнути, щоб почати процес налаштування.

Під час налаштування потрібно вказати дані, необхідні для створення застосунку для конкретного робочого простору. Точні поля залежать від шаблону.

Наприклад, шаблон GitHub Enterprise може запитувати такі дані:

• Назва й опис застосунку.

• Ім’я хоста GitHub Enterprise.

• Конфігурація URL-адреси зворотного виклику.

• Ідентифікатор клієнта OAuth і секрет клієнта.

• Приватний ключ застосунку GitHub.

• Запитані області доступу.

• Дані для налаштування вебхука.

Уважно перегляньте кожне поле перед створенням чернетки. Якщо ваша організація централізовано керує OAuth або обліковими даними провайдера, узгодьте це з командою, відповідальною за ці облікові дані.

Див. інструкції для окремих застосунків:GitHub,Snowflake іDatabricks.

Налаштування клієнта OAuth

Деякі шаблони вимагають, щоб ваша організація надала власний клієнт OAuth. Якщо це потрібно, створіть або налаштуйте застосунок OAuth в адміністративній консолі зовнішнього провайдера, а потім скопіюйте URL-адресу зворотного виклику з ChatGPT у налаштування URL-адреси перенаправлення або зворотного виклику провайдера.

Вводьте ідентифікатор і секрет клієнта OAuth у ChatGPT лише після того, як переконаєтеся, що конфігурація провайдера відповідає інструкціям із налаштування шаблону.

Якщо шаблон містить області доступу за замовчуванням, залиште їх, якщо ваша організація не переглянула дозволи провайдера й не має чіткої причини змінити їх.

Створення чернетки

Після введення потрібної інформації виберіть Створити чернетку.

Створення чернетки не робить застосунок автоматично доступним для учасників. Перегляньте чернетку, опублікуйте її та налаштуйте доступ і параметри дій, перш ніж просити учасників користуватися застосунком.

Публікація й керування отриманим застосунком

Після публікації керуйте застосунком для цього робочого простору в розділі Налаштування робочого простору > Застосунки > Увімкнено.

Рекомендовані перевірки після публікації:

• Переконайтеся, що застосунок відображається в розділі Увімкнені застосунки.

• Налаштуйте Доступ користувачів для ролей, які мають використовувати застосунок.

• Перегляньте Керування діями для дій читання й запису.

• Перегляньте Дозволи застосунку, щоб вибрати, коли ChatGPT має запитувати учасників перед використанням застосунку.

• Попросіть дозволеного тестового користувача відкрити Застосунки в ChatGPT і підтвердити, що застосунок відображається.

• Якщо застосунок потребує автентифікації в провайдера, попросіть тестового користувача підключити свій обліковий запис провайдера.

• Запустіть низькоризиковий тестовий запит, щоб підтвердити, що застосунок працює належним чином.

Ці дозволи застосунку застосовуються до розмов у ChatGPT. Агенти робочого простору використовують елементи керування для кожного агента, задані його розробником, щоб визначати, які дії застосунку доступні та коли кінцевих користувачів просять їх схвалити. Про поведінку агента див.:Агенти робочого простору ChatGPT для Enterprise і Business.

Якщо шаблон можна використати лише один раз

Деякі шаблони можуть створювати лише один застосунок на робочий простір. Якщо шаблон уже використано, кнопка Увімкнути може бути недоступною. У такому разі керуйте наявною чернеткою або опублікованим застосунком замість створювати ще один із того самого шаблону.

Що бачать учасники

Учасники бачать опублікований застосунок, створений із шаблону. Чи може учасник бачити або використовувати його, залежить від налаштувань робочого простору та авторизації провайдера. Якщо застосунок входить до складу плагіна, учасники можуть натрапити на нього через цей плагін, але ті самі вимоги до доступу в робочому просторі та авторизації провайдера все одно застосовуються.

Якщо плагіну потрібен застосунок, створений із шаблону, плагін може показувати, що потрібно налаштування, доки адміністратор не створить і не опублікує застосунок для цього робочого простору, не ввімкне його для відповідної ролі та не буде завершено всю необхідну авторизацію користувача або адміністратора в провайдера.

Перевірте, що:

• Застосунок опубліковано.

• Застосунок увімкнено для робочого простору.

• Роль учасника в робочому просторі має доступ.

• Учасник перебуває в правильному робочому просторі.

• Учасник має потрібні дозволи в зовнішнього провайдера.

Опубліковані застосунки відображаються в розділі Налаштування робочого простору > Застосунки > Увімкнено. Якщо застосунок є частиною плагіна, він також може відображатися на сторінці відомостей про плагін як обов’язковий або необов’язковий застосунок.

Усунення несправностей

Якщо налаштування не вдається або застосунок не відображається, перевірте таке:

• Ім’я хоста клієнта, облікового запису або робочого простору правильне.

• URL зворотного виклику точно скопійовано в конфігурацію провайдера.

• Ідентифікатор клієнта OAuth і секрет клієнта правильні.

• Запитані області доступу відповідають тому, що дозволяє застосунок OAuth провайдера.

• Чернетку створено.

• Чернетку опубліковано.

• Доступ за роллю дає тестовому користувачу змогу бачити застосунок.

• Дозволи на боці провайдера дають змогу виконувати перевірювану дію або працювати з перевірюваними даними.

Примітки щодо безпеки

• Розглядайте секрети клієнта OAuth і облікові дані провайдера як конфіденційну інформацію.

• Перегляньте запитані області доступу перед створенням чернетки.

• Після публікації використовуйте Керування діями, щоб обмежити можливості застосунку.

• Використовуйте Дозволи застосунку, щоб визначити, коли ChatGPT має запитувати учасників перед використанням застосунку.

• Зверніть увагу: дозволи провайдера й надалі застосовуються після ввімкнення застосунку в ChatGPT.