工具参考

🔵 工具是 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>' 监控与调试

章节