OpenAI
页面内容为机器翻译。查看英文原文

ChatGPT 应用模板

了解工作空间管理员和所有者如何将应用模板转化为其组织的工作空间专属应用。

更新于:7 days ago

概述

应用模板是一种设置路径,适用于需要 ChatGPT 应用或连接器的工作空间专属版本的 Business 和 Enterprise 工作空间。工作空间管理员或所有者无需从目录中启用一个共享应用,而是从 OpenAI 提供的模板开始,添加其组织特有的详细信息,并创建一个草稿应用以供审核。

当 OpenAI 可以提供通用应用行为,但每个工作空间都必须提供特定于提供商的配置时,模板会很有用。根据模板不同,该配置可以包括租户或主机名、OAuth 客户端凭据、回调 URL、范围、Webhook 详细信息、托管 MCP 服务器 URL 或其他提供商设置。例如,GitHub Enterprise 模板可能会创建工作空间专属连接器,供 Codex 访问该组织的 GitHub Enterprise 主机。

设置完成后,成员不会使用原始模板。他们会使用由该模板创建的已发布工作空间应用。然后,管理员可以像管理其他 ChatGPT 应用一样管理该应用,包括角色访问权限、操作控制、应用权限和提供商授权。


Codex 插件也可以包含应用模板或从模板创建的应用。如果插件包含应用模板,工作空间管理员或所有者仍需先创建并发布工作空间专属应用,成员才能在 ChatGPT 中连接它并通过该插件使用它。插件运行时,会使用该工作空间中可用的应用实例,而不是要求成员自行配置原始模板。如果所需模板尚未设置,成员可能需要管理员先完成设置。插件本身无法使用应用模板。

请使用本文了解一般模板流程。有关特定于提供商的设置,请参阅:

当同一种应用模式可以适用于许多组织,但每个组织都需要自己的配置时,模板会很有用。

常见示例包括:

  • 提供商 URL 包含公司租户、账号、组织或工作空间主机名。

  • 组织需要自带 OAuth 客户端或提供商凭据。

  • 提供商需要设置客户专属的回调 URL。

  • 应用应使用相同的实现模式,同时每个工作空间分别控制访问权限、操作和安全设置。

模板与常规应用有何不同

常规应用通常可以直接从应用目录启用。模板则会启动一个设置流程。

通常流程如下:

  1. 管理员在应用目录中找到模板。

  2. 管理员输入所需的工作空间专属配置。

  3. ChatGPT 为该工作空间创建一个草稿应用。

  4. 管理员审核并发布草稿。

  5. 管理员为已发布的应用配置访问权限和操作设置。

成员使用已发布的工作空间应用,而不是原始模板。

查找并设置应用模板

  1. 打开 工作空间设置 > 应用

  2. 选择 目录

  3. 搜索提供商或应用名称。

  4. 查找标记为模板的条目。

  5. 选择 启用 以启动设置流程。

设置流程会要求提供创建工作空间专属应用所需的详细信息。具体字段取决于模板。

例如,GitHub Enterprise 模板可能会要求提供以下详细信息:

  • 应用名称和描述。

  • GitHub Enterprise 主机名。

  • 回调 URL 配置。

  • OAuth 客户端 ID 和客户端密钥。

  • GitHub App 私钥。

  • 请求的范围。

  • Webhook 设置详细信息。

创建草稿前,请仔细检查每个字段。如果你的组织集中管理 OAuth 或提供商凭据,请与负责这些凭据的团队协调。

请参阅应用专属说明:GitHubSnowflakeDatabricks

OAuth 客户端设置

某些模板要求你的组织自带 OAuth 客户端。需要这样做时,请在外部提供商的管理控制台中创建或配置 OAuth 应用,然后将回调 URL 从 ChatGPT 复制到提供商的重定向或回调 URL 设置中。

请先确认提供商配置与模板设置说明一致,然后再在 ChatGPT 中输入 OAuth 客户端 ID 和密钥。

如果模板包含默认范围,请保留默认值,除非你的组织已审核提供商权限并有明确理由更改它们。

创建草稿

输入所需信息后,选择 创建草稿

创建草稿不会自动使应用对成员可用。请先审核草稿、发布它,并配置访问权限和操作设置,然后再要求成员使用。

发布并管理生成的应用

发布后,可从 工作空间设置 > 应用 > 已启用 管理工作空间专属应用。

建议的发布后检查:

  1. 确认应用显示在 已启用的应用 中。

  2. 为应使用该应用的角色设置 用户访问权限

  3. 查看 操作控制 中的读取和写入操作。

  4. 查看 应用权限,选择 ChatGPT 何时在使用应用前询问成员。

  5. 请允许访问的测试用户在 ChatGPT 中打开“应用”,并确认该应用已显示。

  6. 如果应用需要提供商身份验证,请让测试用户连接其提供商账号。

  7. 运行低风险测试提示,确认应用按预期工作。

这些应用权限适用于 ChatGPT 对话。工作空间智能体使用智能体构建者设置的每个智能体控制项,来确定哪些应用操作可用,以及何时要求最终用户批准这些操作。有关智能体行为,请参阅:适用于 Enterprise 和 Business 的 ChatGPT 工作空间智能体

如果模板只能使用一次

某些模板可能每个工作空间只能创建一个应用。如果模板已被使用,启用 按钮可能不可用。在这种情况下,请管理现有草稿或已发布的应用,而不是从同一模板创建另一个应用。

成员看到的内容

成员会看到从模板创建的已发布应用。成员能否看到或使用它取决于工作空间设置和提供商授权。如果该应用包含在插件中,成员可能会通过该插件遇到它,但仍需满足相同的工作空间访问权限和提供商授权要求。

检查以下事项:

  • 应用已发布。

  • 应用已为该工作空间启用。

  • 成员的工作空间角色具有访问权限。

  • 成员位于正确的工作空间中。

  • 成员在外部提供商中拥有所需权限。

已发布的应用会显示在 ChatGPT 应用目录中工作空间专属的部分。

故障排除

如果设置失败或应用未显示,请确认以下事项:

  1. 租户、账号或工作空间主机名正确。

  2. 回调 URL 已准确复制到提供商配置中。

  3. OAuth 客户端 ID 和客户端密钥正确。

  4. 请求的范围与提供商 OAuth 应用允许的范围匹配。

  5. 已创建草稿。

  6. 草稿已发布。

  7. 角色访问权限允许测试用户看到该应用。

  8. 提供商端权限允许正在测试的数据或操作。

安全说明

  • 将 OAuth 客户端密钥和提供商凭据视为敏感信息。

  • 创建草稿前,请查看请求的范围。

  • 发布后,使用 操作控制 来限制应用可执行的操作。

  • 使用 应用权限 来决定 ChatGPT 何时在使用应用前询问成员。

  • 请注意,应用在 ChatGPT 中启用后,提供商权限仍然适用。

这篇文章对你有帮助吗?