Огляд
Шаблони застосунків — це спосіб налаштування для керованих робочих просторів, яким потрібна власна версія застосунку або конектора ChatGPT. Адміністратори й власники робочих просторів можуть знайти шаблони в доступному розділі адміністрування Застосунки або Плагіни, додати налаштування для своєї організації та створити чернетку застосунку для перевірки. Шаблони керованих застосунків не відображаються в особистих робочих просторах.
Шаблони корисні, коли OpenAI може забезпечити спільну логіку роботи застосунку, але для кожного робочого простору потрібно вказати налаштування конкретного постачальника. Залежно від шаблону ці налаштування можуть містити ім’я орендаря або хоста, облікові дані клієнта OAuth, URL-адреси зворотного виклику, області доступу, параметри вебхуків, URL-адреси керованих серверів MCP або інші параметри постачальника. Наприклад, шаблон GitHub Enterprise може створити конектор для конкретного робочого простору, який Codex використовуватиме для доступу до хоста GitHub Enterprise цієї організації.
Після налаштування учасники не використовують вихідний шаблон. Вони використовують створений із нього й опублікований застосунок робочого простору. Адміністратори можуть керувати цим застосунком так само, як іншими застосунками ChatGPT. У ChatGPT Business власники й адміністратори вмикають або вимикають застосунок для робочого простору. У ChatGPT Enterprise/Edu власники й адміністратори можуть використовувати доступ до застосунків на основі ролей, якщо він підтримується. Адміністратори також можуть керувати налаштуваннями дій, дозволами застосунків і авторизацією в постачальника.
Плагіни можуть містити шаблони застосунків або застосунки, створені із шаблонів. Якщо плагін містить шаблон застосунку, адміністратор або власник робочого простору має створити й опублікувати застосунок для цього простору. Лише після цього учасники зможуть підключити його в 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 Business увімкніть або вимкніть застосунок для робочого простору. У ChatGPT Enterprise/Edu налаштуйте Доступ за ролями для ролей, які мають використовувати застосунок, якщо доступ до застосунків на основі ролей підтримується.
Перевірте дії читання й запису в розділі Дії.
Перегляньте Дозволи застосунку, щоб вибрати, коли ChatGPT має запитувати згоду учасників перед використанням застосунку.
Попросіть тестового користувача з відповідними правами доступу перейти до доступного розділу Застосунки або Плагіни й перевірити, чи відображається опублікований застосунок.
Якщо застосунок вимагає автентифікації в постачальника, попросіть тестового користувача підключити свій обліковий запис постачальника.
Виконайте тестовий запит із низьким рівнем ризику, щоб переконатися, що застосунок працює належним чином.
Ці дозволи застосовуються до розмов у ChatGPT. Для агентів робочого простору діють окремі налаштування, які визначає автор агента. Докладніше див. у статті Агенти робочого простору ChatGPT для Enterprise і Business.
Якщо шаблон можна використати лише один раз
Деякі шаблони дають змогу створити лише один застосунок у кожному робочому просторі. Якщо шаблон уже використано, кнопка «Увімкнути» може бути недоступною. У такому разі керуйте наявною чернеткою або опублікованим застосунком, а не створюйте ще один із того самого шаблону.
Що бачать учасники
Учасники бачать опублікований застосунок, створений із шаблону. Чи може учасник бачити або використовувати його, залежить від налаштувань робочого простору й авторизації в постачальника. Якщо застосунок входить до складу плагіна, учасники можуть знайти його через цей плагін, але вимоги щодо доступу в робочому просторі й авторизації в постачальника залишаються тими самими.
Якщо для роботи плагіна потрібен застосунок, створений із шаблону, плагін може показувати повідомлення про необхідність налаштування. Воно відображатиметься, доки адміністратор не створить і не опублікує застосунок для конкретного робочого простору, не ввімкне його для цього простору в ChatGPT Business або для відповідної ролі в ChatGPT Enterprise/Edu, де підтримується доступ до застосунків на основі ролей, а користувач або адміністратор не пройде всю необхідну авторизацію в постачальника.
Перевірте, чи виконано наведені нижче умови:
Застосунок опубліковано.
Застосунок увімкнено для робочого простору.
У ChatGPT Enterprise/Edu роль учасника в робочому просторі надає доступ до застосунку, якщо підтримується доступ на основі ролей.
Учасник перебуває в потрібному робочому просторі.
Учасник має необхідні дозволи в зовнішнього постачальника.
Опубліковані застосунки відображаються в доступному розділі налаштувань робочого простору — Застосунки або Плагіни. Якщо застосунок входить до складу плагіна, він також може відображатися на сторінці відомостей про плагін як обов’язковий або необов’язковий застосунок.
Усунення проблем із шаблонами застосунків
Якщо не вдається завершити налаштування або застосунок не відображається, перевірте наведене нижче:
Ім’я хоста орендаря, облікового запису або робочого простору вказано правильно.
URL-адресу зворотного виклику скопійовано в налаштування постачальника без змін.
Ідентифікатор і секрет клієнта OAuth правильні.
Запитувані області доступу відповідають дозволам застосунку OAuth на боці постачальника.
Чернетку створено.
Чернетку опубліковано.
У ChatGPT Business застосунок увімкнено для робочого простору. У ChatGPT Enterprise/Edu доступ за ролями дозволяє тестовому користувачу бачити застосунок, якщо доступ до застосунків на основі ролей підтримується.
Дозволи на боці постачальника дають змогу отримати доступ до даних або виконати дію, що перевіряється.
Перевірка вимог безпеки
Поводьтеся із секретами клієнтів OAuth та обліковими даними постачальника як із конфіденційною інформацією.
Перевірте запитувані області доступу, перш ніж створювати чернетку.
Після публікації скористайтеся розділом Дії, щоб обмежити можливості застосунку.
У розділі Дозволи застосунку визначте, коли ChatGPT має запитувати згоду учасників перед використанням застосунку.
Зверніть увагу: дозволи постачальника залишаються чинними й після ввімкнення застосунку в ChatGPT.