Best Practices

Der Agent in Android Studio fungiert als Ihr Programmierpartner und beschleunigt Ihren Entwicklungsworkflow, indem er Code generiert, komplexe Themen zusammenfasst, bestimmte Ressourcen findet und vieles mehr. Effektive Kommunikation ist der Schlüssel, um das volle Potenzial des KI-Agenten auszuschöpfen.

In diesem Leitfaden werden Strategien zum Einrichten Ihrer Entwicklungsumgebung und zum Schreiben von Prompts beschrieben, die nützliche und zuverlässige Antworten liefern. Für mehrere Strategien haben wir Beispiel-Prompts für verschiedene Anwendungsfälle bereitgestellt. Weitere Beispiel-Prompts finden Sie in der Prompt-Galerie.

Mach möglichst genaue Angaben

Der Agent funktioniert am besten mit klaren, spezifischen Anweisungen. Wenn Sie bestimmte Bibliotheken, APIs oder Ansätze verwenden möchten, geben Sie diese in Ihrer Frage an oder fügen Sie sie der AGENTS.md-Datei im Stammverzeichnis Ihres Projekts hinzu, damit sie über Interaktionen hinweg beibehalten werden. Stellen Sie sich das wie das Einreichen eines Fehlerberichts vor: Je mehr Informationen Sie angeben, desto schneller und effektiver kann das Problem gelöst werden.

Neue Funktionen implementieren:

Wie füge ich meiner App mit CameraX Kameraunterstützung hinzu? Achte darauf, alle Abhängigkeiten und Berechtigungen anzugeben, die ich für die Verwendung der Bibliothek benötige.
Wie füge ich meiner App Kameraunterstützung hinzu?

Code generieren:

Schreiben Sie eine Kotlin-Suspend-Funktion, die die Coil-Bibliothek verwendet, um ein Bild von einem bestimmten URL-String herunterzuladen.

Die Funktion sollte den Namen fetchImageAsBitmap haben. Sie sollte eine Context und eine String-URL als Argumente annehmen und eine nullable Bitmap zurückgeben. Wenn ein Netzwerk- oder Decodierungsfehler auftritt, sollte die Ausnahme abgefangen, protokolliert und null zurückgegeben werden.

Funktion zum Herunterladen eines Bildes schreiben

Ein Konzept erklären:

Ich entwickle eine Musikplayer-App und muss die Wiedergabe fortsetzen, wenn die App im Hintergrund ausgeführt wird.

Welche Möglichkeiten habe ich, meine App im Hintergrund auszuführen, während der Nutzer andere Dinge auf dem Gerät erledigt? Welche API-Level-Anforderungen und Auswirkungen auf die Akkulaufzeit gelten für die einzelnen Ansätze?

Android-Dienste erklären

Beschreiben Sie die Struktur der Antwort.

Standardmäßig liefert der KI-Agent Antworten in einem konversationellen, absatzbasierten Format. Das ist zwar oft nützlich für Erklärungen, aber Sie können effektivere und sofort verwendbare Ergebnisse erzielen, wenn Sie angeben, wie die Antwort strukturiert werden soll. Wenn Sie das Ausgabeformat angeben, wird das Modell angewiesen, die Informationen auf klare, vorhersehbare Weise zu organisieren. So sparen Sie sich die Zeit, die Sie für die manuelle Neuformatierung benötigen würden.

Wenn Sie vom KI-Agenten generierten Code in Ihre Anwendung einfügen möchten und den Code in einem bestimmten Format benötigen, damit Sie ihn sofort verwenden können, geben Sie dem KI-Agenten klare Anweisungen zum Generieren und Formatieren des Codes.

Antwort strukturieren:

Erstelle eine Raum-Entität für ein Nutzerprofil. Sie sollte die Felder id, userName, email und memberSince enthalten. Das Feld id sollte automatisch generiert werden. Das Feld memberSince sollte einen Zeitstempel darstellen.

Erstelle eine Room-Entität für ein Nutzerprofil.

Wenn Sie eine offenere Frage stellen, fragen Sie nach x Optionen.

Antwort einschränken:

Welche Tools sind für die Optimierung der App-Leistung verfügbar? Gib mir eine Liste der drei besten.
Welche Tools sind für die Optimierung der App-Leistung verfügbar?

Komplexe Anfragen in kleinere Aufgaben aufteilen

Wenn der Ansatz des KI-Agenten nicht Ihren Erwartungen entspricht, kann es hilfreich sein, ihn durch eine Reihe kleinerer, aufeinanderfolgender Prompts zu führen, anstatt alles auf einmal zu verlangen. Dieser Ansatz bietet Ihnen mehr Kontrolle und ermöglicht es Ihnen, jeden Schritt zu überprüfen, bevor Sie mit dem nächsten fortfahren.

