应用内内置 Agent

熟练运用 OriginAI Web 工作台内置的 AI Agent，在受控环境中交互式打磨与重构产品规格。

Web 端内置 Agent 深度集成在工作台中，旨在帮助你在严格受控的边界下高效起草、编辑与重构产品规格。它支持在画布上直观框选组件元素、对页面的特定区域就地附加审查批注、支持多会话上下文切换，并提供灵活的自主权限控制模式。

开始使用前，请打开目标项目，并确认当前账户在今日尚有可用的 AI 对话额度。

内置 Agent 与外部编码 Agent 的本质分工

工作台内置 Agent 与你在本地通过 CLI 调用的外部编码 Agent 拥有完全不同的职责定位与系统边界：

比较维度	Web 端内置 Agent	外部编码 Agent（CLI / MCP）
运行运行环境	OriginAI 官方 Web 工作台内部	本地终端、IDE、Claude Code、Cursor、Windsurf 等
操作与修改对象	处于草稿态的动态工作区 RPML 规格	本地代码仓库中可运行的工程源码
资源计量方式	严格计入每日 AI 对话轮次配额	基于个人访问令牌（PAT）验证；不计入对话轮次
首次发布后权限	仍可直接协助人类编辑动态工作区	受到保护机制约束，自动转为暂存变更请求

标准对话调优工作流

展开工作台右侧的 Agent 对话面板。
在指令输入框中描述你希望进行的规格调整——例如新增一个页面、补充某条业务规则、修改异常交互状态或润色界面文案。
在消息流中观察 Agent 执行工具调用的过程，以及给出的规格修改差异。
可以在当前会话中持续追问迭代，亦可随时展开 历史记录 查看或回溯先前的对话分支。
当整套规格调优达到预期且视觉呈现满意时，即可执行发布 Release 版本。

画布元素即时拾取与定向交互

在默认状态下，可视化画布处于**拾取（Select）**交互模式。点击画布上渲染出的任意界面元素，系统会自动将其结构与定位注入为下一轮对话的精确上下文。

打开目标页面文件，使画布完成渲染。
在画布上直接点击你关注的界面节点——例如一个布局卡片、一个操作按钮或一段提示文本。
观察 Agent 指令输入框上方是否出现了高亮的 Selected 元素标签。
在输入框中输入你的修改诉求。占位文案会自动变更为“describe the change for the selected element…（为所选元素描述修改意图）”。
点击发送。内置 Agent 将在提示词中自动融合该选定组件的底层 RPML 标签结构与其在文档树中的精确路径。

实用小建议：

若接下来的修改是一项全局性调整（例如增加全局路由），请务必在发送前点击清除选中标签（点击画布空白区域或点击标签上的关闭按钮）。
当意图修改某一处特定控件时，使用画布点选配合简洁的自然语言指令，其效果与稳定性远胜于手动复制粘贴大段 RPML 代码。
在画布上按住 Cmd 或 Ctrl 键点击时，系统会触发原型的交互导航跳转（根据 to 属性切入目标页面），而不会触发元素拾取——若要拾取该元素，请直接普通单选。

就地附加元素审查批注

在发送对话之前，你还可以为当前选中的元素添加一段轻量的上下文批注：

选中目标元素后，在随附的评论输入框（“Comment on this element…”）中输入批注内容。
按回车确认，该批注将以标签形式堆叠在输入框上方。
可在主指令框中补充整体说明；亦支持在主输入框为空的情况下单独发送批注。
发送前若发现批注有误，可随时单独编辑或删除特定批注标签。
当你重试某一轮对话时，先前附加的批注标签会自动保留以便快速重发。

批注将作为结构化元数据与对话一同发送给底层大模型，使模型能够精确建立“当前评论针对哪个具体控件”的空间认知。

会话流与历史记录管理

功能控件	核心机制与使用场景
新会话（New Session）	开辟全新的空白对话上下文，不会影响或删除已存在的历史会话。
历史记录（History）	罗列该项目名下的所有历史会话流，方便在不同探索分支之间从容切换。
快速恢复推荐	当会话为空时，展示最近的几个对话主题供快速一键恢复。

当讨论的主题发生显著切换时（例如从用户登录旅程转向结算中心计费文案），强烈建议开启一个全新会话，以避免模型上下文过度膨胀造成注意力稀释。请注意：历史记录旨在协助恢复探索上下文，它绝不能替代严谨的版本发布；真正的状态定格必须依靠发布 Release 快照。

自主权限模式（Permission Modes）

为了平衡编辑效率与工程安全，内置 Agent 在执行高影响修改（如批量删除文档）前可以主动发起确认。你可以按需调整其自主裁量权限：

权限模式	具体执行行为
Auto（推荐）	遇到删除文件或关键结构调整时，必须先暂停并向人类请求显式确认。
Edit	遇到删除操作自动批准执行，但遇到模糊边界时仍会主动提问确认。
Bypass	自动静默批准所有工具调用，完全以自主代理模式全速运转。

在尚未完全熟悉 Agent 的具体调整偏好之前，建议始终保持在 Auto 模式。仅在批量处理大范围、确定性且处于人工严密监控下的调整时，才临时切换至 Bypass 模式。请注意：权限模式仅控制工作台内部的文件写入确认逻辑，它无法突破套餐本身的每日对话轮次限制，也无法突破发布后外部编码 Agent 的变更请求暂存保护。

熟练运用的标志

磁盘中实际生效的规格修改与你的自然语言意图完全一致。
清楚掌握当天剩余的 AI 对话轮次，合理规划使用。
善于利用画布拾取与就地批注精准定位问题，彻底告别手动复制粘贴底层标记语言。
在发起连续的多步骤复杂重构之前，清楚确认当前激活的权限模式处于预期状态。

常见排查与处理建议

现象	原因分析与应对方式
指令输入框呈灰色禁用，提示额度超限	当前账户的每日 AI 对话轮次已全部耗尽——可等待每日 UTC 00:00 自动重置刷新，或升级至更高阶套餐。
Agent 生成的修改与当前版本存在冲突	当前动态工作区的内容可能已经显著领先于上次发布的 Release——建议在工作台中发布一个过渡版本，使基准对齐。
点击画布元素后输入框未出现选中标签	确认当前打开的是具体的 `.rpml` 页面文件，且画布处于正常的拾取模式（而非通过快捷键触发了跳转）。
意外触发了非预期的文件删除	检查当前的权限模式设置——若处于 Bypass 模式，Agent 将跳过所有确认弹窗静默执行。
外部编码 Agent 依然无法直接写入工作区	此为发布后的标准安全机制——外部写入将恒定转换为变更请求，不可直接污染工作区。