feat: Initial tutorials/city-time-weather

Author: vorburger

dev/pom.xml

@@ -54,7 +54,7 @@
     <dependency>
       <groupId>com.google.adk</groupId>
       <artifactId>google-adk</artifactId>
-      <version>0.2.1-SNAPSHOT</version><!-- {x-version-update:google-adk:current} -->
+      <version>${project.version}</version>
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>

pom.xml

@@ -31,6 +31,7 @@
     <module>dev</module>
     <module>maven_plugin</module>
     <module>contrib/langchain4j</module>
+    <module>tutorials/city-time-weather</module>
   </modules>
 
   <properties>
@@ -181,13 +182,13 @@
         </plugin>
         <plugin>
           <groupId>org.sonatype.central</groupId>
-            <artifactId>central-publishing-maven-plugin</artifactId>
-            <version>0.8.0</version>
-            <extensions>true</extensions>
-            <configuration>
-              <publishingServerId>central</publishingServerId>
-            </configuration>
-          </plugin>
+          <artifactId>central-publishing-maven-plugin</artifactId>
+          <version>0.8.0</version>
+          <extensions>true</extensions>
+          <configuration>
+            <publishingServerId>central</publishingServerId>
+          </configuration>
+        </plugin>
       </plugins>
     </pluginManagement>
     <plugins>

tutorials/city-time-weather/README.md

@@ -0,0 +1,7 @@
+# City Time Weather
+
+```shell
+GEMINI_API_KEY={YOUR-KEY} ../../mvnw exec:java
+```
+
+See https://google.github.io/adk-docs/get-started/quickstart/#java for more information.

tutorials/city-time-weather/pom.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>com.google.adk</groupId>
+    <artifactId>google-adk-parent</artifactId>
+    <version>0.2.1-SNAPSHOT</version><!-- {x-version-update:google-adk:current} -->
+  </parent>
+
+  <artifactId>google-adk-tutorials-city-time-weather</artifactId>
+
+  <properties>
+    <exec.mainClass>com.google.adk.web.AdkWebServer</exec.mainClass>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.google.adk</groupId>
+      <artifactId>google-adk-dev</artifactId>
+      <version>${project.version}</version>
+    </dependency>
+  </dependencies>
+</project>

tutorials/city-time-weather/src/main/java/com/google/adk/tutorials/CityTimeWeather.java

@@ -0,0 +1,102 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.google.adk.tutorials;
+
+import com.google.adk.agents.BaseAgent;
+import com.google.adk.agents.LlmAgent;
+import com.google.adk.tools.Annotations.Schema;
+import com.google.adk.tools.FunctionTool;
+import java.text.Normalizer;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.Map;
+
+public class CityTimeWeather {
+
+  private static String USER_ID = "student";
+  private static String NAME = "multi_tool_agent";
+
+  public static final BaseAgent ROOT_AGENT = initAgent();
+
+  public static BaseAgent initAgent() {
+    return LlmAgent.builder()
+        .name(NAME)
+        .model("gemini-2.0-flash-lite")
+        .description("Agent to answer questions about the time and weather in a city.")
+        .instruction(
+            "You are a helpful agent who can answer user questions about the time and weather"
+                + " in a city.")
+        .tools(
+            FunctionTool.create(CityTimeWeather.class, "getCurrentTime"),
+            FunctionTool.create(CityTimeWeather.class, "getWeather"))
+        .build();
+  }
+
+  public static Map<String, String> getCurrentTime(
+      @Schema(
+              name = "city",
+              description = "The name of the city for which to retrieve the current time")
+          String city) {
+    String normalizedCity =
+        Normalizer.normalize(city, Normalizer.Form.NFD)
+            .trim()
+            .toLowerCase()
+            .replaceAll("(\\p{IsM}+|\\p{IsP}+)", "")
+            .replaceAll("\\s+", "_");
+
+    return ZoneId.getAvailableZoneIds().stream()
+        .filter(zid -> zid.toLowerCase().endsWith("/" + normalizedCity))
+        .findFirst()
+        .map(
+            zid ->
+                Map.of(
+                    "status",
+                    "success",
+                    "report",
+                    "The current time in "
+                        + city
+                        + " is "
+                        + ZonedDateTime.now(ZoneId.of(zid))
+                            .format(DateTimeFormatter.ofPattern("HH:mm"))
+                        + "."))
+        .orElse(
+            Map.of(
+                "status",
+                "error",
+                "report",
+                "Sorry, I don't have timezone information for " + city + "."));
+  }
+
+  public static Map<String, String> getWeather(
+      @Schema(
+              name = "city",
+              description = "The name of the city for which to retrieve the weather report")
+          String city) {
+    if (city.toLowerCase().equals("new york")) {
+      return Map.of(
+          "status",
+          "success",
+          "report",
+          "The weather in New York is sunny with a temperature of 25 degrees Celsius (77 degrees"
+              + " Fahrenheit).");
+
+    } else {
+      return Map.of(
+          "status", "error", "report", "Weather information for " + city + " is not available.");
+    }
+  }
+}