将 AI 智能体连接到你的文档站点
让 Claude Code、Codex、ChatGPT 或你自己的脚本来起草、整理和发布文档站点页面。涵盖套餐（Pro 及以上版本）、文档站点权限、站点范围和发布规则，并提供指向完整 AI 智能体和 API 指南的链接。
Claude Code、Codex、Cursor、Claude 或 ChatGPT 等 AI 智能体可以为你读取和撰写文档站点：起草文章、修复读者评分较低的页面、填补内容空白、翻译或发布内容。本文介绍了文档站点的具体相关内容。有关令牌、连接器、支出和错误的说明，请参阅 AI 智能体与 API。
开始之前
- AI 智能体与 API 适用于 Pro、商业 和 自定义 套餐，包括 Claude 和 ChatGPT 的连接器。免费版和入门版不包含此功能；如果工作区迁移到这些版本，令牌和应用将停止工作。
- 智能体的行为等同于创建其令牌或连接它的人员，并受限于该人员的角色。它在站点上能执行的操作绝不会超过该人员的权限。
- API 调用不消耗额度。使用 AI 翻译页面和生成站点页面需要消耗额度，且仅在使用可支出额度的令牌时才可进行。
连接智能体
打开工作区菜单并选择 AI 智能体与 API，或者在文档站点的 设置 菜单中选择 AI 智能体与 API（这将打开该站点的活动页面）。
- 适用于 Claude Code、Codex、Cursor 或脚本的 API 令牌：令牌 → 新令牌，然后按照四步向导（用途、权限、限制、查看）进行操作。选择一个文档站点预设（如 撰写者 或 发布者），在 限制 → 文档站点 下选择站点，并复制仅显示一次的令牌。请参阅 创建 API 令牌。
- 适用于 Claude.ai 或 ChatGPT 的 连接器：将 已连接的应用 中的 连接器 URL 粘贴到应用中，登录并选择 站点 和 访问权限。请参阅 连接 AI 应用和智能体。
文档站点预设
| 预设 | 屏幕描述 | 适用对象 |
|---|---|---|
| 撰写者 | “智能体起草；由人员审核并发布。” | 起草文章和更新日志条目，上传图片 |
| 发布者 | “受信任的自动化操作，可能会更改读者看到的内容。” | 文档站点的所有操作，包括发布、设置和创建站点 |
| 支持助手 | “仅回答已发布文档中的内容。无其他权限。” | 仅搜索已发布公共页面的帮助机器人 |
| 只读 | “研究、审计和翻译检查。” | 阅读内容 |
| 分析师 | “读取内容和读者信号以建议修复。” | 阅读内容和洞察信息 |
制作人 和 工作区智能体 可添加视频和支出额度。关于每项权限以及谁可以授予权限的信息，请参阅：智能体权限。
文档站点权限
| 权限 | 允许 |
|---|---|
content:read |
读取站点、页面、文章（包括草稿）、修订版本、更新日志和站点页面 |
articles:write |
创建文章草稿并编辑非实时文章 |
structure:write |
创建和编辑分区；移动、隐藏和重命名页面 |
site-pages:write |
编辑站点页面（如首页、联系方式和法律声明） |
changelog:write |
创建和编辑更新日志条目草稿 |
media:write |
上传图片 |
site:publish |
发布：更改读者看到的内容，编辑实时内容，标记页面为就绪状态 |
insights:read |
读取搜索空白、未回答的问题和页面反馈 |
site:configure |
更改站点设置、外观和导航 |
sites:create |
创建新的文档站点 |
help:read |
仅搜索已发布的公共页面（适用于支持助手） |
任何成员均可阅读。撰写和整理权限：所有者、管理员、编辑和内容创作者。发布和站点设置权限：所有者、管理员和编辑（“仅所有者、管理员和编辑可以授予发布权限。”）。创建站点权限：所有者和管理员。
令牌涵盖的站点
在 限制 → 文档站点 下，选择 全部站点（“此工作区中的每个文档站点，包括新站点。”）或 已选站点。令牌或已连接的应用只能查看和更改其涵盖的站点。如果某篇文章也出现在其范围之外的站点上，更改将被拒绝：“此文章也显示在令牌无法更改的站点上。”
实时内容需要发布权限
如果没有 site:publish，智能体将无法更改读者看到的内容。编辑实时文章的操作会被拒绝（“此内容在已发布的站点上处于实时状态，因此更改它需要 site:publish 权限。”），智能体可以改为提交草稿以供审核。你会收到一条通知，“agent 请求审核 site 上的 page”：“未发布任何内容。请阅读该文章并在准备好后发布。”
智能体所做的每一次更改都会在页面历史记录中显示为“智能体 name (token)”。每个令牌每小时的发布次数限制为 10 次。对于智能体而言，已暂停的站点为只读状态：“此站点已暂停或离线，处于只读状态。”
智能体在站点上能做什么
列出站点并读取页面树、搜索和阅读页面、预览 Markdown、创建和更新文章、提交审核、整理分区和页面、编辑站点页面和更新日志、上传图片、读取洞察信息并将空白标记为已覆盖、更改设置、外观、导航和重定向、创建站点、翻译页面、生成站点页面、发布和回滚。每项操作都需要相应的权限。