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

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

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

במצב סוכן, אתם יכולים לבצע את הפעולות הבאות ועוד:

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

איך פועל Agent Mode

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

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

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

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

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

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

ההקשר של Agent Mode

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

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

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

VS Code

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

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

IntelliJ

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

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

אתם יכולים לראות את ההקשר שזמין לנציג בחלונית ההקשר באזור הנחיית השיחה במצב נציג.

חלונית ההקשר של Agent Mode.

כלים

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

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

כלים מובנים

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

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 לא יהיו זמינות במצב סוכן, או שהן יפעלו בצורה שונה מאשר בצ'אט הרגיל.

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

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