Personnaliser Gemini à l'aide de fichiers AGENT.md

Donnez à Gemini dans Android Studio des instructions personnalisées à suivre à l'aide d'un ou de plusieurs fichiers AGENT.md. Les fichiers AGENT.md sont placés à côté des autres fichiers de votre codebase. Il est donc facile de les archiver 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 programmation et d'autres conseils avec toute votre équipe.

Pour commencer, procédez comme suit :

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

2. Ajoutez vos instructions. Rédigez vos instructions à l'aide de Markdown. Pour plus de clarté, pensez à utiliser des titres et des puces pour les différentes règles. Voir des exemples d'instructions

3. Enregistrez le fichier et validez-le dans votre système de gestion de versions pour le partager avec votre équipe.

Gérer les fichiers AGENT.md comme contexte

Vous pouvez appliquer ou supprimer des fichiers AGENT.md comme contexte pour une requête spécifique à l'aide du panneau Contexte dans le panneau de chat. L'option Fichiers AGENT.md inclut tous les fichiers AGENT.md du répertoire actuel et de ses répertoires parents.

Exemples d'instructions

Vous pouvez utiliser le fichier AGENT.md pour donner des instructions à l'agent. Vous trouverez ci-dessous 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 qui gère les requêtes HTTP se trouve à l'adresse <path>."
• Architecture du projet
  • "Placez toute la logique métier dans les ViewModels."
  • "Suivez toujours les recommandations officielles en matière d'architecture, y compris l'utilisation d'une architecture en couches. Utilisez un flux de données unidirectionnel (UDF), des ViewModels, la collecte de l'état de l'UI en tenant compte du cycle de vie et d'autres recommandations."
• Bibliothèques préférées : "Utilise la bibliothèque <nom de la bibliothèque> pour la navigation."
• Définir des noms de substitution pour les services d'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ère pas les mises en page basées sur XML."

Modulariser vos fichiers AGENT.md

Vous pouvez diviser les fichiers AGENT.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. Référencez les fichiers Markdown plus petits dans un fichier AGENT.md en utilisant le 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 relatifs :
     • @./file.md : importer depuis le même répertoire
     • @../file.md : importer depuis le répertoire parent
     • @./subdirectory/file.md : importer depuis un sous-répertoire
   • Chemins absolus : @/absolute/path/to/file.md

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

# My AGENT.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

Fonctionnement des fichiers AGENT.md

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

Quelle est la différence entre les fichiers AGENT.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 requêtes. Toutefois, les règles sont définies dans le fichier IntelliJ /.idea/project.prompts.xml, tandis que les fichiers AGENT.md sont enregistrés à côté de votre code source et sont indépendants de l'IDE. Nous vous recommandons d'utiliser des fichiers AGENT.md si l'un des principaux objectifs est de partager les instructions avec votre équipe.