Обзор
Шаблоны приложений позволяют настроить приложение или коннектор ChatGPT под конкретную управляемую рабочую область. Администраторы и владельцы рабочих областей могут найти шаблоны в доступном административном разделе Приложения или Плагины, указать настройки своей организации и создать черновик приложения для проверки. Шаблоны для управляемых приложений не отображаются в личных рабочих областях.
Шаблоны полезны, когда 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 разрешения провайдера продолжают действовать.