内置工具
apply_patch 工具
使用结构化补丁格式应用文件更改。它很适合多文件或多 hunk 编辑，在这些场景中单个 edit 调用会比较脆弱。
该工具接受单个 input 字符串，其中包装一个或多个文件操作：
*** Begin Patch*** Add File: path/to/file.txt+line 1+line 2*** Update File: src/app.ts@@-old line+new line*** Delete File: obsolete.txt*** End Patch参数
input（必需）：完整补丁内容，包括*** Begin Patch和*** End Patch。
说明
- 补丁路径支持相对路径（从工作区目录开始）和绝对路径。
tools.exec.applyPatch.workspaceOnly默认值为true（限制在工作区内）。仅当你有意让apply_patch在工作区目录外写入/删除时，才将它设为false。- 在
*** Update File:hunk 中使用*** Move to:来重命名文件。 *** End of File在需要时标记仅 EOF 插入。- 默认可用于 OpenAI 和 OpenAI Codex 模型。设置
tools.exec.applyPatch.enabled: false可禁用它。 - 可选择通过
tools.exec.applyPatch.allowModels按模型设置门控。 - 配置仅位于
tools.exec下。
示例
{ "tool": "apply_patch", "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"}