Commit Graph

94 Commits

Author SHA1 Message Date
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
Mandy Chan 6afd0d37ba fix: Update agent.py (#611)
Fixes #176 

Use AgentTool for subagents
2025-08-14 18:49:53 -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
Anthony Z 8400336372 feat: Update express mode code sample (#494)
* Update quickstart.md

* Create express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update mkdocs.yml

* Update mkdocs.yml

* Update session.md

* Update mkdocs.yml

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update quickstart.md

* Update express-mode.md

* Add files via upload

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

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

* Add files via upload

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

* Add files via upload

* Update express-mode-weather-agent.ipynb

* Update quickstart.md

* Update express-mode.md

* Update express-mode.md

* Update mkdocs.yml

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

* Add files via upload

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update mkdocs.yml

* Update express-mode.md

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-07-11 14:51:52 +05:30
Anthony Z 19a026393e feat(docs): Add vertex express mode documentation for Agent Engine (#439)
* Update quickstart.md

* Create express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update mkdocs.yml

* Update mkdocs.yml

* Update session.md

* Update mkdocs.yml

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

* Update quickstart.md

* Update express-mode.md

* Add files via upload

* Update express-mode.md

* Update express-mode.md

* Update express-mode.md

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

* Add files via upload

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

* Add files via upload

* Update express-mode-weather-agent.ipynb

* Update quickstart.md

* Update express-mode.md

* Update express-mode.md

* Update mkdocs.yml

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-07-08 17:58:29 +05:30