Commit Graph

165 Commits

Author SHA1 Message Date
Che af2fe64ebd Feat: Update docs for using MCP Tools with "adk-web" (#141)
* Update docs for using MCP Tools with "adk-web"

* Feat: Add examples with multiple MCP Servers in the same agent
2025-04-28 12:05:56 -04:00
Jainish-S 31754f8ade Fix: Added pos args where required (#124)
Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-04-25 15:58:27 -04:00
Lavi Nigam 79546252bf feat: Improve workflow agent examples (Loop, Parallel, Sequence) (#157)
* feat: Improve workflow agent examples (Loop, Parallel, Sequence)

This commit enhances the examples for LoopAgent, ParallelAgent, and SequenceAgent to provide clearer usage patterns, demonstrate key features, and improve developer experience.

Agent-Specific Fixes & Enhancements:

LoopAgent:

Adds an example demonstrating CheckCondition usage, showing both max_iterations and custom condition-based termination.
Fixes google/adk-docs#67, google/adk-docs#148, google/adk-python#315

ParallelAgent:

Adds an example showing how to merge outputs from parallel branches using a subsequent SequentialAgent and agent states.
Demonstrates state/output control after parallel execution.
Fixes google/adk-docs#142

SequenceAgent:

Clarifies the example to show explicit use of agent states within instructions for passing outputs between sequential steps.
Fixes google/adk-docs#150

General Example Improvements (Applied across all three):

Updated examples to use InMemoryRunner.
Adopted new, clearer instruction prompt templates.
Included runner.run_async calls in standalone .py files to demonstrate programmatic execution outside adk web.
Enhanced InMemoryRunner print output for better visibility of individual agent outputs during execution.
Added commented-out asyncio.run() calls in .py files for environments requiring explicit async loop management.
Included multiple example queries in .py files for testing.
Added "Part of agent.py -->" comment for easy copy-pasting into agent.py for use with adk web.
Added copyright and license headers for each file.

* fix: instructions for LoopAgent is cleaned up and removed backticks. Changed the init to include initial state in the ---8<

* feat(LoopAgent): add exit_loop tool for controlled exit

Introduces the `exit_loop` tool, enabling the agent to programmatically trigger an exit from its processing loop based on internal logic or tool usage.

fix(LoopAgent): correct state f-string formatting

Resolves runtime errors caused by incorrect f-string formatting when state variables were used within the agent's execution flow.

chore: Temporarily comment out session/runner setup

Comments out initialization code related to session, runner, and agent interaction for debugging/refactoring purposes. This section should be revisited.
2025-04-25 17:46:02 +05:30
Wietse Venema 77059a60d4 docs: Clarify ToolContext injection in docstrings (#161)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-24 20:11:14 -05:00
Kurtis Van Gent 962df91e5f chore: Update diagram for MCP Toolbox (#164)
* Update diagram for Toolbox

* chore: contextual commit

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-24 20:09:39 -05:00
Yeesian Ng c51c5b38e8 chore: Update deployment instructions for agent engine (#165)
* Update deployment instructions for agent engine

* docs: Update deployment instructions for agent engine
2025-04-24 20:07:20 -05:00
Kristopher Overholt 109e556bf9 fix: Update explanatory text in docs 2025-04-23 18:59:43 -05:00
Kristopher Overholt a1b4ef85bf Fix redirects and links for Safety and Security page (#153) 2025-04-23 14:11:00 -05:00
Mirko Montanari 0f773b6c53 fix: Rename responsible agents guide into a safety and security page. (#151)
The title of the section of "responsible agent" isn't appropriate for the content: this is a page about safey and security.
2025-04-23 13:23:38 -05:00
Lavi Nigam a4057576ea fix: tutorial section overhaul and bug fixes (#143)
* fix: tutorial section overhaul and bug fixes
- Tutorial section is moved out of getting started and is a seperate section
- Fixed a sentence in getting-started page that still showed “google search”
- Given we will have more tutorials as part of docs, now we have sub-sections with the tutorial name
- For weather agent team - fixed issues pointed out in #118 #135
    - It now includes code for asynio in the notebook
    - It also now has .py file to run it through adk web
    - Step 2 is now optional and not connected to other steps. So user can follow other steps if they choose to
    - There is disclaimer at the top - for different method to run the code
    - The text on the page is now synced with notebook
    - Collab and social link are updated with new changes in folder.

* added a redirect in the redirect_maps

* adding license headers in the code for tutorial for .py files
2025-04-23 09:43:32 +05:30
Wietse Venema 8b7c333f05 fix: remove reference to database package (#146)
Remove `pip install google-adk[database]`

sqlalchemy is already installed and this package does not exist.
2025-04-22 21:08:18 -05:00
Bhuvan Sawant 65b8cad3b3 fix: CSS Button issue on resizing window (google#96) (#130)
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-22 13:24:24 -05:00
Polong Lin 42af56bd1f feat: Add note on policy when using the built-in Google Search tool (#144)
* add link to A2A

* add A2A link w/o hyphens

* fixes: google/adk-python#221

* fix: add note to emphasize that only Gemini 2 is compatible w google_search tool
2025-04-22 13:03:46 -05:00
Lavi Nigam 7e0f29a9e8 parallel-agent-code-fix (#138) 2025-04-21 10:45:57 +05:30
Harsh Modi c8145cd845 fix: Quickstart (streaming): Correct the agent name in drop-down menu (#136) 2025-04-21 10:58:35 +09:00
Lavi Nigam d213440d30 callback-docs-fix (#132) 2025-04-20 08:40:21 +05:30
Priyanshu Vishwakarma a33e8d6287 fix: variable name in custom agents documentation (#125)
Update the variable name in `docs/agents/custom-agents.md`.

* Change the variable name to `GEMINI_2_FLASH` on line 114 to maintain consistency with example's code

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 23:25:39 -05:00
Hangfei Lin 83069beb3b Update mcp-tools.md (#128) 2025-04-18 23:14:33 -05:00
Kaz Sato 3958bb0007 fix: Quickstart (streaming): fix the SSL error for audio and video, and add Vertex AI support. (#123)
* Added Vertex AI support

* Added a fix for the audio and video SSL errors

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 05:27:15 -05:00
Jeremy Peters 83f4669ae3 Fix typo (#117) 2025-04-18 05:23:09 -05:00
nikkie 664ded3a3d docs: Fix init.py -> __init__.py (#114)
references

* https://google.github.io/adk-docs/get-started/quickstart/#__init__py
* https://github.com/google/adk-python/blob/v0.1.0/src/google/adk/cli/cli_tools_click.py#L111

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 05:21:06 -05:00
Kaz Sato af4ea1ae36 Added the full directory structure for the custom streaming app. (#113) 2025-04-18 13:18:48 +09:00
seanzhou1023 a6c699070b fix: Add user role in querying memory example (#116)
Co-authored-by: Sean Zhou <seanzhougoogle@google.com>
2025-04-17 16:35:18 -05:00
Mofi Rahman 72d782349c typo-fixes (#115)
Co-authored-by: Polong Lin <polong-lin@users.noreply.github.com>
2025-04-17 18:15:25 +01:00
Ian McKee ad0d42f5f7 Clarify documentation on multimodal model support (#107)
* Clarify documentation on multimodal model support

Multimodal inputs require specific supportedGenerationMethods to be included in the model details, bidiGenerateContent for audio/video, generateContent for text.

* update location

* add List method Documentation link
2025-04-17 16:16:52 +09:00
Remigiusz Samborski 258b81e927 Fix ToolContext imports (#101)
Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-16 20:01:35 -05:00
Laziz Turakulov 0e08c0619f Typo in print output (#103)
Typo in print output, as use uses "AGNET" instead of "AGENT"
2025-04-16 16:54:08 +01:00
Lavi Nigam 840a60aeff cloud-tool-render-issue (#99) 2025-04-16 15:22:22 +05:30
Ashley Henry 8e44b6d587 Update tutorial.md (#94) 2025-04-16 03:16:30 +00:00
Sita Lakshmi Sangameswaran 0c471902d3 fix(google-cloud-tools): reword intro (#90) 2025-04-15 18:13:28 -05:00
Saloni Juneja 6915eadd3d Update documentation for Application Integration Tools (#87)
* Update google-cloud-tools.md

* Add images for steps in create connector tool

* Update google-cloud-tools.md with images

* Update google-cloud-tools.md

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-15 11:39:21 -05:00
Didier Durand 06139e011b Update tutorial.md (#89) 2025-04-15 16:36:09 +00:00
Didier Durand 2c162d917f Update cloud-run.md: redundant words (#88)
Hi, 'in on' seems redundant: see commit diff.
I chose one ('in')  and removed the other ('on')
2025-04-15 10:29:59 -05:00
Kristopher Overholt b52288e22d Add social media preview cards (#84)
* Enable social cards

* Add image and meta tags for social media preview card

* Simpler approach for image-based preview
2025-04-15 00:12:13 -05:00
Selcuk Gun c48aa2a209 Update ollama related documentation (#82)
* Update ollama related documentation

* Additional fixes

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-14 22:51:34 -05:00
Kristopher Overholt 4a16c7de49 Initial commit of Community Resources page (#81)
* Initial commit of Community Resources page

* Updates
2025-04-14 22:38:25 -05:00
Mofi Rahman 91662f224c add instruction for deploying to gke (#74)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-14 14:38:18 -05:00
Didier Durand 04cf077961 Update quickstart.md: fixing 1 typo (#72)
Hi,
Just fixing 1 type: describe -> described.
See commit diff for all details
Didier

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-14 14:06:52 -05:00
Didier Durand eb340aacfc Update responsible-agents.md: fixing typo on constrain verb (#73)
Hi,
Just fixing  typo for verb to constrain spelled with superfluous 't'.

See commit diff for details.

Didier
2025-04-15 00:27:21 +05:30
Kristopher Overholt 9db23a018d Update headings and links on Google Cloud Tools page (#65)
* Fix link to Connection Tool, formatting and reflowing MD

* Rework ToC
2025-04-14 11:13:21 +00:00
sudeni 8c08374249 fix: The copy/paste is duplicated in quickstart.md (#70)
Removing the first one will help users understand.
2025-04-14 12:11:52 +01:00
sudeni a10224a251 Update google/adk-docs repository link (#69)
The original link was point to the site itself rather than the git repository.
2025-04-14 12:06:55 +01:00
Jack Wotherspoon 96e83f51d4 chore: update google-cloud-tools.md (#64) 2025-04-13 21:47:02 -05:00
Marco Lardera 90250a53d8 Fixing AgentTool imports (#59)
Import for the AgentTool class was incorrect

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-13 11:34:47 -05:00
Kristopher Overholt 6f8d5bacff Change local testing page to testing page; formatting fixes (#58) 2025-04-13 12:05:12 +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
Vincent Koc 8bee1b97bb docs: added third-party testing solutions (#43)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-13 01:37:01 -05:00
Mofi Rahman e8268d991c [WIP] gcloud cli instruction for cloud run deploy (#53)
* fix #52 gcloud cli instruction for cloud run deploy

* default to port 8080

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-13 01:32:11 -05:00
Alex H. Raber d1b1877bba docs: typo in deploy doc (#51)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-13 01:16:32 -05:00
Shifat Rahman 6a2b439b34 Create windows-installation.md (#49)
* Create windows-installation.md

* Update capitalisation

* Add note for Windows users, cleanup installation and quickstart pages

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-13 01:15:52 -05:00