agent-starter-pack 0.15.7__py3-none-any.whl → 0.17.0__py3-none-any.whl

{agents → agent_starter_pack/agents}/adk_base/.template/templateconfig.yaml

@@ -18,7 +18,7 @@ settings:
   requires_data_ingestion: false
   requires_session: true
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=1.14.0"]
+  extra_dependencies: ["google-adk>=1.15.0,<2.0.0"]
   tags: ["adk"]
   frontend_type: "None"
     

{agents/live_api → agent_starter_pack/agents/adk_live}/.template/templateconfig.yaml

@@ -12,13 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-description: "A real-time multimodal RAG agent powered by Gemini Live API, supporting audio/video/text chat with vector DB-backed responses"
+description: "Real-time multimodal agent with ADK and Gemini Live API for low-latency voice and video interaction."
 settings:
   requires_data_ingestion: false
-  frontend_type: "live_api_react"
-  deployment_targets: ["cloud_run"]
-  extra_dependencies: [
-    "backoff~=2.2.1",
-    "google-genai>=1.16.0",
-  ]
+  frontend_type: "adk_live_react"
+  deployment_targets: ["agent_engine", "cloud_run"]
+  extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "click>=8.0.0,<9.0.0", "uvicorn>=0.18.0,<1.0.0", "fastapi>=0.75.0,<1.0.0", "backoff>=2.0.0,<3.0.0"]
+  tags: ["adk", "adk_live"]
 example_question: "What's the weather in San Francisco?"

agent_starter_pack/agents/adk_live/README.md

