通过工作空间连接,符合条件的团队任务或 @ChatGPT 界面可以使用由公司管理的应用账号,无需每位参与者各自连接个人账号。
如需了解背景,请参阅插件权限和数据共享的工作原理。
工作空间管理员负责授权受支持的应用账号、管理已保存的连接,并控制谁可以找到和使用这些连接。每个账号可以访问哪些数据、执行哪些操作,由服务提供方控制。
有关账号授权,请参阅连接和管理应用账号。有关定期执行的工作,请参阅在 ChatGPT 中创建和管理团队任务。
工作原理
如果 @ChatGPT 或团队任务需要使用由公司管理的账号,请使用工作空间连接。管理员审批访问权限,团队所有者可在权限允许时选择可用的连接。符合条件的多个团队和工作流可以重复使用同一连接。
通过连接,应用可以使用指定账号完成身份验证。
设置连接
开始之前
确认您的工作空间支持所需的应用和身份验证方式,然后明确以下职责:
工作空间管理员:具有插件管理权限的工作空间所有者或管理员负责创建连接并完成授权,同时配置谁可以找到、使用和管理该连接。
服务提供方管理员:负责开设账号并批准对源服务的访问。对于 Notion 和 Linear,请让相应服务的管理员参与设置。管理员使用的账号可能与连接进行身份验证时使用的账号不同。
各服务提供方的要求有所不同。Gmail 可能需要单独的用户账号,云端硬盘的访问权限必须在 Google 中配置,GitHub 在本次发布时使用用户账号登录。
连接账号:使用经批准的账号或服务身份,仅授予访问所需资源的权限。请采用受支持的身份验证方式,避免依赖员工的个人账号。请参阅在 ChatGPT 中连接和管理应用账号。
连接所有者:负责确保授权持续有效、协调权限变更,并在无法访问时恢复访问。共享连接前,请检查可访问的资源范围、读写权限以及撤销授权的方式。
团队或工作流所有者:与管理员确认所需的资源和操作,然后在任务或 @ChatGPT 界面中选择并测试连接。
创建工作空间连接
-
在管理控制台中选择工作空间,打开“工作空间连接”>“+”,然后选择应用。
-
按照应用针对所提供身份验证方式给出的说明操作。如果出现提示,请启用应用的实时访问功能。
-
验证指定账号的身份,或完成应用安装。核实所用账号或应用安装实例,并检查请求的权限。
-
为保存的连接设置一个能说明其访问权限的昵称,例如“项目报告:读取权限”。
-
向经批准的用户、团队或服务账号授予访问权限。分别检查使用权限和管理权限,然后交由团队或工作流所有者选择并测试该连接。
设置各个应用
使用应用提供的身份验证方式,然后配置访问权限,并在将使用该连接的工作流中进行测试。
Google 云端硬盘
授权账号
使用经批准且有权访问所需文件或共享云端硬盘的 Google 账号。
-
选择使用 Google 登录,选中要连接的账号,并在批准前检查请求的访问权限。
-
确认 Google 账号,然后在 ChatGPT 中为连接命名。如果工作流会创建文件,请测试文件的保存位置,并确认接收者能够访问文件。
使用服务账号
如果可以直接使用服务账号进行身份验证,请准备经批准的 Google Cloud 服务账号及其 JSON 密钥。这种方式使用服务账号自身的资源访问权限,不使用全域委派。
-
向服务账号的电子邮件地址授予访问所需文件、文件夹或共享云端硬盘的权限。请分别检查读取权限和写入权限。
-
在受保护的凭据字段中输入完整的 JSON 密钥。请勿在截图或发给支持团队的消息中包含密钥。
-
保存连接,然后尝试读取已共享给服务账号的文件。
请在共享云端硬盘中创建文件。服务账号需要对该云端硬盘拥有写入权限。服务账号无法成为个人“我的云端硬盘”中文件的所有者。
如果找不到文件,请检查文件是否已共享给服务账号的电子邮件地址,以及 ChatGPT 允许该应用执行哪些操作。共享文件夹不会授予对整个 Google Workspace 网域的访问权限。
如果云端硬盘提供全域委派,请按照下文的委派访问步骤操作。
Gmail
授权邮箱
如果提供 OAuth,请授权指定的 Gmail 邮箱。如果工作流需要专用邮箱,请向 IT 部门申请单独的用户账号。
-
选择使用 Google 登录,选中邮箱,并在批准前检查请求的访问权限。
-
检查已保存的连接,并读取一封获准用于测试的邮件。如果需要发送邮件,请向获准的接收者发送测试邮件,然后核实发件人及实际送达的邮件内容。
Google 群组不是邮箱。已连接的邮箱如果订阅了某个群组,就可以接收该群组的邮件,但通过该连接也可能访问到邮箱中的其他邮件。共享连接前,请检查邮箱内容和允许执行的操作。
设置全域委派
使用委派时,必须验证发起请求的员工身份,并使用该员工委派的 Google 权限。在无人值守的情况下运行工作流前,请确认所用功能能够验证请求者的身份。使用服务账号直接访问云端硬盘采用不同的机制。
仅在提供委派选项时使用此方式。您需要获得 Google Workspace 超级管理员的批准,并准备经批准的 Google Cloud 服务账号、该账号的数字 OAuth 客户端 ID 以及完整的 JSON 密钥。
-
选择应用和操作,获取其所需的确切授权范围,并请 Google Workspace 管理员批准这些范围。
-
在 Google 管理控制台中,打开安全性 > 访问权限和数据控制 > API 控件 > 管理全域委派。为数字客户端 ID 授予已批准范围内的权限,并核实保存的授权记录。
-
在 ChatGPT 中输入 JSON 密钥,并确保他人无法看到。请在实际使用该连接的功能中测试,使用已验证的请求者身份访问其有权访问的资源。
如果请求遭拒,请检查请求者身份、已批准的授权范围以及资源访问权限。请勿仅为消除报错而扩大授权范围。
GitHub
授权用户账号
使用经组织批准且有权访问所需代码仓库的 GitHub 用户账号,最好为此连接使用专用账号。
本次发布暂不支持使用 GitHub 应用登录。
-
选择使用 GitHub 用户账号登录,并验证指定账号的身份。
-
在批准连接前,检查账号和请求的访问权限。
-
保存连接,然后在目标工作流中测试能否访问代码仓库中的某项已知资源。请单独测试所需的写入操作。
如果找不到代码仓库,请检查指定账号在 GitHub 中的访问权限,以及 ChatGPT 允许该应用执行哪些操作。
Daybreak Defense Factory 使用个人 GitHub 连接。请参阅设置 Daybreak。
Notion
准备专用 Notion 账号
请 Notion 管理员开设经批准的专用账号,仅授予访问所需资源的权限。确认该账号已加入目标工作空间。连接将使用此账号的权限。
配置工作空间连接
在“管理控制台”>“工作空间连接”中添加 Notion 插件。通过 Notion MCP 使用指定账号登录,选择工作空间,然后为连接命名,以便识别所用的工作空间和账号。
保存连接,然后在目标任务或界面中测试能否访问某个已知的 Notion 页面。请单独测试所需的写入操作,并核实结果。
Linear
准备专用 Linear 账号
请 Linear 管理员邀请指定账号以访客身份加入,并将其访问权限限制在所需团队内:
-
打开“设置”→“管理”→“成员”→“邀请”。
-
输入指定账号的电子邮件地址。
-
在“邀请身份…”下选择“访客”。
-
仅选择该账号应有权访问的 Linear 团队。
-
发送邀请,然后使用指定账号接受邀请。
请参阅Linear 邀请说明。
如果指定账号已经是成员,请 Linear 管理员更新其角色:
-
打开“设置”→“管理”→“成员”。
-
找到该账号,点击“⋯”→“更改角色…”→“访客”。
-
仅让该账号加入目标团队。访客在这些团队中拥有普通成员的权限。请参阅Linear 角色说明。
配置工作空间连接
-
在“管理控制台”→“工作空间连接”中添加 Linear 插件。
-
使用指定账号登录,选择工作空间,并检查权限。
该连接使用此账号在 Linear 中的访问权限。在实际使用该连接的任务或界面中,确认连接可以读取目标团队中的一条议题。请单独测试所需的写入操作。
Slack
配置工作空间连接
确认所需的 Slack 工作空间和频道,核实应用安装情况及管理员批准情况。请使用供 Slack 中的 ChatGPT 使用的共享连接。个人 Slack 连接和 dot 的“添加到 Slack”连接均独立于该共享连接。
在获准的频道中测试发帖,并核实帖子所在的工作空间和发帖人。请分别测试读取和搜索功能。成功发帖无法验证这两项功能。
团队和工作流所有者
选择并测试连接
配置访问权限并选择连接
工作空间管理员:配置各角色的访问权限及连接的可用范围,分别检查使用权限和管理权限。向工作流所有者提供连接昵称、所用账号、获准访问的资源、获准执行的操作以及连接所有者的联系方式。
团队或工作流所有者:在权限允许时选择并保存可用的连接,然后在目标工作流中测试。如果找不到连接,请工作空间管理员检查访问权限和可用范围。
各项设置控制的内容
为某个连接启用 Slack 或 Microsoft Teams 中的 @ChatGPT 时,也会启用该连接的团队和服务账号访问选项。只要该连接启用了 @ChatGPT,就无法单独关闭这些选项。
| 设置或权限 | 检查内容 |
|---|---|
| 外部账号 | 指定账号或应用安装实例能否访问所需资源并执行所需操作? |
| 角色访问权限 | 获准的人员或服务账号能否使用该连接?请单独检查管理权限。 |
| 可用范围 | 目标用户、团队或服务账号能否找到该连接?请检查配置的适用对象。 |
| 团队或工作流的连接选择 | 使用该连接的团队或工作流是否已选中并保存该连接? |
团队和工作流的连接
检查团队的连接
与连接所有者一起核对每个插件的连接昵称、所用账号和资源访问权限。
为工作流选择连接
对于 @ChatGPT,请打开相应界面的插件设置并选择连接。保存后重新打开设置,核实所选连接。
对于团队任务,请确认每个应用所选的连接。任务由团队服务账号运行,各应用所用的外部账号则由其身份验证方式决定。请确认该身份验证方式支持任务的运行类型,尤其是在需要验证员工身份的情况下。
在工作流中测试连接
-
在目标工作流中读取已知的数据源。核实所用身份和访问的资源。
-
在获准的目标位置测试写入或发送操作,然后打开生成的文件、记录或消息。
-
确认获准的用户可以使用连接,而未经授权的用户无法使用。检查接收者能否访问生成的文件。
连接用户
使用工作空间连接
了解已连接账号的权限
执行操作时使用的是已连接账号的权限,这些权限可能超出您个人的访问权限。OAuth 使用已授权的账号,直接通过服务账号访问时则使用该服务账号的身份。部分方式要求验证请求者身份,请参阅 Google Workspace 委派。
使用可用的工作空间连接
- 如果可以选择连接,请选择指定连接。对于受管理的 @ChatGPT 界面或团队任务,请与所有者确认所选连接。
您无需在每次使用时重新输入指定账号的凭据。如果系统提示您登录,请核实正在授权的连接和账号。
工作空间连接可能有权读取您本人无法打开的数据源。数据源链接本身不会授予访问权限。生成的文件可能仅对已连接的账号可见,因此请在共享前检查接收者的访问权限。
连接所有者和用户
管理连接和排查问题
管理变更和移除访问权限
检查连接的昵称、可用范围和角色设置。
如果授权情况或服务提供方的权限发生变化,请连接所有者恢复访问,再请工作流所有者重新测试。重命名连接不会改变外部权限。
禁用连接前,请与工作流所有者确认哪些工作流会受到影响。移除连接后,请验证受影响的用户和工作流已无法使用该连接。
请另行撤销服务提供方的授权。即使已禁用 ChatGPT 连接,仍需完成此步骤。
排查访问问题
如果找不到连接,请先核实工作空间,然后查看访问问题排查表,确定应由谁检查角色访问权限和连接的适用对象。
| 问题 | 可以提供帮助的人 |
|---|---|
| 找不到连接 | 工作空间管理员可以检查您的角色以及连接的适用对象设置。 |
| 连接可用,但任务没有使用它 | 相应界面或团队的所有者可以检查工作流中的应用配置了哪个工作空间连接。 |
| 无法访问数据源或执行操作 | 连接所有者可以核实连接使用的身份,以及该身份是否有权访问资源或执行操作。 |
| 可以阅读摘要,但无法打开原始内容 | 数据源所有者可以检查您对原始页面或文件的访问权限。 |
| 接收者无法打开生成的文件 | 文件所有者可以检查文件的共享设置。 |
重试失败的写入或发送操作前,请先检查目标位置。即使出现报错,操作也可能已经完成,重试可能会生成重复内容。