התאמה אישית של Gemini באמצעות קובצי AGENTS.md

אתם יכולים לתת ל-Gemini ב-Android Studio הוראות מותאמות אישית לפעולה באמצעות קובץ אחד או יותר של AGENTS.md. קובצי AGENTS.md ממוקמים לצד הקבצים האחרים בבסיס הקוד, כך שקל להכניס אותם למערכת בקרת הגרסאות (VCS) ולשתף עם כל הצוות הוראות ספציפיות לפרויקט, כללים לסגנון קידוד והנחיות אחרות.

תחילה, מבצעים את הפעולות הבאות:

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

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

3. שומרים את הקובץ ומבצעים commit למערכת בקרת הגרסאות כדי לשתף אותו עם הצוות.

ניהול קבצים של AGENTS.md כהקשר

אתם יכולים להוסיף או להסיר קבצים של AGENTS.md כהקשר לשאילתה מסוימת באמצעות מגירת ההקשר בחלונית הצ'אט. האפשרויות של AGENTS.md קבצים כוללות את כל הקבצים AGENTS.md בספרייה הנוכחית ובספריות האם שלה.

AGENTS.md

הוראות לדוגמה

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

• "הפעילות העיקרית היא /path/to/MainActivity.kt".
• "הקוד לתמיכה בניווט בין המסכים הוא path/to/navigation/UiNavigation.kt"
• "הקוד שמטפל בבקשות HTTP נמצא בכתובת <path>".
• ארכיטקטורת הפרויקט
  • "כדאי למקם את כל הלוגיקה העסקית ב-ViewModels".
  • "תמיד צריך לפעול לפי ההמלצות הרשמיות לגבי ארכיטקטורה, כולל שימוש בארכיטקטורה שכבתית. שימוש בזרימת נתונים חד-כיוונית (UDF), ב-ViewModels, באיסוף של מצב ממשק המשתמש שמודע למחזור החיים ובהמלצות אחרות".
• ספריות מועדפות: "תשתמש בספרייה <שם הספרייה> לניווט".
• הגדרת שמות של placeholder לשירותי API נפוצים או לטרמינולוגיה פנימית: "שירות לקצה העורפי הראשי נקרא PhotoSift-API".
• מדריכי סגנון של חברות: "כל רכיבי ממשק המשתמש החדשים חייבים להיבנות באמצעות Jetpack Compose. אל תציע פריסות שמבוססות על XML".

חלוקת קובצי AGENTS.md למודולים

אפשר לפצל קובצי AGENTS.md גדולים לקבצים קטנים יותר שאפשר לעשות בהם שימוש חוזר בהקשרים שונים:

1. להפריד קבוצת הוראות ולשמור אותן בקובץ Markdown אחר, למשל style-guidance.md.

2. אפשר להפנות לקובצי Markdown קטנים יותר בקובץ AGENTS.md באמצעות הסמל @ ואחריו הנתיב לקובץ שרוצים לייבא. אפשר להשתמש בפורמטים הבאים של נתיבים:

   • נתיבים יחסיים:
     • ‫@./file.md – ייבוא מאותה ספרייה
     • ‫@../file.md – ייבוא מספריית האב
     • ‫@./subdirectory/file.md – ייבוא מספריית משנה
   • נתיבים מוחלטים: @/absolute/path/to/file.md

לדוגמה, קובץ AGENTS.md הבא מפנה לשני קובצי הוראות אחרים:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

הסבר על קובצי AGENTS.md

‫Gemini סורק באופן אוטומטי את הספרייה הנוכחית ואת ספריות האב כדי למצוא קבצים מסוג AGENTS.md, ומוסיף את התוכן שלהם לתחילת כל הנחיה בתור מבוא. אם לא פותחים קובץ כששולחים שאילתה, קובץ AGENTS.md בשורש הפרויקט (אם יש כזה) נכלל כברירת מחדל.

מה ההבדל בין קובצי AGENTS.md לבין כללים?

כללים מאפשרים לכם גם להגדיר הוראות והעדפות שחלות על כל ההנחיות. עם זאת, הכללים מוגדרים בקובץ IntelliJ‏ /.idea/project.prompts.xml, ואילו קובצי AGENTS.md נשמרים לצד קוד המקור והם לא תלויים ב-IDE. מומלץ להשתמש בקובצי AGENTS.md אם אחת מהמטרות העיקריות היא לשתף את ההוראות עם הצוות.

מה ההבדל בין קובצי AGENTS.md לבין מיומנויות?

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