@@ -0,0 +1,32 @@
+# ADK Live Agent
+
+Real-time conversational agent built with Google ADK and Gemini's live audio model. Supports audio, video, and text interactions with native tool calling.
+
+![live_api_diagram](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/live_api_diagram.png)
+
+**Key components:**
+
+- **Python Backend** (in `app/` folder): ADK-powered agent using Gemini's live audio model with native tool calling and deployment support for Cloud Run and Agent Engine
+
+- **React Frontend** (in `frontend/` folder): Web console for interacting with the live agent via audio, video, and text
+
+![live api demo](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/adk_live_pattern_demo.gif)
+
+Once running, click the play button to connect and interact with the agent. Try asking "What's the weather like in San Francisco?" to see tool calling in action.
+
+## Additional Resources for Multimodal Live API
+
+Explore these resources to learn more about the Multimodal Live API and see examples of its usage:
+
+- [Project Pastra](https://github.com/heiko-hotz/gemini-multimodal-live-dev-guide/tree/main): a comprehensive developer guide for the Gemini Multimodal Live API.
+- [ADK Samples: Realtime Conversational Agent](https://github.com/google/adk-samples/tree/main/python/agents/realtime-conversational-agent): Full-stack, reusable template using Agent Development Kit (ADK) with the Gemini Live API.
+- [Google Cloud Multimodal Live API demos and samples](https://github.com/GoogleCloudPlatform/generative-ai/tree/main/gemini/multimodal-live-api): Collection of code samples and demo applications leveraging multimodal live API in Vertex AI
+- [Gemini 2 Cookbook](https://github.com/google-gemini/cookbook/tree/main/gemini-2): Practical examples and tutorials for working with Gemini 2
+- [Multimodal Live API Web Console](https://github.com/google-gemini/multimodal-live-api-web-console): Interactive React-based web interface for testing and experimenting with Gemini Multimodal Live API.
+
+## Current Status & Future Work
+
+This pattern is under active development. Key areas planned for future enhancement include:
+
+*   **Observability:** Implementing comprehensive monitoring and tracing features.
+*   **Load Testing:** Integrating load testing capabilities.

agent_starter_pack/agents/adk_live/app/agent.py

@@ -0,0 +1,48 @@
+# 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 os
+
+import google.auth
+import vertexai
+from google.adk.agents import Agent
+
+_, project_id = google.auth.default()
+os.environ.setdefault("GOOGLE_CLOUD_PROJECT", project_id)
+os.environ.setdefault("GOOGLE_CLOUD_LOCATION", "us-central1")
+os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
+
+vertexai.init(project=project_id, location="us-central1")
+
+
+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."
+
+
+root_agent = Agent(
+    name="root_agent",
+    model="gemini-live-2.5-flash-preview-native-audio-09-2025",
+    instruction="You are a helpful AI assistant designed to provide accurate and useful information.",
+    tools=[get_weather],
+)

agent_starter_pack/agents/adk_live/tests/unit/test_dummy.py

@@ -0,0 +1,38 @@
+# 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.
+"""
+You can add your unit tests here.
+This is where you test your business logic, including agent functionality,
+data processing, and other core components of your application.
+"""
+
+from app.agent import get_weather
+
+
+def test_get_weather_san_francisco() -> None:
+    """Test get_weather function returns correct weather for San Francisco."""
+    result = get_weather("What's the weather in San Francisco?")
+    assert result == "It's 60 degrees and foggy."
+
+
+def test_get_weather_san_francisco_abbreviation() -> None:
+    """Test get_weather function returns correct weather for SF abbreviation."""
+    result = get_weather("weather in sf")
+    assert result == "It's 60 degrees and foggy."
+
+
+def test_get_weather_other_location() -> None:
+    """Test get_weather function returns default weather for other locations."""
+    result = get_weather("What's the weather in New York?")
+    assert result == "It's 90 degrees and sunny."

{agents → agent_starter_pack/agents}/agentic_rag/.template/templateconfig.yaml

@@ -19,7 +19,7 @@ settings:
   requires_session: true
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: [
-    "google-adk~=1.14.0",
+    "google-adk>=1.15.0,<2.0.0",
     "langchain-google-vertexai~=2.0.7",
     "langchain~=0.3.24",
     "langchain-core~=0.3.55",

agent_starter_pack/agents/crewai_coding_crew/app/agent.py

@@ -0,0 +1,47 @@
+# 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.
+
+# mypy: disable-error-code="union-attr"
+from langchain_google_vertexai import ChatVertexAI
+from langgraph.prebuilt import create_react_agent
+
+from .crew.crew import DevCrew
+
+LOCATION = "global"
+LLM = "gemini-2.5-flash"
+
+llm = ChatVertexAI(model=LLM, location=LOCATION, temperature=0)
+
+
+def coding_tool(code_instructions: str) -> str:
+    """Use this tool to write a python program given a set of requirements and or instructions."""
+    inputs = {"code_instructions": code_instructions}
+    return DevCrew().crew().kickoff(inputs=inputs)
+
+
+system_message = (
+    "You are an expert Lead Software Engineer Manager.\n"
+    "Your role is to speak to a user and understand what kind of code they need to "
+    "build.\n"
+    "Part of your task is therefore to gather requirements and clarifying ambiguity "
+    "by asking followup questions. Don't ask all the questions together as the user "
+    "has a low attention span, rather ask a question at the time.\n"
+    "Once the problem to solve is clear, you will call your tool for writing the "
+    "solution.\n"
+    "Remember, you are an expert in understanding requirements but you cannot code, "
+    "use your coding tool to generate a solution. Keep the test cases if any, they "
+    "are useful for the user."
+)
+
+agent = create_react_agent(model=llm, tools=[coding_tool], prompt=system_message)

agent_starter_pack/agents/langgraph_base_react/app/agent.py

@@ -0,0 +1,34 @@
+# 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.
+
+# mypy: disable-error-code="union-attr"
+from langchain_google_vertexai import ChatVertexAI
+from langgraph.prebuilt import create_react_agent
+
+LOCATION = "global"
+LLM = "gemini-2.5-flash"
+
+llm = ChatVertexAI(model=LLM, location=LOCATION, temperature=0)
+
+
+def get_weather(query: str) -> str:
+    """Simulates a web search. Use it get information on weather"""
+    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."
+
+
+agent = create_react_agent(
+    model=llm, tools=[get_weather], prompt="You are a helpful assistant"
+)

{src → agent_starter_pack}/base_template/GEMINI.md

@@ -1,5 +1,5 @@
 Coding Agent guidance:
-{%- if "adk" in cookiecutter.tags %}
+{%- if cookiecutter.is_adk %}
 {{ cookiecutter.adk_cheatsheet }}
 {%- endif %}
 {{ cookiecutter.llm_txt }}

{src → agent_starter_pack}/base_template/Makefile

@@ -1,99 +1,128 @@
+# ==============================================================================
+# Installation & Setup
+# ==============================================================================
+
 # Install dependencies using uv package manager
 install:
-	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.6.12/install.sh | sh; source $HOME/.local/bin/env; }
-{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %} 
+	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.8.13/install.sh | sh; source $HOME/.local/bin/env; }
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %}
 	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("install")}}
 {%- else %}
-	uv sync --dev{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %} --extra streamlit{%- endif %}{% if cookiecutter.agent_name == 'live_api' %} && (cd frontend && npm install){%- endif %}
-{%- endif %}
-
-{%- if cookiecutter.settings.get("commands", {}).get("extra", {}) %}
-{%- for cmd_name, cmd_value in cookiecutter.settings.get("commands", {}).get("extra", {}).items() %}
-
-# {{ cmd_value.get("description") }}
-{{ cmd_name }}:
-{%- if cmd_value is mapping %}
-{%- if cmd_value.command is mapping and cookiecutter.deployment_target in cmd_value.command %}
-	{{ cmd_value.command[cookiecutter.deployment_target] }}
-{%- else %}
-	{{ cmd_value.command if cmd_value.command is string else "" }}
-{%- endif %}
-{%- else %}
-	{{ cmd_value }}
+	uv sync --dev{% if not cookiecutter.is_adk and not cookiecutter.is_adk_live %} --extra streamlit{%- endif %}{% if cookiecutter.is_adk_live %} && (cd frontend && npm install){%- endif %}
 {%- endif %}
-{%- endfor %}{%- endif %}
 
-{%- if cookiecutter.agent_name == 'live_api' %}
-# Build the frontend for production
-build-frontend:
-	(cd frontend && npm run build)
+# ==============================================================================
+# Playground Targets
+# ==============================================================================
 
-{%- endif %}
 # Launch local dev playground
-playground:{%- if cookiecutter.agent_name == 'live_api' %} build-frontend{%- endif %}
+playground:{%- if cookiecutter.is_adk_live %} build-frontend-if-needed{%- endif %}
 {%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("playground") %}
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("playground") is mapping %}
+	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("playground").get(cookiecutter.deployment_target, "")}}
+{%- else %}
 	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("playground")}}
