Personnaliser Gemini à l'aide de fichiers AGENTS.md

Donnez à Gemini dans Android Studio des instructions personnalisées à suivre à l'aide d'un ou de plusieurs fichiers AGENTS.md. Les fichiers AGENTS.md sont placés à côté des autres fichiers de votre codebase. Il est donc facile de les enregistrer dans votre système de contrôle des versions (VCS) et de partager des instructions spécifiques au projet, des règles de style de codage et d'autres conseils avec l'ensemble de votre équipe.

Pour commencer, procédez comme suit :

1. Créez un fichier AGENTS.md n'importe où dans le système de fichiers de votre projet. Lorsque vous envoyez une requête, Gemini analyse le répertoire actuel et tous les répertoires parents à la recherche de fichiers AGENTS.md. Pour en savoir plus, consultez Fonctionnement des fichiers AGENTS.md work.

2. Ajoutez vos instructions. Rédigez vos instructions au format Markdown. Pour une meilleure lisibilité, envisagez d'utiliser des titres et des puces pour différentes règles. Consultez des exemples d'instructions.

3. Enregistrez le fichier et validez-le dans votre VCS pour le partager avec votre équipe.

Gérer les fichiers AGENTS.md en tant que contexte

Vous pouvez appliquer ou supprimer des fichiers AGENTS.md en tant que contexte pour une requête particulière à l'aide du panneau Context (Contexte) dans le panneau de chat. L'option AGENTS.md Files (Fichiers AGENTS.md) inclut tous les fichiers AGENTS.md du répertoire actuel et de ses répertoires parents.

Exemples d'instructions

Vous pouvez utiliser le fichier AGENTS.md pour donner des instructions à l'agent. Voici quelques exemples, mais les instructions que vous fournissez doivent être spécifiques à votre projet.

• "L'activité principale est /path/to/MainActivity.kt."
• "Le code permettant de naviguer entre les écrans est path/to/navigation/UiNavigation.kt."
• Le code gérant les requêtes HTTP se trouve dans <path>.
• Architecture du projet
  • "Placez toute la logique métier dans les ViewModels."
  • "Suivez toujours les recommandations d'architecture officielles, y compris l'utilisation d'une architecture en couches. Utilisez un flux de données unidirectionnel (UDF), des ViewModels, une collecte d'état de l'UI tenant compte du cycle de vie et d'autres recommandations."
• Bibliothèques préférées : "Utilisez la bibliothèque <nom de la bibliothèque> pour la navigation."
• Définition de noms d'espace réservé pour les services API courants ou la terminologie interne : "Le service de backend principal est appelé 'PhotoSift-API'."
• Guides de style de l'entreprise : "Tous les nouveaux composants d'UI doivent être créés avec Jetpack Compose. Ne suggérez pas de mises en page basées sur XML."

Modulariser vos fichiers AGENTS.md

Vous pouvez diviser les fichiers AGENTS.md volumineux en fichiers plus petits qui peuvent être réutilisés dans différents contextes :

1. Séparez un ensemble d'instructions et enregistrez-les dans un autre fichier Markdown, tel que style-guidance.md.

2. Faites référence aux fichiers Markdown plus petits dans un fichier AGENTS.md à l'aide du symbole @ suivi du chemin d'accès au fichier que vous souhaitez importer. Les formats de chemin d'accès suivants sont acceptés :

   • Chemins d'accès relatifs :
     • @./file.md : importer à partir du même répertoire
     • @../file.md : importer à partir du répertoire parent
     • @./subdirectory/file.md : importer à partir d'un sous-répertoire
   • Chemins d'accès absolus : @/absolute/path/to/file.md

Par exemple, le fichier AGENTS.md suivant fait référence à deux autres fichiers d'instructions :

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style {:#coding-style}

@./shared/style-guidance.md

Fonctionnement des fichiers AGENTS.md

Gemini analyse automatiquement le répertoire actuel et les répertoires parents à la recherche de fichiers AGENTS.md, puis ajoute leur contenu au début de chaque invite en tant que préambule. Si aucun fichier n'est ouvert lorsque vous envoyez une requête, le fichier AGENTS.md à la racine du projet (le cas échéant) est inclus par défaut.

Quelle est la différence entre les fichiers AGENTS.md et les règles ?

Les règles vous permettent également de définir des instructions et des préférences qui s'appliquent à toutes les invites. Toutefois, les règles sont définies dans le fichier IntelliJ /.idea/project.prompts.xml, tandis que les fichiers AGENTS.md sont enregistrés à côté de votre code source et sont indépendants de l'IDE. Nous vous recommandons d'utiliser des fichiers AGENTS.md si l'un des principaux objectifs est de partager les instructions avec votre équipe.

Quelle est la différence entre les fichiers AGENTS.md et les compétences ?

Les compétences représentent une expertise à la demande qui est appelée lorsque votre requête correspond à une description de compétence, tandis que le contenu de AGENTS.md est ajouté au début de chaque invite. Nous vous recommandons d'utiliser des compétences pour des tâches spécifiques et des fichiers AGENTS.md pour influencer le comportement général de l'agent. Pour en savoir plus sur les compétences, consultez la présentation des compétences Android.