agent-starter-pack 0.3.9__tar.gz → 0.4.0__tar.gz

agent_starter_pack-0.4.0/.github/workflows/docs.yml

@@ -0,0 +1,61 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: 'npm'
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install dependencies
+        working-directory: docs
+        run: npm ci
+      
+      - name: Build VitePress site
+        working-directory: docs
+        run: |
+          npm run docs:build
+      
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/.gitignore

@@ -196,3 +196,4 @@ delete_genai_repos.sh
 cleanup_e2e_projects.sh
 .cloudbuild/terraform/backend.tf
 .cloudbuild/terraform/vars/env.tfvars
+docs/.vitepress/cache

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/Makefile

@@ -23,3 +23,6 @@ clean:
 
 install:
 	uv sync --dev --extra lint --frozen
+
+docs-dev:
+	cd docs && npm install && NODE_OPTIONS="--no-warnings" npm run docs:dev

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.3.9
+Version: 0.4.0
 Summary: CLI tool to create GCP-based AI agent projects from templates
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -25,7 +25,7 @@ Description-Content-Type: text/markdown
 
 # 🚀 Agent Starter Pack
 
-![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](./docs/README.md) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
+![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
   <picture>
     <source
       media="(prefers-color-scheme: dark)"
@@ -46,7 +46,7 @@ It accelerates development by providing a holistic, production-ready solution, a
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
-| [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live Multimodal API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](./docs/observability.md), and [CI/CD](./docs/deployment.md) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. |
+| [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. |
 
 ---
  
@@ -66,7 +66,7 @@ agent-starter-pack create my-awesome-agent
 ```
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
-For more installation options, see the [Installation Guide](docs/installation.md).  You can also [try it in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) with zero setup.
+For more installation options, see the [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation). You can also [try it in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) with zero setup.
 
 ---
 
@@ -76,7 +76,7 @@ For more installation options, see the [Installation Guide](docs/installation.md
 agent-starter-pack create my-agent -d agent_engine -a adk_base
 ```
 
-*See the [full list of options](docs/cli/create.md) for details.*
+*See the [full list of options](https://googlecloudplatform.github.io/agent-starter-pack/cli/create) for details.*
 
 ## 🤖 Agents
 
@@ -88,7 +88,7 @@ agent-starter-pack create my-agent -d agent_engine -a adk_base
 | `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                       |
 
-**More agents are on the way!** We are continuously expanding our [agent library](./agents/).  Have a specific agent type in mind?  [Contribute!](#contributing)
+**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)
 
 **🔍 ADK Samples**
 
@@ -97,9 +97,8 @@ Looking to explore more ADK examples? Check out the [ADK Samples Repository](htt
 #### Extra Features
 
 The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
-
-- **🔄 [CI/CD Automation (Experimental)](docs/cli/setup_cicd.md)** - One command to set up a complete GitHub + Cloud Build pipeline for all environments
-- **📥 [Data Pipeline for RAG with Terraform/CI-CD](docs/data-ingestion.md)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. 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).
+- **🔄 [CI/CD Automation (Experimental)](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - One command to set up a complete GitHub + Cloud Build pipeline for all environments
+- **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. 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).
 
 
 ## High-Level Architecture
@@ -118,18 +117,21 @@ This starter pack covers all aspects of Agent development, from prototyping and
 
 
 ## 📚 Documentation
-See the [documentation](docs/) for more details:
 
-- [Why Use the Starter Pack?](docs/why_starter_pack.md)
-- [Installation](docs/installation.md)
-- [Deployment](docs/deployment.md)
-- [Data Ingestion](docs/data-ingestion.md)
-- [Observability](docs/observability.md)
-- [CLI Reference](docs/cli/README.md)
-- [Troubleshooting](docs/troubleshooting.md)
+Visit our [documentation site](https://googlecloudplatform.github.io/agent-starter-pack/) for comprehensive guides and references!
+
+- [Getting Started Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/getting-started) - First steps with agent-starter-pack
+- [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) - Setting up your environment
+- [Deployment Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) - Taking your agent to production
+- [Agent Templates Overview](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview) - Explore available agent patterns
+- [CLI Reference](https://googlecloudplatform.github.io/agent-starter-pack/cli/) - Command-line tool documentation
+
 
 ### Video Walkthrough:
 
+## Video Tutorials
+
+- **April 2024**: A [6-minute introduction video](https://www.youtube.com/live/eZ-8UQ_t4YM?feature=shared&t=2791) Explaining the Agent Starter Pack and demonstrating its key features. Part of the Kaggle GenAI intensive course.
 - **March 6, 2025**: A [120 Minute livestream video demo](https://www.youtube.com/watch?v=yIRIT_EtALs&t=235s) of the new `agent-starter-pack` were we build 3 Agents under 30 minutes!
 - **Oct 29, 2024**: A [20-Minute Video Walkthrough](https://youtu.be/kwRG7cnqSu0) is available, showcasing the previous `agent-starter-pack`.
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/README.md

@@ -1,6 +1,6 @@
 # 🚀 Agent Starter Pack
 
-![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](./docs/README.md) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
+![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
   <picture>
     <source
       media="(prefers-color-scheme: dark)"
@@ -21,7 +21,7 @@ It accelerates development by providing a holistic, production-ready solution, a
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
-| [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live Multimodal API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](./docs/observability.md), and [CI/CD](./docs/deployment.md) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. |
+| [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. |
 
 ---
  
@@ -41,7 +41,7 @@ agent-starter-pack create my-awesome-agent
 ```
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
-For more installation options, see the [Installation Guide](docs/installation.md).  You can also [try it in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) with zero setup.
+For more installation options, see the [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation). You can also [try it in Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) with zero setup.
 
 ---
 
@@ -51,7 +51,7 @@ For more installation options, see the [Installation Guide](docs/installation.md
 agent-starter-pack create my-agent -d agent_engine -a adk_base
 ```
 
-*See the [full list of options](docs/cli/create.md) for details.*
+*See the [full list of options](https://googlecloudplatform.github.io/agent-starter-pack/cli/create) for details.*
 
 ## 🤖 Agents
 
@@ -63,7 +63,7 @@ agent-starter-pack create my-agent -d agent_engine -a adk_base
 | `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                       |
 
-**More agents are on the way!** We are continuously expanding our [agent library](./agents/).  Have a specific agent type in mind?  [Contribute!](#contributing)
+**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)
 
 **🔍 ADK Samples**
 
@@ -72,9 +72,8 @@ Looking to explore more ADK examples? Check out the [ADK Samples Repository](htt
 #### Extra Features
 
 The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
-
-- **🔄 [CI/CD Automation (Experimental)](docs/cli/setup_cicd.md)** - One command to set up a complete GitHub + Cloud Build pipeline for all environments
-- **📥 [Data Pipeline for RAG with Terraform/CI-CD](docs/data-ingestion.md)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. 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).
+- **🔄 [CI/CD Automation (Experimental)](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - One command to set up a complete GitHub + Cloud Build pipeline for all environments
+- **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. 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).
 
 
 ## High-Level Architecture
@@ -93,18 +92,21 @@ This starter pack covers all aspects of Agent development, from prototyping and
 
 
 ## 📚 Documentation
-See the [documentation](docs/) for more details:
 
-- [Why Use the Starter Pack?](docs/why_starter_pack.md)
-- [Installation](docs/installation.md)
-- [Deployment](docs/deployment.md)
-- [Data Ingestion](docs/data-ingestion.md)
-- [Observability](docs/observability.md)
-- [CLI Reference](docs/cli/README.md)
-- [Troubleshooting](docs/troubleshooting.md)
+Visit our [documentation site](https://googlecloudplatform.github.io/agent-starter-pack/) for comprehensive guides and references!
+
+- [Getting Started Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/getting-started) - First steps with agent-starter-pack
+- [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) - Setting up your environment
+- [Deployment Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) - Taking your agent to production
+- [Agent Templates Overview](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview) - Explore available agent patterns
+- [CLI Reference](https://googlecloudplatform.github.io/agent-starter-pack/cli/) - Command-line tool documentation
+
 
 ### Video Walkthrough:
 
+## Video Tutorials
+
+- **April 2024**: A [6-minute introduction video](https://www.youtube.com/live/eZ-8UQ_t4YM?feature=shared&t=2791) Explaining the Agent Starter Pack and demonstrating its key features. Part of the Kaggle GenAI intensive course.
 - **March 6, 2025**: A [120 Minute livestream video demo](https://www.youtube.com/watch?v=yIRIT_EtALs&t=235s) of the new `agent-starter-pack` were we build 3 Agents under 30 minutes!
 - **Oct 29, 2024**: A [20-Minute Video Walkthrough](https://youtu.be/kwRG7cnqSu0) is available, showcasing the previous `agent-starter-pack`.
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/adk_base/app/agent.py

@@ -21,7 +21,7 @@ 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_CLOUD_LOCATION", "global")
 os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
 
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/adk_base/template/.templateconfig.yaml

@@ -13,9 +13,10 @@
 # limitations under the License.
 
 description: "A base ReAct agent built with Google's Agent Development Kit (ADK)"
+example_question: "What's the weather in San Francisco?"
 settings:
   requires_data_ingestion: false
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=0.2.0"]
+  extra_dependencies: ["google-adk~=0.5.0"]
   tags: ["adk"]
   frontend_type: "None"

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/agentic_rag/app/agent.py

@@ -24,12 +24,13 @@ from app.retrievers import get_compressor, get_retriever
 from app.templates import format_docs
 
 EMBEDDING_MODEL = "text-embedding-005"
+LLM_LOCATION = "global"
 LOCATION = "us-central1"
 LLM = "gemini-2.0-flash-001"
 
 credentials, project_id = google.auth.default()
 os.environ.setdefault("GOOGLE_CLOUD_PROJECT", project_id)
-os.environ.setdefault("GOOGLE_CLOUD_LOCATION", LOCATION)
+os.environ.setdefault("GOOGLE_CLOUD_LOCATION", LLM_LOCATION)
 os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
 
 vertexai.init(project=project_id, location=LOCATION)

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/agentic_rag/template/.templateconfig.yaml

@@ -13,11 +13,12 @@
 # limitations under the License.
 
 description: "ADK RAG agent for document retrieval and Q&A. Includes a data pipeline for ingesting and indexing documents into Vertex AI Search or Vector Search."
+example_question: "How to save a pandas dataframe to CSV?"
 settings:
   requires_data_ingestion: true
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: [
-    "google-adk~=0.2.0",
+    "google-adk~=0.5.0",
     "langchain-google-vertexai~=2.0.7",
     "langchain~=0.3.24",
     "langchain-core~=0.3.55",

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/crewai_coding_crew/app/agent.py

@@ -22,7 +22,7 @@ from langgraph.prebuilt import ToolNode
 
 from .crew.crew import DevCrew
 
-LOCATION = "us-central1"
+LOCATION = "global"
 LLM = "gemini-2.0-flash-001"
 
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/crewai_coding_crew/template/.templateconfig.yaml

@@ -17,10 +17,11 @@ settings:
   requires_data_ingestion: false
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: [
-    "langchain-google-vertexai~=2.0.7",
+    "langchain-google-vertexai~=2.0.22",
     "langchain~=0.3.14",
     "langchain-community~=0.3.17", 
     "langchain-openai~=0.3.5",
     "langgraph~=0.2.63",
-    "crewai~=0.102.0"
+    "crewai~=0.119.0"
   ]
+example_question: "How can I implement a function to sort a list in Python?"

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/langgraph_base_react/app/agent.py

@@ -20,7 +20,7 @@ from langchain_google_vertexai import ChatVertexAI
 from langgraph.graph import END, MessagesState, StateGraph
 from langgraph.prebuilt import ToolNode
 
-LOCATION = "us-central1"
+LOCATION = "global"
 LLM = "gemini-2.0-flash-001"
 
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/langgraph_base_react/template/.templateconfig.yaml

@@ -20,8 +20,9 @@ settings:
     "langchain-google-vertexai~=2.0.7",
     "langchain~=0.3.14",
     "langgraph~=0.2.63",
-    "langchain-google-vertexai~=2.0.7",
+    "langchain-google-vertexai~=2.0.22",
     "langchain~=0.3.14", 
     "langchain-community~=0.3.17",
     "langchain-openai~=0.3.5",
   ]
+example_question: "What's the weather in San Francisco?"

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/live_api/README.md

@@ -1,15 +1,15 @@
 # Multimodal Live Agent
 
-This pattern showcases a real-time conversational RAG agent powered by Google Gemini. The agent handles audio, video, and text interactions while leveraging tool calling with a vector DB for grounded responses.
+This pattern showcases a real-time conversational agent powered by Google Gemini. The agent handles audio, video, and text interactions while leveraging tool calling capabilities for enhanced responses.
 
 ![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): A production-ready server built with [FastAPI](https://fastapi.tiangolo.com/) and [google-genai](https://googleapis.github.io/python-genai/) that features:
+- **Python Backend** (in `app/` folder): A production-ready server built with [FastAPI](https://fastapi.tiangolo.com/) and [google-genai](https://googleapis.github.io/python-python-genai/) that features:
 
   - **Real-time bidirectional communication** via WebSockets between the frontend and Gemini model
-  - **Integrated tool calling** with vector database support for contextual document retrieval
+  - **Integrated tool calling** with a weather information tool for demonstrating external data retrieval
   - **Production-grade reliability** with retry logic and automatic reconnection capabilities
   - **Deployment flexibility** supporting both AI Studio and Vertex AI endpoints
   - **Feedback logging endpoint** for collecting user interactions
@@ -18,7 +18,7 @@ This pattern showcases a real-time conversational RAG agent powered by Google Ge
 
 ![live api demo](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/live_api_pattern_demo.gif)
 
-Once both the backend and frontend are running, click the play button in the frontend UI to establish a connection with the backend. You can now interact with the Multimodal Live Agent! You can try asking questions such as "Using the tool you have, define Governance in the context MLOPs" to allow the agent to use the [documentation](https://cloud.google.com/architecture/deploy-operate-generative-ai-applications) it was provided to.
+Once both the backend and frontend are running, click the play button in the frontend UI to establish a connection with the backend. You can now interact with the Multimodal Live Agent! You can try asking questions such as "What's the weather like in San Francisco?" to see the agent use its weather information tool.
 
 ## Additional Resources for Multimodal Live API
 

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/live_api/app/agent.py

@@ -14,26 +14,16 @@
 
 import os
 
-import google
+import google.auth
 import vertexai
 from google import genai
-from google.genai.types import (
-    Content,
-    LiveConnectConfig,
-)
-from langchain_google_vertexai import VertexAIEmbeddings
-
-from app.templates import FORMAT_DOCS, SYSTEM_INSTRUCTION
-from app.vector_store import get_vector_store
+from google.genai import types
 
 # Constants
 VERTEXAI = os.getenv("VERTEXAI", "true").lower() == "true"
 LOCATION = "us-central1"
 EMBEDDING_MODEL = "text-embedding-004"
 MODEL_ID = "gemini-2.0-flash-exp"
-URLS = [
-    "https://cloud.google.com/architecture/deploy-operate-generative-ai-applications"
-]
 
 # Initialize Google Cloud clients
 credentials, project_id = google.auth.default()
@@ -46,33 +36,34 @@ else:
     # API key should be set using GOOGLE_API_KEY environment variable
     genai_client = genai.Client(http_options={"api_version": "v1alpha"})
 
-# Initialize vector store and retriever
-embedding = VertexAIEmbeddings(model_name=EMBEDDING_MODEL)
-vector_store = get_vector_store(embedding=embedding, urls=URLS)
-retriever = vector_store.as_retriever()
 
-
-def retrieve_docs(query: str) -> dict[str, str]:
-    """
-    Retrieves pre-formatted documents about MLOps (Machine Learning Operations),
-      Gen AI lifecycle, and production deployment best practices.
+def get_weather(query: str) -> dict:
+    """Simulates a web search. Use it get information on weather.
 
     Args:
-        query: Search query string related to MLOps, Gen AI, or production deployment.
+        query: A string containing the location to get weather information for.
 
     Returns:
-        A set of relevant, pre-formatted documents.
+        A string with the simulated weather information for the queried location.
     """
-    docs = retriever.invoke(query)
-    formatted_docs = FORMAT_DOCS.format(docs=docs)
-    return {"output": formatted_docs}
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        return {"output": "It's 60 degrees and foggy."}
+    return {"output": "It's 90 degrees and sunny."}
 
 
 # Configure tools available to the agent and live connection
-tool_functions = {"retrieve_docs": retrieve_docs}
+tool_functions = {"get_weather": get_weather}
 
-live_connect_config = LiveConnectConfig(
-    response_modalities=["AUDIO"],
-    tools=[retrieve_docs],
-    system_instruction=Content(parts=[{"text": SYSTEM_INSTRUCTION}]),
+live_connect_config = types.LiveConnectConfig(
+    response_modalities=[types.Modality.AUDIO],
+    tools=list(tool_functions.values()),
+    # Change to desired language code (e.g., "es-ES" for Spanish, "fr-FR" for French)
+    speech_config=types.SpeechConfig(language_code="en-US"),
+    system_instruction=types.Content(
+        parts=[
+            types.Part(
+                text="""You are a helpful AI assistant designed to provide accurate and useful information."""
+            )
+        ]
+    ),
 )

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/live_api/app/server.py

@@ -89,9 +89,11 @@ class GeminiSession:
                 logging.error(f"Error receiving from client {self.user_id}: {e!s}")
                 break
 
-    def _get_func(self, action_label: str) -> Callable | None:
+    def _get_func(self, action_label: str | None) -> Callable | None:
         """Get the tool function for a given action label."""
-        return None if action_label == "" else self.tool_functions.get(action_label)
+        if action_label is None or action_label == "":
+            return None
+        return self.tool_functions.get(action_label)
 
     async def _handle_tool_call(
         self, session: Any, tool_call: LiveServerToolCall
@@ -102,9 +104,20 @@ class GeminiSession:
             session: The Gemini session
             tool_call: Tool call request from Gemini
         """
+        # Handle case where function_calls might be None
+        if tool_call.function_calls is None:
+            logging.debug("No function calls in tool_call")
+            return
+
         for fc in tool_call.function_calls:
             logging.debug(f"Calling tool function: {fc.name} with args: {fc.args}")
-            response = self._get_func(fc.name)(**fc.args)
+            func = self._get_func(fc.name)
+            if func is None:
+                logging.error(f"Function {fc.name} not found")
+                continue
+            args = fc.args if fc.args is not None else {}
+            response = func(**args)
+
             tool_response = types.LiveClientToolResponse(
                 function_responses=[
                     types.FunctionResponse(name=fc.name, id=fc.id, response=response)

{agent_starter_pack-0.3.9 → agent_starter_pack-0.4.0}/agents/live_api/template/.templateconfig.yaml

@@ -19,11 +19,6 @@ settings:
   deployment_targets: ["cloud_run"]
   extra_dependencies: [
     "backoff~=2.2.1",
-    "beautifulsoup4~=4.12.3",
-    "google-genai~=1.8.0",
-    "jinja2~=3.1.4",
-    "langchain~=0.3.13",
-    "langchain-community~=0.3.13",
-    "langchain-google-vertexai~=2.0.9",
-    "scikit-learn>=1.0.0,<2.0.0",
+    "google-genai~=1.14.0",
   ]
+example_question: "What's the weather in San Francisco?"

agent_starter_pack-0.4.0/docs/.vitepress/config.js

@@ -0,0 +1,71 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  title: 'Agent Starter Pack',
+  description: 'Build Production Agents faster',
+  base: '/agent-starter-pack/',
+  head: [
+    ['link', { rel: 'preconnect', href: 'https://fonts.googleapis.com' }],
+    ['link', { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }],
+    ['link', { href: 'https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500;700&display=swap', rel: 'stylesheet' }],
+    ['style', {}, `
+      :root {
+        --vp-font-family-base: 'Roboto', sans-serif;
+        --vp-font-family-mono: 'Roboto Mono', monospace;
+        --vp-c-text-1: 0.9rem;
+        --vp-font-size-base: 0.9rem;
+      }
+    `]
+  ],
+
+  themeConfig: {
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Guide', link: '/guide/getting-started' },
+      { text: 'Agents', link: '/agents/overview' },
+      { text: 'CLI', link: '/cli/index.md' }
+    ],
+    sidebar: [
+      {
+        text: 'Guide',
+        items: [
+          { text: 'Getting Started', link: '/guide/getting-started' },
+          { text: 'Why Starter Pack?', link: '/guide/why_starter_pack' },
+          { text: 'Video Tutorials', link: '/guide/video-tutorials' },
+          { text: 'Installation', link: '/guide/installation' },
+          { text: 'Deployment', link: '/guide/deployment' },
+          { text: 'Data Ingestion', link: '/guide/data-ingestion' },
+          { text: 'Observability', link: '/guide/observability' },
+          { text: 'Troubleshooting', link: '/guide/troubleshooting' }
+        ]
+      },
+      {
+        text: 'Agents',
+        items: [
+          { text: 'Overview', link: '/agents/overview' },
+
+        ]
+      },
+      {
+        text: 'CLI Reference',
+        items: [
+          { text: 'create', link: '/cli/create' },
+          { text: 'setup-cicd', link: '/cli/setup_cicd' }
+        ]
+      }
+    ],
+    socialLinks: [
+      { 
+        icon: 'github',
+        link: 'https://github.com/GoogleCloudPlatform/agent-starter-pack' 
+      },
+    ],
+    search: {
+      provider: 'local'
+    },
+
+    footer: {
+      message: 'Released under the Apache 2.0 License.'
+    }
+  }
+})