apply_patch 도구

구조화된 패치 형식을 사용하여 파일 변경을 적용합니다. 단일 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: 헝크 내에서 *** 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"
}