Commit Graph

79 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
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
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
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
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
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
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
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
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
Terrence Ryan 43a58a2a05 fix: Prevent overwriting of function response (#607)
In the human-in-the-loop example, the long_running_function_response
variable could be overwritten with `None` by a subsequent event that
did not contain a function response. This would cause the logic that
depends on the response to fail.

Fixes #375

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:01:19 -07:00
Mandy Chan 9bd2d1bd29 fix: add code example for skip_summarization (#595)
fix issue https://github.com/google/adk-docs/issues/531
2025-08-13 16:04:04 -04:00
Kaz Sato 98d2a5828b fix: updated adk version to 1.10.0 (#589)
* fix: updated adk version to 1.10.0

fix: updated adk version to 1.10.0, and confirmed the demos work properly.

* fix: add session resumption

fix: add session resumption

* fix: adding session resumption to the docs.

fix: adding session resumption to the docs.
2025-08-12 10:23:42 -07:00
ASHISH JOHNSON df4874441a fix: await not correctly applied to example code (#437)
* fix: applied `await` on the `session_service.create_session()` call

* added license to the code

---------

Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-08-09 14:35:28 -07:00
Kaz Sato 7bafd1eb2e fix: upgraded to adk 1.9.0 and removed unnecessary infinite loop (#554)
fix: upgraded to adk 1.9.0 and removed unnecessary infinite loop
2025-08-04 15:26:14 +09:00
shruti-mantri 66e6c937d3 fix: llm-agents capital_agent.py example failing due to missing awaits (#550)
* fix: llm-agents capital_agent.py example failing due to missing awaits

* add license header to the code
2025-08-01 11:47:25 +05:30
Sita Lakshmi Sangameswaran b40accd5cb fix(state): update state key references in instructions (#493)
* fix: update state key references

* update docs to include info on state injection in instructions

* update java snippet

* add docs on InstructionProvider

* add tooltip on direct state modification

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-07-11 09:42:18 -04:00
Shobhit Singh ae18ef6d13 docs: fix the usage of BuiltInCodeExecutor in code snippets (#503)
* docs: fix the usage of `BuiltInCodeExecutor` in code snippets

* revert stray spaces

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-07-11 18:07:07 +05:30
Gururaj Deshpande ff454ac1c9 fix: change call_agent to call_agent_async (#450)
* fix: change call_agent to call_agent_async

* added await in storyflow where missing

* updated callbacks and storyflow with await and user comment

* fixed more

* added licencse header

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
Co-authored-by: Lavi Nigam <lavinigam@google.com>
2025-06-28 00:10:12 +05:30
Shobhit Singh 36911713e9 docs: document built-in BigQuery tools (#449)
* Mention BigQuery tools among built-in tools

* Create bigquery.py

* Update bigquery snippet with working code
2025-06-25 13:06:51 -07:00