כלי מערכת קבצים ו-Shell

Triggerfish מספק לסוכן כלי מערכת קבצים ו-shell כלליים לקריאה, כתיבה, חיפוש והרצת פקודות. אלו הם הכלים הבסיסיים שעליהם יכולות אחרות (סביבת ביצוע, חקירה, מיומנויות) בנויות.

כלים

read_file

קריאת תוכן קובץ בנתיב מוחלט.

פרמטר	סוג	נדרש	תיאור
path	string	כן	נתיב קובץ מוחלט לקריאה

מחזיר את תוכן הטקסט המלא של הקובץ.

write_file

כתיבת תוכן לקובץ בנתיב יחסי למרחב העבודה.

פרמטר	סוג	נדרש	תיאור
path	string	כן	נתיב יחסי במרחב העבודה
content	string	כן	תוכן קובץ לכתיבה

כתיבות מוגבלות לספריית מרחב העבודה של הסוכן. הסוכן אינו יכול לכתוב למיקומים שרירותיים במערכת הקבצים.

edit_file

החלפת מחרוזת ייחודית בקובץ. old_text חייב להופיע בדיוק פעם אחת בקובץ.

פרמטר	סוג	נדרש	תיאור
path	string	כן	נתיב קובץ מוחלט לעריכה
old_text	string	כן	טקסט מדויק למציאה (חייב להיות ייחודי בקובץ)
new_text	string	כן	טקסט להחלפה

זהו כלי עריכה כירורגי -- הוא מוצא התאמה מדויקת אחת ומחליף אותה. אם הטקסט מופיע יותר מפעם אחת או בכלל לא, הפעולה נכשלת עם שגיאה.

list_directory

רשימת קבצים וספריות בנתיב מוחלט נתון.

פרמטר	סוג	נדרש	תיאור
path	string	כן	נתיב ספרייה מוחלט לרשימה

מחזיר רשומות עם סיומת / לספריות.

search_files

חיפוש קבצים התואמים לדפוס glob, או חיפוש בתוכן קבצים עם grep.

פרמטר	סוג	נדרש	תיאור
path	string	כן	ספרייה לחפש בה
pattern	string	כן	דפוס glob לשמות קבצים, או טקסט/regex לחיפוש בתוך קבצים
content_search	boolean	לא	אם true, חפש בתוכן קבצים במקום בשמות קבצים

run_command

הרצת פקודת shell בספריית מרחב העבודה של הסוכן.

פרמטר	סוג	נדרש	תיאור
command	string	כן	פקודת shell להרצה

מחזיר stdout, stderr וקוד יציאה. פקודות מורצות בספריית מרחב העבודה של הסוכן. וו PRE_TOOL_CALL בודק פקודות מול רשימת חסימה לפני ביצוע.

קשר לכלים אחרים

כלי מערכת קבצים אלו חופפים לכלי סביבת הביצוע (exec.write, exec.read, exec.run, exec.ls). ההבחנה:

• כלי מערכת קבצים פועלים על נתיבים מוחלטים ומרחב העבודה ברירת המחדל של הסוכן. הם תמיד זמינים.
• כלי exec פועלים בתוך מרחב עבודה מובנה עם בידוד מפורש, מריצי בדיקות והתקנת חבילות. הם חלק מאינטגרציית סביבת הביצוע.

הסוכן משתמש בכלי מערכת קבצים לפעולות קבצים כלליות ובכלי exec כאשר עובד בזרימת עבודה פיתוח (לולאת כתיבה/הרצה/תיקון).

אבטחה

• write_file מוגבל לספריית מרחב העבודה של הסוכן
• run_command עובר דרך וו PRE_TOOL_CALL עם הפקודה כהקשר
• רשימת חסימת פקודות חוסמת פעולות מסוכנות (rm -rf /, sudo, וכו')
• כל תגובות הכלים עוברות דרך POST_TOOL_RESPONSE לסיווג ומעקב זיהום
• במצב תכנון, write_file חסום עד שהתוכנית מאושרת