智能体工具

每个编程智能体都自带工具：读取文件、运行命令、编辑代码。OAR 在此基础上额外添加了一小组工具，让智能体能够做只有中继才能做的事：与其他会话协作，发布网页预览，以及向你提出一个只需轻点一下就能回答的问题。

你从不需要自己调用这些工具。你用日常语言提出请求，由智能体选择工具。本章节帮助你了解智能体能做什么、哪些操作需要你批准，以及它具体发送什么、得到什么。

工具 #

• relay_toolrelay_tool 智能体工具——与此中继和已配对中继上的会话协作。全部 23 个操作、它们的参数和结果、权限、限制和错误。
• previewpreview 智能体工具——将本地开发服务器或文件夹发布到公开链接上。操作、参数、结果、设置和限制。
• ask_user智能体如何以带按钮的卡片向你提问——OAR 的 ask_user 工具和各提供商自带的提问工具，以及每个提供商的参数。

你可以提出哪些请求 #

一些请求以及智能体会使用的工具：

按提供商 #

工具的作用在每个提供商上都相同。不同的是提供商的智能体是否获得该工具，以及它们看到的工具名称。

Claude API 和 DeepSeek 对话在中继主机上运行 Claude Code，因此它们的智能体获得的工具与 Claude 对话完全相同。参见 Claude API 和 DeepSeek。

Claude Cloud 会话在 Anthropic 的沙箱中运行，而不是在你的机器上。中继的工具无法进入其中：云端会话没有 relay_tool 也没有 preview。其他会话中的智能体仍然可以用 relay_tool 启动、读取和停止云端会话，或向它发送提示词。

Grok 和 Copilot 的扩展引擎从 OAR 附加到智能体的一个小型 MCP 服务器获得工具。为中继设置环境变量 OAR_MCP_SERVER=0 会关闭该服务器；这些智能体就没有 relay_tool，也没有 preview 工具，而是被告知如何调用预览 API。

工具何时存在 #

会话是否获得 relay_tool，在其智能体进程启动时确定。你配对第一个中继或开启智能体会话后，已经在运行的对话可能要等其智能体重新启动后才有该工具。0.9.18 新增 该工具的新名称同样如此：在你更新到 0.9.18 时正在运行的会话可能仍以 remote_relay 的名称拥有它；参见名称。

你始终掌控什么 #

• 凡是超出对话范围的功能，默认都不开启。 智能体会话在你开启之前是关闭的，已配对的中继在每个对话中保持锁定，直到你提及它，预览通道在你配置之前也是关闭的。
• 审批卡片。 智能体在对话中启动的第一个会话、它第一次在中继上监视会话，以及 ask 和 plan 中继模式下的每个写入操作，都会先通过提问卡片征求你的同意。
• 这些工具从不给智能体令牌。 对另一个中继的调用通过你自己的中继进行，它持有那个中继的令牌。但这不是沙箱：智能体以中继的用户身份运行，能够从磁盘读取配置文件和数据库。参见 OAR 暴露什么。
• 预览链接是公开的。 任何拥有预览链接的人都无需登录即可打开它。智能体被告知在给你链接时要说明这一点。智能体只能列出和关闭它自己对话的预览 0.9.14 新增；Settings → Previews（设置 → 预览）显示并关闭所有预览。

详细信息见每个工具的页面：relay_tool → 权限与批准 和 preview → 限制。

不是工具 #

智能体在 OAR 中做的一些事情无需 OAR 的工具即可完成：

• 回复中的图片、视频和音频。 智能体会被告知可以通过绝对路径嵌入媒体文件；中继会内联显示它。这是提示词中的一条指令，不是工具。Copilot 扩展引擎上和 Claude Cloud 中的智能体不会收到这条指令。
• 输入区中的 /preview。 你可以通过输入 /preview 自己发布、列出和关闭预览（输入区）。这不消耗智能体的轮次，并且适用于所有提供商。
• 计划看板。 当智能体完成规划时，OAR 会显示一个 Plan ready（计划已就绪）看板。在 Claude 和 DeepSeek 上，它来自 Claude Code 自带的计划工具，由 OAR 接收并显示。