Sequenzielle Prompts anwenden:

Prompt 1: Das Datenmodell
Erstelle zuerst eine Kotlin-Datenklasse mit dem Namen User. Sie sollte drei Attribute haben: id (ein Int), name (ein String) und email (ein String).

Prompt 2: Die Netzwerkschicht
Erstellen Sie jetzt eine Retrofit API-Schnittstelle mit dem Namen ApiService. Es ist ein einzelner suspend fun namens getUsers() erforderlich, der einen List<User> zurückgibt.

Prompt 3: Zustandsverwaltung
Als Nächstes schreiben Sie einen UsersViewModel, der den ApiService als Abhängigkeit verwendet. Das UsersViewModel sollte einen StateFlow einer versiegelten UiState-Klasse bereitstellen, die die Status Loading, Success(users: List) und Error(message: String) darstellen kann. Erstellen Sie eine Funktion in ViewModel, um die Nutzer abzurufen und den Status zu aktualisieren. Schreiben Sie Unittests für die neue Funktion.

Prompt 4: Die UI-Ebene
Schreibe abschließend eine Jetpack Compose-Funktion namens UserListScreen, die UiState als Parameter akzeptiert. Verwenden Sie eine when-Anweisung, um eine CircularProgressIndicator für den Ladestatus, eine LazyColumn mit Nutzernamen für den Erfolgsstatus und ein Text-Element mit der Fehlermeldung für den Fehlerstatus anzuzeigen. Fügen Sie Tests hinzu, mit denen die neue Funktion überprüft wird.

Erstelle einen Jetpack Compose-Bildschirm, der eine Liste von Nutzern von einer JSON API abruft und in einer Liste anzeigt. Sie sollte ein ViewModel haben, das Retrofit und Koroutinen verwendet, ein Repository zur Verarbeitung der Datenlogik, eine User-Datenklasse und sie muss Lade- und Fehlerstatus anzeigen.

Kontext verwalten

Ein wichtiger Teil der Arbeit mit dem Agenten ist die Bereitstellung des richtigen Kontexts. Stellen Sie relevante Code-Snippets, Dateiinhalte und Informationen zur Projektstruktur bereit, um möglichst hilfreiche Antworten zu erhalten. Möglicherweise müssen Sie mehrere Versuche unternehmen, um die richtige Balance zu finden: Zu viele Informationen können den KI-Agenten in die Irre führen, während zu wenige Informationen nicht genügend Kontext bieten, um hilfreich zu sein. Verwenden Sie die verfügbaren Funktionen, um dem Agenten Zugriff auf den erforderlichen Kontext zu gewähren:

  • Hängen Sie Bilder an, um die Benutzeroberfläche, die Sie sich vorstellen, oder die App-Architektur, die Sie verstehen möchten, visuell darzustellen.
  • Hängen Sie Dateien an, um relevante Teile der Codebasis hervorzuheben.
  • Verwenden Sie .aiexclude-Dateien, damit der Agent bestimmte Teile der Codebasis ignoriert.
  • Verwenden Sie AGENTS.md-Dateien, um projektspezifische Anweisungen zu geben und sie im Team zu teilen. Verwenden Sie in AGENTS.md-Dateien Markdown-Überschriften und ‑Formatierungen, um Ihre Anweisungen klar zu strukturieren.
  • Wenn Sie den KI-Agentenmodus verwenden, konfigurieren Sie MCP-Server, um das Wissen und die Funktionen des KI-Agenten mit der externen Umgebung zu erweitern.

Nach Erklärungen fragen

Wenn Sie die Antwort des KI-Agenten nicht verstehen, bitten Sie um eine Erklärung. So können Sie sich mit der vorgeschlagenen Lösung vertraut machen und prüfen, ob sie für Ihren Anwendungsfall geeignet ist. Wenn die Antwort nicht Ihren Erwartungen entspricht, kann es sein, dass der Agent tatsächlich falsch liegt. Wenn Sie nach einer Erklärung fragen, hat der Agent die Möglichkeit, sich selbst zu korrigieren.

Anweisungen iterieren

Ähnlich wie bei der Zusammenarbeit mit einem Kollegen ist auch bei der Zusammenarbeit mit dem Agenten manchmal ein Hin und Her erforderlich, um die Aufgabe und das erwartete Ergebnis zu klären. Wenn die erste Antwort des KI-Agenten nicht ausreicht, antworten Sie mit Feedback und Verbesserungsvorschlägen. Wenn sich die Antwort aufgrund Ihrer Vorschläge verbessert, übernehmen Sie diesen Vorschlag in den ursprünglichen Prompt, indem Sie den Eintrag in der Prompt-Bibliothek oder Ihre AGENTS.md-Dateien aktualisieren.