Обзор
Шаблоны приложений — это способ настройки для рабочих областей 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.