Skip to content

docs: python toolbox-adk sdk doc migration#2409

Open
rapid-killer-9 wants to merge 4 commits intopy-sdk-docsfrom
docs-py-sdk-adk
Open

docs: python toolbox-adk sdk doc migration#2409
rapid-killer-9 wants to merge 4 commits intopy-sdk-docsfrom
docs-py-sdk-adk

Conversation

@rapid-killer-9
Copy link
Member

@rapid-killer-9 rapid-killer-9 commented Feb 3, 2026

This PR migrates the toolbox-adk Python SDK documentation to the main documentation site. It ensures all technical guides and references are centralized and up-to-date with the latest project standards.  

Key Changes

  • Documentation Migration: Ported comprehensive content from the Python SDK repository to the main docsite, covering installation, basic usage, and advanced configurations.  

  • Compatibility Updates: Updated the documentation to support the current Hugo version used by the site.  

  • Model Update: Updated all Gemini model references to Gemini 3 Preview to align with the latest SDK capabilities.  

  • Content Enhancement: Added detailed guides for:

  • Transport Protocols: Documentation on supported transport protocols, including Model Context Protocol (MCP) and native Toolbox HTTP.

  • Authentication Strategies: Extensive coverage of various authentication methods using CredentialStrategy, such as Workload Identity, OAuth2, API keys, and manual credentials.

  • Advanced Configuration: Outlined options for adding custom headers, global parameter binding, and implementing pre_hook and post_hook functions for tool invocation.

@rapid-killer-9 rapid-killer-9 requested a review from a team as a code owner February 3, 2026 06:34
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @rapid-killer-9, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces comprehensive documentation for the toolbox-adk Python SDK, detailing its integration with ADK agents. The new documentation covers essential aspects from installation and basic usage to advanced topics like transport protocols, diverse authentication strategies, and sophisticated configuration options, ensuring developers have a clear guide for utilizing the SDK.

Highlights

  • New Documentation Added: A comprehensive documentation page for the toolbox-adk Python SDK has been added, detailing its features and usage.
  • Installation and Basic Usage: The documentation includes instructions for installing toolbox-adk and examples for basic usage of the ToolboxToolset with ADK agents.
  • Transport Protocols: Details on supported transport protocols, including Model Context Protocol (MCP) and native Toolbox HTTP, are now documented.
  • Authentication Strategies: An extensive section covers various authentication methods using CredentialStrategy, such as Workload Identity, OAuth2, API keys, and manual credentials.
  • Advanced Configuration: The documentation outlines advanced configuration options, including adding custom headers, global parameter binding, and implementing pre_hook and post_hook functions for tool invocation.
Changelog
  • docs/en/sdks/python-sdk/adk/index.md
    • Added a new documentation file for the toolbox-adk Python SDK.
    • The new file provides an overview, installation guide, usage examples, and detailed sections on transport protocols, authentication, and advanced configuration.
Activity
  • No specific activity (comments, reviews, progress updates) has been recorded for this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds comprehensive documentation for the toolbox-adk Python SDK, covering installation, usage, authentication, and advanced configuration. The new documentation is well-structured and detailed.

I have one suggestion for improvement in the new documentation file to enhance clarity.

Additionally, I have a couple of general points:

  • The pull request title is docs: python toolbox-llamaindex sdk doc migration, but the changes are for toolbox-adk. It would be helpful to update the title to accurately reflect the content.
  • The new documentation page for toolbox-adk is added, but the main Python SDK index page at docs/en/sdks/python-sdk/_index.md is not updated to include toolbox-adk in its table of packages. This could make the new documentation less discoverable. Consider updating the table as part of this PR.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 3, 2026

@github-actions
Copy link
Contributor

github-actions bot commented Feb 3, 2026

@rapid-killer-9 rapid-killer-9 changed the title docs: python toolbox-llamaindex sdk doc migration docs: python toolbox-adk sdk doc migration Feb 3, 2026
@github-actions
Copy link
Contributor

@github-actions
Copy link
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants