công cụ apply_patch

Áp dụng các thay đổi tệp bằng định dạng bản vá có cấu trúc. Cách này lý tưởng cho các chỉnh sửa trên nhiều tệp hoặc nhiều đoạn, khi một lệnh gọi edit duy nhất dễ bị lỗi.

Công cụ chấp nhận một chuỗi input duy nhất bao bọc một hoặc nhiều thao tác với tệp:

*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@ optional change context
-old line
+new line
*** Delete File: obsolete.txt
*** End Patch

​

Tham số

• input (bắt buộc): Toàn bộ nội dung bản vá, bao gồm *** Begin Patch và *** End Patch.

​

Lưu ý

• Đường dẫn trong bản vá hỗ trợ đường dẫn tương đối (tính từ thư mục không gian làm việc) và đường dẫn tuyệt đối.
• tools.exec.applyPatch.workspaceOnly mặc định là true (chỉ trong không gian làm việc). Chỉ đặt thành false nếu bạn chủ ý muốn apply_patch ghi/xóa bên ngoài thư mục không gian làm việc.
• Sử dụng *** Move to: trong một đoạn *** Update File: để đổi tên tệp.
• *** End of File đánh dấu thao tác chèn chỉ tại cuối tệp khi cần.
• Được bật mặc định cho mọi mô hình. Đặt tools.exec.applyPatch.enabled: false để tắt, hoặc giới hạn cho các mô hình cụ thể bằng tools.exec.applyPatch.allowModels (chấp nhận mã định danh thô như gpt-5.4 hoặc mã định danh đầy đủ như openai/gpt-5.4).
• Cấu hình nằm trong tools.exec.applyPatch.*.

​

Ví dụ

{
  "tool": "apply_patch",
  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}

​

Liên quan

Bản khác biệt

Trình xem bản khác biệt chỉ đọc để trình bày các thay đổi.

Công cụ Exec

Thực thi lệnh shell từ tác tử.

Thực thi mã

Phân tích Python từ xa trong môi trường hộp cát bằng xAI.