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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/PKG-INFO +8 -9
  2. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/README.md +6 -7
  3. {agent_starter_pack-0.4.0/agents/agentic_rag → agent_starter_pack-0.4.2/agents/adk_base}/notebooks/adk_app_testing.ipynb +99 -67
  4. {agent_starter_pack-0.4.0/agents/adk_base → agent_starter_pack-0.4.2/agents/agentic_rag}/notebooks/adk_app_testing.ipynb +99 -67
  5. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/.vitepress/config.js +3 -1
  6. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/getting-started.md +1 -1
  7. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/video-tutorials.md +6 -0
  8. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/why_starter_pack.md +2 -2
  9. agent_starter_pack-0.4.2/docs/images/agent_starter_pack_screenshot.png +0 -0
  10. agent_starter_pack-0.4.2/docs/images/why_sp_edited.png +0 -0
  11. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/index.md +2 -1
  12. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/package-lock.json +1 -1
  13. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/package.json +1 -1
  14. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/pyproject.toml +2 -2
  15. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/Makefile +2 -2
  16. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/commands/setup_cicd.py +12 -38
  17. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/cicd.py +1 -46
  18. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/uv.lock +1 -1
  19. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/cd/test_e2e.yaml +0 -0
  20. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/ci/build_use_wheel.yaml +0 -0
  21. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/ci/lint.yaml +0 -0
  22. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/ci/lint_templated_agents.yaml +0 -0
  23. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/ci/test.yaml +0 -0
  24. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/ci/test_templated_agents.yaml +0 -0
  25. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/terraform/apis.tf +0 -0
  26. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/terraform/build_triggers.tf +0 -0
  27. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/terraform/service_account.tf +0 -0
  28. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/terraform/storage.tf +0 -0
  29. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.cloudbuild/terraform/variables.tf +0 -0
  30. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.github/workflows/docs.yml +0 -0
  31. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/.gitignore +0 -0
  32. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/CODE_OF_CONDUCT.md +0 -0
  33. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/CONTRIBUTING.md +0 -0
  34. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/LICENSE +0 -0
  35. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/Makefile +0 -0
  36. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/adk_base/README.md +0 -0
  37. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/adk_base/app/agent.py +0 -0
  38. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/adk_base/notebooks/evaluating_adk_agent.ipynb +0 -0
  39. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/adk_base/template/.templateconfig.yaml +0 -0
  40. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/adk_base/tests/integration/test_agent.py +0 -0
  41. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/README.md +0 -0
  42. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/app/agent.py +0 -0
  43. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/app/retrievers.py +0 -0
  44. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/app/templates.py +0 -0
  45. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/notebooks/evaluating_adk_agent.ipynb +0 -0
  46. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/template/.templateconfig.yaml +0 -0
  47. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/agentic_rag/tests/integration/test_agent.py +0 -0
  48. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/README.md +0 -0
  49. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/app/agent.py +0 -0
  50. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/app/crew/config/agents.yaml +0 -0
  51. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/app/crew/config/tasks.yaml +0 -0
  52. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/app/crew/crew.py +0 -0
  53. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/notebooks/evaluating_crewai_agent.ipynb +0 -0
  54. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/notebooks/evaluating_langgraph_agent.ipynb +0 -0
  55. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/template/.templateconfig.yaml +0 -0
  56. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/crewai_coding_crew/tests/integration/test_agent.py +0 -0
  57. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/langgraph_base_react/README.md +0 -0
  58. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/langgraph_base_react/app/agent.py +0 -0
  59. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/langgraph_base_react/notebooks/evaluating_langgraph_agent.ipynb +0 -0
  60. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/langgraph_base_react/template/.templateconfig.yaml +0 -0
  61. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/langgraph_base_react/tests/integration/test_agent.py +0 -0
  62. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/README.md +0 -0
  63. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/app/agent.py +0 -0
  64. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/app/server.py +0 -0
  65. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/template/.templateconfig.yaml +0 -0
  66. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/tests/integration/test_server_e2e.py +0 -0
  67. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/tests/load_test/load_test.py +0 -0
  68. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/agents/live_api/tests/unit/test_server.py +0 -0
  69. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/agents/overview.md +0 -0
  70. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/cli/create.md +0 -0
  71. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/cli/index.md +0 -0
  72. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/cli/setup_cicd.md +0 -0
  73. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/data-ingestion.md +0 -0
  74. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/deployment.md +0 -0
  75. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/installation.md +0 -0
  76. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/observability.md +0 -0
  77. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/guide/troubleshooting.md +0 -0
  78. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/adk_logo.png +0 -0
  79. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/ags_high_level_architecture.png +0 -0
  80. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/icon.png +0 -0
  81. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/logo.png +0 -0
  82. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/prototype_to_prod.png +0 -0
  83. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/docs/images/why_starter_pack.png +0 -0
  84. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/.gitignore +0 -0
  85. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/README.md +0 -0
  86. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/app/__init__.py +0 -0
  87. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/app/utils/tracing.py +0 -0
  88. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/app/utils/typing.py +0 -0
  89. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/README.md +0 -0
  90. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/cd/deploy-to-prod.yaml +0 -0
  91. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/cd/staging.yaml +0 -0
  92. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/ci/pr_checks.yaml +0 -0
  93. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/apis.tf +0 -0
  94. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/build_triggers.tf +0 -0
  95. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/apis.tf +0 -0
  96. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/iam.tf +0 -0
  97. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/log_sinks.tf +0 -0
  98. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/providers.tf +0 -0
  99. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/storage.tf +0 -0
  100. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/variables.tf +0 -0
  101. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/dev/vars/env.tfvars +0 -0
  102. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/iam.tf +0 -0
  103. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/locals.tf +0 -0
  104. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/log_sinks.tf +0 -0
  105. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/providers.tf +0 -0
  106. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/service_accounts.tf +0 -0
  107. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/storage.tf +0 -0
  108. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/variables.tf +0 -0
  109. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/deployment/terraform/vars/env.tfvars +0 -0
  110. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/pyproject.toml +0 -0
  111. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/base_template/tests/unit/test_dummy.py +0 -0
  112. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/commands/create.py +0 -0
  113. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/main.py +0 -0
  114. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/__init__.py +0 -0
  115. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/datastores.py +0 -0
  116. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/gcp.py +0 -0
  117. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/logging.py +0 -0
  118. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/template.py +0 -0
  119. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/cli/utils/version.py +0 -0
  120. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/README.md +0 -0
  121. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/data_ingestion_pipeline/components/ingest_data.py +0 -0
  122. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/data_ingestion_pipeline/components/process_data.py +0 -0
  123. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/data_ingestion_pipeline/pipeline.py +0 -0
  124. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/data_ingestion_pipeline/submit_pipeline.py +0 -0
  125. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/pyproject.toml +0 -0
  126. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/data_ingestion/uv.lock +0 -0
  127. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/app/agent_engine_app.py +0 -0
  128. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/app/utils/gcs.py +0 -0
  129. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/deployment_metadata.json +0 -0
  130. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/notebooks/intro_agent_engine.ipynb +0 -0
  131. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/tests/integration/test_agent_engine_app.py +0 -0
  132. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/tests/load_test/.results/.placeholder +0 -0
  133. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/tests/load_test/README.md +0 -0
  134. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/agent_engine/tests/load_test/load_test.py +0 -0
  135. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/Dockerfile +0 -0
  136. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/app/server.py +0 -0
  137. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/tests/integration/test_server_e2e.py +0 -0
  138. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/tests/load_test/.results/.placeholder +0 -0
  139. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/tests/load_test/README.md +0 -0
  140. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/tests/load_test/load_test.py +0 -0
  141. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/deployment_targets/cloud_run/uv.lock +0 -0
  142. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/package-lock.json +0 -0
  143. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/package.json +0 -0
  144. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/public/favicon.ico +0 -0
  145. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/public/index.html +0 -0
  146. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/public/robots.txt +0 -0
  147. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/App.scss +0 -0
  148. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/App.test.tsx +0 -0
  149. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/App.tsx +0 -0
  150. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/audio-pulse/AudioPulse.tsx +0 -0
  151. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/audio-pulse/audio-pulse.scss +0 -0
  152. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/control-tray/ControlTray.tsx +0 -0
  153. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/control-tray/control-tray.scss +0 -0
  154. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/logger/Logger.tsx +0 -0
  155. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/logger/logger.scss +0 -0
  156. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/logger/mock-logs.ts +0 -0
  157. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/side-panel/SidePanel.tsx +0 -0
  158. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/components/side-panel/side-panel.scss +0 -0
  159. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/contexts/LiveAPIContext.tsx +0 -0
  160. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/hooks/use-live-api.ts +0 -0
  161. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/hooks/use-media-stream-mux.ts +0 -0
  162. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/hooks/use-screen-capture.ts +0 -0
  163. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/hooks/use-webcam.ts +0 -0
  164. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/index.css +0 -0
  165. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/index.tsx +0 -0
  166. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/multimodal-live-types.ts +0 -0
  167. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/react-app-env.d.ts +0 -0
  168. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/reportWebVitals.ts +0 -0
  169. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/setupTests.ts +0 -0
  170. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/audio-recorder.ts +0 -0
  171. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/audio-streamer.ts +0 -0
  172. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/audioworklet-registry.ts +0 -0
  173. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/multimodal-live-client.ts +0 -0
  174. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/store-logger.ts +0 -0
  175. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/utils.ts +0 -0
  176. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/worklets/audio-processing.ts +0 -0
  177. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/src/utils/worklets/vol-meter.ts +0 -0
  178. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/live_api_react/frontend/tsconfig.json +0 -0
  179. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/side_bar.py +0 -0
  180. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/streamlit_app.py +0 -0
  181. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/style/app_markdown.py +0 -0
  182. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/chat_utils.py +0 -0
  183. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/local_chat_history.py +0 -0
  184. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/message_editing.py +0 -0
  185. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/multimodal_utils.py +0 -0
  186. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/stream_handler.py +0 -0
  187. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit/frontend/utils/title_summary.py +0 -0
  188. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/side_bar.py +0 -0
  189. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/streamlit_app.py +0 -0
  190. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/style/app_markdown.py +0 -0
  191. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/chat_utils.py +0 -0
  192. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/local_chat_history.py +0 -0
  193. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/message_editing.py +0 -0
  194. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/multimodal_utils.py +0 -0
  195. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/stream_handler.py +0 -0
  196. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/frontends/streamlit_adk/frontend/utils/title_summary.py +0 -0
  197. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/containers/data_processing/Dockerfile +0 -0
  198. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/containers/e2e-tests/Dockerfile +0 -0
  199. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/idx/.idx/dev.nix +0 -0
  200. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/idx/idx-template.json +0 -0
  201. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/idx/idx-template.nix +0 -0
  202. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-adk_base-agent_engine.lock +0 -0
  203. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-adk_base-cloud_run.lock +0 -0
  204. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-agentic_rag-agent_engine.lock +0 -0
  205. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-agentic_rag-cloud_run.lock +0 -0
  206. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-crewai_coding_crew-agent_engine.lock +0 -0
  207. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-crewai_coding_crew-cloud_run.lock +0 -0
  208. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-langgraph_base_react-agent_engine.lock +0 -0
  209. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-langgraph_base_react-cloud_run.lock +0 -0
  210. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/locks/uv-live_api-cloud_run.lock +0 -0
  211. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/setup_cicd/cicd_variables.tf +0 -0
  212. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/setup_cicd/github.tf +0 -0
  213. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/resources/setup_cicd/providers.tf +0 -0
  214. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/utils/generate_locks.py +0 -0
  215. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/utils/lock_utils.py +0 -0
  216. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/src/utils/watch_and_rebuild.py +0 -0
  217. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/__init__.py +0 -0
  218. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/cicd/example.env +0 -0
  219. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/cicd/test_e2e_deployment.py +0 -0
  220. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/cli/commands/test_create.py +0 -0
  221. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/cli/commands/test_setup_cicd.py +0 -0
  222. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/cli/utils/test_cicd.py +0 -0
  223. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/integration/test_template_linting.py +0 -0
  224. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/integration/test_templated_patterns.py +0 -0
  225. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_side_bar.py +0 -0
  226. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_streamlit_app.py +0 -0
  227. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_utils/test_chat_utils.py +0 -0
  228. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_utils/test_local_chat_history.py +0 -0
  229. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_utils/test_message_editing.py +0 -0
  230. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_utils/test_multimodal_utils.py +0 -0
  231. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/test_frontend/test_utils/test_stream_handler.py +0 -0
  232. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/utils/__init__.py +0 -0
  233. {agent_starter_pack-0.4.0 → agent_starter_pack-0.4.2}/tests/utils/get_agents.py +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agent-starter-pack
3
- Version: 0.4.0
4
- Summary: CLI tool to create GCP-based AI agent projects from templates
3
+ Version: 0.4.2
4
+ Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
5
5
  Author-email: Google LLC <agent-starter-pack@google.com>
6
6
  License: Apache-2.0
7
7
  License-File: LICENSE
@@ -38,7 +38,7 @@ Description-Content-Type: text/markdown
38
38
  alt="Try in Firebase Studio"
39
39
  src="https://cdn.firebasestudio.dev/btn/try_blue_20.svg">
40
40
  </picture>
41
- </a> ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
41
+ </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
42
42
 
43
43
 
44
44
  The `agent-starter-pack` is a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
@@ -66,7 +66,7 @@ agent-starter-pack create my-awesome-agent
66
66
  ```
67
67
 
68
68
  **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.
69
- 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.
69
+ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) for more options, or try with zero setup in [Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) or [Cloud Shell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs).
70
70
 
71
71
  ---
72
72
 
@@ -129,13 +129,12 @@ Visit our [documentation site](https://googlecloudplatform.github.io/agent-start
129
129
 
130
130
  ### Video Walkthrough:
131
131
 
132
- ## Video Tutorials
132
+ - **[Exploring the Agent Starter Pack](https://www.youtube.com/watch?v=9zqwym-N3lg)**: A comprehensive tutorial demonstrating how to rapidly deploy AI Agents using the Agent Starter Pack, covering architecture, templates, and step-by-step deployment.
133
133
 
134
- - **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.
135
- - **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!
136
- - **Oct 29, 2024**: A [20-Minute Video Walkthrough](https://youtu.be/kwRG7cnqSu0) is available, showcasing the previous `agent-starter-pack`.
134
+ - **[6-minute introduction](https://www.youtube.com/live/eZ-8UQ_t4YM?feature=shared&t=2791)** (April 2024): Explaining the Agent Starter Pack and demonstrating its key features. Part of the Kaggle GenAI intensive course.
135
+
136
+ - **[120-minute livestream demo](https://www.youtube.com/watch?v=yIRIT_EtALs&t=235s)** (March 6, 2025): Watch us build 3 Agents in under 30 minutes using the `agent-starter-pack`!
137
137
 
138
- ## Explore More Generative AI Resources
139
138
 
140
139
  Looking for more examples and resources for Generative AI on Google Cloud? Check out the [GoogleCloudPlatform/generative-ai](https://github.com/GoogleCloudPlatform/generative-ai) repository for notebooks, code samples, and more!
141
140
 
@@ -13,7 +13,7 @@
13
13
  alt="Try in Firebase Studio"
14
14
  src="https://cdn.firebasestudio.dev/btn/try_blue_20.svg">
15
15
  </picture>
16
- </a> ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
16
+ </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
17
17
 
18
18
 
19
19
  The `agent-starter-pack` is a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
@@ -41,7 +41,7 @@ agent-starter-pack create my-awesome-agent
41
41
  ```
42
42
 
43
43
  **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.
44
- 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.
44
+ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) for more options, or try with zero setup in [Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) or [Cloud Shell](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs).
45
45
 
46
46
  ---
47
47
 
@@ -104,13 +104,12 @@ Visit our [documentation site](https://googlecloudplatform.github.io/agent-start
104
104
 
105
105
  ### Video Walkthrough:
106
106
 
107
- ## Video Tutorials
107
+ - **[Exploring the Agent Starter Pack](https://www.youtube.com/watch?v=9zqwym-N3lg)**: A comprehensive tutorial demonstrating how to rapidly deploy AI Agents using the Agent Starter Pack, covering architecture, templates, and step-by-step deployment.
108
108
 
109
- - **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.
110
- - **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!
111
- - **Oct 29, 2024**: A [20-Minute Video Walkthrough](https://youtu.be/kwRG7cnqSu0) is available, showcasing the previous `agent-starter-pack`.
109
+ - **[6-minute introduction](https://www.youtube.com/live/eZ-8UQ_t4YM?feature=shared&t=2791)** (April 2024): Explaining the Agent Starter Pack and demonstrating its key features. Part of the Kaggle GenAI intensive course.
110
+
111
+ - **[120-minute livestream demo](https://www.youtube.com/watch?v=yIRIT_EtALs&t=235s)** (March 6, 2025): Watch us build 3 Agents in under 30 minutes using the `agent-starter-pack`!
112
112
 
113
- ## Explore More Generative AI Resources
114
113
 
115
114
  Looking for more examples and resources for Generative AI on Google Cloud? Check out the [GoogleCloudPlatform/generative-ai](https://github.com/GoogleCloudPlatform/generative-ai) repository for notebooks, code samples, and more!
116
115
 
@@ -16,58 +16,43 @@
16
16
  "cell_type": "markdown",
17
17
  "metadata": {},
18
18
  "source": [
19
- "### Import libraries"
19
+ "## Install dependencies"
20
20
  ]
21
21
  },
22
22
  {
23
23
  "cell_type": "code",
24
- "execution_count": 1,
24
+ "execution_count": null,
25
25
  "metadata": {},
26
26
  "outputs": [],
27
27
  "source": [
28
- "import json\n",
29
- "\n",
30
- "import requests\n",
31
- "import vertexai.agent_engines"
28
+ "!pip install google-cloud-aiplatform --upgrade"
32
29
  ]
33
30
  },
34
31
  {
35
32
  "cell_type": "markdown",
36
33
  "metadata": {},
37
34
  "source": [
38
- "## If you are using Agent Engine\n",
39
- "See more documentation at [Agent Engine Overview](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview)"
40
- ]
41
- },
42
- {
43
- "cell_type": "markdown",
44
- "metadata": {},
45
- "source": [
46
- "### Local Testing\n",
47
- "\n",
48
- "You can import directly the AgentEngineApp class within your environment. "
35
+ "### Import libraries"
49
36
  ]
50
37
  },
51
38
  {
52
39
  "cell_type": "code",
53
- "execution_count": 2,
40
+ "execution_count": 1,
54
41
  "metadata": {},
55
42
  "outputs": [],
56
43
  "source": [
57
- "from app.agent import root_agent\n",
58
- "from app.agent_engine_app import AgentEngineApp\n",
44
+ "import json\n",
59
45
  "\n",
60
- "agent_engine = AgentEngineApp(agent=root_agent)"
46
+ "import requests\n",
47
+ "import vertexai.agent_engines"
61
48
  ]
62
49
  },
63
50
  {
64
- "cell_type": "code",
65
- "execution_count": null,
51
+ "cell_type": "markdown",
66
52
  "metadata": {},
67
- "outputs": [],
68
53
  "source": [
69
- "for event in agent_engine.stream_query(message=\"hi!\", user_id=\"test\"):\n",
70
- " print(event)"
54
+ "## If you are using Agent Engine\n",
55
+ "See more documentation at [Agent Engine Overview](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview)"
71
56
  ]
72
57
  },
73
58
  {
@@ -122,6 +107,53 @@
122
107
  ")"
123
108
  ]
124
109
  },
110
+ {
111
+ "cell_type": "markdown",
112
+ "metadata": {},
113
+ "source": [
114
+ "### Local Testing\n",
115
+ "\n",
116
+ "You can import directly the AgentEngineApp class within your environment. \n",
117
+ "To run the agent locally, follow these steps:\n",
118
+ "1. Make sure all required packages are installed in your environment\n",
119
+ "2. The recommended approach is to use the same virtual environment created by the 'uv' tool\n",
120
+ "3. You can set up this environment by running 'make install' from your agent's root directory\n",
121
+ "4. Then select this kernel (.venv folder in your project) in your Jupyter notebook to ensure all dependencies are available"
122
+ ]
123
+ },
124
+ {
125
+ "cell_type": "code",
126
+ "execution_count": 2,
127
+ "metadata": {},
128
+ "outputs": [],
129
+ "source": [
130
+ "# Uncomment the following lines if you're not using the virtual environment created by uv\n",
131
+ "# import sys\n",
132
+ "# sys.path.append(\"../\")"
133
+ ]
134
+ },
135
+ {
136
+ "cell_type": "code",
137
+ "execution_count": null,
138
+ "metadata": {},
139
+ "outputs": [],
140
+ "source": [
141
+ "from app.agent import root_agent\n",
142
+ "from app.agent_engine_app import AgentEngineApp\n",
143
+ "\n",
144
+ "agent_engine = AgentEngineApp(agent=root_agent)"
145
+ ]
146
+ },
147
+ {
148
+ "cell_type": "code",
149
+ "execution_count": null,
150
+ "metadata": {},
151
+ "outputs": [],
152
+ "source": [
153
+ "for event in agent_engine.stream_query(message=\"hi!\", user_id=\"test\"):\n",
154
+ " print(event)"
155
+ ]
156
+ },
125
157
  {
126
158
  "cell_type": "markdown",
127
159
  "metadata": {},
@@ -133,17 +165,39 @@
133
165
  "cell_type": "markdown",
134
166
  "metadata": {},
135
167
  "source": [
136
- "### Local Testing\n",
168
+ "#### Remote Testing\n",
137
169
  "\n",
138
- "> You can run the application locally via the `make backend` command."
170
+ "For more information about authenticating HTTPS requests to Cloud Run services, see:\n",
171
+ "[Cloud Run Authentication Documentation](https://cloud.google.com/run/docs/triggering/https-request)\n",
172
+ "\n",
173
+ "Remote testing involves using a deployed service URL instead of localhost.\n",
174
+ "\n",
175
+ "Authentication is handled using GCP identity tokens instead of local credentials."
176
+ ]
177
+ },
178
+ {
179
+ "cell_type": "code",
180
+ "execution_count": 20,
181
+ "metadata": {},
182
+ "outputs": [],
183
+ "source": [
184
+ "ID_TOKEN = get_ipython().getoutput(\"gcloud auth print-identity-token -q\")[0]"
185
+ ]
186
+ },
187
+ {
188
+ "cell_type": "code",
189
+ "execution_count": null,
190
+ "metadata": {},
191
+ "outputs": [],
192
+ "source": [
193
+ "SERVICE_URL = \"YOUR_SERVICE_URL_HERE\" # Replace with your Cloud Run service URL"
139
194
  ]
140
195
  },
141
196
  {
142
197
  "cell_type": "markdown",
143
198
  "metadata": {},
144
199
  "source": [
145
- "#### Create a session\n",
146
- " Create a new session with user preferences and state information\n"
200
+ "You'll need to first create a Session"
147
201
  ]
148
202
  },
149
203
  {
@@ -156,8 +210,8 @@
156
210
  "session_id = \"test_session_456\"\n",
157
211
  "session_data = {\"state\": {\"preferred_language\": \"English\", \"visit_count\": 1}}\n",
158
212
  "\n",
159
- "session_url = f\"http://127.0.0.1:8000/apps/app/users/{user_id}/sessions/{session_id}\"\n",
160
- "headers = {\"Content-Type\": \"application/json\"}\n",
213
+ "session_url = f\"{SERVICE_URL}/apps/app/users/{user_id}/sessions/{session_id}\"\n",
214
+ "headers = {\"Content-Type\": \"application/json\", \"Authorization\": f\"Bearer {ID_TOKEN}\"}\n",
161
215
  "\n",
162
216
  "session_response = requests.post(session_url, headers=headers, json=session_data)\n",
163
217
  "print(f\"Session creation status code: {session_response.status_code}\")"
@@ -167,8 +221,7 @@
167
221
  "cell_type": "markdown",
168
222
  "metadata": {},
169
223
  "source": [
170
- "#### Send a message\n",
171
- "Send a message to the backend service and receive a streaming response\n"
224
+ "Then you will be able to send a message"
172
225
  ]
173
226
  },
174
227
  {
@@ -185,7 +238,7 @@
185
238
  " \"streaming\": True,\n",
186
239
  "}\n",
187
240
  "\n",
188
- "message_url = \"http://127.0.0.1:8000/run_sse\"\n",
241
+ "message_url = f\"{SERVICE_URL}/run_sse\"\n",
189
242
  "message_response = requests.post(\n",
190
243
  " message_url, headers=headers, json=message_data, stream=True\n",
191
244
  ")\n",
@@ -206,39 +259,17 @@
206
259
  "cell_type": "markdown",
207
260
  "metadata": {},
208
261
  "source": [
209
- "#### Remote Testing\n",
210
- "\n",
211
- "For more information about authenticating HTTPS requests to Cloud Run services, see:\n",
212
- "[Cloud Run Authentication Documentation](https://cloud.google.com/run/docs/triggering/https-request)\n",
213
- "\n",
214
- "Remote testing involves using a deployed service URL instead of localhost.\n",
262
+ "### Local Testing\n",
215
263
  "\n",
216
- "Authentication is handled using GCP identity tokens instead of local credentials."
217
- ]
218
- },
219
- {
220
- "cell_type": "code",
221
- "execution_count": 20,
222
- "metadata": {},
223
- "outputs": [],
224
- "source": [
225
- "ID_TOKEN = get_ipython().getoutput(\"gcloud auth print-identity-token -q\")[0]"
226
- ]
227
- },
228
- {
229
- "cell_type": "code",
230
- "execution_count": null,
231
- "metadata": {},
232
- "outputs": [],
233
- "source": [
234
- "SERVICE_URL = \"YOUR_SERVICE_URL_HERE\" # Replace with your Cloud Run service URL"
264
+ "> You can run the application locally via the `make backend` command."
235
265
  ]
236
266
  },
237
267
  {
238
268
  "cell_type": "markdown",
239
269
  "metadata": {},
240
270
  "source": [
241
- "You'll need to first create a Session"
271
+ "#### Create a session\n",
272
+ " Create a new session with user preferences and state information\n"
242
273
  ]
243
274
  },
244
275
  {
@@ -251,8 +282,8 @@
251
282
  "session_id = \"test_session_456\"\n",
252
283
  "session_data = {\"state\": {\"preferred_language\": \"English\", \"visit_count\": 1}}\n",
253
284
  "\n",
254
- "session_url = f\"{SERVICE_URL}/apps/app/users/{user_id}/sessions/{session_id}\"\n",
255
- "headers = {\"Content-Type\": \"application/json\", \"Authorization\": f\"Bearer {ID_TOKEN}\"}\n",
285
+ "session_url = f\"http://127.0.0.1:8000/apps/app/users/{user_id}/sessions/{session_id}\"\n",
286
+ "headers = {\"Content-Type\": \"application/json\"}\n",
256
287
  "\n",
257
288
  "session_response = requests.post(session_url, headers=headers, json=session_data)\n",
258
289
  "print(f\"Session creation status code: {session_response.status_code}\")"
@@ -262,7 +293,8 @@
262
293
  "cell_type": "markdown",
263
294
  "metadata": {},
264
295
  "source": [
265
- "Then you will be able to send a message"
296
+ "#### Send a message\n",
297
+ "Send a message to the backend service and receive a streaming response\n"
266
298
  ]
267
299
  },
268
300
  {
@@ -279,7 +311,7 @@
279
311
  " \"streaming\": True,\n",
280
312
  "}\n",
281
313
  "\n",
282
- "message_url = f\"{SERVICE_URL}/run_sse\"\n",
314
+ "message_url = \"http://127.0.0.1:8000/run_sse\"\n",
283
315
  "message_response = requests.post(\n",
284
316
  " message_url, headers=headers, json=message_data, stream=True\n",
285
317
  ")\n",
@@ -299,7 +331,7 @@
299
331
  ],
300
332
  "metadata": {
301
333
  "kernelspec": {
302
- "display_name": ".venv",
334
+ "display_name": "Python 3",
303
335
  "language": "python",
304
336
  "name": "python3"
305
337
  },
@@ -313,7 +345,7 @@
313
345
  "name": "python",
314
346
  "nbconvert_exporter": "python",
315
347
  "pygments_lexer": "ipython3",
316
- "version": "3.12.8"
348
+ "version": "3.12.2"
317
349
  }
318
350
  },
319
351
  "nbformat": 4,
@@ -16,58 +16,43 @@
16
16
  "cell_type": "markdown",
17
17
  "metadata": {},
18
18
  "source": [
19
- "### Import libraries"
19
+ "## Install dependencies"
20
20
  ]
21
21
  },
22
22
  {
23
23
  "cell_type": "code",
24
- "execution_count": 1,
24
+ "execution_count": null,
25
25
  "metadata": {},
26
26
  "outputs": [],
27
27
  "source": [
28
- "import json\n",
29
- "\n",
30
- "import requests\n",
31
- "import vertexai.agent_engines"
28
+ "!pip install google-cloud-aiplatform --upgrade"
32
29
  ]
33
30
  },
34
31
  {
35
32
  "cell_type": "markdown",
36
33
  "metadata": {},
37
34
  "source": [
38
- "## If you are using Agent Engine\n",
39
- "See more documentation at [Agent Engine Overview](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview)"
40
- ]
41
- },
42
- {
43
- "cell_type": "markdown",
44
- "metadata": {},
45
- "source": [
46
- "### Local Testing\n",
47
- "\n",
48
- "You can import directly the AgentEngineApp class within your environment. "
35
+ "### Import libraries"
49
36
  ]
50
37
  },
51
38
  {
52
39
  "cell_type": "code",
53
- "execution_count": 2,
40
+ "execution_count": 1,
54
41
  "metadata": {},
55
42
  "outputs": [],
56
43
  "source": [
57
- "from app.agent import root_agent\n",
58
- "from app.agent_engine_app import AgentEngineApp\n",
44
+ "import json\n",
59
45
  "\n",
60
- "agent_engine = AgentEngineApp(agent=root_agent)"
46
+ "import requests\n",
47
+ "import vertexai.agent_engines"
61
48
  ]
62
49
  },
63
50
  {
64
- "cell_type": "code",
65
- "execution_count": null,
51
+ "cell_type": "markdown",
66
52
  "metadata": {},
67
- "outputs": [],
68
53
  "source": [
69
- "for event in agent_engine.stream_query(message=\"hi!\", user_id=\"test\"):\n",
70
- " print(event)"
54
+ "## If you are using Agent Engine\n",
55
+ "See more documentation at [Agent Engine Overview](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview)"
71
56
  ]
72
57
  },
73
58
  {
@@ -122,6 +107,53 @@
122
107
  ")"
123
108
  ]
124
109
  },
110
+ {
111
+ "cell_type": "markdown",
112
+ "metadata": {},
113
+ "source": [
114
+ "### Local Testing\n",
115
+ "\n",
116
+ "You can import directly the AgentEngineApp class within your environment. \n",
117
+ "To run the agent locally, follow these steps:\n",
118
+ "1. Make sure all required packages are installed in your environment\n",
119
+ "2. The recommended approach is to use the same virtual environment created by the 'uv' tool\n",
120
+ "3. You can set up this environment by running 'make install' from your agent's root directory\n",
121
+ "4. Then select this kernel (.venv folder in your project) in your Jupyter notebook to ensure all dependencies are available"
122
+ ]
123
+ },
124
+ {
125
+ "cell_type": "code",
126
+ "execution_count": 2,
127
+ "metadata": {},
128
+ "outputs": [],
129
+ "source": [
130
+ "# Uncomment the following lines if you're not using the virtual environment created by uv\n",
131
+ "# import sys\n",
132
+ "# sys.path.append(\"../\")"
133
+ ]
134
+ },
135
+ {
136
+ "cell_type": "code",
137
+ "execution_count": null,
138
+ "metadata": {},
139
+ "outputs": [],
140
+ "source": [
141
+ "from app.agent import root_agent\n",
142
+ "from app.agent_engine_app import AgentEngineApp\n",
143
+ "\n",
144
+ "agent_engine = AgentEngineApp(agent=root_agent)"
145
+ ]
146
+ },
147
+ {
148
+ "cell_type": "code",
149
+ "execution_count": null,
150
+ "metadata": {},
151
+ "outputs": [],
152
+ "source": [
153
+ "for event in agent_engine.stream_query(message=\"hi!\", user_id=\"test\"):\n",
154
+ " print(event)"
155
+ ]
156
+ },
125
157
  {
126
158
  "cell_type": "markdown",
127
159
  "metadata": {},
@@ -133,17 +165,39 @@
133
165
  "cell_type": "markdown",
134
166
  "metadata": {},
135
167
  "source": [
136
- "### Local Testing\n",
168
+ "#### Remote Testing\n",
137
169
  "\n",
138
- "> You can run the application locally via the `make backend` command."
170
+ "For more information about authenticating HTTPS requests to Cloud Run services, see:\n",
171
+ "[Cloud Run Authentication Documentation](https://cloud.google.com/run/docs/triggering/https-request)\n",
172
+ "\n",
173
+ "Remote testing involves using a deployed service URL instead of localhost.\n",
174
+ "\n",
175
+ "Authentication is handled using GCP identity tokens instead of local credentials."
176
+ ]
177
+ },
178
+ {
179
+ "cell_type": "code",
180
+ "execution_count": 20,
181
+ "metadata": {},
182
+ "outputs": [],
183
+ "source": [
184
+ "ID_TOKEN = get_ipython().getoutput(\"gcloud auth print-identity-token -q\")[0]"
185
+ ]
186
+ },
187
+ {
188
+ "cell_type": "code",
189
+ "execution_count": null,
190
+ "metadata": {},
191
+ "outputs": [],
192
+ "source": [
193
+ "SERVICE_URL = \"YOUR_SERVICE_URL_HERE\" # Replace with your Cloud Run service URL"
139
194
  ]
140
195
  },
141
196
  {
142
197
  "cell_type": "markdown",
143
198
  "metadata": {},
144
199
  "source": [
145
- "#### Create a session\n",
146
- " Create a new session with user preferences and state information\n"
200
+ "You'll need to first create a Session"
147
201
  ]
148
202
  },
149
203
  {
@@ -156,8 +210,8 @@
156
210
  "session_id = \"test_session_456\"\n",
157
211
  "session_data = {\"state\": {\"preferred_language\": \"English\", \"visit_count\": 1}}\n",
158
212
  "\n",
159
- "session_url = f\"http://127.0.0.1:8000/apps/app/users/{user_id}/sessions/{session_id}\"\n",
160
- "headers = {\"Content-Type\": \"application/json\"}\n",
213
+ "session_url = f\"{SERVICE_URL}/apps/app/users/{user_id}/sessions/{session_id}\"\n",
214
+ "headers = {\"Content-Type\": \"application/json\", \"Authorization\": f\"Bearer {ID_TOKEN}\"}\n",
161
215
  "\n",
162
216
  "session_response = requests.post(session_url, headers=headers, json=session_data)\n",
163
217
  "print(f\"Session creation status code: {session_response.status_code}\")"
@@ -167,8 +221,7 @@
167
221
  "cell_type": "markdown",
168
222
  "metadata": {},
169
223
  "source": [
170
- "#### Send a message\n",
171
- "Send a message to the backend service and receive a streaming response\n"
224
+ "Then you will be able to send a message"
172
225
  ]
173
226
  },
174
227
  {
@@ -185,7 +238,7 @@
185
238
  " \"streaming\": True,\n",
186
239
  "}\n",
187
240
  "\n",
188
- "message_url = \"http://127.0.0.1:8000/run_sse\"\n",
241
+ "message_url = f\"{SERVICE_URL}/run_sse\"\n",
189
242
  "message_response = requests.post(\n",
190
243
  " message_url, headers=headers, json=message_data, stream=True\n",
191
244
  ")\n",
@@ -206,39 +259,17 @@
206
259
  "cell_type": "markdown",
207
260
  "metadata": {},
208
261
  "source": [
209
- "#### Remote Testing\n",
210
- "\n",
211
- "For more information about authenticating HTTPS requests to Cloud Run services, see:\n",
212
- "[Cloud Run Authentication Documentation](https://cloud.google.com/run/docs/triggering/https-request)\n",
213
- "\n",
214
- "Remote testing involves using a deployed service URL instead of localhost.\n",
262
+ "### Local Testing\n",
215
263
  "\n",
216
- "Authentication is handled using GCP identity tokens instead of local credentials."
217
- ]
218
- },
219
- {
220
- "cell_type": "code",
221
- "execution_count": 20,
222
- "metadata": {},
223
- "outputs": [],
224
- "source": [
225
- "ID_TOKEN = get_ipython().getoutput(\"gcloud auth print-identity-token -q\")[0]"
226
- ]
227
- },
228
- {
229
- "cell_type": "code",
230
- "execution_count": null,
231
- "metadata": {},
232
- "outputs": [],
233
- "source": [
234
- "SERVICE_URL = \"YOUR_SERVICE_URL_HERE\" # Replace with your Cloud Run service URL"
264
+ "> You can run the application locally via the `make backend` command."
235
265
  ]
236
266
  },
237
267
  {
238
268
  "cell_type": "markdown",
239
269
  "metadata": {},
240
270
  "source": [
241
- "You'll need to first create a Session"
271
+ "#### Create a session\n",
272
+ " Create a new session with user preferences and state information\n"
242
273
  ]
243
274
  },
244
275
  {
@@ -251,8 +282,8 @@
251
282
  "session_id = \"test_session_456\"\n",
252
283
  "session_data = {\"state\": {\"preferred_language\": \"English\", \"visit_count\": 1}}\n",
253
284
  "\n",
254
- "session_url = f\"{SERVICE_URL}/apps/app/users/{user_id}/sessions/{session_id}\"\n",
255
- "headers = {\"Content-Type\": \"application/json\", \"Authorization\": f\"Bearer {ID_TOKEN}\"}\n",
285
+ "session_url = f\"http://127.0.0.1:8000/apps/app/users/{user_id}/sessions/{session_id}\"\n",
286
+ "headers = {\"Content-Type\": \"application/json\"}\n",
256
287
  "\n",
257
288
  "session_response = requests.post(session_url, headers=headers, json=session_data)\n",
258
289
  "print(f\"Session creation status code: {session_response.status_code}\")"
@@ -262,7 +293,8 @@
262
293
  "cell_type": "markdown",
263
294
  "metadata": {},
264
295
  "source": [
265
- "Then you will be able to send a message"
296
+ "#### Send a message\n",
297
+ "Send a message to the backend service and receive a streaming response\n"
266
298
  ]
267
299
  },
268
300
  {
@@ -279,7 +311,7 @@
279
311
  " \"streaming\": True,\n",
280
312
  "}\n",
281
313
  "\n",
282
- "message_url = f\"{SERVICE_URL}/run_sse\"\n",
314
+ "message_url = \"http://127.0.0.1:8000/run_sse\"\n",
283
315
  "message_response = requests.post(\n",
284
316
  " message_url, headers=headers, json=message_data, stream=True\n",
285
317
  ")\n",
@@ -299,7 +331,7 @@
299
331
  ],
300
332
  "metadata": {
301
333
  "kernelspec": {
302
- "display_name": ".venv",
334
+ "display_name": "Python 3",
303
335
  "language": "python",
304
336
  "name": "python3"
305
337
  },
@@ -313,7 +345,7 @@
313
345
  "name": "python",
314
346
  "nbconvert_exporter": "python",
315
347
  "pygments_lexer": "ipython3",
316
- "version": "3.12.8"
348
+ "version": "3.12.2"
317
349
  }
318
350
  },
319
351
  "nbformat": 4,