Commit Graph

114 Commits

Author SHA1 Message Date
Toni Klopfenstein e0b5518886 moving go mcp_tool snippets to separate examples 2025-11-07 20:18:11 +00:00
Toni Klopfenstein 9443c54f4f Merge branch 'main' of github.com:google/adk-docs into tk-mcp-tools 2025-11-06 23:19:49 +00:00
Toni Klopfenstein bb6aa08be5 initial addition of Go snippets to mcp-tools docs 2025-11-06 23:19:16 +00:00
Ivan Cheung 5675b92a4f docs: Add MCP Toolbox for databases Go SDK Documentation (#895)
* docs: Add MCP Toolbox for databases Go SDK Documentation

* minor fix

* Moved into tabs

---------

Co-authored-by: Disha Prakash <dishaprakash@google.com>
Co-authored-by: ivanmkc <ivanmkc@google.com>
2025-11-06 16:48:23 -05:00
Joe Fernandez 37fee2598d docs: Tools, update language order, part3 (#896) 2025-11-06 13:13:18 -08:00
Kristopher Overholt e573d96b7b Fix link to MCP tools from Tools page (#890)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-11-06 12:09:43 -08:00
Ivan Cheung 8834593806 [ADK Go] Merging all Go docs from the private repo (#885)
* docs: Add Go language quickstart

* updates based on review comments

* fix tab stops

* update based on review comments

* sync with main

* update to tested version

* Added google_search snippet

* Fix: Address Go style guide issues in google_search.go

* Migrated to new API

* Fixed tool info in md file

* Added partial check

* Added function-tools sample

* Migrated to new API

* Added partial check

* Ran linter

* feat: add go fmt check

* Run go fmt only on changed files

* Added google_search snippet

* Fix: Address Go style guide issues in google_search.go

* Migrated to new API

* Added partial check

* Added function-tools sample

* Migrated to new API

* Added partial check

* Ran linter

* feat: add go fmt check

* Run go fmt only on changed files

* Feat: Add Golang example for LLM agents

* Added schema agent

* Added session support

* Migrated to new API

* Added back OutputKey

* Added missing snippets

* Moved snipped to its own package

* Minor cleanup

* Reverted llm-agents.md

* Added back correct changes to llm-agents.md

* Updated to newest API

* Ran linter

* WIP

* WIP: Added the rest of the agents

* Added sequential agent

* Migrated agents to new API

* Fixed snippet tags

* Updated parallel and sequential with OutputKey

* Updated loop agent

* Cleanup

* Fixed and ran linter

* Removed comment

* Ran linter

* Added custom agent snippets

* Migrated to new API

* Fixed incorrect info about channels since run returns an Iterator, not Channel

* Cleanup and renaming

* Ran linter

* Fixed md

* Added multi-agent docs

* Updated to use AgentTool

* Split snippets

* Added missing file

* Ran linter and fixed API

* Added Models snippets

* Migrated to new API

* Embedded imports

* Ran linter

* Added long running tool

* Ran linter and fixed API

* Switched to two-turn style

* Ran linter

* Added callback snippets

* Added back imports

* Added types of callbacks snippets

* feat(go): align callback snippets with other languages

* Ran linter and updated API

* Added tool callbacks

* Added artifact snippets

* Use story.pdf instead of random bytes

* Fixed issue with artifact loading

* Cleanup unneeded fixes

* Added back inadvertently removed GCS section

* Addressed PR comments

* Ran linter

* feat: Added context snippets

* Fixed callback signature

* Fixed additional callbacks

* Added remaining snippets

* Added conceptual runner example

* Removed duplicate code

* Clean up tags and imports

* Updated API

* Twaked text

* Ran linter

* Fixed broken API issues

* Updated to latest Go ADK API

* Added func param info

* Interleaved Py and Go

* Revert mistakes

* Removed extra newline

* Added example cloud run code and update md with Go (#41)

* Added example cloud run code and update md with Go

* Added a2a_agent_url and fixed future tense

* Moved Go before Java

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding go snippets to runconfig docs

* realigning runconfig go examples with current state of adk-go.

* adding language support tags to individual runtime config fields

* removing unsupported supportcfc go examples

* removing unsupported streamingmode.bidi go snippets

* Added AgentTool examples (#31)

* Added AgentTool example

* Ran formatter

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding initial go sessions.sessions snippets

* updating go session docs + session examples

* update go session snippets

* updating DatabaseSessionService language support tag

* cleaning up go vertex ai comments

* removing go.mod for session_management_example

* docs: add language support tags for Go

* initial go runtime sample updates

* fixing runtime go snippet formatting

* formatting updates to runtime go snippets

* updating runtime go examples to streamline to newer go features

* adding go snippets for events

* updating go snippets for events

* adding artifactdelta snippet for go

* minor java fixes, cleaning up go event.content

* Custom tools: Merging again  (#44)

* Added missing custom-tools snippets

* Split user_preference runner code

* Split more files

* Tweaks

* Split session into 1 and 2 and added artifact saving

* Fixed conflict

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Fixed tab issue with cloud-run md (#45)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding initial go snippets for memory services

* updating go memory sample, adding python formatting in docs to clarify current support.

* removing go replace for memory example

* removing go.sum from memory_example

* fixing go formatting for memory example

* fixing go memory snippets to streamline examples in docs

* removing unnecessary go.mod for memory_example.go and snippet cleanup

* adding go session state snippets."

* adding additional go state examples for state injection

* fixing go formatting

* fixing language ordering on session/state.md; removing unnecessary go.mod files

* reworking error functions in go session state samples

* fixing go formatting on session state samples

* initial go snippets for safety tools

* fixing go snippet formatting in safety/index.md

* temp storing safety example

* cleaning up go snippets in safety docs; deferring safety go full example

* cleaning up go safety snippets

* Added link to Go API docs (#47)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added a2a_basic sample (#46)

* Added a2a_basic sample

* Removed dummy LLMs

* Added md

Fix inaccuracies in md

Ran formatter

* Cleaned up index

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Reverted to proper ToC and added missing links (#48)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added missing get-started/go.md (#50)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added missing JSON tags for Go structs (#51)

* Added json tags

* Added jsonschema and json tags

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Renamed Golang to Go (#52)

Co-authored-by: ivanmkc <ivanmkc@google.com>

---------

Co-authored-by: Joe Fernandez <joefernandez@google.com>
Co-authored-by: ivanmkc <ivanmkc@google.com>
Co-authored-by: Toni Klopfenstein <tklopfenstein@google.com>
2025-11-06 14:13:13 -05:00
Kristopher Overholt b9a06b8558 Add Tavily to third-party tools page (#860)
* Add page for Tavily tool

* Add to sidebar nav

* Update

* Fix links

* Fix heading

* Update mkdocs config / nav

* Add listing to tools page

* Add example usage and available tools

* Add screenshot

* Add left and right padding to tool cards

* Edits to Tavily page

* Update tool descriptions
2025-11-04 18:59:22 -06:00
Kristopher Overholt 7a918e48ad Add Browserbase to third-party tools page (#861)
* Add page for Browserbase tool

* Set links to relative for staging preview

* Update fields

* Add to sidebar nav

* Add to tools listing page

* Fix table width

* Shorten link text
2025-11-04 18:39:16 -06:00
Kristopher Overholt 507e5e353b Hide ToC on 3P tools listing page (#843)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-11-04 09:57:44 -08:00
Joe Fernandez f12068a4bb docs: add language support tags to pages (#850)
* docs: add language support tags to pages

- replace img.shield tags
- add language support tags where missing

* update Agents page with general tags

* update language and version tagging

- response to review comments
- rename css styles to avoid style name conflicts

* add tags to api-server page
2025-11-03 16:07:35 -08:00
Kristopher Overholt 243794ea13 Add Notion to third-party tools page (#847) 2025-11-03 10:49:27 -06:00
Kristopher Overholt 18ac8db444 Add Exa to third-party tools (#842)
* Add page for Exa tool

* Add card and fix link

* Fix image link

* Fix absolute link
2025-10-31 11:38:01 -05:00
Kristopher Overholt ac968aff44 Refactor 3P tool wrappers (#837)
* Refactor third-party tools pages

* Remove 3P tool wrapper references

* Update mkdocs.yml - redirect old page locations

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-10-31 09:23:26 -07:00
Kristopher Overholt 9b457dc319 Add Firecrawl to third-party tools (#839)
* Add Firecrawl tools page

* Add abolute path

* Python code samples

* Update icon and cards

* Update Firecrawl page content

* Update nav

* Fix image link

* Other cleanup

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-10-31 09:14:01 -07:00
Joe Fernandez ffdae95fb6 docs: move AG-UI into third party tools for better discovery (#835) 2025-10-29 11:14:32 -07:00
Joe Fernandez 17505eee3f docs: moving MCP Toolbox tool to separate page (#831)
* docs: moving MCP Toolbox tool to separate page

* updated docs link on MCP page
2025-10-28 12:15:28 -07:00
Kristopher Overholt dd6bd99e1b feat: Add initial third-party tools pages, rework tool wrapper pages (#811)
* Add 3P tools pages

* Move OpenAPI tools to custom tools

* Add cards for 3P tools, reorg wrappers

* Fix links to wrapper pages

* Update nav

* Add 3P tools icons

* Fix post-conflict merge

* Remove redundant headings

* Reword header

* Move 3P tools pages in nav; move OpenAPI tools file and in nav

* Update redirect paths, add back openapi-tools page
2025-10-28 12:27:05 -05:00
adk-bot b139235658 Update ADK doc according to issue #796 - 2 (#800)
* docs: Add documentation for ComputerUseToolset

* docs: update Computer Use Toolset docs draft

* furhter updates

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@google.com>
2025-10-27 10:31:15 -07:00
Joe Fernandez dd94c28c9d docs: Add Code Execution with Agent Engine tool (#810)
* docs: Add Code Execution with Agent Engine tool

* update final version base on comments
2025-10-23 12:56:01 -07:00
Xuan Yang f51bdf129b docs: add the information about the workaround added in ADK python to bypass the multi tools limitation for GoogleSearchTool and VertexAiSearchTool (#772)
* docs: add the information about the workaround added in ADK python to bypass the multi tools limitation for `GoogleSearchTool` and `VertexAiSearchTool`

* Add `bypass_multi_tools_limit` info for workaround in `GoogleSearchTool` and `VertexAiSearchTool`
2025-10-22 15:14:39 -07:00
Joe Fernandez d68f5587db docs: Add Resume feature notes to affected features: (#790)
* docs: Add Resume feature notes to affected features:

- authentication
- confirmation
- long running functions

* Update authentication.md

* Update confirmation.md

* Update function-tools.md
2025-10-22 15:07:42 -07:00
Kristopher Overholt 8b15da2477 feat: Add visual cards to Tools page (#789)
* Add cards to Tools page

* Use relative links

* Fix absolute links

* Add newlines to card code

* Readd file
2025-10-22 16:55:07 -05:00
Joe Fernandez 42d2aafbfb docs: put third party tools in /tools/third-party/ (#788)
- restructuring for future updates
2025-10-20 12:54:23 -07:00
Joe Fernandez 340a2fb03a docs: Add ADK Tools list to docs (#781)
* docs: Add ADK Tools list to docs

* docs: Update Plugins page (#780)

Add links to code examples, fix repetition of tips

* Update docs/tools/list.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/tools/list.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* docs: Update Python API Reference to v1.16 release (#782)

* Update mkdocs.yml

* docs: reconfigure tools to emphasize pre-built tool

- added new tools listing page
- created separate directory for custom tool dev

* fix MCP Toolbox name

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-10-17 13:01:00 -07:00
Anubhav Dhawan f07a60dbc2 docs: add datasource links and update MCP Toolbox sources list (#779)
* docs: add deep links to MCP Toolbox supported datasources

* docs: add datasources list to Google Cloud Tools page
2025-10-15 09:24:49 -05:00
Kristopher Overholt c92ab3bf91 fix: Remove link and other cleanup in Application Integration Tools section (#730)
* fix: Remove link and other cleanup for Application Integration Tools section

* Formatting

* Rework video link and add embed

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-10-06 13:58:30 -07:00
abiramit5 f156c327d1 Update google-cloud-tools.md (#729) 2025-10-01 09:45:18 -07:00
Joe Fernandez ad094d9da4 Update ADK doc according to issue #689 - 3 (#723)
* Update ADK doc according to issue #689 - 3

* docs: add more detail to GKE Code Executor docs
2025-09-30 16:54:14 -07:00
Joe Fernandez 22d8e804c4 Update ADK doc according to issue #689 - 5 (#705)
* Update ADK doc for BigQuery forecast tool

* Update agent changes, roll back code sample changes
2025-09-30 16:53:42 -07:00
An Nguyen 8b4609cace Add Bigtable documentation (#725) 2025-09-29 09:04:08 -07:00
tianbowen-google c5db8cd97c docs: document spanner built-in toolset (#710) 2025-09-23 15:13:22 -07:00
Joe Fernandez 5a26f82b48 docs: update Long Running Function warning (#693)
* docs: Long Run Function, add warning and clarification

* docs: update Long Run Function warning
2025-09-12 14:01:04 -07:00
Joe Fernandez 26ec3ebcc7 docs: Long Run Function, add warning and clarification (#692) 2025-09-12 11:36:11 -07:00
Shubham Saboo cde55532f5 docs: updated built-in tools to standardize AgentTool call (#510)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-10 15:33:14 -07:00
Nagaaki Hoshi 1facb7b6a0 fix: Modify wrong IAM roles (#678)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-10 08:38:25 -07:00
David Liu 8f472eaf82 Update google-cloud-tools.md (#661)
fix missing object reference due name conflict

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-10 08:37:08 -07:00
Holt Skinner af2ee80fde docs: Fix formatting/spelling errors in Docs (#676)
* docs: Update formatting of logging information

- Remove duplicates

* Fix formatting/spelling issues in Express Mode page

* Fix code formatting

* Rename "Google Cloud's" -> Google Cloud per branding guidelines

* Spelling fix on A2A

* Formatting fixes in a2a consuming

* Fix typo/formatting error on API Reference homepage

* Remove custom anchors in CONTRIBUTING.md because GFM doesn't support them

* Add imports to A2A Samples and update agent.json to agent-card.json

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-10 08:18:12 -07:00
Joe Fernandez 653640ba92 docs: Add Tool Confirmation feature (#681) 2025-09-09 16:08:39 -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
Joe Fernandez 3ca044fccb docs: Re-add GKE Code Executor tool doc (#677)
* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* docs: Re-add GKE Code Executor tool doc

- from: https://github.com/google/adk-docs/pull/621

---------

Co-authored-by: Summer <xiaotongyang@google.com>
2025-09-08 13:59: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
Nagaaki Hoshi 1283a89e09 docs: remove redundant sentence for improved clarity (#641)
* docs: fix duplicate sentense

* docs: No longer needs `also`

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-03 10:45:59 -07:00
Andrew Ginns 62148fc1c5 refactor: update MCP examples to use StdioConnectionParams (#457)
* refactor: swap to StdioConnectionParams

  - Fix import path to avoid ImportError
  - Changed from StdioServerParameters to StdioConnectionParams as recommended.

* fix: Re-modify imports for MCP config libraries

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:34:59 -07:00
Joe Fernandez c73e113b7b feat: Add docs for tool parallel execution (#651) 2025-08-26 15:44:02 -07:00
Joe Fernandez c9bfba286c Revert "feat(code_executors): Add GkeCodeExecutor for sandboxed execution on …" (#650)
This reverts commit 050c05156c.
2025-08-26 11:35:03 -07:00
Cameron 42c2faaa3a fix: update broken authenticated tool helper (#599)
* fix: update broken authenticated tool helper

* fix: Update invalid auth config argument reference in helpers

* fix: Incorrect code example for `get_auth_config`

`auth_request_function_call`'s args values are dictionaries, meaning it will never be an instance of AuthConfig by default
2025-08-21 14:29:16 -07:00
google-labs-jules[bot] 9d918512ac fix: docs clarify temp namespace (#612)
This commit clarifies the behavior of the `temp:` namespace in the documentation.

The following changes were made:
- Updated `docs/sessions/state.md` to provide a more detailed explanation of the `temp:` namespace.
- Updated `docs/context/index.md` to improve the clarity of an example related to passing data between tools.
- Updated `docs/runtime/index.md` to add a note about the scope of `temp:` variables.
- Updated `docs/agents/multi-agents.md` and `docs/agents/workflow-agents/sequential-agents.md` to clarify how the `temp:` namespace is propagated to sub-agents.
- Updated `docs/tools/function-tools.md` to explain how to use the `temp:` namespace to pass data between tool calls.

fixes #160

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-19 16:53:08 +00:00
Summer 050c05156c feat(code_executors): Add GkeCodeExecutor for sandboxed execution on GKE (#621)
* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 09:42:18 -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