Mit der Agent Development Kit-Bibliothek (ADK) für Android können Sie komplexe KI-Agenten direkt in Ihre Android-Apps einbinden. Das ADK ist ein Open-Source-Entwickler-Framework zum Erstellen von KI-basierten Agenten, die lokal, in gehosteten Diensten und auf Android-Mobilgeräten ausgeführt werden. Das Framework unterstützt die Programmiersprachen Kotlin und Java, sodass Sie schnell mit der Erstellung von KI-Agenten beginnen und diese zu komplexen Multi-Agenten-Anwendungen skalieren können.
Die ADK for Android-Bibliothek bietet spezielle Abhängigkeiten und Laufzeitunterstützung, die auf mobile Umgebungen zugeschnitten sind. Sie können KI-Agenten erstellen, die KI-Modelle mit Gemini Nano über die ML Kit GenAI APIs auf dem Gerät ausführen. So können Sie datenschutzorientierte KI-Anwendungen mit niedriger Latenz erstellen, die ohne Netzwerkzugriff funktionieren.
ADK Kotlin in Android-Projekten verwenden
Mit der ADK Kotlin Agent API können Sie KI-Agenten erstellen, die in Android-Apps ausgeführt werden. Der von Ihnen geschriebene Agentencode ist mit dem ADK-Kotlin-Startleitfaden identisch. Die Unterschiede sind die Gradle-Abhängigkeit, die Projektkonfiguration und die Art und Weise, wie Sie den Agenten zur Laufzeit aufrufen.
Vorbereitung
Für die ADK for Android-Bibliothek gelten die folgenden Entwicklungsanforderungen:
- Android Studio
- Android SDK (compileSdk 34 oder höher, minSdk 24 oder höher)
Android-Projekt konfigurieren
Fügen Sie in der build.gradle.kts-Datei Ihres Android-Projekts die ADK-Android-Abhängigkeit und den KSP-Anmerkungsprozessor hinzu:
plugins {
id("com.android.application")
kotlin("android")
id("com.google.devtools.ksp") version "2.1.20-2.0.1"
}
android {
namespace = "com.example.agent"
compileSdk = 34
defaultConfig {
applicationId = "com.example.agent"
minSdk = 24
targetSdk = 34
}
packaging {
resources {
excludes += "/META-INF/{INDEX.LIST,DEPENDENCIES}"
}
}
}
dependencies {
implementation("com.google.adk:google-adk-kotlin-core-android:0.1.0")
ksp("com.google.adk:google-adk-kotlin-processor:0.1.0")
}
kotlin {
jvmToolchain(17)
}
KI-Agenten definieren
Der Agentencode ist mit dem in der Kotlin-Kurzanleitung für das ADK identisch. Das Codebeispiel HelloTimeAgent mit der Syntax @Tool, @Param und .generatedTools() funktioniert ohne Änderungen auf Android-Geräten:
// package com.example.agent // import com.google.adk.kt.agents.Instruction // import com.google.adk.kt.agents.LlmAgent // import com.google.adk.kt.annotations.Param // import com.google.adk.kt.annotations.Tool // import com.google.adk.kt.models.Gemini class TimeService { /** Mock tool implementation */ @Tool fun getCurrentTime( @Param("Name of the city to get the time for") city: String ): Map<String, String> { return mapOf("city" to city, "time" to "The time is 10:30am.") } } object HelloTimeAgent { @JvmField val rootAgent = LlmAgent( name = "hello_time_agent", description = "Tells the current time in a specified city.", model = Gemini( name = "gemini-flash-latest", apiKey = System.getenv("GOOGLE_API_KEY") ?: error("GOOGLE_API_KEY environment variable not set."), ), instruction = Instruction( "You are a helpful assistant that tells the current time in a city. " + "Use the 'getCurrentTime' tool for this purpose." ), tools = TimeService().generatedTools(), ) }
Agent über Ihre Android-App ausführen
Verwenden Sie auf Android-Geräten InMemoryRunner, um den Agenten aufzurufen und Antworten aus einer Koroutine zu erfassen, wie im folgenden Codebeispiel gezeigt:
// import com.google.adk.kt.runners.InMemoryRunner // import com.google.adk.kt.sessions.InMemorySessionService // import com.google.adk.kt.types.Content // import com.google.adk.kt.types.Part // import com.google.adk.kt.types.Role // import kotlinx.coroutines.CoroutineScope // import kotlinx.coroutines.launch // Create a runner and session service val sessionService = InMemorySessionService() val runner = InMemoryRunner( agent = HelloTimeAgent.rootAgent, sessionService = sessionService, ) // Call the agent from a coroutine (e.g. in a ViewModel or Activity) scope.launch { runner.runAsync( userId = "user-123", sessionId = "session-123", newMessage = Content( role = Role.USER, parts = listOf(Part(text = "What time is it in New York?")), ), ).collect { event -> val text = event.content?.parts?.firstOrNull()?.text if (!text.isNullOrBlank()) { // Update your UI with the agent's response } } }
Agenten zum Generieren von Benutzeroberflächen verwenden
Wenn Ihr KI-Agent strukturierte, interaktive Benutzeroberflächen wie Karten, Formulare oder Listen anstelle von Nur-Text zurückgeben muss, verwenden Sie das Agent-to-UI-Protokoll (A2UI).
Mit dem Jetpack Compose A2UI Renderer können Sie A2UI-Antworten automatisch als native Jetpack Compose- und Material 3-Komponenten in der UI-Hierarchie Ihrer App rendern. Informationen zum Einstieg finden Sie im Jetpack Compose-Leitfaden für A2UI.
On-Device-Modelle mit Gemini Nano
Das ADK für Android-Artefakt unterstützt die On-Device-Inferenz mit Gemini Nano über die ML Kit GenAI API. So können KI-Agenten ohne Netzwerkzugriff ausgeführt werden und die Daten bleiben auf dem Gerät.
Wenn Sie ein On-Device-Modell verwenden möchten, erstellen Sie ein GenaiPrompt-Modell anstelle von Gemini, wie im folgenden Codebeispiel gezeigt:
// import com.google.adk.kt.models.mlkit.GenaiPrompt // import com.google.mlkit.genai.prompt.Generation // import com.google.mlkit.genai.prompt.GenerativeModel // Create an ML Kit GenerativeModel for on-device inference val generativeModel: GenerativeModel = Generation.getClient() val onDeviceModel = GenaiPrompt.create( generativeModel = generativeModel, name = "gemini-nano", ) val agent = LlmAgent( name = "on_device_agent", model = onDeviceModel, instruction = Instruction("You are a helpful assistant."), )
Sie können auch Cloud- und On-Device-Modelle in einem Multi-Agenten-System kombinieren: Verwenden Sie ein cloudbasiertes Gemini für den Root-Orchestrator und On-Device-GenaiPrompt-Modelle für Sub-Agenten, die datenschutzrelevante Aufgaben ausführen. Weitere Informationen zu diesem Muster finden Sie im Blogpost zum ADK für Kotlin und Android.
Eine vollständige funktionierende Aktivität und weitere Beispiele findest du in den ADK-Kotlin-Beispielen auf GitHub.