מצב סוכן

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

דרישות מערכת

מצב הסוכן זמין החל מ-Android Studio Narwhal Feature Drop Canary 4. הורדה של גרסת התצוגה המקדימה האחרונה של Android Studio

שנתחיל?

כדי להתחיל להשתמש במצב סוכן ב-Android Studio, פועלים לפי השלבים הבאים:

1. בסרגל הצד, לוחצים על Gemini . אם צריך, נכנסים לחשבון ומצטרפים ל-Google Workspace.
2. בוחרים בכרטיסייה סוכן.
3. מתארים את המשימה שרוצים שהסוכן יבצע.

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

   

5. אופציונלי: כדי לאשר שינויים באופן אוטומטי, בוחרים באפשרות אפשרויות של סוכן > אישור אוטומטי של שינויים.

   

תרחישים לדוגמה

הנה כמה דוגמאות לתרחישי שימוש שבהם הסוכן יכול לעזור לכם:

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

  

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

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

הנחיות נוספות שאפשר לנסות:

• ‫"Write unit tests for <class> in <module>."
• ‫"Generate documentation for the currently open file" (יצירת תיעוד לקובץ שפתוח כרגע).
• "תשנה את שם האפליקציה מ-<השם הנוכחי> ל-<השם החדש>".
• ‫"Resolve the null pointer exception"‏ (פתרון חריגת מצביע null).
• "תבצע רפקטורינג בקוד שלי על ידי העברת הקומפוזיבל [שם הקומפוזיבל] לקובץ חדש. צריך לוודא שכל הייבוא עודכן".
• "תוסיף כפתור חדש למסך הבית של האפליקציה בשם 'מעקב' שיוביל לרשימת נושאים".
• ‫"In the <composable name> composable, reduce the padding of the <modifier name> modifier."
• "צור לחצן שיתוף כדי לשתף ברשתות חברתיות".

הוספת מפתח Gemini API

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

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

כדי לקבל מפתח API:

1. נכנסים ל-Google AI Studio ולוחצים על הלחצן Get API key (קבלת מפתח API) כדי לקבל מפתח.
2. ב-Android Studio, עוברים אל File (Android Studio ב-macOS) > Settings > Tools > Gemini כדי להזין את מפתח Gemini API.
3. מפעילים מחדש את Gemini ב-Android Studio ומקבלים תשובות טובות יותר ממצב הסוכן.

חשוב לשמור על מפתח Gemini API כי יחולו חיובים נוספים על שימוש ב-Gemini API שמשויך למפתח API אישי. אתם יכולים לעקוב אחרי השימוש במפתח Gemini API ב-AI Studio דרך Get API Key > Usage & Billing (קבלת מפתח API > שימוש וחיוב).

הוספה של שרת MCP

סוכן ה-AI של Gemini ב-Android Studio יכול ליצור אינטראקציה עם כלים חיצוניים באמצעות פרוטוקול הקשר של המודל (MCP). התכונה הזו מספקת דרך סטנדרטית למצב סוכן להשתמש בכלים ולהרחיב את הידע והיכולות שלו באמצעות הסביבה החיצונית.

יש הרבה כלים שאפשר לחבר למארח MCP ב-Android Studio. לדוגמה, אפשר לבצע שילוב עם שרת ה-MCP של GitHub כדי ליצור בקשות משיכה ישירות מ-Android Studio. רעיונות נוספים זמינים בדוגמאות לשרתי MCP.

כדי להוסיף שרת MCP, יוצרים קובץ mcp.json וממקמים אותו בתיקיית ההגדרות של Studio. קובץ ה-mcp.json צריך להיות בפורמט הבא:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

במסמכי התיעוד של שרת ה-MCP שאיתו אתם משלבים את המערכת, מפורטים הערכים המדויקים של command ושל args שצריך לציין בקובץ הזה. יכול להיות שתצטרכו גם להתקין כלים כמו Node.js או Docker, בהתאם לדרישות התוכנה של שרת ה-MCP.

מגבלות

יש כמה מגבלות חשובות לשילוב של MCP ב-Android Studio:

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

איך הסוכן פועל

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

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