Commit Graph

27 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
Joe Fernandez 37fee2598d docs: Tools, update language order, part3 (#896) 2025-11-06 13:13:18 -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
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 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
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
Aaron Wanjala 58998675c1 Update mcp-tools.md (#283)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:43:20 -07:00
sfkrieger 8e4f503680 fix(mcp-deployment): Add comprehensive MCP deployment documentation (#594)
* Add comprehensive MCP deployment documentation

- Add detailed deployment section for ADK agents with MCP tools
- Document critical synchronous agent definition requirement for deployment
- Cover three deployment patterns: self-contained stdio, remote SSE/HTTP, and sidecar containers
- Include production deployment checklist with security, monitoring, and scalability considerations
- Provide environment-specific configurations for Cloud Run, GKE, and Vertex AI Agent Engine
- Add troubleshooting guide for common MCP deployment issues
- Include quick deployment commands for Agent Engine and Cloud Run

Addresses deployment challenges outlined in issue #327 where async MCP toolset creation
is no longer supported in deployment environments.

Fixes #327

* Replace SSE/HTTP with Streamable HTTP implementation in MCP Pattern 2

- Update Pattern 2 deployment example to use StreamableHTTPSessionManager
- Replace basic SSE server code with comprehensive Streamable HTTP implementation
- Add production-ready features: stateless mode, ASGI compliance, lifecycle management
- Include Starlette application setup with proper error handling
2025-08-14 18:13:42 +00:00
shruti-mantri 752a30c85b fix: correct the usage of StdioServerParameters (#555)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-05 10:27:08 -07:00
shruti-mantri 3954da4e1c fix: correct the examples of locally hosted mcp servers (#551)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-01 08:14:15 -07:00
shruti-mantri 3e53fb7eb1 docs: change ServerParams to ConnectionParams (#548) 2025-07-31 19:40:18 +05:30
Aslam Anver b7a0478a93 Fix: Use correct variable and imports (#421)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-06-20 11:25:18 -05:00
Lavi Nigam 6e175eff43 [PR fixes]This PR is trying to fix multiple old PRs. Due to merge conflicts, we are doing all those small changes in this PR. Each changes are listed below: (#342)
- #254 docs/sessions/session.md -> …part of session object's identification.
In the session object identification description, it was unclear (for first time readers), what exactly is id, and app_name and how they are different. Added some examples according to my own understanding. Please change accordingly if you feel so. Thanks.

- #252 Multiple files: quickstart-streaming.md,  quickstart.md, mcp-tools.md
add an option in the CLI to enable or disable the reload feature. So users(esp. windows) can disable this if they come across the '_make_subprocess_transport NotImplementedError' bug on windows.

- #179 docs/agents/models.md -> Add Windows Encoding Note for LiteLLM
When using ADK agents with LiteLlm on Windows, users might encounter a UnicodeDecodeError: 'charmap' codec can't decode byte... error. This often happens when litellm (used by LiteLlm) tries to read cached files (like model pricing information) using the default Windows encoding (cp1252) instead of UTF-8.

- #170 docs/tools/mcp-tools.md  fix: update ADK setup link and add .env file location note in MCPTools.
Also resolved the issue: #169
2025-05-30 19:49:41 +05:30
Samyukta Hariharan d32aec182d Fix: #310 Fix code in documentation for using MCPToolset out of ADK (#312)
* Fix #310

* Target folder path clearly defined

* addding import os

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-05-29 21:27:43 +05:30
Kristopher Overholt 77c93e2158 fix: Minor edits to style and formatting on MCP and quickstart pages (#293) 2025-05-21 17:10:59 -05:00
Megan O'Keefe 0887973bed feat: Initializes Java documentation (#277) 2025-05-20 12:10:27 -04:00
Jiao, Hsu dd7fe93b27 fix(docs): add missing URL to [setup]() link in MCP Tools section (#261)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-05-16 22:43:35 -05:00
Preston Holmes 35e0021030 fix: Minor cleanup to FastMCP sample (#225)
* Add missing import to FastMCP sample

Missing the import from contextlib

* Remove unneeded SseServerParams

These did not cause errors, but are not required or used by the library

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-05-07 08:23:54 -05:00
Andrey Shakirov 63ede24a05 docs: Added FastMCP example (#202)
* Added FastMCP example

* FastMCP example

* updated GCP project id
2025-05-01 05:15:32 +09:00
Kristopher Overholt b6298ed801 fix: Update links to screenshots on MCP tools page (#199) 2025-04-30 08:46:15 -05:00
Kaz Sato ef4d230e17 feat: Add MCP Toolbox for Databases to the MCP section (#198)
* Add MCP Toolbox for Databases to the MCP section

* Formatting

---------

Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-04-30 07:34:05 -05: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
Hangfei Lin 83069beb3b Update mcp-tools.md (#128) 2025-04-18 23:14:33 -05: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