​

FileWriterTool

​

الوصف

​

التثبيت

pip install 'crewai[tools]'

​

مثال

from crewai_tools import FileWriterTool

file_writer_tool = FileWriterTool()

result = file_writer_tool.run(
    filename='example.txt',
    content='This is a test content.',
    directory='test_directory',
)
print(result)

​

المعاملات

• filename: اسم الملف المراد كتابته، نسبةً إلى directory. يمكن أن يتضمن مجلدات فرعية. تُنشأ تلك المجلدات الفرعية إذا لم تكن موجودة.
• content: المحتوى النصي المراد كتابته.
• directory (اختياري): المجلد الذي تتم الكتابة إليه. يُحل المسار النسبي داخل المجلد المسموح للأداة (base_dir عند تعيينه، وإلا مجلد العمل الحالي) ويُعيَّن افتراضيًا إلى جذر ذلك المجلد (./). يُنشأ إذا لم يكن موجودًا.
• overwrite (اختياري): ما إذا كان يجب استبدال ملف موجود. يقبل قيمة منطقية أو السلاسل y/yes/t/true/on/1 و n/no/f/false/off/0. الافتراضي هو false. عندما يكون false والملف موجودًا مسبقًا، تُرجع الأداة خطأً ولا تعدّل الملف.

• base_dir (اختياري): المجلد الذي يجب أن تبقى عمليات الكتابة داخله. الافتراضي هو مجلد العمل الحالي. يُحل المسار النسبي عند إنشاء الأداة، لذا لا ينقل تغيير لاحق لمجلد العمل حدود الـ sandbox.
• encoding (اختياري): ترميز النص المستخدم لكتابة الملف. الافتراضي هو utf-8.

​

المسارات المسموح بها

• يجب أن يكون directory المحلول داخل base_dir (مجلد العمل الحالي افتراضيًا).
• يجب أن يكون مسار الملف المحلول داخل ذلك directory.
• تُحل مقاطع .. والمسارات المطلقة والروابط الرمزية قبل كلا الفحصين.

file_writer_tool = FileWriterTool(base_dir='/var/output')