Commit Graph

1158 Commits

Author SHA1 Message Date
Kaz Sato 374c02d004 feat: add MCP section (#195)
* Adding new MCP section

* fixed file path

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-30 00:48:17 -05:00
Matt Landers 3794147f77 fix: Instruction Templating Documentation (#178)
* Add State to LLM Instructions

* Update llm-agents.md

* fix: Added documentation for instruction templating

* Formatting fixes

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-30 00:32:13 -05:00
hsuyuming 158013b64b fix: the ParallelAgent execute run_async instead of run() base on this line [1]. (#190)
[1]https://github.com/google/adk-python/blob/main/src/google/adk/agents/parallel_agent.py#L94

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-30 00:13:26 -05:00
hsuyuming d3bd474488 docs: ancestor agent have to associate with a model. (#194)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-30 00:10:33 -05:00
Kavin Kumar B 96f42d2432 docs: Runconfig documentation (#186)
* docs: Runconfig documentation

* Updates

* Updates

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2025-04-30 00:03:14 -05:00
Yeesian Ng 4a388b81b2 docs: Add details on deploying and managing agents in agent engine (#193) 2025-04-29 15:50:58 -05:00
alan blount a28eb81f05 Update google-cloud-tools.md (#188)
Change formatting to correctly style the shell command, and added variable placeholder.
2025-04-28 15:22:58 -05:00
seanzhou1023 dabaf948d4 fix: update authentication doc to correct some error and keep it consistent with latest codes (#184)
* fix: update authentication doc to correct some error and keep it consistent with latest codes

* Update docs/tools/authentication.md

---------

Co-authored-by: Sean Zhou <seanzhougoogle@google.com>
Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-04-28 12:11:33 -04:00
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
nikkie 46b774fd36 fix: typo in youtube-shorts-assistant scriptwriter instruction (#175)
Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-04-25 16:00:04 -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
hsuyuming 574668c452 fix: add missing .txt within "Install dependencies" step (#168)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-24 20:08:16 -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
Alok Pattani d4452bf1ef Update small temp error in sample agent.py (#162) 2025-04-24 15:42:13 -05:00
Kristopher Overholt 3ce9085699 Update README 2025-04-23 19:01:23 -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
Kristopher Overholt af9d0a8a15 Fix redirect for old tutorial page (#147) 2025-04-22 23:34:46 -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
Sita Lakshmi Sangameswaran 5ce661de6c samples: add a sample getting started agent (#108)
* samples: add a sample getting started agent

* format acc to review comments

* add copyright headers

---------

Co-authored-by: Sampath Kumar <sam1990kumar@gmail.com>
2025-04-22 10:40:52 -04:00
Polong Lin ca0c6e56a4 feat: add A2A link on main page (#140)
* add link to A2A

* add A2A link w/o hyphens
2025-04-21 11:34:40 -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
Sampath Kumar 477c780dc0 feat: add header-checker-lint.yml (#122)
Add config file for header-checker-lint.yml to limit checking for python files

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 05:24:20 -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
Sampath Kumar f6f9850b6e feat: add dev guidance steps to CONTRIBUTING.md (#121)
Add steps to setup a local mkdocs server to easy docs development & verification

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 05:18:17 -05:00
Sampath Kumar a242ad1bc4 feat: add footer navigation (#119)
Add footer navigation (next, previous) pages for easy page scrolling

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-18 05:15:41 -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
Sita Lakshmi Sangameswaran 89f02777ff fix(loop-agent): update max_iterations param (#106) 2025-04-16 20:01:05 -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
alan blount a7a7776df4 Add llms.txt to docs repo (#78)
This is a quick and easy attempt at delivering a llms.txt file.

code2prompt \
  -p "README.md" \
  -p "docs" \
  -p "examples" \
  -f "*.md,*.py" \
  -e "api_reference,*.json,*.txt,*.js" \
  -o "full_repo.md"

llm -m gemini-2.5-pro-exp-03-25 \
  'You are an expert technical writer.  Review this complete website, and return a comprehensive summary of the content. Provide a high level summary and then a complete and detailed cheatsheet covering all the details, optimized for LLM ingestion, in markdown format.' \
  -a "full_repo.md" \
  --no-stream \
  > llms.txt

Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-04-16 15:39:44 +05:30
Lavi Nigam 840a60aeff cloud-tool-render-issue (#99) 2025-04-16 15:22:22 +05:30
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
Ashley Henry c46538db2c Update mkdocs.yml (#95) 2025-04-15 23:07:52 -05:00