מצב סוכן

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

מצב הסוכן זמין בסביבות הפיתוח המשולבות (IDE) של VS Code ו-IntelliJ. כדי להתחיל להשתמש במצב סוכן, אפשר לעיין במאמר בנושא שימוש בצ'אט עם סוכן כמתכנת שותף.

מצב הסוכן ב-VS Code מבוסס על Gemini CLI.

מצב הסוכן ב-IntelliJ לא משתמש ב-Gemini CLI.

במצב סוכן אפשר לבצע את הפעולות הבאות ועוד:

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

איך מצב הסוכן פועל

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

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

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

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

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

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

הקשר של מצב הנציג

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

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

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

VS Code

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

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

הזיכרון של נציג התמיכה

מצב הסוכן של Gemini Code Assist ב-VS Code מסתמך על שירות גילוי הזיכרון של Gemini CLI כדי למצוא ולטעון GEMINI.mdקבצים שמספקים הקשר לסוכן. שירות איתור הזיכרון מחפש את הקבצים האלה בהיררכיה, החל מספריית העבודה הנוכחית ועד לשורש הפרויקט ולספריית הבית. הוא גם מחפש בספריות משנה.

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

אפשר להשתמש בפקודה /memory show כדי לראות את התוכן המשולב של כל הקבצים GEMINI.md שנטענו, ובפקודה /memory refresh כדי לטעון אותם מחדש.

IntelliJ

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

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

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

חלונית ההקשר במצב נציג.

כלים

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

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

כלים מובנים

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

VS Code

כל הכלים המובנים של Gemini CLI זמינים במצב סוכן ב-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 לא מצטט מקורות ואי אפשר להשבית הצעות לקוד שתואמות למקורות המצוטטים.

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