Gemini mit AGENT.md-Dateien anpassen

Sie können Gemini in Android Studio benutzerdefinierte Anweisungen geben, die anhand einer oder mehrerer AGENT.md-Dateien ausgeführt werden. AGENT.md-Dateien werden neben den anderen Dateien in Ihrer Codebasis platziert. Sie können sie also ganz einfach in Ihr Versionsverwaltungssystem (VCS) einchecken und projektspezifische Anweisungen, Regeln für den Programmierstil und andere Anleitungen für Ihr gesamtes Team freigeben.

Die App lässt sich so aktivieren:

  1. Erstellen Sie eine AGENT.md-Datei an einer beliebigen Stelle im Dateisystem Ihres Projekts. Wenn Sie eine Anfrage senden, durchsucht Gemini das aktuelle Verzeichnis und alle übergeordneten Verzeichnisse nach AGENT.md-Dateien. Weitere Informationen finden Sie unter Funktionsweise von AGENT.md-Dateien.

  2. Fügen Sie Ihre Anweisungen hinzu. Schreiben Sie Ihre Anleitung mit Markdown. Um die Lesbarkeit zu verbessern, sollten Sie Überschriften und Aufzählungspunkte für die verschiedenen Regeln verwenden. Beispielanleitung

  3. Speichern Sie die Datei und übertragen Sie sie in Ihr Versionsverwaltungssystem, um sie für Ihr Team freizugeben.

AGENT.md-Dateien als Kontext verwalten

Sie können AGENT.md-Dateien als Kontext für eine bestimmte Anfrage über die Kontext-Schublade im Chatbereich hinzufügen oder entfernen. Die Optionen unter AGENT.md Dateien umfassen alle AGENT.md-Dateien im aktuellen Verzeichnis und in den übergeordneten Verzeichnissen.

AGENT.md-Dateien als Kontext verwalten
Abbildung 1: AGENT.md-Dateien als Kontext verwalten

Beispielanweisungen

Sie können die Datei AGENT.md verwenden, um dem Agent Anweisungen zu geben. Im Folgenden finden Sie einige Beispiele. Die Anleitungen, die Sie bereitstellen, sollten jedoch spezifisch für Ihr Projekt sein.

  • „Die Hauptaktivität ist /path/to/MainActivity.kt.“
  • „Der Code für die Navigation zwischen Bildschirmen ist path/to/navigation/UiNavigation.kt“
  • „Der Code für die Verarbeitung von HTTP-Anfragen befindet sich unter <path>.“
  • Projektarchitektur
    • „Place all business logic in ViewModels.“ (Die gesamte Geschäftslogik in ViewModels platzieren.)
    • „Befolgen Sie immer die offiziellen Architektur-Empfehlungen, einschließlich der Verwendung einer mehrschichtigen Architektur. Verwenden Sie einen unidirektionalen Datenfluss (UDF), ViewModels, die Erfassung des UI-Zustands mit Berücksichtigung des Lebenszyklus und andere Empfehlungen.“
  • Bevorzugte Bibliotheken: „Verwende die Bibliothek <Bibliotheksname> für die Navigation.“
  • Platzhalternamen für gängige API-Dienste oder interne Terminologie definieren: „Der primäre Backend-Dienst wird als ‚PhotoSift-API‘ bezeichnet.“
  • Styleguides für Unternehmen: „Alle neuen UI-Komponenten müssen mit Jetpack Compose erstellt werden. Schlage keine XML-basierten Layouts vor.“

AGENT.md-Dateien modularisieren

Sie können große AGENT.md-Dateien in kleinere Dateien aufteilen, die in verschiedenen Kontexten wiederverwendet werden können:

  1. Trennen Sie eine Reihe von Anweisungen ab und speichern Sie sie in einer anderen Markdown-Datei, z. B. style-guidance.md.

  2. Verweisen Sie in einer AGENT.md-Datei auf die kleineren Markdown-Dateien, indem Sie das Symbol @ gefolgt vom Pfad zur Datei verwenden, die Sie importieren möchten. Die folgenden Pfadformate werden unterstützt:

    • Relative Pfade:
      • @./file.md – Aus demselben Verzeichnis importieren
      • @../file.md – Aus dem übergeordneten Verzeichnis importieren
      • @./subdirectory/file.md – Aus einem Unterverzeichnis importieren
    • Absolute Pfade: @/absolute/path/to/file.md

Die folgende AGENT.md-Datei verweist beispielsweise auf zwei andere Anweisungsdateien:

# My AGENT.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

So funktionieren AGENT.md-Dateien

Gemini scannt automatisch das aktuelle Verzeichnis und die übergeordneten Verzeichnisse nach AGENT.md-Dateien und fügt deren Inhalt als Präambel am Anfang jedes Prompts hinzu. Wenn Sie beim Senden einer Anfrage keine Datei geöffnet haben, wird standardmäßig die Datei AGENT.md im Stammverzeichnis des Projekts (falls vorhanden) berücksichtigt.

Was ist der Unterschied zwischen AGENT.md-Dateien und Regeln?

Mit Regeln können Sie auch Anweisungen und Einstellungen definieren, die für alle Prompts gelten. Regeln werden jedoch in der IntelliJ-Datei /.idea/project.prompts.xml definiert, während AGENT.md-Dateien neben Ihrem Quellcode gespeichert werden und IDE-neutral sind. Wir empfehlen die Verwendung von AGENT.md-Dateien, wenn Sie die Anleitung hauptsächlich mit Ihrem Team teilen möchten.