메인 콘텐츠로 건너뛰기

​
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 전용 삽입을 표시합니다.
  • 실험적이며 기본적으로 비활성화되어 있습니다. tools.exec.applyPatch.enabled 로 활성화하십시오.
  • OpenAI 전용입니다(OpenAI Codex 포함). 필요 시 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"
}