מפרט כלי לסוכן AI משפטי

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

מה הכלי עושה: [תיאור] מערכת היעד: [API / מסד נתונים / מערכת קבצים] האם הפעולה הפיכה: [כן / לא]

הפק:

1. שם הכלי — פועל_עצם, מפורש. הימנע משמות כלליים כמו process או handle.
2. תיאור — שתיים עד ארבע שורות שעונות על: מה הכלי עושה, מתי להשתמש בו, ובמפורש מתי לא. רוב כשלי הסוכן הם בחירת כלי שגוי, לא פרמטרים שגויים.
3. סכמת פרמטרים — JSON Schema עם type, description ו-required לכל שדה. כל תיאור פרמטר חייב לכלול דוגמה. השתמש ב-enum במקום מחרוזת חופשית בכל מקום אפשרי.
4. סכמת החזרה — מה חוזר בהצלחה, כולל השדות שהמודל צריך כדי להחליט על הצעד הבא.
5. שגיאות — כל מצב שגיאה עם הודעה שהמודל יכול לפעול לפיה. "Error 500" חסר תועלת; "לא נמצא לקוח עם המזהה הזה — ודא את המזהה או חפש לפי שם" מאפשר התאוששות.
6. הרשאות ואישור — אם הפעולה בלתי הפיכה, כותבת נתונים, שולחת החוצה או עולה כסף: דרוש אישור מפורש. פרט מה מוצג למאשר לפני ההרצה.
7. גבולות — מגבלת קצב, גודל מקסימלי, timeout, וכמה פעמים מותר לקרוא לכלי ברצף.
8. שלוש דוגמאות קריאה תקינות ושתי דוגמאות שגויות עם ההודעה שתחזור.