概述
应用模板是一种设置路径,适用于需要 ChatGPT 应用或连接器的工作空间专属版本的 Business 和 Enterprise 工作空间。工作空间管理员或所有者无需从目录中启用一个共享应用,而是从 OpenAI 提供的模板开始,添加其组织特有的详细信息,并创建一个草稿应用以供审核。
当 OpenAI 可以提供通用应用行为,但每个工作空间都必须提供特定于提供商的配置时,模板会很有用。根据模板不同,该配置可以包括租户或主机名、OAuth 客户端凭据、回调 URL、范围、Webhook 详细信息、托管 MCP 服务器 URL 或其他提供商设置。例如,GitHub Enterprise 模板可能会创建工作空间专属连接器,供 Codex 访问该组织的 GitHub Enterprise 主机。
设置完成后,成员不会使用原始模板。他们会使用由该模板创建的已发布工作空间应用。然后,管理员可以像管理其他 ChatGPT 应用一样管理该应用,包括角色访问权限、操作控制、应用权限和提供商授权。
Codex 插件也可以包含应用模板或从模板创建的应用。如果插件包含应用模板,工作空间管理员或所有者仍需先创建并发布工作空间专属应用,成员才能在 ChatGPT 中连接它并通过该插件使用它。插件运行时,会使用该工作空间中可用的应用实例,而不是要求成员自行配置原始模板。如果所需模板尚未设置,成员可能需要管理员先完成设置。插件本身无法使用应用模板。
请使用本文了解一般模板流程。有关特定于提供商的设置,请参阅:
当同一种应用模式可以适用于许多组织,但每个组织都需要自己的配置时,模板会很有用。
常见示例包括:
提供商 URL 包含公司租户、账号、组织或工作空间主机名。
组织需要自带 OAuth 客户端或提供商凭据。
提供商需要设置客户专属的回调 URL。
应用应使用相同的实现模式,同时每个工作空间分别控制访问权限、操作和安全设置。
模板与常规应用有何不同
常规应用通常可以直接从应用目录启用。模板则会启动一个设置流程。
通常流程如下:
管理员在应用目录中找到模板。
管理员输入所需的工作空间专属配置。
ChatGPT 为该工作空间创建一个草稿应用。
管理员审核并发布草稿。
管理员为已发布的应用配置访问权限和操作设置。
成员使用已发布的工作空间应用,而不是原始模板。
查找并设置应用模板
打开 工作空间设置 > 应用。
选择 目录。
搜索提供商或应用名称。
查找标记为模板的条目。
选择 启用 以启动设置流程。
设置流程会要求提供创建工作空间专属应用所需的详细信息。具体字段取决于模板。
例如,GitHub Enterprise 模板可能会要求提供以下详细信息:
应用名称和描述。
GitHub Enterprise 主机名。
回调 URL 配置。
OAuth 客户端 ID 和客户端密钥。
GitHub App 私钥。
请求的范围。
Webhook 设置详细信息。
创建草稿前,请仔细检查每个字段。如果你的组织集中管理 OAuth 或提供商凭据,请与负责这些凭据的团队协调。
请参阅应用专属说明:GitHub、Snowflake 和 Databricks。
OAuth 客户端设置
某些模板要求你的组织自带 OAuth 客户端。需要这样做时,请在外部提供商的管理控制台中创建或配置 OAuth 应用,然后将回调 URL 从 ChatGPT 复制到提供商的重定向或回调 URL 设置中。
请先确认提供商配置与模板设置说明一致,然后再在 ChatGPT 中输入 OAuth 客户端 ID 和密钥。
如果模板包含默认范围,请保留默认值,除非你的组织已审核提供商权限并有明确理由更改它们。
创建草稿
输入所需信息后,选择 创建草稿。
创建草稿不会自动使应用对成员可用。请先审核草稿、发布它,并配置访问权限和操作设置,然后再要求成员使用。
发布并管理生成的应用
发布后,可从 工作空间设置 > 应用 > 已启用 管理工作空间专属应用。
建议的发布后检查:
确认应用显示在 已启用的应用 中。
为应使用该应用的角色设置 用户访问权限。
查看 操作控制 中的读取和写入操作。
查看 应用权限,选择 ChatGPT 何时在使用应用前询问成员。
请允许访问的测试用户在 ChatGPT 中打开“应用”,并确认该应用已显示。
如果应用需要提供商身份验证,请让测试用户连接其提供商账号。
运行低风险测试提示,确认应用按预期工作。
这些应用权限适用于 ChatGPT 对话。工作空间智能体使用智能体构建者设置的每个智能体控制项,来确定哪些应用操作可用,以及何时要求最终用户批准这些操作。有关智能体行为,请参阅:适用于 Enterprise 和 Business 的 ChatGPT 工作空间智能体。
如果模板只能使用一次
某些模板可能每个工作空间只能创建一个应用。如果模板已被使用,启用 按钮可能不可用。在这种情况下,请管理现有草稿或已发布的应用,而不是从同一模板创建另一个应用。
成员看到的内容
成员会看到从模板创建的已发布应用。成员能否看到或使用它取决于工作空间设置和提供商授权。如果该应用包含在插件中,成员可能会通过该插件遇到它,但仍需满足相同的工作空间访问权限和提供商授权要求。
检查以下事项:
应用已发布。
应用已为该工作空间启用。
成员的工作空间角色具有访问权限。
成员位于正确的工作空间中。
成员在外部提供商中拥有所需权限。
已发布的应用会显示在 ChatGPT 应用目录中工作空间专属的部分。
故障排除
如果设置失败或应用未显示,请确认以下事项:
租户、账号或工作空间主机名正确。
回调 URL 已准确复制到提供商配置中。
OAuth 客户端 ID 和客户端密钥正确。
请求的范围与提供商 OAuth 应用允许的范围匹配。
已创建草稿。
草稿已发布。
角色访问权限允许测试用户看到该应用。
提供商端权限允许正在测试的数据或操作。
安全说明
将 OAuth 客户端密钥和提供商凭据视为敏感信息。
创建草稿前,请查看请求的范围。
发布后,使用 操作控制 来限制应用可执行的操作。
使用 应用权限 来决定 ChatGPT 何时在使用应用前询问成员。
请注意,应用在 ChatGPT 中启用后,提供商权限仍然适用。
