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