Tools
أداة 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(محصورة ضمن مساحة العمل). عيّنها إلىfalseفقط إذا كنت تريد عمدًا أن يكتبapply_patchأو يحذف خارج دليل مساحة العمل. - استخدم
*** Move to:ضمن مقطع*** Update File:لإعادة تسمية الملفات. - يضع
*** End of Fileعلامة على إدراج خاص بنهاية الملف فقط عند الحاجة. - متاحة افتراضيًا لنماذج 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"
}