mirror of
https://github.com/google/adk-docs.git
synced 2026-09-14 16:16:59 +08:00
1f2147bfff
* Add Kotlin to hero / front page * Add quickstart page for Kotlin * Complete Kotlin quickstart guide and fix hero code sample (#2) * Replace GitHub repo links with language icons in header (#3) * Fix header icon FOUC and homepage font weight regression (#4) * Testing staging pipeline * Revert test edit (for staging pipeline) * Update language icon tooltips to indicate GitHub destination (#5) * Add link to ADK Kotlin release notes (#7) * Initial commit of ADK Kotlin API reference docs (#6) * Add script to generate ADK Kotlin API reference docs (#8) * Update links and link checker ignore list (temporarily) (#9) * Add ADK Kotlin for Android getting started guide to Advanced setup page (#10) * Add advanced setup page with steps to "Use ADK Kotlin in Android projects" * Update temp link checker rules * Add placeholder folder for adk-samples (#13) * adding linter/compilation checks for kotlin snippets (#12) * adding linter/compilation checks for kotlin snippets * Add Kotlin validation scripts * Initial commit of Kotlin sample agents for adk-samples (#15) * Adding kotlin snippet for llm agents (#16) * Adding kotlin snippets to Events (#17) * Pull changes to docs/events/index.md from glaforge-kotlin-snippets * fixing kotlin event timestamp and longRunningToolIds * Fix language tags (#19) * Fix language tags * Update * Fix wrapping * Fix wrapping (again) * Fix wrapping/format * Fix language tag on integration page * Enable check_paths in PyMdown Snippets Extension to make the build fail if a snippet can't be found (#20) * Update mkdocs config (#21) * Fix broken links, update URLs to adk.dev, and improve (temp) lychee config (#22) * Add Kotlin/maven badge to README (#23) * Adding Kotlin snippets for artifacts (#18) * Pull Kotlin snippets for artifacts from glaforge-kotlin-snippets * Add comprehensive Kotlin snippets for artifacts * Refactor artifacts documentation to use external Kotlin snippets * Update Kotlin model to gemini-flash-latest * Fix GCS initialization in Kotlin artifact snippet * afixi failing test with capital-agent added to files_to_check * Fix snippet label syntax for MkDocs build * Configure proper Gradle project for Kotlin snippets and fix dependencies * Add KSP support and generated sources to Kotlin snippets build * fixing capital_agent turnComplete * Fix syntax error in build.gradle.kts by removing invalid placeholders (#25) * Adding Kotlin snippets to google-gemini.md (#27) Pulling kotlin changes to google-gemini.md from glaforge-kotlin-snippets * Add a warning about not adding an api key to production code. (#28) * Add a warning about not adding an api key to production code. * Update note --------- Co-authored-by: Kristopher Overholt <koverholt@google.com> * Add ADK Demo App sample showcasing Gemini-powered agents (#29) This sample demonstrates how to use the Google ADK (Agent Development Kit) in an Android application to create a chat interface powered by a Gemini-based "Fun Facts" agent. The implementation features: * Integration with the Kotlin ADK core and processor libraries. * A `FunFactsAgent` defined using `LlmAgent` and the Gemini model. * A `ChatViewModel` utilizing `InMemoryRunner` for asynchronous message streaming. * A modern UI built with Jetpack Compose and Material 3. * Build configuration logic for secure API key management via environment variables or `local.properties`. * Update Kotlin docs and samples to align with adk-kotlin API changes (#30) Rename GeminiModel to Gemini, @AdkTool/@AdkParam to @Tool/@Param, adkTools() to generatedTools(), replace DebugRunner with InMemoryRunner, fix AgentLoader import path, use SingleAgentLoader, bump Kotlin to 2.3.21 and KSP to 2.3.7, and update Android minSdk from 24 to 26. * adding kotlin info to READMEs (#14) * Reorganize Android sample agent and add READMEs (#31) * Move Android sample agent * Update repo README, add Android README, update sample agent README * Minor edit to language support tags (#32) * Remove blog post link (#33) Will re-add after it's published * Remove examples link (#34) * Adding Kotlin snippets for Sessions docs (#26) * initial kotlins snippets additions to sessions docs * Updating memory docs with kotlin snippets * Adding kotlin snippets to session state docs. * update model to gemini-flash-latest * sessions examples clean-up * fixing sessions snippet markers * adding kotlin session snippets to files to test * adding callback to memory_example * Fixing capital agent snippet (#35) Fixing file name Updating adkTool > Tool Updating GeminiModel > Gemini * Adding kotlin snippets for tools docs (#36) * adding function tool kotlin snippets * adding function_tools snippets to files to test * Adding kotlin snippets to observability docs (#37) * initial kotlin observability updates * adding observability snippets to file check (#38) * Adding Kotlin snippets to Callbacks docs (#39) * kotlin callbacks snippets * adding callbacks snippets to file check * Align Kotlin and KSP versions with published 0.1.0 artifacts (#40) * switch CLI entry points from InMemoryRunner to ReplRunner (#41) * Switch CLI entry points from InMemoryRunner to ReplRunner * Fix wording * Update API reference docs for Kotlin, 2026-05-18 (#42) * Remove ADK on Android note until published (#43) * Update Kotlin code samples (#44) * Rename GeminiModel to Gemini in Kotlin snippets and docs * Remove broken SessionKey call and use sessionId directly in AgentTool snippet * Rewrite Go hero snippet to use llmagent API * Use isFinalResponse with safe access in CapitalAgent snippet * Use Role.USER constant instead of raw string in SetupExample * Use full semver v0.1.0 in Kotlin language support tags * Remove Android setup steps, moving to new property (#45) * Tutorial Kotlin agent (#46) * Adding multi-tool-agent snippet and updating tutorial * Fixing Go language order on tutorial page * adding multi tool agent example to files to test * Inline Kotlin get-started code sample * Kotlin Multi agents snippets (#47) * Multi-agent kotlin snippets * Fixing docs tags in multiagent example * Fix Kotlin language support tags, code samples, and google-gemini.md cleanup (#48) * Add Kotlin v0.1.0 to language support tags across docs * Fix MultiToolAgent.kt model string and argument style * Update MultiAgentExample.kt to use gemini-flash-latest model string * Fix google-gemini.md: add Kotlin sample, remove unsupported Java tabs * Remove explicit apiKey from CallbackBasic.kt for consistency * Standardize Gemini() constructor to use named args in all snippets * Remove adk-samples directory (moved to google/adk-samples#1969) * Remove adk-samples directory (moved to google/adk-samples#1969) (#49) * Update API reference docs for ADK Kotlin 0.1.0 (#50) * Remove adk-samples directory (moved to google/adk-samples#1969) * Update API reference docs for ADK Kotlin 0.1.0 * Remove kotlin lycheeignore config (#51) * Remove adk-samples directory (moved to google/adk-samples#1969) * Remove Kotlin .lycheeignore config links --------- Co-authored-by: Toni Klopfenstein <2359976+ToniCorinne@users.noreply.github.com> Co-authored-by: Jolanda Verhoef <JolandaVerhoef@users.noreply.github.com>
121 lines
4.0 KiB
Kotlin
121 lines
4.0 KiB
Kotlin
package agents.multitool
|
|
|
|
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
|
|
import com.google.adk.kt.runners.InMemoryRunner
|
|
import com.google.adk.kt.sessions.InMemorySessionService
|
|
import com.google.adk.kt.sessions.SessionKey
|
|
import com.google.adk.kt.types.Content
|
|
import com.google.adk.kt.types.Part
|
|
import com.google.adk.kt.types.Role
|
|
import kotlinx.coroutines.flow.toList
|
|
import kotlinx.coroutines.runBlocking
|
|
import java.text.Normalizer
|
|
import java.time.ZoneId
|
|
import java.time.ZonedDateTime
|
|
import java.time.format.DateTimeFormatter
|
|
import java.util.Scanner
|
|
|
|
class MultiToolService {
|
|
@Tool
|
|
fun getCurrentTime(
|
|
@Param("The name of the city for which to retrieve the current time") city: String,
|
|
): Map<String, String> {
|
|
val normalizedCity =
|
|
Normalizer.normalize(city, Normalizer.Form.NFD)
|
|
.trim()
|
|
.lowercase()
|
|
.replace(Regex("(\\p{IsM}+|\\p{IsP}+)"), "")
|
|
.replace(Regex("\\s+"), "_")
|
|
|
|
val zoneId =
|
|
ZoneId.getAvailableZoneIds()
|
|
.firstOrNull { it.lowercase().endsWith("/$normalizedCity") }
|
|
|
|
return if (zoneId != null) {
|
|
val time =
|
|
ZonedDateTime.now(ZoneId.of(zoneId))
|
|
.format(DateTimeFormatter.ofPattern("HH:mm"))
|
|
mapOf(
|
|
"status" to "success",
|
|
"report" to "The current time in $city is $time.",
|
|
)
|
|
} else {
|
|
mapOf(
|
|
"status" to "error",
|
|
"report" to "Sorry, I don't have timezone information for $city.",
|
|
)
|
|
}
|
|
}
|
|
|
|
@Tool
|
|
fun getWeather(
|
|
@Param("The name of the city for which to retrieve the weather report") city: String,
|
|
): Map<String, String> {
|
|
return if (city.lowercase() == "new york") {
|
|
mapOf(
|
|
"status" to "success",
|
|
"report" to "The weather in New York is sunny with a temperature of " +
|
|
"25 degrees Celsius (77 degrees Fahrenheit).",
|
|
)
|
|
} else {
|
|
mapOf(
|
|
"status" to "error",
|
|
"report" to "Weather information for $city is not available.",
|
|
)
|
|
}
|
|
}
|
|
}
|
|
|
|
fun main() =
|
|
runBlocking {
|
|
val model = Gemini(name = "gemini-flash-latest")
|
|
|
|
val agent =
|
|
LlmAgent(
|
|
name = "multi_tool_agent",
|
|
model = model,
|
|
description = "Agent to answer questions about the time and weather in a city.",
|
|
instruction =
|
|
Instruction(
|
|
"You are a helpful agent who can answer user questions about the " +
|
|
"time and weather in a city.",
|
|
),
|
|
tools = MultiToolService().generatedTools(),
|
|
)
|
|
|
|
val sessionService = InMemorySessionService()
|
|
val runner =
|
|
InMemoryRunner(
|
|
agent = agent,
|
|
appName = "multi_tool_app",
|
|
sessionService = sessionService,
|
|
)
|
|
|
|
val userId = "student"
|
|
val sessionId = "session_1"
|
|
|
|
sessionService.createSession(SessionKey("multi_tool_app", userId, sessionId))
|
|
|
|
val scanner = Scanner(System.`in`)
|
|
while (true) {
|
|
print("\nYou > ")
|
|
val userInput = scanner.nextLine()
|
|
if (userInput.lowercase() == "quit") break
|
|
|
|
val userContent = Content(role = Role.USER, parts = listOf(Part(text = userInput)))
|
|
val events = runner.runAsync(userId = userId, sessionId = sessionId, newMessage = userContent).toList()
|
|
|
|
print("\nAgent > ")
|
|
for (event in events) {
|
|
event.content?.parts?.forEach { part ->
|
|
part.text?.let { print(it) }
|
|
}
|
|
}
|
|
println()
|
|
}
|
|
}
|