במאמר הזה מתואר מצב הסוכן ב-Gemini Code Assist.
מצב סוכן זמין בסביבות הפיתוח המשולבות (IDE) של VS Code ו-IntelliJ. כדי להתחיל להשתמש ב-Agent Mode, אפשר לעיין במאמר בנושא שימוש ב-Agent Mode ב-Gemini Code Assist.
במצב סוכן, אפשר לבצע את הפעולות הבאות ועוד:
- לשאול שאלות לגבי הקוד.
- אפשר להשתמש בהקשר ובכלים המובנים כדי לשפר את התוכן שנוצר.
- הגדרת שרתי MCP כדי להרחיב את היכולות של הסוכן.
- קבלת פתרונות למשימות מורכבות עם כמה שלבים.
- ליצור קוד ממסמכי עיצוב, מבעיות ומ
TODOתגובות. - שליטה בהתנהגות של הסוכן באמצעות הוספת הערות, עריכה ואישור של תוכניות ושימוש בכלי במהלך ההרצה.
איך פועל Agent Mode
במצב סוכן, ההנחיה שלכם נשלחת ל-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.
אפשר לראות את ההקשר שזמין לסוכן בחלונית ההקשר באזור ההנחיה של הצ'אט במצב סוכן.
כלים
כלים הם קטגוריה רחבה של שירותים שנציג יכול להשתמש בהם כדי להבין את ההקשר ולבצע פעולות בתשובה להנחיה. הכלים מאפשרים לסוכנים לגשת למידע עדכני באמצעות קריאה לפונקציות לנקודות קצה של API או לסוכנים אחרים. יכול להיות שכלי יציע רק פונקציה אחת, או שהוא יציע כמה פונקציות קשורות.
דוגמאות לכלים: כלים מובנים כמו grep וקריאה או כתיבה של קבצים, שרתים מקומיים או מרוחקים של Model Context Protocol (MCP) והפונקציות הניתנות להפעלה שלהם, וקריאות ל-API מסוג RESTful.
כלים מובנים
במצב סוכן, ל-Gemini יש גישה לכלים המובנים של המערכת. בוחרים את סביבת הפיתוח המשולבת כדי לראות רשימה של כלים מובנים שזמינים ל-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 לא יהיו זמינות במצב סוכן, או שיפעלו בצורה שונה מהצורה שבה הן פועלות בצ'אט הרגיל.
אי אפשר להשתמש בהקראה במצב נציג. במצב סוכן, Gemini לא מצטט מקורות ואי אפשר להשבית הצעות לקוד שתואמות למקורות המצוטטים.