* 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
The `lookup_order_status` example in the tool documentation was using the `status` field to represent both the tool's execution outcome and the business-level order status. This is ambiguous and can be confusing for the LLM.
This change refactors the example to use a dedicated `status` field for the execution outcome (`success`/`error`) and nests the order-specific data in a separate `order` dictionary. This aligns with best practices for tool design and improves clarity.
Fixes#530
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>
* Update "Application Integration Tools" in google-cloud-tools.md
- Fixed b/425843277 and b/427619667 bugs.
* Added required IAM roles in the prerequites with a note, linked them in subsections
* Replaced service-account-credentials with service-account json
- Fixed grammar and structure throughout the document.
* Update google-cloud-tools.md
* Update google-cloud-tools.md
* Update google-cloud-tools.md
The LRO (Long-Running Operation) and HTIL (Human-in-the-Loop) tools were failing to execute properly due to an unhandled promise.
The `session_service.create_session` method is asynchronous but was not being awaited, causing race conditions. This change adds the required `await` to ensure proper execution flow.
Additionally, the related documentation has been updated to reflect the corrected code.
- #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
* Update authentication.md
Fix an example code that refers to undefined variables.
* Update authentication.md
use client_id and client_secret stored in auth_credential.
* Update authentication.md
Add missing imports
* Update authentication.md
Update for the latest auth lib.
---------
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
* 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>
* 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>
Matt Landers