סקירה כללית של Agent Mode

במאמר הזה מתואר מצב הסוכן ב-Gemini Code Assist.

מצב Agent זמין בסביבות הפיתוח המשולבות (IDE) של VS Code ו-IntelliJ. כדי להתחיל להשתמש ב-Agent Mode, אפשר לעיין במאמר בנושא שימוש ב-Agent Mode ב-Gemini Code Assist.

במצב Agent, אפשר לבצע את הפעולות הבאות ועוד:

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

איך Agent Mode עובד

במצב Agent, ההנחיה שלכם נשלחת ל-Gemini API עם רשימה של כלים שזמינים. ‫Gemini API מעבד את ההנחיה ומחזיר תשובה. יכול להיות שהתשובה תהיה תשובה ישירה או בקשה להשתמש בכלי זמין.

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

  • אם תבקשו מ-Gemini להשתמש בכלי כדי לשנות את מערכת הקבצים או לבצע פעולות שינוי במשאבים כלשהם, Gemini יבקש מכם לאשר את הפעולה, אלא אם הגדרתם את Gemini כך שתמיד יאשר את השימוש בכלי או בכלים.
  • יכול להיות שבקשות לשימוש בכלים שהגישה אליהם היא לקריאה בלבד לא ידרשו הרשאה לפני השלמת המשימה.

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

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

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

ההקשר של Agent Mode

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

בהתאם ל-IDE ולהגדרות, יכול להיות שסוגי הקשר שונים יהיו זמינים לסוכן.

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

VS Code

בדרך כלל, השיטות הבאות לקבלת הקשר זמינות ל-Gemini Code Assist במצב סוכן:

  • מידע בסביבת העבודה שלכם ב-IDE.
  • תשובות של כלים מכלים מובנים כמו grep,‏ terminal,‏ file read או file write.
  • תשובות מחיפוש Google.
  • תוכן מכתובת URL מסוימת שסופקה בהנחיה או על ידי כלי.
  • קבצים של הקשר שאתם יוצרים ב-Markdown.

IntelliJ

בדרך כלל, השיטות הבאות לקבלת הקשר זמינות ל-Gemini Code Assist במצב סוכן:

  • מידע בפרויקט IDE, כולל הקבצים, הסמלים המאונדקסים והשימוש בסמלים בפרויקט.
  • תשובות של כלים מכלים מובנים כמו grep, קריאת קובץ או כתיבת קובץ.
  • ניהול גרסאות ב-IntelliJ.
  • שרתים וכלים של MCP שהוגדרו
  • קבצים של הקשר שאתם יוצרים ב-Markdown.

אפשר לראות את ההקשר שזמין ל-Agent בחלונית ההקשר באזור ההנחיה של הצ'אט במצב Agent.

מגירת ההקשר של Agent Mode.

כלים

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

דוגמאות לכלים כאלה הם כלים מובנים כמו grep וקריאה או כתיבה של קבצים, שרתי Model Context Protocol (MCP) מקומיים או מרוחקים והפונקציות הניתנות להרצה שלהם, וקריאות API בארכיטקטורת REST.

כלים מובנים

במצב Agent, ל-Gemini יש גישה לכלים המובנים של המערכת. בוחרים את סביבת הפיתוח המשולבת כדי לראות רשימה של כלים מובנים שזמינים ל-Gemini במצב Agent.

VS Code

כל הכלים המובנים של Gemini CLI זמינים ב-Agent Mode ב-Gemini Code Assist.

IntelliJ

read_file
מאחזר את תוכן הטקסט של קובץ באמצעות הנתיב המוחלט שלו.
write_file
כותב את הטקסט שצוין לקובץ מסוים, ויוצר את הקובץ אם הוא לא קיים.
analyze_current_file
מנתח את הקובץ הפתוח בכלי העריכה כדי למצוא שגיאות ואזהרות.
find_files
חיפוש הנתיב המוחלט לקבצים לפי שם הקובץ או חלק מהנתיב
grep
חיפוש כל הקבצים בפרויקט שמכילים דפוס טקסט או ביטוי רגולרי מסוים.
list_files
מציג רשימה של כל הקבצים והספריות בנתיב מוחלט נתון.
resolve_symbol
פותרים הפניה לסמל ספציפי להצהרה המקורית שלו.
find_usages
חיפוש בפרויקט של כל ההפניות להצהרת סמל נתונה.
git
מריצה פקודה של ממשק שורת הפקודה (CLI) של Git ומחזירה את התוצאה.
list_vcs_roots
מחזירה את כל השורשים של מערכת ניהול הגרסאות (VCS), כמו מאגרי Git, בפרויקט הנוכחי.

מגבלות

יכול להיות שחלק מהתכונות של הצ'אט הרגיל של Gemini Code Assist לא יהיו זמינות במצב סוכן, או שיפעלו בצורה שונה מהצורה שבה הן פועלות בצ'אט הרגיל.

הקראה אינה זמינה במצב Agent. במצב Agent, Gemini לא מצטט מקורות ואי אפשר להשבית הצעות לקוד שתואמות למקורות המצוטטים.

המאמרים הבאים