Agent 工具

每個程式設計 agent 都有自己的工具：讀取檔案、執行指令、編輯程式碼。OAR 在這之上再加了一小組工具，讓 agent 能做只有中繼才做得到的事：與其他 session 協作、發布網頁預覽，以及向你提出一個點一下就能回答的問題。

你永遠不必自己呼叫這些工具。你用一般的話提出要求，agent 會自己挑選工具。這個章節讓你了解 agent 能做什麼、哪些事需要你核准，以及它到底送出什麼、收到什麼。

工具 #

• relay_toolrelay_tool agent 工具——操作此中繼與配對中繼上的 session。全部 23 個動作、它們的參數與結果、權限、限制與錯誤。
• previewpreview agent 工具——把本機 dev server 或資料夾發布到公開連結上。動作、參數、結果、設定與限制。
• ask_useragent 如何以附按鈕的卡片向你提問——OAR 的 ask_user 工具與各供應商自己的提問工具，以及各供應商的參數。

你可以要求什麼 #

一些要求範例，以及 agent 會用到的工具：

依供應商 #

工具的作用對每個供應商都一樣。不同的是供應商的 agent 是否能取得該工具，以及它們看到的工具名稱。

Claude API 和 DeepSeek 對話會在中繼主機上執行 Claude Code，所以它們的 agent 取得工具的方式和 Claude 對話完全相同。見 Claude API 和 DeepSeek。

Claude Cloud session 在 Anthropic 的沙箱中執行，而不是在你的機器上。中繼的工具無法伸入其中：雲端 session 沒有 relay_tool，也沒有 preview。不過其他 session 中的 agent 仍然可以用 relay_tool 啟動、讀取、提示和停止雲端 session。

Grok 和 Copilot 的擴充功能引擎會從 OAR 附加到 agent 的小型 MCP 伺服器取得工具。為中繼設定環境變數 OAR_MCP_SERVER=0 會關閉這個伺服器；這時這些 agent 就沒有 relay_tool，也沒有 preview 工具，而是被告知如何呼叫 preview API。

工具何時可用 #

session 是在它的 agent 處理程序啟動時，得知自己是否取得 relay_tool。在你配對第一個中繼或開啟 agent session 之後，已在執行的對話可能要等到它的 agent 重新啟動，才會有這個工具。0.9.18 新增 工具的新名稱也是如此：你更新到 0.9.18 時正在執行的 session，可能仍以 remote_relay 這個名稱擁有它；見名稱。

你仍能掌控的部分 #

• 預設不會開啟任何超出對話範圍的功能。 agent session 在你開啟之前都是關閉的，配對的中繼在每個對話中都處於鎖定狀態，直到你提到它為止，預覽通道在你設定之前也是關閉的。
• 核准卡片。 agent 在對話中啟動的第一個 session、它第一次監看某個中繼上的 session，以及在 ask 和 plan 中繼模式下的每個寫入動作，都會先以提問卡片詢問你。
• 工具絕不會把 token 交給 agent。 對其他中繼的呼叫會經過你自己的中繼，由它保管對方中繼的 token。這不是沙箱：agent 以中繼的使用者身分執行，可以從磁碟讀取設定檔和資料庫。見 OAR 會暴露什麼。
• 預覽連結是公開的。 任何拿到預覽連結的人都不必登入就能開啟。agent 會被要求在提供連結時說明這一點。agent 只能列出和關閉自己對話的預覽 0.9.14 新增；Settings → Previews（設定 → 預覽）則會顯示並可關閉所有預覽。

詳細說明請見各工具的頁面：relay_tool → 權限與核准和 preview → 限制。

不是工具的功能 #

agent 在 OAR 中做的一些事，並不需要 OAR 的工具：

• 回覆中的圖片、影片和音訊。 agent 會被告知可以用絕對路徑嵌入媒體檔案；中繼會內嵌顯示它。這是提示中的一項指示，而不是工具。Copilot 擴充功能引擎上的 agent 和 Claude Cloud 中的 agent 不會收到這項指示。
• 輸入區中的 /preview。 你可以自己輸入 /preview 來發布、列出和關閉預覽（輸入區）。這不會耗用 agent 的回合，而且適用於每個供應商。
• 計畫看板。 agent 完成規劃時，OAR 會顯示 Plan ready（計畫已就緒）看板。在 Claude 和 DeepSeek 上，它來自 Claude Code 自己的計畫工具，由 OAR 接手顯示。