系统与实用工具

Shell、node、SQL、当前时间、推送通知——补全工具箱的小工具。

通用工具家族。代理在完善任务时会用到的小而精的工具。

该家族中的工具

工具	功能
shell	运行 shell 命令。输出受限，并捕获退出码。
node_exec	运行一段 Node.js 代码片段——适合一次性脚本编写。
npm_exec	运行一个 npm/pnpm/yarn 脚本。
python_exec	运行一段 Python 3 代码片段或 .py 脚本——用于一次性的 Python 脚本编写。
current_time	获取任意时区的当前时间，并提供格式化选项。
schedule	一次性“在时间 T 执行一次”——对于重复任务，请参见 Cron.
pushover	向你的设备发送推送通知。
insert_sql_record	向代理的结构化工作区 SQL 存储中追加一行。
lsp	查询语言服务器（定义、引用、诊断）。
workspace_state	检查当前工作区——打开的文件、最近的编辑、环境。
proxy_config	读取或修改出站请求的代理配置。
tool_stats	自我反思——本次会话中使用了哪些工具，以及使用频率。

适用场景

• 工作流中不适合更丰富工具家族的部分。

• “直接运行这个命令，然后告诉我它输出了什么。”

• 具备时间感知的行为（“用户现在那边几点了？”），而无需把时区假设写死到提示词中。

• 让代理 通知你 当它完成一个长时间运行的任务时。

另请参阅

• Coder ——对于大量涉及文件系统的工作，优先使用专用工具，而不是 shell.

• Cron 与调度 ——适用于任何重复性任务。