agent-starter-pack 0.3.3__py3-none-any.whl → 0.21.0__py3-none-any.whl

agent_starter_pack/agents/README.md

@@ -0,0 +1,7 @@
+# Agent Templates
+
+This directory contains template implementations for various agents designed to work with the Agent Starter Pack templating system.
+Feel free to browse through these folders to preview what each template offers.
+Direct cloning of this repository isn't necessary to utilize these templates.
+
+For setup instructions and getting started, please refer to the main [README](/README.md) which explains how to install and use the Agent Starter Pack.

agents/langgraph_base_react/template/.templateconfig.yaml → agent_starter_pack/agents/adk_a2a_base/.template/templateconfig.yaml

@@ -12,16 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-description: "An agent implementing a base ReAct agent using LangGraph"
+description: "A base ReAct agent built with Google's Agent Development Kit (ADK) and Agent2Agent (A2A) Protocol. #experimental"
+example_question: "What's the weather in San Francisco?"
 settings:
   requires_data_ingestion: false
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: [
-    "langchain-google-vertexai~=2.0.7",
-    "langchain~=0.3.14",
-    "langgraph~=0.2.63",
-    "langchain-google-vertexai~=2.0.7",
-    "langchain~=0.3.14", 
-    "langchain-community~=0.3.17",
-    "langchain-openai~=0.3.5",
-  ]
+  extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "a2a-sdk~=0.3.9", "nest-asyncio>=1.6.0,<2.0.0"]
+  tags: ["adk", "a2a"]
+  frontend_type: "None"

agent_starter_pack/agents/adk_a2a_base/README.md

@@ -0,0 +1,37 @@
+# ADK with Agent2Agent (A2A) Protocol: Minimal Agent Example
+
+<p align="center">
+  <img src="https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/adk_logo.png?raw=true" width="200" alt="ADK Logo" style="margin-right: 40px; vertical-align: middle;">
+  <img src="https://github.com/a2aproject/A2A/blob/main/docs/assets/a2a-logo-white.svg?raw=true" width="200" alt="A2A Logo" style="vertical-align: middle;">
+</p>
+
+A basic agent built using the **[Google Agent Development Kit (ADK)](https://google.github.io/adk-docs/)** with **[Agent2Agent (A2A) Protocol](https://a2a-protocol.org/)** support. This example demonstrates core ADK concepts like agent creation and tool integration, while enabling distributed agent communication through the A2A protocol for interoperability with agents across different frameworks and languages.
+
+This agent uses the `gemini-2.5-flash` model and is equipped with two simple tools:
+*   `get_weather`: Simulates fetching weather (hardcoded for SF).
+*   `get_current_time`: Simulates fetching the time (hardcoded for SF).
+
+## Validating Your A2A Implementation
+
+This template includes the **[A2A Protocol Inspector](https://github.com/a2aproject/a2a-inspector)** for validating your agent's A2A implementation.
+
+```bash
+make inspector
+```
+
+The inspector now supports both JSON-RPC 2.0 (Cloud Run) and HTTP-JSON (Agent Engine) transport protocols:
+
+- **Cloud Run**: Test locally at `http://localhost:8000` or connect to your deployed Cloud Run URL
+- **Agent Engine**: Must deploy first, then connect to your deployed Agent Engine URL (local testing not available)
+
+For detailed setup instructions including local and remote testing workflows, refer to the `README.md` in your generated project.
+
+## Additional Resources
+
+### ADK Resources
+- **ADK Documentation**: Learn more about ADK concepts and capabilities in the [official documentation](https://google.github.io/adk-docs/)
+- **ADK Samples**: Explore more examples and use cases in the [official ADK Samples Repository](https://github.com/google/adk-samples)
+
+### A2A Resources
+- **A2A Documentation**: Learn about the Agent2Agent protocol and distributed agent communication in the [official A2A documentation](https://a2a-protocol.org/latest/specification/)
+- **A2A Samples**: Explore A2A agent implementations and integration examples in the [A2A Samples Repository](https://github.com/a2aproject/a2a-samples)

src/deployment_targets/cloud_run/Dockerfile → agent_starter_pack/agents/adk_a2a_base/app/__init__.py

@@ -12,18 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-FROM python:3.11-slim
+from .agent import app
 
-RUN pip install --no-cache-dir uv==0.6.12
-
-WORKDIR /code
-
-COPY ./pyproject.toml ./README.md ./uv.lock* ./
-
-COPY ./app ./app
-
-RUN uv sync --frozen
-
-EXPOSE 8080
-
-CMD ["uv", "run", "uvicorn", "app.server:app", "--host", "0.0.0.0", "--port", "8080"]
+__all__ = ["app"]

agent_starter_pack/agents/adk_a2a_base/app/agent.py

@@ -0,0 +1,70 @@
+# 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.
+
+import datetime
+import os
+from zoneinfo import ZoneInfo
+
+import google.auth
+from google.adk.agents import Agent
+from google.adk.apps.app import App
+
+_, project_id = google.auth.default()
+os.environ.setdefault("GOOGLE_CLOUD_PROJECT", project_id)
+os.environ.setdefault("GOOGLE_CLOUD_LOCATION", "global")
+os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
+
+
+def get_weather(query: str) -> str:
+    """Simulates a web search. Use it get information on weather.
+
+    Args:
+        query: A string containing the location to get weather information for.
+
+    Returns:
+        A string with the simulated weather information for the queried location.
+    """
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        return "It's 60 degrees and foggy."
+    return "It's 90 degrees and sunny."
+
+
+def get_current_time(query: str) -> str:
+    """Simulates getting the current time for a city.
+
+    Args:
+        city: The name of the city to get the current time for.
+
+    Returns:
+        A string with the current time information.
+    """
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        tz_identifier = "America/Los_Angeles"
+    else:
+        return f"Sorry, I don't have timezone information for query: {query}."
+
+    tz = ZoneInfo(tz_identifier)
+    now = datetime.datetime.now(tz)
+    return f"The current time for query {query} is {now.strftime('%Y-%m-%d %H:%M:%S %Z%z')}"
+
+
+root_agent = Agent(
+    name="root_agent",
+    model="gemini-2.5-flash",
+    description="An agent that can provide information about the weather and time.",
+    instruction="You are a helpful AI assistant designed to provide accurate and useful information.",
+    tools=[get_weather, get_current_time],
+)
+
+app = App(root_agent=root_agent, name="app")