agent-starter-pack 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

{agent_starter_pack-0.3.0.dist-info → agent_starter_pack-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.3.0
+Version: 0.3.2
 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
@@ -70,7 +70,7 @@ agent-starter-pack create my-agent -d agent_engine -a adk_base
 
 | Agent Name                  | Description                                                                                                                       |
 |-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
-| `adk_base`      | An agent implementing a base ReAct agent using Google's [Agent Development Kit](https://github.com/google/adk-python)
+| `adk_base`      | A base ReAct agent implemented using Google's [Agent Development Kit](https://github.com/google/adk-python) |
 | `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       |

{agent_starter_pack-0.3.0.dist-info → agent_starter_pack-0.3.2.dist-info}/RECORD

@@ -1,14 +1,14 @@
-agents/adk_base/README.md,sha256=4_VlWQI0HU_rvaKZ59Qs7P5VYklWoEJr9pSV-m_BADc,852
+agents/adk_base/README.md,sha256=eLf-F9Z4u_mQOchAnUaSrOAHXRSx8wUQN29kkwz1SF4,894
 agents/adk_base/app/agent.py,sha256=Dm7dcELj0RbALNI20R9-uEay_RHgej0dPOdQRHA7E-8,2187
-agents/adk_base/notebooks/adk_app_testing.ipynb,sha256=7qZmhssPoJCfT0DA2WpT3uwHgLBIu1EGoFyUDkjaVio,8198
-agents/adk_base/template/.templateconfig.yaml,sha256=JNQsR2s2oOOCaycp_5FEy5MU3xsj4SyOKScUNI7teMg,856
+agents/adk_base/notebooks/adk_app_testing.ipynb,sha256=sHaW9s1PiclJILKBK5j-W6nx_-g60UVnvITKgZFraME,8591
+agents/adk_base/template/.templateconfig.yaml,sha256=m8Qkm1maDIQRDk5GmJlk7_tZT_1ZCn7Cxzo00TzMYmI,836
 agents/adk_base/tests/integration/test_agent.py,sha256=1VyshBu44p_PUAQQxV0QROmv6OUGt_m0nDLyaTI77po,1964
 agents/agentic_rag/README.md,sha256=mxMLkq6tAghFaDmc2sc2sEQ5vn9kGWdiRxfTykwpLz0,2268
 agents/agentic_rag/app/agent.py,sha256=EkbMIjEeyXqK49wIkoW6uWotxyXCIfJpeLCizw2QDZM,3959
 agents/agentic_rag/app/retrievers.py,sha256=qfxwSEixMddvAu4FvUTZAFh1Gdp3RPY65s0Wp6gEFVk,4561
 agents/agentic_rag/app/templates.py,sha256=8N_uRchwiN7hlH9Y8rdJ1CAtOhpHUWZkXZZ7IU-YJJk,867
-agents/agentic_rag/notebooks/adk_app_testing.ipynb,sha256=7qZmhssPoJCfT0DA2WpT3uwHgLBIu1EGoFyUDkjaVio,8198
-agents/agentic_rag/template/.templateconfig.yaml,sha256=gaDURx4tBI3620txEFAE8zJSmHL9qtZjlARCEZnBpi0,1120
+agents/agentic_rag/notebooks/adk_app_testing.ipynb,sha256=sHaW9s1PiclJILKBK5j-W6nx_-g60UVnvITKgZFraME,8591
+agents/agentic_rag/template/.templateconfig.yaml,sha256=6wznpR27bt_brW0DCT7rq_J5AaLVo6M--dcoG_uFtsU,1111
 agents/agentic_rag/tests/integration/test_agent.py,sha256=HbEv2gzC77jrse3RZ0ra_Bcu6zW_7YlrxYWcYfei63M,2107
 agents/crewai_coding_crew/README.md,sha256=4No7sfHQVHELARGiT3fWANJzDR0NP48ow4ct3FoPwlA,1672
 agents/crewai_coding_crew/app/agent.py,sha256=GcmNrOyRPhnI7LICIV6GvBvcDfA_PKqPsQcOEzAORmY,3269
@@ -38,7 +38,7 @@ src/base_template/Makefile,sha256=vxOfXc3ZH2re_AYbWVjOBAMPeOgEtjGTOHMhEwAMs_c,36
 src/base_template/README.md,sha256=0dHYVT8IlG0eMd7dEelAaPyuyk5ZDHnKAvNV8x7TBEA,10397
 src/base_template/pyproject.toml,sha256=pLw8q6j3qQWcu6A3HUpwsT2p3BzfmM2RDxjwUgZ2ulQ,2865
 src/base_template/app/__init__.py,sha256=UyAgc2l8nkVIUPUzL9hKR7EgzCsc2jSYcOcjHNNmpMU,59
-src/base_template/app/utils/tracing.py,sha256=sYN_zSaIrOSSc4YTewKp3FNkKXj0Ksk79ZT_Ftv5QrY,6046
+src/base_template/app/utils/tracing.py,sha256=2rv1Ukh2jTBENDwoghCItJ28l-Sjz9gMlzdojlVgJa4,6052
 src/base_template/app/utils/typing.py,sha256=DP5OZC3IGvqA1XbvWt8kI3gyAK3ZjzUSL5Ca17wNeLI,4249
 src/base_template/deployment/README.md,sha256=XjRRcEiyoobi0YEXybfvtaOi9ecNDU2bVKczv0MUBac,5255
 src/base_template/deployment/cd/deploy-to-prod.yaml,sha256=Vzt83DunPF64wVsY96KTGvhxZFHAF5Tze_88KW4O-oo,4297
@@ -70,7 +70,7 @@ src/cli/utils/cicd.py,sha256=tlz50wI0unRosRZsDpZ5Oh5haMJmNjc9dV0-TPWawKE,27443
 src/cli/utils/datastores.py,sha256=gv1V6eDcOEKx4MRNG5C3Y-VfixYq1AzQuaYMLp8QRNo,1058
 src/cli/utils/gcp.py,sha256=gVak73MD74sZTXvchZB59KFpoqp-aTIsvcMKvYMkXJE,4062
 src/cli/utils/logging.py,sha256=0lHe4EPi1A8sOx9xkA7gS4UNl0GsIyp2ahydkkuCzLY,1570
-src/cli/utils/template.py,sha256=iIRh6hNP-na7j9UcxE8r6ZwukXq_WLIwv-VbQ9U2Oxk,28931
+src/cli/utils/template.py,sha256=HQg_SIruiL52LrjeVr9Nxw7zqq9CC96l78DIGPIJjHw,29099
 src/cli/utils/version.py,sha256=F4udQmzniPStqWZFIgnv3Qg3l9non4mfy2An-Oveqmc,2916
 src/data_ingestion/README.md,sha256=LNxSQoJW9JozK-TbyGQLj5L_MGWNwrfLk6V6RmQ2oBQ,4032
 src/data_ingestion/pyproject.toml,sha256=-1Mf2QB8K70ICQV5UPZDpf-fN3UwEQLVzQyxfakCSTY,445
@@ -80,7 +80,7 @@ src/data_ingestion/data_ingestion_pipeline/submit_pipeline.py,sha256=tWGqL0zUB3V
 src/data_ingestion/data_ingestion_pipeline/components/ingest_data.py,sha256=QbPmk6V7JPGo5Yc1BhL-1W_t9CXEN0iY5NKaGWlfSbM,10667
 src/data_ingestion/data_ingestion_pipeline/components/process_data.py,sha256=3D4CaUV9pBaIU10MogJMQAR00JPVzqjFHN6eL7WM_5Y,22045
 src/deployment_targets/agent_engine/deployment_metadata.json,sha256=G_t_n-UNrFsBgH1Xrw5-ZqYzUGwZ4X6ipsIm_yiSq-w,72
-src/deployment_targets/agent_engine/app/agent_engine_app.py,sha256=hRzFSAjaxMJzahJ0CYypWjV1SMAFok3UsAly4jMScTk,11334
+src/deployment_targets/agent_engine/app/agent_engine_app.py,sha256=ZBER9DVyVfG6R4IyukgFaVVL-AsbqLmvvBsXAwgv2jk,12032
 src/deployment_targets/agent_engine/app/utils/gcs.py,sha256=jKblaWOGQEigw3esaawcfX178shhZi2Fyk0fJSA4T68,1501
 src/deployment_targets/agent_engine/notebooks/intro_agent_engine.ipynb,sha256=RE6Gp-bu4bHtNBngfkt_CF5emy5YcOWQ5rMYW_Cv8_w,48809
 src/deployment_targets/agent_engine/tests/integration/test_agent_engine_app.py,sha256=3mEHdnenqT1RrQpndnQWZSMnn8kSLH85rPDhbxH6_lk,5978
@@ -166,8 +166,8 @@ src/resources/setup_cicd/providers.tf,sha256=Km4z6IJt7x7PLaa0kyZbBrO2m3lpuIJZFD5
 src/utils/generate_locks.py,sha256=xu5IAhGGBPkVQGSJX4kk7_JNDwWJUEaXAHbmaQIohbg,4386
 src/utils/lock_utils.py,sha256=_QdzQtgIbCmJ87s046_i1g966slVNmvr3bJDeHbRQSM,2419
 src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
-agent_starter_pack-0.3.0.dist-info/METADATA,sha256=gqs2okJC9y34nuxb4SmgELfSO3Juldd8O_-GzDzyicA,8026
-agent_starter_pack-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.3.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
-agent_starter_pack-0.3.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.3.0.dist-info/RECORD,,
+agent_starter_pack-0.3.2.dist-info/METADATA,sha256=JDgsTYFzAC-s_GsOXtQe6IcaUsUnZoeQFvI5hUCE1R4,8018
+agent_starter_pack-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.3.2.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
+agent_starter_pack-0.3.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.3.2.dist-info/RECORD,,

agents/adk_base/README.md

@@ -1,6 +1,6 @@
 # ADK: Minimal Agent Example
 
-[![ADK Logo](./../../docs/images/adk_logo.png)](https://google.github.io/adk-docs/)
+<img src="https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/adk_logo.png?raw=true" width="400">
 
 A basic agent built using the **[Google Agent Development Kit (ADK)](https://google.github.io/adk-docs/)**. This example demonstrates core ADK concepts like agent creation and tool integration in a minimal setup.
 

agents/adk_base/notebooks/adk_app_testing.ipynb

@@ -106,6 +106,22 @@
     "    print(event)"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "remote_agent_engine.register_feedback(\n",
+    "    feedback={\n",
+    "        \"score\": 5,\n",
+    "        \"text\": \"Great response!\",\n",
+    "        \"invocation_id\": \"test-invocation-123\",\n",
+    "        \"user_id\": \"test\",\n",
+    "    }\n",
+    ")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

agents/adk_base/template/.templateconfig.yaml

@@ -12,10 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-description: "An agent implementing a base ReAct agent using Google's Agent Development Kit"
+description: "A base ReAct agent built with Google's Agent Development Kit (ADK)"
 settings:
   requires_data_ingestion: false
   deployment_targets: ["agent_engine", "cloud_run"]
   extra_dependencies: ["google-adk~=0.1.0"]
   tags: ["adk"]
-  frontend_type: "streamlit_adk"
+  frontend_type: "None"

agents/agentic_rag/notebooks/adk_app_testing.ipynb

@@ -106,6 +106,22 @@
     "    print(event)"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "remote_agent_engine.register_feedback(\n",
+    "    feedback={\n",
+    "        \"score\": 5,\n",
+    "        \"text\": \"Great response!\",\n",
+    "        \"invocation_id\": \"test-invocation-123\",\n",
+    "        \"user_id\": \"test\",\n",
+    "    }\n",
+    ")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

agents/agentic_rag/template/.templateconfig.yaml

@@ -25,4 +25,4 @@ settings:
     "langchain-google-community[vertexaisearch]~=2.0.7",
   ]
   tags: ["adk"]
-  frontend_type: "streamlit_adk"
+  frontend_type: "None"

src/base_template/app/utils/tracing.py

@@ -17,8 +17,8 @@ import logging
 from collections.abc import Sequence
 from typing import Any
 
+import google.cloud.storage as storage
 from google.cloud import logging as google_cloud_logging
-from google.cloud import storage
 from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter
 from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.sdk.trace.export import SpanExportResult

src/cli/utils/template.py

@@ -690,6 +690,11 @@ def copy_files(
 
 def copy_frontend_files(frontend_type: str, project_template: pathlib.Path) -> None:
     """Copy files from the specified frontend folder directly to project root."""
+    # Skip copying if frontend_type is "None"
+    if frontend_type == "None":
+        logging.debug("Frontend type is 'None', skipping frontend files")
+        return
+
     # Use default frontend if none specified
     frontend_type = frontend_type or DEFAULT_FRONTEND
 

src/deployment_targets/agent_engine/app/agent_engine_app.py

@@ -14,9 +14,11 @@
 
 # mypy: disable-error-code="attr-defined"
 {%- if "adk" in cookiecutter.tags %}
+import copy
 import datetime
 import json
 import logging
+import os
 from collections.abc import Mapping, Sequence
 from typing import Any
 
@@ -41,7 +43,11 @@ class AgentEngineApp(AdkApp):
         logging_client = google_cloud_logging.Client()
         self.logger = logging_client.logger(__name__)
         provider = TracerProvider()
-        processor = export.BatchSpanProcessor(CloudTraceLoggingSpanExporter())
+        processor = export.BatchSpanProcessor(
+            CloudTraceLoggingSpanExporter(
+                project_id=os.environ.get("GOOGLE_CLOUD_PROJECT")
+            )
+        )
         provider.add_span_processor(processor)
         trace.set_tracer_provider(provider)
 
@@ -58,6 +64,19 @@ class AgentEngineApp(AdkApp):
         operations = super().register_operations()
         operations[""] = operations[""] + ["register_feedback"]
         return operations
+
+    def clone(self) -> "AgentEngineApp":
+        """Returns a clone of the ADK application."""
+        template_attributes = self._tmpl_attrs
+        return self.__class__(
+            agent=copy.deepcopy(template_attributes.get("agent")),
+            enable_tracing=template_attributes.get("enable_tracing"),
+            session_service_builder=template_attributes.get("session_service_builder"),
+            artifact_service_builder=template_attributes.get(
+                "artifact_service_builder"
+            ),
+            env_vars=template_attributes.get("env_vars"),
+        )
 {%- else %}
 import datetime
 import json
@@ -211,7 +230,8 @@ def deploy_agent_engine_app(
         requirements = f.read().strip().split("\n")
 {% if "adk" in cookiecutter.tags %}
     agent_engine = AgentEngineApp(
-        agent=root_agent, env_vars=env_vars, enable_tracing=True
+        agent=root_agent,
+        env_vars=env_vars,
     )
 {% else %}
     agent_engine = AgentEngineApp(project_id=project, env_vars=env_vars)