📘 תיעוד 3

סוכן Cursor

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

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

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

#כיצד Agent עובד

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

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

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

#כלים

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

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

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

#חיפוש קבצים ותיקיות

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

#רשת

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

#אחזור כללים

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

#קריאת קבצים

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

#עריכת קבצים

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

#הרצת פקודות מעטפת

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

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

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

#דפדפן

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

#יצירת תמונות

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

#שאילת שאלות

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

#נקודות ביקורת

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

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

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

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

#הודעות בתור

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

מדיה

#שימוש בתור

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 או /btw בשדה הקלט של הצ'אט, בצירוף השאלה שלכם לפי בחירתכם, או השתמשו בכפתור הפלוס בחלק העליון של חלונית הצ'אט.

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

#חיפוש בשיחות

חפשו בתמלילי עבר של סוכנים מתוך Agents Window. לחצו על Cmd+K ב-Mac או על Ctrl+K ב-Windows וב-Linux כדי לפתוח את לוח הפקודות, ולאחר מכן חפשו בין שיחות. Cursor בונה אינדקס חיפוש מקומי.

כדי למצוא טקסט בתוך השיחה הפתוחה, לחצו על Cmd+F ב-Mac או על Ctrl+F ב-Windows וב-Linux.

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

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

/goal fix all flaky tests and make CI green

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

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

#מפת האתר

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