الانتقال إلى المحتوى الرئيسي

​
أداة apply_patch

تطبيق تغييرات الملفات باستخدام تنسيق تصحيح منظَّم. يُعد هذا مثاليًا للتعديلات متعددة الملفات أو متعددة المقاطع (hunks) حيث يكون استدعاء واحد 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 إلى إدراج عند نهاية الملف فقط عند الحاجة.
  • تجريبية ومعطّلة افتراضيًا. فعِّلها باستخدام 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"
}