工具参考
按任务选择文件、命令、观察、网络、规划和委派工具。
This page has not been translated into English yet. The original Chinese version is shown below.
工具是模型向 Qwen Code 请求的结构化操作。core 验证参数、处理权限并执行,再把结果交还模型;模型声称“已读取”不等于真实工具调用已经成功。
按操作查阅
- 文件发现与读取、精确编辑与编码、Notebook 单元格:定位文件、核对完整内容后修改。
- Shell与Monitor:一次性命令、后台进程和持续输出通知。
- 网页获取与网页搜索:已有 URL 与尚需检索的来源。
- Todo、退出 Plan、Agent 调用:任务进度、实施审批和委派契约。
- MCP 服务作者参考:名称、内容块、认证和发现排障。
可见、允许与可执行
模型看到工具声明,不代表每次调用都获准。工具启用、发现、权限规则和沙箱是不同层;有些工具默认不注册,需要设置后重启。
写文件和执行命令通常经过相应审批,但实际以当前模式和规则为准;进入 YOLO 不等于启用隔离。见审批模式、工具发现配置和沙箱。
容器或系统沙箱中的工具还需具备可用执行文件、目录与网络。主机装有 npx 或某个 MCP 服务,不保证隔离环境内也能找到。
本目录的调用示例展示工具参数形状,不是直接粘贴到系统终端的命令;只有标为 bash 等 shell 的代码块才是命令行语法。
In this section
- 文件发现与分段读取使用 Glob、Grep、ReadFile,处理结果截断、PDF 与旧多文件接口。
- 文件写入、替换与编码区分覆盖和精确替换,核对多重匹配、BOM 与 Windows 脚本规则。
- Notebook 单元格编辑按读取结果中的 cell ID 修改笔记本,避免失效输出和错位编辑。
- Shell 执行与后台进程设置工作目录、PTY 和受管后台模式,正确判定退出状态。
- Monitor 流式观察管理持续命令的通知、限流、空闲停止和独立权限规则。
- 网页获取与内容协商提取单个 URL 的信息,区分 Accept 偏好、正文转换和模型摘要。
- 内置搜索与 MCP 替代核对自动注册、DashScope 凭据、超时、调用预算与旧配置迁移。
- Todo 列表工具启用会话任务列表,区分进度标记和实际完成证据。
- 退出 Plan 的审批工具提交实施计划并等待明确决定,处理取消和模式切换失败。
- Agent 调用参数与返回选择独立 subagent 或 fork,控制前后台与已有 worktree 生命周期。
- MCP 服务作者与兼容性按当前命名和发现实现返回工具、提示与资源,定位协议和认证问题。