工具参考
🔵 工具是 config/agents/<agent>/tools/ 中的 YAML 文件。字段 kind:
选择引擎。下面是所有引擎的汇总表,附有各章节链接,
以免阅读多余内容。
引擎表
| 引擎 | 作用 | 章节 |
|---|---|---|
site_tool |
声明式 HTTP/API 客户端:抓取 + 字段提取 + 格式化 | 数据采集与搜索 |
rest_tool |
site_tool 的别名,用于 REST/API 集成(method/body/oauth2) |
数据采集与搜索 |
browser_tool |
无头浏览器(JS 网站、点击、页面内脚本) | 数据采集与搜索 |
archive_tool |
本地归档搜索 | 数据采集与搜索 |
json_tool |
预加载 JSON 搜索 | 数据采集与搜索 |
rss_tool |
RSS 订阅源搜索 | 数据采集与搜索 |
pdf_tool |
逐页读取 PDF | 数据采集与搜索 |
geo_tool |
地理编码与地点(OpenStreetMap) | 数据采集与搜索 |
rasp_tool |
交通时刻表(Яндекс.Расписания,免费密钥) | 数据采集与搜索 |
web_search |
互联网搜索(FireCrawl;模块 searchers) |
模块 searchers |
read_file / write_file / edit_file / list_files / grep / run_command |
项目代码操作(模块 code) |
模块 code |
supervisor |
启动子代理、订阅、self-inject、查看会话(模块 supervisor) |
模块 supervisor |
machine_list / machine_get / machine_upsert / machine_delete |
受管机器清单(模块 remote) |
模块 remote |
ssh_exec / ssh_upload / ssh_download / remote_health |
在按机器策略下通过 SSH/SCP 执行命令和传输文件(模块 remote) |
模块 remote |
kernel_list / kernel_get / kernel_upsert / kernel_delete |
远程 Agent OS 内核注册表(模块 kernels) |
模块 kernels |
kernel_health / kernel_models / kernel_agents / kernel_templates / kernel_request |
远程内核 HTTP API(模块 kernels) |
模块 kernels |
kernel_service / kernel_logs / kernel_deploy |
通过 SSH 的内核生命周期与发行版部署(模块 kernels) |
模块 kernels |
state_tool |
带作用域的状态存储 | 状态、数据库与可视化 |
scratch_tool |
会话草稿中的文件(list/read/write/edit/delete/mkdir/move) | 状态、数据库与可视化 |
duckdb_tool |
代理专属 DuckDB 数据库(raw SQL 或声明式 operations:) |
状态、数据库与可视化 |
sql_tool |
对外部 PostgreSQL/MySQL 的 SQL 访问 | 状态、数据库与可视化 |
chart_tool / table_tool |
静态图表/表格 | 状态、数据库与可视化 |
visualize_tool |
从任意数据生成图表/表格 | 状态、数据库与可视化 |
map_tool |
带标记的地图(Leaflet;提供商 osm/google/yandex/2gis/custom) | 状态、数据库与可视化 |
script_tool |
Rhai 或 JavaScript 脚本 | 计算与操作 |
subagent_tool |
将任务委托给子代理 | 计算与操作 |
email_tool |
发送邮件(SMTP) | 计算与操作 |
vk_tool |
以社区身份调用 VK API(帖子、消息、搜索) | 计算与操作 |
ym_tool |
以机器人身份向 Яндекс Мессенджер 发送消息/文件(Bot API) | 计算与操作 |
shell_tool |
运行 CLI 命令 | 计算与操作 |
workflow_tool |
运行工作流 | 计算与操作 |
file_tool |
向用户发送文件 | 计算与操作 |
office_tool |
生成/读取 Word/Excel/PowerPoint(OfficeCLI 的封装) | 计算与操作 |
storage_tool |
S3/WebDAV/FTP 上的文件(list/get/put/delete) | 计算与操作 |
calendar_tool |
读取和管理 Google Calendar(服务账号) | 计算与操作 |
google_tool |
Google Drive / Sheets / Docs / Slides(服务账号) | 计算与操作 |
yandex_tool |
Яндекс.Диск / Яндекс.Календарь(用户 OAuth,字段 service) |
计算与操作 |
vision_tool |
用 vision 模型进行 OCR/图片分析(一个或多个) | 计算与操作 |
request_attachment |
向用户请求文件 / 截图 / 照片(代理发起) | 计算与操作 |
ask_user |
向用户展示表单:多个问题(text/textarea/number/select/multiselect/confirm/date),支持“自定义选项” | 计算与操作 |
notify_tool |
吸引用户注意(silent/notify/alert/alarm/call) | 计算与操作 |
oauth_connect |
向用户请求连接器授权(OAuth) | 计算与操作 |
connector_request |
通过连接器以用户身份发起授权请求 | 计算与操作 |
await_event |
暂停流程并等待外部事件(webhook/定时器) | 计算与操作 |
async_action |
完整异步流程:请求 → 显示 URL → 回调 → 结果 | 计算与操作 |
show_link |
以按钮形式向用户显示链接(点击后打开窗口) | 计算与操作 |
wait_tool |
暂停 N 秒(长操作轮询的计时) | 计算与操作 |
image_tool |
图片处理(crop/resize/grayscale/rotate/flip/亮度/对比度/blur/格式) | 计算与操作 |
image_gen_tool |
通过可配置的 URL 后端根据提示词生成图片(默认 Pollinations) | 计算与操作 |
mcp_tool |
外部 MCP 服务器的工具(stdio / HTTP / SSE) | 计算与操作 |
trace_tool |
查询 agent 追踪记录 | 监控与调试 |
human_approval |
向人询问决策(批准/拒绝) | 操作审批 |
escalate_to_operator |
将对话转接给人工客服(或返回联系方式) | 计算与操作 |
dll_tool |
来自 Rust DLL 的原生工具(C ABI) | 原生插件 |
http_fetch / fs_read / job_done |
内置工具 | 基础 |
通用字段、ui、块、warnings |
YAML 通用机制 | 基础 |
| 模板与变量 | MiniJinja | 基础 |
| 本地测试 | agent-os tool <yaml> '<args>' |
监控与调试 |
章节
- 基础 — 通用字段、模板、内置工具。
- 数据采集与搜索 —
site_tool、browser_tool、archive_tool、json_tool、rss_tool、pdf_tool、geo_tool。 - 状态、数据库与可视化 —
state_tool、scratch_tool、duckdb_tool、sql_tool、chart_tool/table_tool、visualize_tool、map_tool。 - 计算与操作 —
script_tool、subagent_tool、email_tool、vk_tool、ym_tool、shell_tool、workflow_tool、file_tool、office_tool、storage_tool、calendar_tool、google_tool、vision_tool、image_tool、image_gen_tool、mcp_tool、wait_tool。 - 监控与调试 —
trace_tool、本地 测试。 - 模块
searchers— 网络搜索:工具web_search、 演示 agentsearchers-demo、FireCrawl 密钥。 - 模块
code— 项目代码操作:read_file、write_file、edit_file、list_files、grep、run_command;agentcoder。 - 模块
supervisor— 启动子 agent 与监督: 子级事件订阅、self-inject、会话查看。 - 模块
remote— 受管机器清单及 基于 per-machine 策略的 SSH/SCP 操作(machine_*、ssh_exec/ssh_upload/ssh_download、remote_health)。 - 模块
kernels— 远程 Agent OS 内核注册表、 HTTP 平面(kernel_health/models/agents/templates/request)及 基于 SSH 的生命周期(kernel_service/logs/deploy)。