为 AI 智能体选择权限
API 令牌或已连接应用可以拥有的每项权限、其允许的操作、包含该权限的预设，以及可以授予该权限的角色（所有者、管理员、编辑、内容创作者）。
更新于 阅读需 3 分钟
每个 API 令牌和已连接应用都带有一组权限（能力），这些权限决定了智能体在你的工作区中可以执行的操作。本文列出了每项权限、其允许的操作、包含该权限的预设以及可以授予该权限的角色。
权限的工作原理
- 智能体以创建令牌的人员身份行事，且受该人员角色权限的限制。它执行的操作绝不会超出其所有者在应用中可执行的范围，并且只能看到其所有者可见的录制内容、视频和集合。
- 你的角色决定了你可以授予的权限。 在令牌向导和连接屏幕上，如果你无法授予某项权限，该选项将显示为灰色，并提示“你的角色无法授予此权限。”（发布权限则显示为“仅所有者、管理员和编辑可以授予发布权限。”）。如果某个预设包含此类权限，该预设将显示为灰色，并提示“你的角色无法授予此预设中的所有能力。”
- 系统会在每次调用时检查角色，而不仅仅是在创建令牌时。 如果所有者的角色后续发生变更，则需要新角色不支持的权限的调用将被拒绝，且令牌列表中会显示 超出角色权限：“所有者的角色已更改。需要被划掉的能力的调用已被拒绝。”
- 每项权限都有一个类型，在向导中显示为徽章：已读、编辑、发布、管理 或 消耗积分。
- 智能体只能看到其权限允许的工具 (MCP) 和端点 (REST)。调用其不具备权限的工具将返回“此令牌缺少……能力。”
预设
令牌向导的第一步（它的用途是什么？）提供了一些预设。选择一个预设会自动勾选其对应的权限；你可以在下一步中更改其中任何一项，此时向导将显示 已自定义 以及 重置为 预设。
| 预设 | 屏幕描述 | 权限 |
|---|---|---|
| 撰写者 | “智能体起草；人员审核并发布。” | content:read, articles:write, changelog:write, media:write |
| 发布者 | “受信任的自动化操作，可能会更改读者看到的内容。” | 除 help:read 和 insights:read 外的所有文档站点权限 |
| 支持助手 | “来自已发布文档的回答。仅此而已。” | help:read |
| 只读 | “研究、审计和翻译检查。” | content:read |
| 分析师 | “读取内容和读者信号以建议修复。” | content:read, insights:read |
| 制作人 | “起草内容并在积分上限内启动付费工作。” | 撰写者，外加 site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| 工作区智能体 | “智能体在此工作区中可执行的所有操作，在积分上限内。” | 除 help:read 外的所有权限 |
制作人 和 工作区智能体 包含 credits:spend，因此向导会在 限制 步骤中要求设置积分上限。请参阅 控制智能体支出和审批。
“撰写者”、“发布者”、“支持助手”、“只读”和“分析师”预设适用于文档站点。
视频权限
| 权限 | 类型 | 允许的操作 |
|---|---|---|
library:read |
已读 | “读取所有者可见的录制内容、视频、文章和转录稿”：列出库和录制内容，读取项目、其转录稿及其文章，并获取嵌入代码。 |
videos:create |
编辑 | “引用并请求视频、录制内容的文章和翻译”：请求报价，并从录制内容中请求操作指南、产品演示、清理和样式化视频、社交剪辑、文章以及视频翻译。启动付费工作还需要 credits:spend。 |
videos:export |
编辑 | “导出视频并获取嵌入代码”：渲染 1080p（默认）、2K 或 4K 的 MP4，始终为 60 fps，并获取下载链接。导出不消耗积分。 |
materials:write |
编辑 | “将图像、视频和 PDF 添加到用于新视频的工作区上传内容中”。 |
工作区权限
| 权限 | 类型 | 允许的操作 |
|---|---|---|
credits:spend |
消耗积分 | “在令牌上限内为报价工作消耗积分”。这是除该工作所需权限（例如 videos:create）外，每次启动付费工作所需的第二个关键权限。 |
jobs:read |
已读 | “查看由所有者的其他令牌启动的任务”。令牌始终能看到自己的任务；此权限可增加查看所有者其他令牌任务的功能。还允许智能体取消任务并读取工作区的积分余额。 |
文档权限
这些权限适用于 文档站点。在 限制 → 文档站点 下，令牌可以涵盖 全部站点（“此工作区中的每个文档站点，包括新站点。”）或 已选站点。
| 权限 | 类型 | 允许的操作 |
|---|---|---|
content:read |
已读 | “读取站点、页面、文章（包括草稿）、修订版本、更新日志和站点页面”。还包括站点设置、外观、导航和重定向。 |
articles:write |
编辑 | “创建文章草稿并编辑非实时文章”。翻译文章（付费）还需要 credits:spend。 |
structure:write |
编辑 | “创建和编辑部分，移动、隐藏和重命名页面”。 |
site-pages:write |
编辑 | “编辑站点页面，如主页、联系方式和法律声明”。使用 AI 生成或翻译站点页面（付费）还需要 credits:spend。 |
changelog:write |
编辑 | “创建和编辑更新日志条目作为草稿”。 |
media:write |
编辑 | “上传图像”。 |
site:publish |
发布 | “发布：更改读者看到的内容、编辑实时内容、标记页面为就绪”。还包括发布和删除更新日志条目以及回滚站点。 |
insights:read |
已读 | “读取站点洞察：搜索差距、未回答的问题和页面反馈”。配合 articles:write，它还可以将差距标记为已覆盖。 |
site:configure |
管理 | “更改站点设置、外观和导航”，以及添加重定向。 |
sites:create |
管理 | “创建新的文档站点”。 |
help:read |
已读 | “仅搜索已发布的公共页面（支持助手）”。仅拥有此权限的令牌无法看到其他任何内容。 |
谁可以授予什么权限
| 权限 | 所有者 | 管理员 | 编辑 | 内容创作者 |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
是 | 是 | 是 | 是 |
library:read |
是 | 是 | 是 | 是 |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
是 | 是 | 是 | 是 |
videos:export |
是 | 是 | 是 | 是 |
videos:create, materials:write, credits:spend |
是 | 是 | 否 | 是 |
site:publish, site:configure |
是 | 是 | 是 | 否 |
sites:create |
是 | 是 | 否 | 否 |
内容创作者可以为令牌授予 credits:spend，但需要审批的付费工作始终由工作区所有者或管理员批准，不能仅由令牌所有者批准。请参阅 控制智能体支出和审批。
智能体暂不可用的权限
智能体目前无法运行网站研究或录制的操作演示，也无法将视频发布到其他平台。这些权限无法授予。