Обзор

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

• Запрошенные области доступа.

• Сведения о настройке вебхука.

Внимательно проверьте каждое поле перед созданием черновика. Если ваша организация централизованно управляет OAuth или учетными данными провайдера, согласуйте действия с командой, отвечающей за эти учетные данные.

См. инструкции для отдельных приложений:GitHub,Snowflake иDatabricks.

Настройка клиента OAuth

Некоторые шаблоны требуют, чтобы организация использовала собственный клиент OAuth. Если это требуется, создайте или настройте OAuth-приложение в консоли администратора внешнего провайдера, а затем скопируйте URL обратного вызова из ChatGPT в настройки URL перенаправления или обратного вызова у провайдера.

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

Если шаблон включает области доступа по умолчанию, сохраните их, если только ваша организация не проверила разрешения провайдера и не имеет ясной причины изменить их.

Создание черновика

После ввода необходимой информации выберите Создать черновик.

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

Публикация и управление созданным приложением

После публикации управляйте приложением для конкретной рабочей области из раздела Настройки рабочей области > Приложения > Включено.

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

• Убедитесь, что приложение отображается в разделе Включенные приложения.

• Настройте Доступ пользователей для ролей, которые должны использовать приложение.

• Проверьте Управление действиями для действий чтения и записи.

• Проверьте Разрешения приложения, чтобы выбрать, когда ChatGPT будет спрашивать участников перед использованием приложения.

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

• Если приложению требуется аутентификация у провайдера, попросите тестового пользователя подключить свою учетную запись у провайдера.

• Запустите тестовый промпт с низким риском, чтобы убедиться, что приложение работает должным образом.

Эти разрешения приложения применяются к беседам ChatGPT. Агенты рабочей области используют отдельные настройки для каждого агента, заданные создателем агента, чтобы определить, какие действия приложения доступны и когда конечным пользователям нужно подтвердить их выполнение. О поведении агентов см.:Агенты ChatGPT Workspace для Enterprise и Business.

Если шаблон можно использовать только один раз

Некоторые шаблоны могут создавать только одно приложение на рабочую область. Если шаблон уже использовался, кнопка Включить может быть недоступна. В этом случае управляйте существующим черновиком или опубликованным приложением вместо того, чтобы создавать еще одно приложение из того же шаблона.

Что видят участники

Участники видят опубликованное приложение, созданное из шаблона. Сможет ли участник увидеть или использовать его, зависит от настроек рабочей области и авторизации у провайдера. Если приложение входит в состав плагина, участники могут столкнуться с ним через этот плагин, но требования к доступу в рабочей области и авторизации у провайдера остаются теми же.

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

Проверьте следующее:

• Приложение опубликовано.

• Приложение включено для рабочей области.

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

• Участник находится в правильной рабочей области.

• У участника есть необходимые разрешения во внешнем провайдере.

Опубликованные приложения отображаются в разделе Настройки рабочей области > Приложения > Включено. Если приложение входит в состав плагина, оно также может отображаться как обязательное или необязательное приложение на странице сведений о плагине.

Устранение неполадок

Если настройка не удалась или приложение не отображается, проверьте следующее:

• Имя хоста арендатора, учетной записи или рабочей области указано правильно.

• URL обратного вызова скопирован в конфигурацию провайдера без изменений.

• Идентификатор клиента OAuth и секрет клиента указаны правильно.

• Запрошенные области доступа соответствуют тому, что разрешает OAuth-приложение провайдера.

• Черновик создан.

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

• Доступ по ролям позволяет тестовому пользователю видеть приложение.

• Разрешения на стороне провайдера позволяют работать с проверяемыми данными или выполнять проверяемое действие.

Примечания по безопасности

• Секреты клиентов OAuth и учетные данные провайдера следует считать конфиденциальной информацией.

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

• После публикации используйте Управление действиями, чтобы ограничить возможности приложения.

• Используйте Разрешения приложения, чтобы определить, когда ChatGPT должен спрашивать участников перед использованием приложения.

• Обратите внимание, что разрешения провайдера продолжают действовать после включения приложения в ChatGPT.