ADK Live API - Agent Engine Bidi in Agent Engine (#371)

*   **Refactors Real-Time Agent:** Renamed the `live_api` agent to `adk_live` and migrated its core logic to use the Agent Development Kit.
*   **Enables Bidirectional Streaming:** Integrates with Agent Engine and the Gemini Live API for real-time communication.
*   **Updates Frontend & CI/CD:** Aligned the React frontend, build configurations, and CI/CD pipelines to support the new ADK-based agent in Agent Engine, adding new tests and deployment targets.

Author: eliasecchig

.cloudbuild/ci/test_templated_agents.yaml

@@ -35,4 +35,4 @@ logsBucket: gs://${PROJECT_ID}-logs-data/build-logs
 options:
   defaultLogsBucketBehavior: REGIONAL_USER_OWNED_BUCKET
   env:
-    - "_TEST_AGENT_COMBINATION=live_api,cloud_run"
+    - "_TEST_AGENT_COMBINATION=${_TEST_AGENT_COMBINATION}"

.cloudbuild/terraform/backend.tf

@@ -0,0 +1,6 @@
+terraform {
+  backend "gcs" {
+    bucket = "agent-starter-pack-cicd-terraform-state"
+    prefix = "cloudbuild"
+  }
+}

.cloudbuild/terraform/build_triggers.tf

@@ -91,8 +91,12 @@ locals {
       value = "agentic_rag,cloud_run,--include-data-ingestion,--datastore,vertex_ai_vector_search"
     },
     {
-      name  = "live_api-cloud_run"
-      value = "live_api,cloud_run"
+      name  = "adk_live-agent_engine"
+      value = "adk_live,agent_engine"
+    },
+    {
+      name  = "adk_live-cloud_run"
+      value = "adk_live,cloud_run"
     },
     {
       name  = "adk_base-cloud_run-alloydb"
@@ -132,6 +136,10 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       name = "agentic_rag-agent_engine-vertex_ai_search-github"
       value = "agentic_rag,agent_engine,--include-data-ingestion,--datastore,vertex_ai_search,--cicd-runner,github_actions"
     },
+    {
+      name  = "adk_live-agent_engine-github"
+      value = "adk_live,agent_engine,--cicd-runner,github_actions"
+    },
     {
       name  = "adk_base-agent_engine"
       value = "adk_base,agent_engine,-dir,tag"
@@ -153,8 +161,12 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       value = "agentic_rag,cloud_run,--include-data-ingestion,--datastore,vertex_ai_vector_search"
     },
     {
-      name  = "live_api-cloud_run"
-      value = "live_api,cloud_run"
+      name  = "adk_live-agent_engine"
+      value = "adk_live,agent_engine"
+    },
+    {
+      name  = "adk_live-cloud_run"
+      value = "adk_live,cloud_run"
     },
     {
       name  = "adk_base-cloud_run-alloydb"
@@ -180,8 +192,8 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       "agents/agentic_rag/**",
       "src/data_ingestion/**",
       "pyproject.toml",
-    ] : substr(combo.name, 0, 8) == "live_api" ? [
-      "agents/live_api/**",
+    ] : substr(combo.name, 0, 8) == "adk_live" ? [
+      "agents/adk_live/**",
       "pyproject.toml",
     ] : [
       # Only include files for the specific agent being tested

.cloudbuild/terraform/vars/env.tfvars

@@ -0,0 +1,13 @@
+cicd_runner_project_id = "agent-starter-pack-cicd"
+
+region = "europe-west4"
+
+host_connection_name = "git-connection"
+
+repository_name = "GoogleCloudPlatform-agent-starter-pack"
+
+e2e_test_project_mapping = {
+  dev     = "agent-starter-pack-e2e-dev"
+  staging = "agent-starter-pack-e2e-st"
+  prod    = "agent-starter-pack-e2e-pr"
+}

.gitignore

@@ -195,8 +195,6 @@ target
 set_projects.sh
 delete_genai_repos.sh
 cleanup_e2e_projects.sh
-.cloudbuild/terraform/backend.tf
-.cloudbuild/terraform/vars/env.tfvars
 docs/.vitepress/cache
 tests/cicd/delete_gcp_resources.sh
 tests/cicd/delete_agent_engines.py

GEMINI.md

@@ -139,7 +139,7 @@ Changes often require coordinated updates:
 
 ### Conditional Logic Patterns
 ```jinja
-{%- if cookiecutter.agent_name == "live_api" %}
+{%- if cookiecutter.agent_name == "adk_live" %}
 # Agent-specific logic
 {%- elif cookiecutter.deployment_target == "cloud_run" %}
 # Deployment-specific logic  
@@ -148,15 +148,15 @@ Changes often require coordinated updates:
 
 ### Testing Strategy
 Test changes across multiple dimensions:
-- Agent types (live_api, adk_base, etc.)
+- Agent types (adk_live, adk_base, etc.)
 - Deployment targets (cloud_run, agent_engine)
 - Feature combinations (data_ingestion, frontend_type)
 - Example command for testing the starter pack creation - from the root of the repo run: `uv run agent-starter-pack create myagent-$(date +%s) --output-dir target`
 
 ### Common Pitfalls
 - **Hardcoded URLs**: Use relative paths for frontend connections
 - **Missing Conditionals**: Wrap agent-specific code in proper `{% if %}` blocks
-- **Dependency Conflicts**: Some agents lack certain extras (e.g., live_api + lint)
+- **Dependency Conflicts**: Some agents lack certain extras (e.g., adk_live + lint)
 
 ## File Modification Checklist
 

README.md

@@ -72,7 +72,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | `agentic_rag` | A RAG agent for document retrieval and Q&A. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).       |
 | `langgraph_base_react`      | An agent implementing a base ReAct agent using LangGraph |
 | `crewai_coding_crew`       | A multi-agent system implemented with CrewAI created to support coding activities       |
-| `live_api`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
+| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
 
 **More agents are on the way!** We are continuously expanding our [agent library](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview). Have a specific agent type in mind? [Raise an issue as a feature request!](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues/new?labels=enhancement)
 

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"
 

…s/live_api/.template/templateconfig.yaml …s/adk_live/.template/templateconfig.yamlagents/live_api/.template/templateconfig.yaml renamed to agents/adk_live/.template/templateconfig.yaml agents/live_api/.template/templateconfig.yaml renamed to 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.15.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?"

agents/adk_live/README.md

@@ -0,0 +1,31 @@
+# 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.
+
+![adk_live_diagram](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/adk_live_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.
+- [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.