agent-starter-pack 0.0.12b0__tar.gz → 0.0.13b0__tar.gz

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.0.12b0
+Version: 0.0.13b0
 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

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/agents/multimodal_live_api/README.md

@@ -18,42 +18,6 @@ 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)
 
-## Usage
-
-1.  **Install Dependencies:**
-
-    ```bash
-    make install
-    ```
-
-2.  **Start the Backend and Frontend:**
-
-    **Backend:**
-    ```bash
-    make backend
-    ```
-    
-    The backend will be ready when you see `INFO:     Application startup complete.` in the console.
-
-    <details>
-    <summary><b>Click here if you want to use AI Studio and API Key instead of Vertex AI:</b></summary>
-
-    ```bash
-    export VERTEXAI=false
-    export GOOGLE_API_KEY=your-google-api-key
-    ```
-
-    </details>
-    <br>
-    
-    **Frontend:**
-    ```bash
-    # In a different shell
-    make ui
-    ```
-
-    This is the suggested mode for development as it allows you to see changes in real-time.
-
 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.
 
 ## Additional Resources for Multimodal Live API

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/agents/multimodal_live_api/app/server.py

@@ -77,7 +77,7 @@ class GeminiSession:
                 elif "setup" in data:
                     self.run_id = data["setup"]["run_id"]
                     self.user_id = data["setup"]["user_id"]
-                    logging.info(f"Setup data: {data['setup']}")
+                    logger.log_struct({**data['setup'],"type": "setup"}, severity="INFO")
                 else:
                     logging.warning(f"Received unexpected input from client: {data}")
             except ConnectionClosedError as e:

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.0.12b"
+version = "0.0.13b"
 description = "CLI tool to create GCP-based AI agent projects from templates"
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/src/base_template/README.md

@@ -12,7 +12,11 @@ This project is organized as follows:
 {{cookiecutter.project_name}}/
 ├── app/                 # Core application code
 │   ├── agent.py         # Main agent logic
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+│   ├── server.py        # FastAPI Backend server
+{%- elif cookiecutter.deployment_target == 'agent_engine' %}
 │   ├── agent_engine_app.py # Agent Engine application logic
+{%- endif %}
 │   └── utils/           # Utility functions and helpers
 ├── deployment/          # Infrastructure and deployment scripts
 ├── notebooks/           # Jupyter notebooks for prototyping and evaluation
@@ -35,10 +39,10 @@ Before you begin, ensure you have:
 Install required packages using uv:
 
 ```bash
-uv sync --extra jupyter --extra streamlit --frozen
+make install
 ```
 
-### Setupx
+### Setup
 
 If not done during the initialization, set your default Google Cloud project and Location:
 
@@ -69,23 +73,108 @@ gcloud auth application-default set-quota-project $PROJECT_ID
 
 For full command options and usage, refer to the [Makefile](Makefile).
 
+{% if cookiecutter.agent_name == 'multimodal_live_api' %}
+## Usage
+
+1.  **Install Dependencies:**
+
+    ```bash
+    make install
+    ```
+
+2.  **Start the Backend and Frontend:**
+
+    **Backend:**
+    ```bash
+    make backend
+    ```
+    
+    The backend will be ready when you see `INFO:     Application startup complete.` in the console.
+
+    <details>
+    <summary><b>Click here if you want to use AI Studio and API Key instead of Vertex AI:</b></summary>
+
+    ```bash
+    export VERTEXAI=false
+    export GOOGLE_API_KEY=your-google-api-key
+    ```
+
+    </details>
+    <br>
+    
+    **Frontend:**
+    ```bash
+    # In a different shell
+    make ui
+    ```
+
+    This is the suggested mode for development as it allows you to see changes in real-time.
+
+3.  **Interact with the Agent**
+    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 it was provided to.
+
+**Cloud Shell usage**
+To use the `multimodal_live_api` agent in Cloud Shell, follow these steps:
+
+1.  **Start the Frontend:**
+
+    ```bash
+    make ui
+    ```
+
+    You may be prompted to run the app on a different port if port 3000 is in use. Accept by pressing Enter. You'll see a message similar to:
+
+    ```
+    You can now view multimodal-live-api-web-console in the browser.
+
+      Local:            http://localhost:3001
+      On Your Network:  http://10.88.0.4:3001
+    ```
+
+    Click the `localhost` link to open a web preview in Cloud Shell.
+
+2.  **Start the Backend:**
+
+    Open a *new* Cloud Shell terminal tab. Remember to set your Cloud Platform project in this new session using `gcloud config set project [PROJECT_ID]`. Then from the root of the repository, run:
+
+    ```bash
+    make backend
+    ```
+
+3.  **Configure Web Preview for the Backend:**
+
+    Trigger a web preview for port 8000 - you'll need to change the default port which is `8080`.  See [Cloud Shell Web Preview documentation](https://cloud.google.com/shell/docs/using-web-preview#preview_the_application) for details.
+
+4.  **Connect Frontend to Backend:**
+
+    *   The web preview will open a new tab in your browser. Copy the URL from the address bar (e.g., `https://8000-cs-8a3189b8-5295-4085-9893-c318f1724456.ql-europe-west1-ojep.cloudshell.dev/?authuser=0`).
+    *   Return to the frontend preview tab (from step 1).
+    *   Paste the copied URL into the frontend's "Server URL" connection settings.
+    *   Click the "Play button" to connect. Start interacting with it!
+
+*   When using Cloud Shell there is a known limitation when using the feedback feature in the Frontend. Feedback submission might fail due to different origins between the frontend and backend in the Cloud Shell environment.
+{%- else %}
 ## Usage
+
 1. **Prototype:** Build your Generative AI Agent using the intro notebooks in `notebooks/` for guidance. Use Vertex AI Evaluation to assess performance.
 2. **Integrate:** Import your chain into the app by editing `app/agent.py`.
 3. **Test:** Explore your chain's functionality using the Streamlit playground with `make playground`. The playground offers features like chat history, user feedback, and various input types, and automatically reloads your agent on code changes.
 4. **Deploy:** Configure and trigger the CI/CD pipelines, editing tests if needed. See the [deployment section](#deployment) for details.
 5. **Monitor:** Track performance and gather insights using Cloud Logging, Tracing, and the Looker Studio dashboard to iterate on your application.
+{% endif %}
 
 ## Deployment
 
 ### Dev Environment
 
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
 You can test deployment towards a Dev Environment using the following command:
 
 ```bash
 gcloud config set project <your-dev-project-id>
 make backend
 ```
+{%- endif %}
 
 The repository includes a Terraform configuration for the setup of the Dev Google Cloud project.
 See [deployment/README.md](deployment/README.md) for instructions.

{agent_starter_pack-0.0.12b0 → agent_starter_pack-0.0.13b0}/uv.lock

@@ -11,7 +11,7 @@ resolution-markers = [
 
 [[package]]
 name = "agent-starter-pack"
-version = "0.0.11b0"
+version = "0.0.12b0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },