Commit Graph

105 Commits

Author SHA1 Message Date
Milen Kovachev ab749867b0 docs(eventarc): Address technical verification report feedback (#2074)
- Add pip install "google-adk[gcp]" step to Eventarc Prerequisites.
- Clarify datacontenttype inference defaults and specify application/json in snippet prompt.
- Update Runtime Lambda table entry to use ctx.session_id and note support for payload and Context.
- Update OMIT table entry to list all mandatory attributes (type, source, bus, id, specversion).

Addresses feedback in https://github.com/google/adk-docs/pull/2045#issuecomment-5184438669

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-07 20:30:29 +00:00
Milen Kovachev 9f1ae0d3f0 docs: add Eventarc tool integration page and code snippets (#2045)
* docs: add Eventarc tool integration page and code snippets

- Document general-purpose EventarcToolset and publish_message tool
- Document domain-specific create_publish_tool with static, dynamic, and runtime lambda attribute bindings
- Add complete, runnable Python code snippets for both built-in tool and domain-specific publishing
- Add Eventarc icon asset

* Improve the documentation after running integration-review script.

* Update eventarc.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-04 20:48:26 +00:00
Ali Adnan 882165a8b2 Fix route key mismatch in conditional-routing.py workflow example (#1996)
* Update conditional-routing.py

* Update tools_and_agent.py

* Update tools_and_agent.py

* Update tools_and_agent.py

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-07-30 22:48:11 +00:00
Umer Ali cd7b1935ed fix: add missing await to create_session calls in callback examples (#1976)
InMemorySessionService.create_session is async, so calls without await
return unawaited coroutines and the sessions are never created, causing
SessionNotFoundError on subsequent runner.run_async() calls.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-20 16:56:53 -05:00
Umer Ali 04655e1bf7 docs: fix wrong return type and missing imports in function tools example (#1979)
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-20 15:54:06 -05:00
Serena 534d39895e Fix ValueError for Python agent_team ADK tutorial (#1957)
* fix directory names

* Update links and dir name in README and notebook

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-13 11:45:57 -05:00
Zyan 7458d68a64 #1029 - 8 vector_store_similarity_search and SpannerVectorStoreSettings (#1926)
* #1029 - 8 vector_store_similarity_search and SpannerVectorStoreSettings

Added vector_store_similarity_search to SpannerToolset. SpannerVectorStoreSettings is introduced to support this feature.

* Update spanner.md

* Update spanner.md

Applied feedback. Additionally, reviewed the phrasing in the intro for clarity and concision and did some minor formatting edits.

* Fix wrapping, missing import, trailing whitespace, formatting fixes

* Restructure Spanner page: add intro, section headings, reorder vector search

* Add experimental tags/notes to corresponding integration pages

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-08 18:28:52 -05:00
rishipradeep-think41 452c15f418 Fix Go multi-tool tutorial snippet to include two tools (#1577)
* Fix Go multi-tool tutorial snippet to include two tools

* Update model string in multi-tool snippets to gemini-flash-latest in Python, TS, Java

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-08 14:19:01 -05:00
Gary Zavaleta 2c385b98ab docs(memory): use public preload_memory tool API in examples (#1804)
The memory docs and the express-mode weather agent notebook referenced
`adk.tools.preload_memory_tool.PreloadMemoryTool()`, which raises
`AttributeError: module 'google.adk.tools' has no attribute
'preload_memory_tool'` because the submodule is not exposed via the
package's lazy `__getattr__`.

Use the documented public API `from google.adk.tools import preload_memory`
and pass the `preload_memory` instance directly, consistent with how the
sibling `load_memory` tool is shown in the same page.

Fixes #1771

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-07 14:42:00 -05:00
Haran Rajkumar d802044831 docs: update GenAI auth env var and Client parameter (#1832)
* docs: update GOOGLE_GENAI_USE_VERTEXAI to GOOGLE_GENAI_USE_ENTERPRISE in configs and models

* docs: update GOOGLE_GENAI_USE_VERTEXAI in deployment and setup guides

* docs: update GOOGLE_GENAI_USE_VERTEXAI and Client parameter in integrations and streaming docs

* docs: update GOOGLE_GENAI_USE_VERTEXAI in tutorials and examples

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-30 08:51:51 -07:00
Adam Cohen 9ed1945145 Bump gemini flash from v2 to flash-latest (#1840)
* Bump gemini flash from v2 to v2.5

* Update agent.py

* Update agent.py

* Update agent.py

* Update agent.py

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-29 19:18:27 -07:00
Shahin Saadati a7c2f5c5f3 Added a sample to show how the conditional routing works. (#1792)
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-05-28 20:59:58 +00:00
Isaac Alejandro Blanco 32ca424b35 Update A Simple Math Toolset example code (#1697)
* fix: working code for the new version

* fix: typos

* fix: lint

* Fix import paths, remove trailing underscore from prefix, and replace Runner with InMemoryRunner/run_debug for a self-contained runnable example.

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-28 13:14:58 -05:00
Kristopher Overholt 1214ad915a Update product names in docs (#1673)
* Update names in docs

* Update names in docs

* Code formatting

* Format notebooks

* Update names in docs

* Update names in docs

* Update names in code samples

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update icon

* Update names in docs

* Update names in docs
2026-04-22 05:10:38 -07:00
dependabot[bot] 9edc834103 chore(deps): bump the pip group across 4 directories with 1 update (#1641)
* chore(deps): bump the pip group across 4 directories with 1 update

Bumps the pip group with 1 update in the /examples/python/agent-samples/youtube_shorts_assistant directory: [google-adk](https://github.com/google/adk-python).
Bumps the pip group with 1 update in the /examples/python/snippets/streaming/adk-streaming-ws directory: [google-adk](https://github.com/google/adk-python).
Bumps the pip group with 1 update in the /examples/python/snippets/streaming/adk-streaming-ws/app directory: [google-adk](https://github.com/google/adk-python).
Bumps the pip group with 1 update in the /examples/python/snippets/streaming/adk-streaming/app directory: [google-adk](https://github.com/google/adk-python).


Updates `google-adk` from 0.1.0 to 1.28.1
- [Release notes](https://github.com/google/adk-python/releases)
- [Changelog](https://github.com/google/adk-python/blob/main/CHANGELOG.md)
- [Commits](https://github.com/google/adk-python/compare/v0.1.0...v1.28.1)

Updates `google-adk` from 1.17.0 to 1.28.1
- [Release notes](https://github.com/google/adk-python/releases)
- [Changelog](https://github.com/google/adk-python/blob/main/CHANGELOG.md)
- [Commits](https://github.com/google/adk-python/compare/v0.1.0...v1.28.1)

Updates `google-adk` from 1.17.0 to 1.28.1
- [Release notes](https://github.com/google/adk-python/releases)
- [Changelog](https://github.com/google/adk-python/blob/main/CHANGELOG.md)
- [Commits](https://github.com/google/adk-python/compare/v0.1.0...v1.28.1)

Updates `google-adk` from 1.10.0 to 1.28.1
- [Release notes](https://github.com/google/adk-python/releases)
- [Changelog](https://github.com/google/adk-python/blob/main/CHANGELOG.md)
- [Commits](https://github.com/google/adk-python/compare/v0.1.0...v1.28.1)

---
updated-dependencies:
- dependency-name: google-adk
  dependency-version: 1.28.1
  dependency-type: direct:production
  dependency-group: pip
- dependency-name: google-adk
  dependency-version: 1.28.1
  dependency-type: direct:production
  dependency-group: pip
- dependency-name: google-adk
  dependency-version: 1.28.1
  dependency-type: direct:production
  dependency-group: pip
- dependency-name: google-adk
  dependency-version: 1.28.1
  dependency-type: direct:production
  dependency-group: pip
...

Signed-off-by: dependabot[bot] <support@github.com>

* Remove version pins from samples

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-15 09:58:13 -05:00
eliasecchig f3f466fe29 Add ambient agents documentation (#1630)
* Add ambient agents documentation

Document how to build event-driven ambient agents using ADK trigger
endpoints and the /run endpoint. Covers Pub/Sub, Eventarc (Standard
and Advanced), Cloud Scheduler, concurrency control, retry logic,
session lifecycle, and deployment to Cloud Run.

* Address reviewer feedback: clarify event processing flow

- Move "How events are processed" higher, right after trigger endpoints
  intro, so the mental model comes before setup instructions
- Reword step 5: explicitly describe status code behavior (200 = ack,
  500 = retry) instead of vague "determines whether to retry"
- Clarify that trigger endpoints auto-create sessions without needing
  the --auto_create_session flag
- Restructure heading hierarchy under "Using trigger endpoints"

* Address reviewer feedback from koverholt

- Use named sections (--8<-- [start/end]) in code snippets to hide
  license headers in doc embeds
- Change model to gemini-flash-latest alias
- Restructure: show example agent first, then enable instructions,
  then "Try it locally" with step-by-step commands and curl test
- Fix port consistency (curl uses 8000 matching adk api_server default)
- Add curl example for /run endpoint

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-15 09:26:16 -05:00
Joe Fernandez 7567175816 docs: move multi-tool agent and redirect links (#1557)
* docs: move multi-tool agent and redirect links

* update based on comments and testing
2026-04-03 17:55:27 -07:00
Kristopher Overholt 58f3aaebca Replace documentation URLs and paths for adk.dev migration (#1536)
* Replace google.github.io/adk-docs URLs and /adk-docs/ paths with adk.dev

Migrate all hardcoded documentation references to use the new custom
domain. Update root-relative links to remove the /adk-docs/ subpath
prefix since the site will be served from the root of adk.dev.

* Additional fixes
2026-04-01 12:48:27 -05:00
vpaiva77 0a09aefdbd Fix: Model not supported (#1483) 2026-03-26 15:32:28 +00:00
Sandheep P ee1555e66c The app name youtube-shorts-assistant contains hyphens, which aren't valid Python identifiers. (#1436) 2026-03-16 23:52:40 +00:00
ShacharSh 1d02f6f461 Fix tool name reference in the customer_support_agent.py example (#1224)
While the check_and_transfer function is wrapped as a FunctionTool named as escalation_tool , this name is later on remains unused. This fix should clarify the example using the right name.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-04 10:40:41 -08:00
Aditya Mulik 10ba6551f3 docs: refactor parallel agent example - clean imports and test code (#1213)
* docs: refactor parallel agent example - clean imports and test code

* Update parallel agent; bump to Gemini 2.5 Flash

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-02-02 18:42:00 -06:00
Aditya Mulik b3146d7e60 docs: refactor loop agent example - clean imports and test code (#1212)
* docs: refactor loop agent example - clean imports and test code

* Update loop agent; bump to Gemini 2.5 Flash

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-02-02 18:26:10 -06:00
Aditya Mulik 0222117d34 docs: refactor sequential agent example - clean imports and test code (#1211)
* docs: refactor sequential agent example - clean imports and test code

* removed constants comment

* fix typo

* Add GEMINI_MODEL constant comment to sequential agent

* Update to Gemini 2.5 Flash

* Clean up sequential agent code sample

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-02-02 18:02:40 -06:00
Aditya Mulik 15fb0b5910 Removed BaseAgent as it was redundant (#1199)
Was wondering if BaseAgent was used in the code, since it's redundant, I thought of removing it.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-01-29 11:48:49 -06:00
Huan Chen 372b316234 docs: document built-in data-agent tools (#1164)
* docs: document built-in data-agent tools

* replace project and agent name

* add in nav

* update title

* update content

* update title

* update content

* update content

* update content

* update version
2026-01-23 14:39:36 -08:00
Kamal Aboul-Hosn b38ec7602b docs: Add documentation for the new Pub/Sub tool (#1151)
* docs: Add documentation for the new Pub/Sub tool

* Update pubsub.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-20 15:25:01 -08:00
Kristopher Overholt 01c85c4a13 Cleaning up 3P tool wrapper sample code (#1152) 2026-01-16 13:54:30 -06:00
alan blount e145fd4932 fix(docs): Update bigquery.py creds (#845)
* fix(docs): Update bigquery.py creds 

I required this to make it work
application_default_credentials, _ = google.auth.default()

* Update examples/python/snippets/tools/built-in-tools/bigquery.py

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-01-16 11:50:12 -06:00
Sultan Fariz 613079f70f fix: infinite loop in LoopAgent exit tool example (#1105)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-15 17:03:37 -08:00
Didier Durand 159e536aed doc: fixing typos in various files (#1140)
* doc: fixing typos in various files

* Update code-exec-agent-engine.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-15 16:59:02 -08:00
Pang Luo 026def65ee Fix state update (#1104)
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-01-05 15:37:38 -06:00
Didier Durand 60c8fa89be doc: fixing typos in various files (#1093)
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-01-05 11:37:02 -06:00
uedayo 75e3412b86 Update express-mode-weather-agent.ipynb (#941)
Add missing code section for "Create Vertex AI Memory through ADK to use locally

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-11-12 10:15:36 -08:00
Adrian Altermatt bf12de8ea2 Fix import statement for deepcopy (#944)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-11-12 09:10:50 -08:00
Anthony Z 411b057cc8 feat(docs): Add vertex express mode documentation for Agent Engine deploy (#883)
* Update express-mode.md

* Update express-mode.md

* Update agent-engine.md

* Update agent-engine.md

* Update agent-engine.md

* Delete examples/python/notebooks/express-mode-weather-agent.ipynb

* Add files via upload

* Rename express_mode_weather_agent_(1).ipynb to express_mode_weather_agent.ipynb

* Rename express_mode_weather_agent.ipynb to express-mode-weather-agent.ipynb

* Update express-mode-weather-agent.ipynb

* Update agent-engine.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-11-07 08:28:00 -08:00
Kristopher Overholt 4cb3a891a1 feat: Add sections and groupings to sidebar navigation menu (#791)
* Add navigation sections to docs

* Move two pages

* Move more sections

* Update nav

* Fix whitespace, newlines

* Fix section headings

* Fix top level headings

* Move Technical Overview in nav

* Change Testing page to API Server page

* Reorder sub-pages in Components section

* Add Home as top level nav; remove redundant site title

* Update links to API server docs page

* Formatting

* Formatting
2025-11-03 12:48:32 -06:00
Sergei Lilichenko b06d473f5e Fix the code sample of using BigQuery with the application default credentails (#825)
* Fix the code sample of using BigQuery with the application default credentails

* Update bigquery.py

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-10-31 09:32:04 -07:00
Kaz Sato 278bd2fbed fix: updated the article and code to adk 1.17.0 (#834)
* fix: updated the article and code to adk 1.17.0

fix: updated the article and code to adk 1.17.0

* fix: removing the outdated code from the index

fix: removing the outdated code from the index

* fix: removing 404 link

fix: removing 404 link
2025-10-31 12:44:51 +09:00
An Nguyen 8b4609cace Add Bigtable documentation (#725) 2025-09-29 09:04:08 -07:00
tianbowen-google 935b95e4b8 fix: update spanner sample comments (#711) 2025-09-23 17:58:07 -07:00
tianbowen-google c5db8cd97c docs: document spanner built-in toolset (#710) 2025-09-23 15:13:22 -07:00
Huan Chen 858ab0b79b docs: add ask_data_insights tool to bigquery document (#674)
* docs: add ask_data_insights tool to bigquery document.

* remove extra line

* add example question for ask_data_insights
2025-09-09 15:49:25 -07:00
tenghuil 7322cf06f5 fix(docs): Add rag engne to adk built in tool doc (#423)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-04 12:54:15 -07:00
Fran e45c8ffeba Fix capital_agent.py example (#528)
* Fix capital_agent.py

* moved comment

* fix: moved comment capital_agent.py

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 16:59:01 -07:00
anifort 315ee79307 Update human_in_the_loop.py (#642)
the removed line is not needed -events is never used and the 2 lines below is creating events_async

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:15:35 -07:00
sfkrieger da6d18fa8c chore: Updated code sample to genericize region in datastore ID (#622)
* Updated code sample to genericize region in datastore ID

* Added licensing information.
2025-08-19 13:56:32 -07:00
nikkie ebbf121fcd fix: Remove redundant trailing quote (#623)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 09:40:46 -07:00
Jasmeet Bhatia 4b3ea82bdd fix: correct syntax error and typo in Python examples (#625) 2025-08-19 09:39:30 -07:00
Matt Landers da5ce68cbe fix: code executor examples for python (#377)
* fix: code executor examples for python

* fix: updated snippet for code executor

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-15 11:28:52 -07:00