Обзор
Шаблоны позволяют настроить приложение ChatGPT для вашего аккаунта или рабочей области.
Управляемые рабочие области: администраторы и владельцы могут:
Перейти в Консоль администратора, выбрать нужную рабочую область ChatGPT и открыть раздел Плагины.
Использовать раздел Управление устаревшими приложениями для поддерживаемых сценариев работы с устаревшими шаблонами.
Указать настройки для своей организации и создать черновик приложения для проверки.
Личные аккаунты: пользователи Plus и Pro могут настроить Databricks и Snowflake в разделе Настройки > Плагины.
Шаблоны полезны, когда OpenAI может предоставить общую логику работы приложения, но для каждой рабочей области нужно указать собственные настройки подключения к поставщику. В зависимости от шаблона эти настройки могут включать имя тенанта или хоста, учетные данные клиента OAuth, URL обратного вызова, области доступа, параметры вебхуков, URL управляемых MCP-серверов или другие параметры поставщика. Например, шаблон GitHub Enterprise может создать приложение для конкретной рабочей области, через которое Codex подключается к хосту GitHub Enterprise этой организации.
После настройки участники не используют исходный шаблон. Они используют опубликованное приложение рабочей области, созданное на его основе. Администраторы могут управлять этим приложением так же, как и другими приложениями ChatGPT. В ChatGPT Business владельцы и администраторы включают или отключают приложение для рабочей области. В ChatGPT Enterprise/Edu владельцы и администраторы могут использовать поддерживаемые настройки доступа к приложениям на основе ролей. Администраторы также могут управлять ограничениями на действия, разрешениями приложений и авторизацией у поставщика.
Плагины могут включать шаблоны приложений или приложения, созданные на основе шаблонов.
При настройке для рабочей области администратор или владелец должен создать и опубликовать приложение, прежде чем участники смогут подключить его в ChatGPT или использовать через плагин. Плагин использует это опубликованное приложение рабочей области; участникам не нужно самостоятельно настраивать шаблон.
В этой статье описан общий порядок работы с шаблонами. Инструкции по настройке для конкретных поставщиков см. здесь:
Вот распространенные случаи, когда стоит использовать шаблон:
URL поставщика содержит имя хоста тенанта компании, аккаунта, организации или рабочей области.
Организации нужно использовать собственный клиент OAuth или свои учетные данные для доступа к поставщику.
Поставщик требует отдельной настройки URL обратного вызова для каждого клиента.
Приложение должно использовать единый подход к реализации, при этом доступ, действия и параметры безопасности настраиваются отдельно в каждой рабочей области.
Чем шаблоны отличаются от обычных приложений
Обычные приложения, как правило, можно включить сразу. При использовании шаблона в управляемой рабочей области администратор должен сначала создать приложение для этой рабочей области.
Обычно процесс выглядит так:
Администратор находит шаблон в разделе Приложения или Плагины панели администратора рабочей области — в зависимости от доступного интерфейса.
Администратор указывает необходимые настройки для рабочей области.
ChatGPT создает черновик приложения для рабочей области.
Администратор проверяет и публикует черновик.
Администратор настраивает доступ и параметры действий для опубликованного приложения.
Участники используют опубликованное приложение рабочей области, а не исходный шаблон.
Поиск и настройка шаблона приложения
Приведенные ниже инструкции относятся к административному разделу Приложения. Если нужный плагин или шаблон можно настроить в разделе Плагины в консоли администратора, выполните настройку там. Для выполнения приведенных ниже инструкций используйте прежний интерфейс Приложения, который по-прежнему доступен. О навигации по рабочей области и инструментах администратора для разных тарифов см. статью Управление, безопасность и соблюдение требований для плагинов и приложений.
Перейдите в раздел «Настройки рабочей области» > «Приложения». Вы также можете перейти в консоль администратора, выбрать нужную рабочую область 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 разрешения провайдера продолжают действовать.