API 设置和 Agent 设置有什么区别
区分开放 API 密钥和 Agent 密钥的用途、权限边界和适用场景。
API 设置和 Agent 设置都在系统设置中，但用途不同。API 密钥主要用于外部系统读取公开站点内容；Agent 密钥用于让受控自动化工具协助创建内容、更新目录和执行发布工作流。
进入入口
从左侧导航进入「系统设置」，在顶部切换「API 设置」或「Agent 设置」。创建或复制密钥前，先确认当前品牌和团队是否正确。
> API 设置用于读取官网助手公开内容，截图中的密钥区域已遮罩。
API 适用
API 设置适合官网、内部服务或外部系统读取站点、菜单、目录、文章、标签、置顶内容和站点地图。它更偏向只读展示和系统集成，不建议用来执行内容写入动作。
> Agent 设置用于受控自动化协作，截图中的密钥区域已遮罩。
Agent 适用
Agent 设置适合让可信环境里的自动化工具协助处理内容和官网工作流，例如创建内容、更新文章、上传截图、调整目录、绑定页面、发布、下线或恢复。
权限边界
只读展示使用 API 密钥；需要写内容或操作发布时使用 Agent 密钥。不要把 Agent 密钥放在公开前端页面，也不要把密钥粘贴到不可信工具中。
使用检查
创建密钥后定期检查是否仍在使用。发生泄露、人员变动或自动化工具停用时，应及时停用或重生成密钥。对外展示配置时必须遮罩 Authorization 和完整密钥。
