返回文档核心概念

权限

逐个连接器控制 Okou 的操作权限——默认、审批、审计、撤销。

最后更新于2026年10月29日 · 1 min read

连接器访问权限分为三层:成员的连接、智能体的授权,以及授予该智能体的具体权限。连接服务不会自动赋予所有智能体所有操作权限。

连接、授权与权限

层级控制内容
连接哪个成员账户或凭证可用于该服务。
智能体授权哪个智能体可以使用该已连接的服务。
权限授予该智能体可请求哪些指定操作,以及持续多长时间。

对于需要成员凭证的服务,每位成员需连接自己的账户。共享智能体依然通过运行该智能体的成员的已连接账户和权限进行操作;不会继承队友的收件箱、令牌或私人聊天记录。

授权访问

当智能体需要某个尚未拥有的连接器权限时,Okou 会显示权限请求。请在选择 允许 或 拒绝 前,仔细检查连接器、智能体、权限名称及请求原因。

被允许的权限可选择产品中提供的有效期:

  • 允许 1 小时
  • 允许 24 小时
  • 允许 7 天
  • 始终允许

临时授权到期后,智能体需重新请求。拒绝某项权限不会断开账户连接,也不会移除无关权限。

你可在智能体的授权设置中管理其当前连接器访问权限。连接器访问视图会显示哪些智能体已获授权,以及其权限状态(允许、拒绝或混合)。

凭证管理

OAuth 令牌和手动输入的密钥会存储在平台上。对于连接器请求,防火墙会在网络边界注入凭证;密钥不会作为环境变量暴露给智能体代码。

请勿将 API 密钥、OAuth 令牌、密码或客户端密钥粘贴到聊天、智能体指令、工作流指令或附件中。请使用连接器的连接流程。

断开成员的连接器后,该连接将不再用于后续运行。移除智能体授权会阻止该智能体使用连接器,但不会影响其他已授权智能体。

审批边界

可强制执行的边界是连接器的指定权限授予。不要依赖通用操作类别来保证每封邮件、每条帖子、每笔支付、每次基础设施变更或删除都能以相同方式暂停。

对于必须人工审核的工作:

  1. 仅授予读取或草稿权限,并在连接器单独暴露时拒绝最终写入或发送权限。
  2. 在智能体或工作流指令中明确说明审核要求。
  3. 将最终操作保留给人工,例如生成 Gmail 草稿或建议变更,而不是直接发送或应用。

同时建议使用上游服务控制:限定 API 密钥、最小权限 OAuth 范围、仓库权限和独立生产凭证。

聊天、日志与管理员可见性

成员可访问自己的聊天线程。发布智能体或工作流不会公开成员的私人聊天记录或连接器凭证。仅通过明确的分享界面共享对话或成果。

工作区管理员可查看用于计费和容量管理的成员级用量汇总。这不会自动提供跨成员的私人聊天内容视图。

在成员自己的聊天中,活动视图会记录可见的运行序列、连接器活动、成果、状态和错误。你可用其验证请求的连接器操作是否已运行及是否成功。

审核清单

  • 连接器是否关联到预期成员账户?
  • 预期的智能体是否已获授权?
  • 是否只允许本任务所需的权限?
  • 授权是否可在 1 小时、24 小时或 7 天后过期,而非永久有效?
  • 工作流是否将不可逆或对外操作保留在人工审核步骤?
  • 上游凭证是否还能进一步收窄?

下一步

  • 查看聊天了解聊天边界内的行为。
  • 查看连接器了解目录及各连接器功能。
  • 查看团队使用了解组织级权限设置。