סדר במוח של הסוכן: איך לארגן הוראות מערכת עם Markdown

תוכן עניינים

כאשר אנו כותבים הוראות מערכת (System Prompt) לסוכן AI, המטרה שלנו היא להיות ברורים ככל האפשר. אנחנו רוצים שהסוכן יבין בדיוק את תפקידו, מגבלותיו והוראות הפעולה שלו, ללא שום מקום לפרשנות שגויה. שימוש ב-Markdown הוא הדרך הטכנית להשיג את הבהירות הזו.

 

Markdown היא שפת סימון פשוטה המאפשרת לנו לעצב טקסט, ליצור היררכיה, ולהדגיש חלקים חשובים. במקום לכתוב פסקה ארוכה ורציפה, Markdown מאפשר לנו "לפרק" את ההוראות לחלקים לוגיים שהמודל יכול לעבד בקלות רבה יותר – ממש כמו שאנחנו קוראים מסמך PDF או Word, הכולל כותרות, כותרות משנה, הדגשות, רשימות וכו׳. זה לא עניין אסתטי בלבד, עבור AI, מבנה ברור שקול להוראות מדויקות יותר.

 

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

 

שימו לב: מומלץ לתרגל את תוכן מדריך זה בעורכי-Markdown אונליין, כמו לדוגמא: https://markdownlivepreview.com.
 


שימוש בכותרות (Headings)

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

 

  • רמה 1 (נדיר בשימוש): # Main Header (בדרך כלל שמורה לשם הסוכן)
  • רמה 2 (הכי נפוץ): ## Primary Topic (למשל: ## Role, ## Instructions)
  • רמה 3 (לנושאי משנה): ### Secondary Topic (למשל: ### Tone of Voice)

 

דוגמה לשימוש:


# Customer Service Agent
 
## Role
You are a customer service agent...
 
## Goal
Your goal is to resolve customer issues...
 
## Instructions
### Tone of Voice
- Always be polite and empathetic.
 
### Constraints
- Never promise a refund without approval.

 
הטקסט הנ״ל מקביל למבנה המסמך הבא:

Customer Service Agent

Role

You are a customer service agent…

 

Goal

Your goal is to resolve customer issues…

 

Instructions

Tone of Voice

  • Always be polite and empathetic.

Constraints

  • Never promise a refund without approval.

הדגשות (Emphasis)

הדגשה (Bold) ונטוי (Italic) משמשות כדי למשוך את תשומת הלב של המודל למילים קריטיות. זה עוזר לו להבין מהן מילות המפתח החשובות ביותר בהוראה.

 

  • הדגשה (Bold): **Bold Text** או __Bold Text__
  • נטוי (Italic): *Italic Text* או _Italic Text_

 

דוגמה לשימוש:


- You must **always** verify the user's ID before proceeding.
- **Never** share personal information with an unverified user.
- Respond in a *friendly* but *professional* manner.

 

טיפ: השתמשו בהדגשה עבור פקודות מוחלטות (כמו Always, Never) ועבור מושגי מפתח שהסוכן חייב לזכור.


רשימות (Lists)

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

 

  • רשימת בולטים (Bullets): השתמשו ב *, -, או + בתחילת שורה.
  • רשימה ממוספרת (Ordered): השתמשו במספר ונקודה (1., 2.).

 

דוגמה לשימוש (שילוב של רשימות):


## Instructions
1. Greet the user and ask for their name.
2. Ask for their request.
3. When analyzing the request, follow these steps:
    * Identify the main topic (e.g., Billing, Technical Support).
    * Extract key entities (e.g., account number, error code).
    * **Always** confirm the details with the user before taking action.
4. If the topic is Billing, transfer to the `billing_tool`.

קווים מפרידים (Separators)

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

 

  • כדי ליצור קו: הקלידו ---, ***, או ___ בשורה נפרדת.

 

דוגמה לשימוש:


## Role and Goal
You are a helpful assistant. Your goal is to answer questions.
 
---
 
## Constraints
- Do not discuss politics.
- Do not use slang.
- Keep answers under 100 words.
 
---
 
## Tools
You have access to the following tools...

סיכום

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