💬 פרק 4

עבודה עם Agent: הסוכן האוטונומי של קרסור

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

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

#כיצד Agent עובד

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

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

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

#כלי העבודה של הסוכן (Tools)

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

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

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

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

#רשת (Web)

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

#שליפת חוקים (Fetch Rules)

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

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

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

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

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

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

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

כדי להגדיר את פרופיל הטרמינל המועדף:

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

#דפדפן (Browser)

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

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

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

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

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

#סיכום כלי העבודה

#נקודות שחזור (Checkpoints)

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

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

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

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

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

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

#שימוש בתור (Using the queue)

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

#קיצורי מקשים

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

• לחיצה על Enter: מוסיפה את ההודעה לתור (ממתינה עד שהסוכן יסיים את המשימה הנוכחית).
• לחיצה על Cmd+Enter: שולחת את ההודעה מיד ועוקפת את התור.

#שליחה מיידית (Immediate messaging)

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

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

#היגוי סוכן פועל (Steer a running agent)

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

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

בממשק שורת הפקודה (CLI):

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

#טבלת דרכי תקשורת עם סוכן פעיל

#שיחות צד (Side chats)

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

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

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

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

/goal fix all flaky tests and make CI green

התנהגויות ושילובים של יעדים:

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