45 Commits

Author SHA1 Message Date
Ali Adnan 9ce0e98b5e fix: await create_session in agent_search example (#2053)
create_session is async; calling it without await at module scope
produces an un-awaited coroutine. Wrap with asyncio.run, matching the
pattern used in other built-in tool examples.
2026-09-11 23:56:29 +00:00
Ali Adnan 911869c6de fix: remove broken relative import in rag_engine example (#2052)
* fix: remove broken relative import in rag_engine example

The snippet imported from a non-existent .prompts module and used an
undefined return_instructions_root(). Replaced with a self-contained
instruction string so the knowledge-engine example runs standalone.

* Apply suggestion from @joefernandez

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-09-11 23:14:53 +00:00
Ali Adnan 3b350ea25b docs: add missing Apache 2.0 license headers to python snippets (#2054)
Three example files were missing the required Google license header,
which fails the License Header Lint CI check. Prepend the standard header.
2026-09-11 21:18:22 +00:00
Ali Adnan 36ef9871e2 fix: await create_session and add license header in agent_cli example (#2055)
* fix: await create_session and add license header in agent_cli example

create_session is async; the un-awaited coroutine caused a RuntimeError
when session.id was accessed. Also added the missing Apache 2.0 header.

* Apply suggestion from @joefernandez

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-09-11 21:14:48 +00:00
Kathy Wu fb23822335 Update outdated BigQuery integration sample code (#2214)
The BigQuery integration page still imports from google.adk.tools.bigquery,
which now raises a DeprecationWarning pointing at
google.adk.integrations.bigquery. Update all five auth snippets and the
included sample to the new path.

The sample also wrapped session_service.create_session() in asyncio.run(),
which blows up in Colab and other notebooks where a loop is already running.
Restructure it around an async main() that awaits create_session() and
iterates runner.run_async(), matching the pattern the other built-in tool
snippets already use.

Bug: b/559149787

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-09-10 15:41:55 +00:00
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 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
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
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
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
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
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
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
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
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
Lavi Nigam 33b60275d3 fix(tools): Correct async handling in LRO and HTIL sessions (#374)
The LRO (Long-Running Operation) and HTIL (Human-in-the-Loop) tools were failing to execute properly due to an unhandled promise.

The `session_service.create_session` method is asynchronous but was not being awaited, causing race conditions. This change adds the required `await` to ensure proper execution flow.

Additionally, the related documentation has been updated to reflect the corrected code.
2025-06-06 18:21:10 +09:00
Lavi Nigam 5a690cf74a Pjchender/main - added license header (#339)
* doc: update openapi tool for v1.0.0

* added license header

---------

Co-authored-by: pjchender <pjchender@gmail.com>
2025-05-30 11:55:13 +05:30
Aaron Chen 79c0f65f5f doc: update openapi tool for v1.0.0 (#311)
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-05-30 11:54:27 +05:30
Megan O'Keefe 0887973bed feat: Initializes Java documentation (#277) 2025-05-20 12:10:27 -04:00
Zike Yang 51dfbb6f57 fix: fix hunman_in_the_loop example (#240)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-05-12 10:21:11 -05:00
seanzhou1023 e62f7565d2 fix: fix long running tool docs (#229)
Co-authored-by: Sean Zhou <seanzhougoogle@google.com>
2025-05-07 13:37:03 -05:00
Jinyong Shin 8ebdcf4876 feat: Docs improvement: FunctionTool (#212)
* fix: improvement docs according to issue #210

* fix: remove duplicated(?) comments

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-05-06 09:10:42 -05:00
Rebenkov Aleksey 496fcf3dec Fixed instruction for root agent to avoid summarization before passing text to summary agent (#98)
Co-authored-by: Rebenkov Aleksey <aleksey.rebenkov@hindsiteinc.com>
2025-04-16 03:04:26 -05:00
adars124 0a66987547 docs: fix agent tool example doc (#93)
Add  instead of  in the Runner
2025-04-15 22:02:27 -05:00
Daniel Dekhtyar bcf6077d68 Use third-person (this agent) instead of second-person (you) in the agent description (#61)
Changed the agent's description from second-person (you) to third-person (this agent).

I also fixed a couple of grammatical errors in the agent's instructions.
2025-04-13 12:15:19 +01:00
Polong Lin 2ccd53a3d9 fix: update gemini 2.0 flash to latest model id for Live API (#47)
* fix: update gemini 2.0 flash to latest model id for Live API

* fix: use -flash for most pages instead of the live api model

* fix: wording andformatting

* fix: resolve merge conflict
2025-04-13 11:50:57 +01:00
Kristopher Overholt d3cec829c9 Initial commit of Agent Development Kit 2025-04-09 08:49:23 -07:00