This commit adds a new page to the documentation for the REST API, with
details about the `/run` and `/run_sse` endpoints.
A new file is created at `docs/api-reference/rest/index.md` and linked
from the main API reference page and the navigation bar.
Joe: Modified navigation ordering, and added information to point to REST API guide in Testing topic.
fixes#126
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>
* 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>
- Restructured callback design patterns with clear "Pattern Overview/Implementation/Example Use Case" sections
- Organized best practices into thematic categories (Design Principles, Error Handling, State Management, Reliability, Testing & Documentation)
- Converted dense bullet-point lists into more scannable, structured content
- Enhanced readability while maintaining all technical information and examples
- Applied consistent formatting patterns across all 8 design patterns
This makes the callback documentation easier to skim and absorb for developers learning ADK callback patterns.
Resolves#110
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
Wrong method is used for getting weather. Instead of `get_weather` it should be `get_weather_stateful`
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
Modified get_fast_api_app method parameters according to current code implementation
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
* fix: updated adk version to 1.10.0
fix: updated adk version to 1.10.0, and confirmed the demos work properly.
* fix: add session resumption
fix: add session resumption
* fix: adding session resumption to the docs.
fix: adding session resumption to the docs.
Matt Landers