📘 תיעוד 3

סוכן Cursor

ה-Agent הוא העוזר של Cursor שמסוגל להשלים משימות קידוד מורכבות באופן עצמאי, להריץ פקודות מסוף ולערוך קוד. הגישה אליו מתבצעת בחלונית הצד באמצעות Cmd+I.

למדו עוד על כיצד סוכנים עובדים ועוזרים לכם לבנות מהר יותר.

עבור היקף עבודה גדול יותר, כגון תכונה או הגירה (מיגרציה), צרו Project: סוכן מתאם מתכנן את העבודה ומאציל אותה לסוכנים אחרים.

#כיצד Agent עובד

סוכן בנוי משלושה רכיבים:

1. הנחיות (Instructions): הנחיית המערכת (system prompt) וכללים שמנחים את התנהגות הסוכן
2. כלים (Tools): עריכת קבצים, חיפוש בבסיס הקוד, הרצה במסוף ועוד
3. מודל (Model): מודל הסוכן שאתם בוחרים עבור המשימה

הסוכן של Cursor מתזמר את הרכיבים הללו עבור כל מודל שבו אנו תומכים, ומתאים הנחיות וכלים באופן ייעודי לכל מודל מוביל (frontier model). ככל שמשתחררים מודלים חדשים, אתם יכולים להתמקד בבניית תוכנה בזמן ש-Cursor מטפלת באופטימיזציות הייעודיות למודל.

#כלים (Tools)

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

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

אין מגבלה על מספר הקריאות לכלים ש-Agent יכול לבצע במהלך משימה.

#חיפוש קבצים ותיקיות (Search files and folders)

חיפוש קבצים לפי שם, קריאת מבני תיקיות ומציאת מילות מפתח או תבניות מדויקות בתוך קבצים.

#אינטרנט (Web)

יצירת שאילתות חיפוש וביצוע חיפושים ברשת.

#אחזור כללים (Fetch Rules)

שליפת כללים ספציפיים על פי סוג ותיאור.

#קריאת קבצים (Read files)

קריאה חכמה של תוכן קובץ. תומך גם בקובצי תמונה (.png, .jpg, .gif, .webp, .svg) וכולל אותם בהקשר השיחה לניתוח על ידי מודלים בעלי יכולות ראייה.

#עריכת קבצים (Edit files)

הצעת עריכות לקבצים והחלתן באופן אוטומטי.

#הרצת פקודות מעטפת (Run shell commands)

הרצת פקודות מסוף ומעקב אחר הפלט. כברירת מחדל, Cursor משתמשת בפרופיל המסוף הראשון הזמין.

כדי להגדיר את פרופיל המסוף המועדף עליכם:

1. פתחו את Command Palette (Cmd/Ctrl+Shift+P)
2. חפשו "Terminal: Select Default Profile"
3. בחרו את הפרופיל הרצוי

#דפדפן (Browser)

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

#יצירת תמונות (Image generation)

יצירת תמונות מתיאורי טקסט או מתמונות ייחוס. שימושי ליצירת דגמי ממשק משתמש (UI mockups), נכסי מוצר והמחשה חזותית של תרשימי ארכיטקטורה. תמונות נשמרות בתיקיית assets/ של הפרויקט כברירת מחדל ומוצגות בתוך הצ'אט.

#שאילת שאלות (Ask questions)

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

#נקודות ביקורת (Checkpoints)

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

אם Agent פונה לכיוון לא נכון, לחצו על נקודת ביקורת כלשהי בציר הזמן של הצ'אט כדי לצפות בתצוגה מקדימה של הקבצים שלכם באותה נקודה, ולאחר מכן שחזרו כדי להחזיר את כל הקבצים לאותו מצב. תוכלו גם לשחזר דרך הכפתור Restore Checkpoint בבקשות קודמות או דרך כפתור ה-+ בעת ריחוף מעל הודעה. שחזור נקודת ביקורת מחזיר קבצים בלבד; הוא אינו מסיר הודעות מהשיחה.

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

נקודות ביקורת נשמרות מקומית ובנפרד מ-Git. השתמשו בהן רק כדי לבטל שינויים שביצע Agent; השתמשו ב-Git לניהול גרסאות קבוע.

#הודעות בתור (Queued messages)

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

Media

#שימוש בתור

1. בזמן ש-Agent עובד, הקלידו את ההנחיה הבאה שלכם
2. לחצו על Enter כדי להוסיף אותה לתור
3. הודעות מופיעות לפי הסדר מתחת למשימה הפעילה
4. גררו כדי לשנות את סדר ההודעות שבתור לפי הצורך
5. ה-Agent מעבד אותן ברצף לאחר הסיום

#קיצורי מקלדת

בזמן ש-Agent עובד:

• לחצו על Enter כדי להכניס את ההודעה שלכם לתור (היא ממתינה עד ש-Agent יסיים את המשימה הנוכחית)
• לחצו על Cmd+Enter כדי לשלוח מיד, תוך עקיפת התור

#שליחה מיידית

כאשר אתם משתמשים ב-Cmd+Enter כדי לשלוח מיד, ההודעה שלכם מתווספת להודעת המשתמש האחרונה בצ'אט ומעובדת מיד מבלי להמתין בתור.

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

#ניווט סוכן בזמן ריצה

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

תכונה זו זמינה כעת ב-cursor.com/agents ומופצת כעת ב-Agents Window. לחצו על Tab כדי להכניס את ההודעה לתור למועד שלאחר סיום התור במקום זאת.

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

#צ'אטים צדדיים (Side chats)

פתחו צ'אט צדדי כדי לשאול שאלה או לחקור נושא צדדי מבלי לקטוע את השיחה הראשית. הקלידו /side או /btw בקלט הצ'אט, בתוספת השאלה שלכם כרצונכם, או השתמשו בכפתור הפלוס בחלק העליון של חלונית הצ'אט.

צ'אט צדדי הוא שיחת סוכן קבועה. הוא משתמש בשרשור האב כהקשר ייחוס מוסתר ומחזיק תמליל משלו. אזכור של הצ'אט הצדדי עם @ בשרשור הראשי מושך את ההקשר הזה בחזרה.

#יעדים באמצעות /goal

ה-Agent קורא כל הודעה כמשימה חדשה. השתמשו ב-/goal כדי לתת לסוכן יעד מתמשך לפעול לקראתו עד להשלמתו המלאה:

/goal fix all flaky tests and make CI green

ב-CLI, קיצור המקשים Ctrl+C משהה את היעד. חברו יעד עם Custom Mode כאשר אתם רוצים שהסוכן יפעל לפי תוכנית עבודה (playbook), או עם היכולת המובנית /loop לבדיקות תקופתיות חוזרות בזמן שהוא חותר להשגת היעד.

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

#מפת האתר (Sitemap)

סקירה כללית של כל דפי התיעוד