Built in Tools zh

English · 简体中文

内置工具

这些是 agent 不用装任何东西就有的工具。技能和 MCP server 在此之上再加，这一页是地板。

你不需要自己调用它们——你描述想要什么，agent 自己挑。但知道有哪些仍然有用，因为它告诉你可以要求什么；而溯源面板会告诉你实际跑了哪些。

文件与检索

工具	作用
read	读项目里的文件。文本直接读，图片走 view_image。
write	新建或覆盖文件。
edit	对已有文件做精确字符串替换。
grep	跨文件内容的正则搜索。
search	按文件名或 glob 找文件。
view_image	把图片加载进来让模型真的看见——配图、绘图、显微图像。

跑代码

工具	作用
python	常驻 Python REPL，按项目隔离。状态跨消息保留。
r	常驻 R REPL。需要 PATH 上有 Rscript，且该环境里装了 jsonlite。
shell	在项目目录里执行 shell 命令。
set_runtime_interpreter	把某个环境的 Python 或 R 指到特定解释器，并重启该 REPL。

"常驻"是重点。 python 是一个 kernel，不是 python -c。一个 10 GB 的 AnnData 读进来一次就能一直用。重启 REPL（通过 set_runtime_interpreter，或崩溃后）会清空该 REPL 的内存——这也正是不重启整个 Wisp 就能救回卡死运行时的办法。

Python 首次使用时会在 .wisp/python/.venv 建一个 uv 虚拟环境。Wisp 永远不会自动安装 R 包。

远程与长时任务

工具	作用
run_in_context	向已注册的执行环境（本地、WSL、SSH）提交任务。能扛断线。
get_run	取某次运行的状态和输出。
monitor_run	盯一个正在跑的任务。进度更新不经过模型。
cancel_run	停掉一次运行。
transfer_between_contexts	在本地与远程之间、或两台远程之间传文件。
configure_ssh_trust	为已注册的 SSH 主机配置 host key 信任。

怎么注册服务器、以及为什么 probe 是强制的，见执行环境。

网页与浏览器

工具	作用
web_scan	读取页面内容。
web_open_tab	打开一个 URL。
web_screenshot	把真实渲染的页面截成模型能看的图。
web_execute_js	在页面里执行 JS 做检查。
browser_setup	准备浏览器桥接。

web_screenshot 存在是因为有些页面只有看才有意义——仪表盘上的图、布局问题、在线论文里的配图。

委派与专家

工具	作用
delegate_tasks	把子任务分给已配置的子 agent，并行执行。
get_delegated_result	收取被委派 agent 的返回。
save_specialist	把当前配置存成一个可复用的专家。

**专家（specialist）**是一份存下来的 agent 配置——模型、工具、指令——以后直接调用，不用重新解释一遍。委派则是把这些一次跑好几个，适合能干净拆分的活。

记录

工具	作用
research_graph	为项目记录一条决策、文献或数据资产，或把两者关联起来。
update_plan	长任务过程中维护一份可见的任务计划。
attempt_completion	给出本轮的最终答复。

research_graph 记的东西会出现在研究图谱面板——见界面指南。

安全边界

值得先知道，因为这些是刻意设计的，不会被绕过：

• shell 里的裸 ssh / scp 被禁用。 远程操作必须走已注册的主机，这样别名、用户、端口、密钥都是你配的那套，而不是模型临场编的。
• SSH 主机必须先 probe 通过才能被 agent 使用。 在没有成功 probe 记录的情况下启用，会弹窗要求你先去检查并 probe。
• 失败不自动重试。 probe、上传或启动失败后，Wisp 会为该主机打开一道连通性闸门，后续托管请求立即失败（不再联系服务器），直到你手动重新 probe。
• 密钥永不进项目数据库。 API key 和 SSH 密码存在操作系统钥匙串里。