Skip to content

Update ADK doc according to issue #1227 - 4 - Toolset Authentication - #1234

Closed
adk-bot wants to merge 1 commit into
mainfrom
agent-changes-20260205-185815
Closed

adk-bot wants to merge 1 commit into
mainfrom
agent-changes-20260205-185815

Conversation

@adk-bot

@adk-bot adk-bot commented Feb 5, 2026 •

Copy link
Copy Markdown
Collaborator
  • Add a new section or update "Journey 1" to explain "Toolset Authentication".
  • Explain that BaseLlmFlow now automatically checks BaseToolset.get_auth_config() before tools are listed or executed.
  • If credentials are missing, the framework pauses execution and issues an adk_request_credential event, just like in the tool-level auth flow.
  • This allows toolsets to define auth requirements centrally and have them resolved proactively.

@joefernandez joefernandez changed the title Update ADK doc according to issue #1227 - 4 Update ADK doc according to issue #1227 - 4 - Toolset Authentication Feb 5, 2026
@zyantw zyantw self-assigned this Jul 29, 2026
@zyantw

zyantw commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Closing with #2138

@zyantw zyantw closed this Sep 2, 2026
zyantw added a commit to zyantw/adk-docs that referenced this pull request Sep 24, 2026
This PR consolidates several pending documentation updates into a unified, restructured `mcp-tools.md` guide. It improves the Information Architecture (IA) by grouping deployment, authentication, and transport types. Grounds abstract concepts with concrete, production-ready code examples.

-  Key Improvements
* **Feature Completeness:** Integrated documentation for MCP Resources, Experimental UI Widgets, and Connection Timeouts.
* **Technical Accuracy:** Standardized authentication examples to use native ADK parameters (`AuthScheme`, `AuthCredential`) instead of manual headers. Corrected Cloud Run transport examples to utilize `StreamableHTTPConnectionParams`.
* **Better UX & IA:** Replaced text-heavy descriptions with Mermaid sequence diagrams (e.g., UI rendering flow). Elevated critical deployment requirements (like absolute paths and environment-aware connections) for better scannability.

---

## PR Consolidation Mapping

The following table maps the specific lines from the previous disparate PRs to their new homes in the revamped draft:

| PR Reference | Original Lines (PR) | New Lines (Draft) | Change Description |
| :--- | :--- | :--- | :--- |
| **google#1234** | 49-74 | 343-436 | Added **Accessing MCP Resources** section, detailing how to use `list_resources()` and `read_resource(name)`. |
| **google#1443** | 51 | 472-509 | Added **Experimental UI Rendering** section, including the Mermaid sequence diagram and code examples for `meta.ui.resourceUri`. |
| **google#1188 & google#1186** | 43 | 93-100 | Integrated connection timeouts (`timeout`, `sse_read_timeout`) into `StreamableHTTPConnectionParams` for production stability. |

## Review Notes
All code snippets have been verified for consistency with Jetski. The environment-aware transport selector now correctly branches between `StdioConnectionParams` (local) and `StreamableHTTPConnectionParams` (production).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants