Merge branch 'main' into kaz-11230736

Author: kazunori279

.github/workflows/go-snippets-pr-check.yaml

@@ -0,0 +1,84 @@
+# 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.
+
+name: Go Snippets Build on PR and Schedule
+
+on:
+  # Run on pull requests targeting the main branch.
+  pull_request:
+    branches: [ "main" ]
+  
+  # Run on a weekly schedule (every Sunday at 3:00 AM UTC).
+  schedule:
+    - cron: '0 3 * * 0'
+
+jobs:
+  # This job builds and runs the Go snippets.
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        # Fetch the entire history to compare branches in the PR.
+        fetch-depth: 0
+
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.22'
+
+    - name: Cache Go modules
+      uses: actions/cache@v3
+      with:
+        path: ~/go/pkg/mod
+        key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+        restore-keys: |
+          ${{ runner.os }}-go-
+
+    # --- PR-Specific Checks ---
+    # These steps only run for pull request events.
+
+    - name: Find new, un-tested Go files (PR only)
+      if: github.event_name == 'pull_request'
+      run: |
+        echo "Checking for any new Go files that are not in the build script..."
+        ./tools/go-snippets/check_go_snippets.sh
+
+    - name: Get changed Go snippet files (PR only)
+      if: github.event_name == 'pull_request'
+      id: changed-files
+      run: |
+        # This command gets the list of changed .go files in the snippets directory
+        # between the PR's head and the base branch.
+        # The output is an escaped, space-separated string suitable for shell commands.
+        CHANGED_FILES=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.event.pull_request.head.sha }} -- 'examples/go/snippets/**/*.go' | xargs)
+        echo "changed_files=${CHANGED_FILES}" >> $GITHUB_OUTPUT
+        echo "Detected changes in: ${CHANGED_FILES}"
+
+    - name: Build changed Go snippets (PR only)
+      if: github.event_name == 'pull_request' && steps.changed-files.outputs.changed_files != ''
+      run: |
+        echo "Building only the changed Go files..."
+        ./tools/go-snippets/runner.sh build ${{ steps.changed-files.outputs.changed_files }}
+
+    # --- Scheduled Checks ---
+    # These steps only run on the weekly schedule.
+
+    - name: Build all Go snippets (Scheduled)
+      if: github.event_name == 'schedule'
+      run: |
+        echo "Running weekly build for all Go snippets..."
+        ./tools/go-snippets/runner.sh build

docs/agents/llm-agents.md

@@ -445,15 +445,8 @@ Control whether the agent receives the prior conversation history.
     ....
     ```
 
-### Code Execution
-
-<div class="language-support-tag">
-   <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python v0.1.0</span>
-</div>
-
-* **`code_executor` (Optional):** Provide a `BaseCodeExecutor` instance to allow the agent to execute code blocks found in the LLM's response. ([See Tools/Built-in tools](../tools/built-in-tools.md)).
-
 Example for using built-in-planner:
+
 ```python
 from dotenv import load_dotenv
 
@@ -572,6 +565,26 @@ call_agent("If it's raining in New York right now, what is the current temperatu
 
 ```
 
+### Code Execution
+
+<div class="language-support-tag">
+   <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python v0.1.0</span><span class="lst-java">Java v0.1.0</span>
+</div>
+
+- **`code_executor` (Optional):** Provide a `BaseCodeExecutor` instance to allow the agent to execute code blocks found in the LLM's response. ([See Tools/Built-in tools](../tools/built-in-tools.md)).
+
+== "Python"
+
+    ```py
+    --8<-- "examples/python/snippets/tools/built-in-tools/code_execution.py"
+    ```
+
+=== "Java"
+
+    ```java
+    --8<-- "examples/java/snippets/src/main/java/tools/CodeExecutionAgentApp.java:full_code"
+    ```
+
 ## Putting It Together: Example
 
 ??? "Code"

docs/agents/models.md

@@ -322,7 +322,7 @@ public class DirectAnthropicAgent {
 ## Using Apigee gateway for AI models
 
 <div class="language-support-tag">
-   <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python v1.18.0</span>
+   <span class="lst-supported">Supported in ADK</span><span class="lst-python">Python v1.18.0</span><span class="lst-java">Java v0.4.0</span>
 </div>
 
 [Apigee](https://docs.cloud.google.com/apigee/docs/api-platform/get-started/what-apigee) acts as a powerful [AI Gateway](https://cloud.google.com/solutions/apigee-ai), transforming how you manage and govern your generative AI model traffic. By exposing your AI model endpoint (like Vertex AI or the Gemini API) through an Apigee proxy, you immediately gain enterprise-grade capabilities:
@@ -341,30 +341,55 @@ public class DirectAnthropicAgent {
 
 **Example:**
 
-```python
+=== "Python"
 
-from google.adk.agents import LlmAgent
-from google.adk.models.apigee_llm import ApigeeLlm
-
-# Instantiate the ApigeeLlm wrapper
-model = ApigeeLlm(
-    # Specify the Apigee route to your model. For more info, check out the ApigeeLlm documentation (https://github.com/google/adk-python/tree/main/contributing/samples/hello_world_apigeellm).
-    model="apigee/gemini-2.5-flash",
-    # The proxy URL of your deployed Apigee proxy including the base path
-    proxy_url=f"https://{APIGEE_PROXY_URL}",
-    # Pass necessary authentication/authorization headers (like an API key)
-    custom_headers={"foo": "bar"}
-)
+    ```python
 
-# Pass the configured model wrapper to your LlmAgent
-agent = LlmAgent(
-    model=model,
-    name="my_governed_agent",
-    instruction="You are a helpful assistant powered by Gemini and governed by Apigee.",
-    # ... other agent parameters
-)
+    from google.adk.agents import LlmAgent
+    from google.adk.models.apigee_llm import ApigeeLlm
+
+    # Instantiate the ApigeeLlm wrapper
+    model = ApigeeLlm(
+        # Specify the Apigee route to your model. For more info, check out the ApigeeLlm documentation (https://github.com/google/adk-python/tree/main/contributing/samples/hello_world_apigeellm).
+        model="apigee/gemini-2.5-flash",
+        # The proxy URL of your deployed Apigee proxy including the base path
+        proxy_url=f"https://{APIGEE_PROXY_URL}",
+        # Pass necessary authentication/authorization headers (like an API key)
+        custom_headers={"foo": "bar"}
+    )
 
-```
+    # Pass the configured model wrapper to your LlmAgent
+    agent = LlmAgent(
+        model=model,
+        name="my_governed_agent",
+        instruction="You are a helpful assistant powered by Gemini and governed by Apigee.",
+        # ... other agent parameters
+    )
+
+    ```
+
+=== "Java"
+
+    ```java
+    import com.google.adk.agents.LlmAgent;
+    import com.google.adk.models.ApigeeLlm;
+    import com.google.common.collect.ImmutableMap;
+
+    ApigeeLlm apigeeLlm =
+            ApigeeLlm.builder()
+                .modelName("apigee/gemini-2.5-flash") // Specify the Apigee route to your model. For more info, check out the ApigeeLlm documentation
+                .proxyUrl(APIGEE_PROXY_URL) //The proxy URL of your deployed Apigee proxy including the base path
+                .customHeaders(ImmutableMap.of("foo", "bar")) //Pass necessary authentication/authorization headers (like an API key)
+                .build();
+    LlmAgent agent =
+        LlmAgent.builder()
+            .model(apigeeLlm)
+            .name("my_governed_agent")
+            .description("my_governed_agent")
+            .instruction("You are a helpful assistant powered by Gemini and governed by Apigee.")
+            // tools will be added next
+            .build();
+    ```
 
 With this configuration, every API call from your agent will be routed through Apigee first, where all necessary policies (security, rate limiting, logging) are executed before the request is securely forwarded to the underlying AI model endpoint.
 

docs/assets/tools-apify.png

@@ -10,7 +10,7 @@ of this context data grows, agent processing times typically also increase.
 More and more data is sent to the generative AI model used by the agent,
 increasing processing time and slowing down responses. The ADK Context
 Compaction feature is designed to reduce the size of context as an agent
-is running by summarizing older parts of the agent workflow event history. 
+is running by summarizing older parts of the agent workflow event history.
 
 The Context Compaction feature uses a *sliding window* approach for collecting
 and summarizing agent workflow event data within a
@@ -47,7 +47,7 @@ background each time the session reaches the interval.
 If you set `compaction_interval` to 3 and `overlap_size` to 1, the event data is
 compressed upon completion of events 3, 6, 9, and so on. The overlap setting
 increases size of the second summary compression, and each summary afterwards,
-as shown in Figure 1. 
+as shown in Figure 1.
 
 ![Context compaction example illustration](/adk-docs/assets/context-compaction.svg)
 **Figure 1.** Ilustration of event compaction configuration with a interval of 3
@@ -65,19 +65,19 @@ With this example configuration, the context compression tasks happen as follows
 
 The configuration settings for this feature control how frequently event data is compressed
 and how much data is retained as the agent workflow runs. Optionally, you can configure
-a compactor object 
+a compactor object
 
 *   **`compaction_interval`**: Set the number of completed events that triggers compaction
-    of the prior event data. 
+    of the prior event data.
 *   **`overlap_size`**: Set how many of the previously compacted events are included in a
     newly compacted context set.
-*   **`compactor`**: (Optional) Define a compactor object including a specific AI model
-    to use for summarization. For more information, see 
-    [Define a compactor](#define-compactor).    
+*   **`summarizer`**: (Optional) Define a summarizer object including a specific AI model
+    to use for summarization. For more information, see
+    [Define a Summarizer](#define-summarizer).
 
 ### Define a Summarizer {#define-summarizer}
-You can customize the process of context compression by defining a summarizer. 
-The LlmEventSummarizer class allows you to specify a particular model for summarization. 
+You can customize the process of context compression by defining a summarizer.
+The LlmEventSummarizer class allows you to specify a particular model for summarization.
 The following code example demonstrates how to define and configure a custom summarizer:
 
 ```python
@@ -96,12 +96,12 @@ app = App(
     name='my-agent',
     root_agent=root_agent,
     events_compaction_config=EventsCompactionConfig(
-        summarizer=my_summarizer,
         compaction_interval=3,
-        overlap_size=1
+        overlap_size=1,
+        summarizer=my_summarizer,
     ),
 )
-``` 
+```
 
 You can further refine the operation of the `SlidingWindowCompactor` by
 by modifying its summarizer class `LlmEventSummarizer` including changing

docs/assets/tools-atlassian.png

@@ -11,7 +11,7 @@ To deploy your agent, you can use either the `adk deploy cloud_run` command _(re
 
 ## Agent sample
 
-For each of the commands, we will reference a the `Capital Agent` sample defined on the [LLM agent](../agents/llm-agents.md) page. We will assume it's in a directory (eg: `capital_agent`).
+For each of the commands, we will reference the `Capital Agent` sample defined on the [LLM agent](../agents/llm-agents.md) page. We will assume it's in a directory (eg: `capital_agent`).
 
 To proceed, confirm that your agent code is configured as follows:
 

docs/assets/tools-linear.png

@@ -162,6 +162,11 @@ upper left corner and type a request.
 
 ![adk-web-dev-ui-chat.png](/adk-docs/assets/adk-web-dev-ui-chat.png)
 
+!!! warning "Caution: ADK Web for development only"
+
+    ADK Web is ***not meant for use in production deployments***. You should
+    use ADK Web for development and debugging purposes only.
+
 ## Next: Build your agent
 
 Now that you have ADK installed and your first agent running, try building

docs/context/compaction.md

@@ -268,6 +268,11 @@ upper left corner and type a request.
 
 ![adk-web-dev-ui-chat.png](/adk-docs/assets/adk-web-dev-ui-chat.png)
 
+!!! warning "Caution: ADK Web for development only"
+
+    ADK Web is ***not meant for use in production deployments***. You should
+    use ADK Web for development and debugging purposes only.
+
 ## Next: Build your agent
 
 Now that you have ADK installed and your first agent running, try building