+{%- endif %}
 {%- else %}
 	@echo "==============================================================================="
 	@echo "| 🚀 Starting your agent playground...                                        |"
 	@echo "|                                                                             |"
-{%- if cookiecutter.agent_name == 'live_api' %}
+{%- if cookiecutter.is_adk_live %}
 	@echo "| 🌐 Access your app at: http://localhost:8000                               |"
 {%- endif %}
 	@echo "| 💡 Try asking: {{cookiecutter.example_question}}|"
-{%- if "adk" in cookiecutter.tags %}
+{%- if cookiecutter.is_adk %}
 	@echo "|                                                                             |"
 	@echo "| 🔍 IMPORTANT: Select the '{{cookiecutter.agent_directory}}' folder to interact with your agent.          |"
 {%- endif %}
 	@echo "==============================================================================="
-{%- if "adk" in cookiecutter.tags %}
+{%- if cookiecutter.is_adk_live %}
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
+{%- else %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host localhost --port 8000 --reload
+{%- endif %}
+{%- elif cookiecutter.is_adk %}
 	uv run adk web . --port 8501 --reload_agents
 {%- else %}
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
-{%- if cookiecutter.agent_name == 'live_api' %}
-	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload
-{%- else %}
-	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload &
-{%- endif %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host localhost --port 8000 --reload &
 {%- endif %}
-{%- if cookiecutter.agent_name != 'live_api' %}
 	{% if cookiecutter.deployment_target == 'agent_engine' %}PYTHONPATH=. {% endif %}uv run streamlit run frontend/streamlit_app.py --browser.serverAddress=localhost --server.enableCORS=false --server.enableXsrfProtection=false
 {%- endif %}
 {%- endif %}
+{%- if cookiecutter.settings.get("commands", {}).get("extra", {}) %}
+
+# ==============================================================================
+# Agent-Specific Commands
+# ==============================================================================
+{%- for cmd_name, cmd_value in cookiecutter.settings.get("commands", {}).get("extra", {}).items() %}
+{%- if cmd_value is mapping %}
+{%- if cmd_value.command is mapping %}
+{%- if cookiecutter.deployment_target in cmd_value.command %}
+
+# {{ cmd_value.get("description") }}
+{{ cmd_name }}:
+	{{ cmd_value.command[cookiecutter.deployment_target] }}
 {%- endif %}
+{%- else %}
 
-# Deploy the agent remotely
-{%- if cookiecutter.deployment_target == 'cloud_run' %}
-# Usage: make backend [IAP=true] [PORT=8080] - Set IAP=true to enable Identity-Aware Proxy, PORT to specify container port
+# {{ cmd_value.get("description") }}
+{{ cmd_name }}:
+	{{ cmd_value.command if cmd_value.command is string else "" }}
 {%- endif %}
-backend:
-{%- if cookiecutter.deployment_target == 'cloud_run' %}
-	PROJECT_ID=$$(gcloud config get-value project) && \
-	gcloud beta run deploy {{cookiecutter.project_name}} \
-		--source . \
-		--memory "4Gi" \
-		--project $$PROJECT_ID \
-		--region "us-central1" \
-		--no-allow-unauthenticated \
-		--no-cpu-throttling \
-		--labels "{% if "adk" in cookiecutter.tags %}created-by=adk{% if cookiecutter.agent_garden %},{% endif %}{% endif %}{% if cookiecutter.agent_garden %}deployed-with=agent-garden{% if cookiecutter.agent_sample_id %},vertex-agent-sample-id={{cookiecutter.agent_sample_id}},vertex-agent-sample-publisher={{cookiecutter.agent_sample_publisher}}{% endif %}{% endif %}" \
-		--set-env-vars \
-		"COMMIT_SHA=$(shell git rev-parse HEAD){%- if cookiecutter.data_ingestion %}{%- if cookiecutter.datastore_type == "vertex_ai_search" %},DATA_STORE_ID={{cookiecutter.project_name}}-datastore,DATA_STORE_REGION=us{%- elif cookiecutter.datastore_type == "vertex_ai_vector_search" %},VECTOR_SEARCH_INDEX={{cookiecutter.project_name}}-vector-search,VECTOR_SEARCH_INDEX_ENDPOINT={{cookiecutter.project_name}}-vector-search-endpoint,VECTOR_SEARCH_BUCKET=$$PROJECT_ID-{{cookiecutter.project_name}}-vs{%- endif %}{%- endif %}" \
-		$(if $(IAP),--iap) \
-		$(if $(PORT),--port=$(PORT))
-{%- elif cookiecutter.deployment_target == 'agent_engine' %}
-	# Export dependencies to requirements file using uv export.
-	uv export --no-hashes --no-header --no-dev --no-emit-project --no-annotate > .requirements.txt 2>/dev/null || \
-	uv export --no-hashes --no-header --no-dev --no-emit-project > .requirements.txt && uv run {{cookiecutter.agent_directory}}/agent_engine_app.py
+{%- else %}
+
+# {{ cmd_value.get("description", "") }}
+{{ cmd_name }}:
+	{{ cmd_value }}
 {%- endif %}
+{%- endfor %}
+{%- endif %}
+{%- if cookiecutter.is_adk_live %}
+
+# ==============================================================================
+# ADK Live Commands
+# ==============================================================================
+
+# Build the frontend for production
+build-frontend:
+	(cd frontend && npm run build)
+
+# Build the frontend only if needed (conditional build)
+build-frontend-if-needed:
+	@if [ ! -d "frontend/build" ] || [ ! -f "frontend/build/index.html" ]; then \
+		echo "Frontend build directory not found or incomplete. Building..."; \
+		$(MAKE) build-frontend; \
+	elif [ "frontend/package.json" -nt "frontend/build/index.html" ] || \
+		 find frontend/src -newer frontend/build/index.html 2>/dev/null | head -1 | grep -q .; then \
+		echo "Frontend source files are newer than build. Rebuilding..."; \
+		$(MAKE) build-frontend; \
+	else \
+		echo "Frontend build is up to date. Skipping build..."; \
+	fi
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 
 # Launch local development server with hot-reload
 local-backend:
-	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload
+	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host localhost --port 8000 --reload
+{%- endif %}
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --port 8000  --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
+
+# Connect to remote deployed agent
+playground-remote: build-frontend-if-needed
+	@echo "==============================================================================="
+	@echo "| 🚀 Connecting to REMOTE agent...                                           |"
+	@echo "|                                                                             |"
+	@echo "| 🌐 Access your app at: http://localhost:8000                               |"
+	@echo "| ☁️  Connected to deployed agent engine                                      |"
+	@echo "==============================================================================="
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode remote
 {%- endif %}
-{%- if cookiecutter.deployment_target == 'cloud_run' %}
-{%- if cookiecutter.agent_name == 'live_api' %}
 
 # Start the frontend UI separately for development (requires backend running separately)
 ui:
@@ -106,7 +135,7 @@ playground-dev:
 	@echo "|                                                                             |"
 	@echo "| 🌐 Frontend: http://localhost:8501                                         |"
 	@echo "| 🌐 Backend:  http://localhost:8000                                         |"
-	@echo "| 💡 Try asking: What's the weather in San Francisco?                         |"
+	@echo "| 💡 Try asking: {{cookiecutter.example_question}}|"
 	@echo "| 🔄 Both frontend and backend will auto-reload on changes                    |"
 	@echo "==============================================================================="
 	@echo "Starting backend server..."
@@ -114,15 +143,51 @@ playground-dev:
 	@echo "Starting frontend dev server..."
 	$(MAKE) ui
 {%- endif %}
+
+# ==============================================================================
+# Backend Deployment Targets
+# ==============================================================================
+
+# Deploy the agent remotely
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+# Usage: make backend [IAP=true] [PORT=8080] - Set IAP=true to enable Identity-Aware Proxy, PORT to specify container port
+{%- endif %}
+backend:
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	PROJECT_ID=$$(gcloud config get-value project) && \
+	gcloud beta run deploy {{cookiecutter.project_name}} \
+		--source . \
+		--memory "4Gi" \
+		--project $$PROJECT_ID \
+		--region "us-central1" \
+		--no-allow-unauthenticated \
+		--no-cpu-throttling \
+		--labels "{% if cookiecutter.is_adk %}created-by=adk{% if cookiecutter.agent_garden %},{% endif %}{% endif %}{% if cookiecutter.agent_garden %}deployed-with=agent-garden{% if cookiecutter.agent_sample_id %},vertex-agent-sample-id={{cookiecutter.agent_sample_id}},vertex-agent-sample-publisher={{cookiecutter.agent_sample_publisher}}{% endif %}{% endif %}" \
+		--set-env-vars \
+		"COMMIT_SHA=$(shell git rev-parse HEAD){%- if cookiecutter.data_ingestion %}{%- if cookiecutter.datastore_type == "vertex_ai_search" %},DATA_STORE_ID={{cookiecutter.project_name}}-datastore,DATA_STORE_REGION=us{%- elif cookiecutter.datastore_type == "vertex_ai_vector_search" %},VECTOR_SEARCH_INDEX={{cookiecutter.project_name}}-vector-search,VECTOR_SEARCH_INDEX_ENDPOINT={{cookiecutter.project_name}}-vector-search-endpoint,VECTOR_SEARCH_BUCKET=$$PROJECT_ID-{{cookiecutter.project_name}}-vs{%- endif %}{%- endif %}" \
+		$(if $(IAP),--iap) \
+		$(if $(PORT),--port=$(PORT))
+{%- elif cookiecutter.deployment_target == 'agent_engine' %}
+	# Export dependencies to requirements file using uv export.
+	uv export --no-hashes --no-header --no-dev --no-emit-project --no-annotate > .requirements.txt 2>/dev/null || \
+	uv export --no-hashes --no-header --no-dev --no-emit-project > .requirements.txt && uv run {{cookiecutter.agent_directory}}/agent_engine_app.py
 {%- endif %}
 
+
+# ==============================================================================
+# Infrastructure Setup
+# ==============================================================================
+
 # Set up development environment resources using Terraform
 setup-dev-env:
 	PROJECT_ID=$$(gcloud config get-value project) && \
 	(cd deployment/terraform/dev && terraform init && terraform apply --var-file vars/env.tfvars --var dev_project_id=$$PROJECT_ID --auto-approve)
-
 {%- if cookiecutter.data_ingestion %}
 
+# ==============================================================================
+# Data Ingestion (RAG capabilities)
+# ==============================================================================
+
 # Run the data ingestion pipeline for RAG capabilities
 data-ingestion:
 	PROJECT_ID=$$(gcloud config get-value project) && \
@@ -142,6 +207,10 @@ data-ingestion:
 		--pipeline-name="data-ingestion-pipeline")
 {%- endif %}
 
+# ==============================================================================
+# Testing & Code Quality
+# ==============================================================================
+
 # Run unit and integration tests
 test:
 	uv run pytest tests/unit && uv run pytest tests/integration

{src → agent_starter_pack}/base_template/README.md

@@ -58,11 +58,11 @@ make install && make playground
 {%- endfor %}
 {%- endif %}
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
-| `make playground`    | Launch local development environment with backend and frontend{%- if "adk" in cookiecutter.tags %} - leveraging `adk web` command. {%- endif %}|
+| `make playground`    | Launch local development environment with backend and frontend{%- if cookiecutter.is_adk %} - leveraging `adk web` command. {%- endif %}|
 | `make backend`       | Deploy agent to Cloud Run (use `IAP=true` to enable Identity-Aware Proxy) |
 | `make local-backend` | Launch local development server |
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
-{%- if cookiecutter.agent_name == 'live_api' %}
+{%- if cookiecutter.is_adk_live %}
 | `make ui`       | Launch Agent Playground front-end only |
 {%- endif %}
 {%- endif %}
@@ -80,7 +80,7 @@ make install && make playground
 
 For full command options and usage, refer to the [Makefile](Makefile).
 
-{% if cookiecutter.agent_name == 'live_api' %}
+{% if cookiecutter.is_adk_live %}
 ## Usage
 
 This template follows a "bring your own agent" approach - you focus on your business logic in `{{cookiecutter.agent_directory}}/agent.py`, and the template handles the surrounding components (UI, infrastructure, deployment, monitoring).
@@ -158,7 +158,7 @@ You can test deployment towards a Dev Environment using the following command:
 gcloud config set project <your-dev-project-id>
 make backend
 ```
-{% if cookiecutter.agent_name == 'live_api' %}
+{% if cookiecutter.is_adk_live %}
 **Note:** For secure access to your deployed backend, consider using Identity-Aware Proxy (IAP) by running `make backend IAP=true`.
 {%- endif %}
 
@@ -169,9 +169,9 @@ See [deployment/README.md](deployment/README.md) for instructions.
 
 The repository includes a Terraform configuration for the setup of a production Google Cloud project. Refer to [deployment/README.md](deployment/README.md) for detailed instructions on how to deploy the infrastructure and application.
 
-{% if cookiecutter.agent_name != 'live_api' %}
+{% if not cookiecutter.is_adk_live %}
 ## Monitoring and Observability
-> You can use [this Looker Studio dashboard]({%- if "adk" in cookiecutter.tags %}https://lookerstudio.google.com/reporting/46b35167-b38b-4e44-bd37-701ef4307418/page/tEnnC{%- else %}https://lookerstudio.google.com/c/reporting/fa742264-4b4b-4c56-81e6-a667dd0f853f/page/tEnnC{%- endif %}
+> You can use [this Looker Studio dashboard]({%- if cookiecutter.is_adk %}https://lookerstudio.google.com/reporting/46b35167-b38b-4e44-bd37-701ef4307418/page/tEnnC{%- else %}https://lookerstudio.google.com/c/reporting/fa742264-4b4b-4c56-81e6-a667dd0f853f/page/tEnnC{%- endif %}
 ) template for visualizing events being logged in BigQuery. See the "Setup Instructions" tab to getting started.
 
 The application uses OpenTelemetry for comprehensive observability with all events being sent to Google Cloud Trace and Logging for monitoring and to BigQuery for long term storage. 

{src → agent_starter_pack}/base_template/deployment/terraform/dev/apis.tf

@@ -25,7 +25,7 @@ locals {
     "serviceusage.googleapis.com",
     "logging.googleapis.com",
     "cloudtrace.googleapis.com",
-{%- if "adk" in cookiecutter.tags and cookiecutter.session_type == "alloydb" %}
+{%- if cookiecutter.is_adk and cookiecutter.session_type == "alloydb" %}
     "compute.googleapis.com",
     "servicenetworking.googleapis.com",
     "alloydb.googleapis.com",

{src → agent_starter_pack}/base_template/deployment/terraform/dev/log_sinks.tf

@@ -12,13 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-resource "google_project_iam_member" "bigquery_data_editor" {
-
-  project = var.dev_project_id
-  role    = "roles/bigquery.dataEditor"
-  member  = module.log_export_to_bigquery.writer_identity
-}
-
 resource "google_bigquery_dataset" "feedback_dataset" {
   project       = var.dev_project_id
   dataset_id    = replace("${var.project_name}_feedback", "-", "_")
@@ -35,29 +28,42 @@ resource "google_bigquery_dataset" "telemetry_logs_dataset" {
   depends_on    = [resource.google_project_service.services]
 }
 
-module "feedback_export_to_bigquery" {
-  source                 = "terraform-google-modules/log-export/google"
-  version                = "10.0.0"
-  log_sink_name          = "${var.project_name}_feedback"
-  parent_resource_type   = "project"
-  parent_resource_id     = var.dev_project_id
-  destination_uri        = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.feedback_dataset.dataset_id}"
-  filter                 = var.feedback_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
+resource "google_logging_project_sink" "feedback_export_to_bigquery" {
+  name        = "${var.project_name}_feedback"
+  project     = var.dev_project_id
+  destination = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.feedback_dataset.dataset_id}"
+  filter      = var.feedback_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
+
   unique_writer_identity = true
   depends_on             = [google_bigquery_dataset.feedback_dataset]
 }
 
-module "log_export_to_bigquery" {
-  source  = "terraform-google-modules/log-export/google"
-  version = "10.0.0"
+resource "google_logging_project_sink" "log_export_to_bigquery" {
+  name        = "${var.project_name}_telemetry"
+  project     = var.dev_project_id
+  destination = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.telemetry_logs_dataset.dataset_id}"
+  filter      = var.telemetry_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
 
-  log_sink_name          = "${var.project_name}_telemetry"
-  parent_resource_type   = "project"
-  parent_resource_id     = var.dev_project_id
-  destination_uri        = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.telemetry_logs_dataset.dataset_id}"
-  filter                 = var.telemetry_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
   unique_writer_identity = true
   depends_on             = [google_bigquery_dataset.telemetry_logs_dataset]
 }
+
+resource "google_project_iam_member" "bigquery_data_editor" {
+  project = var.dev_project_id
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.log_export_to_bigquery.writer_identity
+}
+
+resource "google_project_iam_member" "feedback_bigquery_data_editor" {
+  project = var.dev_project_id
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.feedback_export_to_bigquery.writer_identity
+}