Skip to content

docs: python toolbox-core sdk doc migration #2166

Merged
rapid-killer-9 merged 12 commits intopy-sdk-docsfrom
docs-py-sdk-core
Feb 23, 2026
Merged

docs: python toolbox-core sdk doc migration #2166
rapid-killer-9 merged 12 commits intopy-sdk-docsfrom
docs-py-sdk-core

Conversation

@rapid-killer-9
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 commented Dec 12, 2025

This PR migrates the toolbox-core 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, setup, and core features.  

  • 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:

  • SDK Usage and Quickstart: Clear instructions for installation and minimal examples for both asynchronous and synchronous operations.  

  • Authentication Mechanisms: Guidance for client-to-server authentication (e.g., Cloud Run) and per-tool authentication using ID token retriever functions.  

  • Advanced Features: Detailed explanations on binding parameter values to tools, either statically or dynamically.  

  • Framework Integration: Practical integration examples with frameworks such as LangGraph.

@rapid-killer-9 rapid-killer-9 added the type: docs Improvement to the documentation for an API. label Dec 12, 2025
@gemini-code-assist
Copy link
Copy Markdown
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 a new, detailed documentation page for the toolbox-core Python SDK. The documentation aims to provide users with a clear understanding of how to install, configure, and effectively utilize the SDK to interact with the MCP Toolbox service. It covers essential topics such as asynchronous and synchronous operations, various authentication methods, and advanced functionalities like parameter binding and integration with AI frameworks like LangGraph, ensuring developers can quickly get started and leverage the SDK's full potential.

Highlights

  • New Documentation Page: A comprehensive documentation page for the toolbox-core Python SDK has been added, covering its features and usage.
  • SDK Usage and Quickstart: The documentation includes installation instructions, a quickstart guide with minimal examples, and detailed sections on loading and invoking tools asynchronously and synchronously.
  • Authentication Mechanisms: Guidance is provided for both client-to-server authentication (e.g., for Cloud Run deployments) and per-tool authentication using ID token retriever functions.
  • Advanced Features: The new docs explain how to bind parameter values to tools, either statically or dynamically, and demonstrate integration with frameworks like LangGraph.
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
Copy Markdown
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-core Python SDK. The new documentation is well-structured and covers installation, usage, authentication, and integration with other frameworks like LangGraph. I've provided a few suggestions to improve clarity and correctness, such as fixing minor typos, removing a redundant notice, and clarifying a code example. Overall, this is a great addition to the project's documentation.

Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md
Comment thread docs/en/sdks/python-sdk/core/index.md
Comment thread docs/en/sdks/python-sdk/core/index.md
@github-actions
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 changed the title py Sdk core docs migration PY toolbox-core Sdk doc migration Dec 17, 2025
@Yuan325 Yuan325 changed the title PY toolbox-core Sdk doc migration docs: python toolbox-core sdk doc migration Dec 31, 2025
@Yuan325 Yuan325 added the priority: p2 Moderately-important priority. Fix may not be included in next release. label Dec 31, 2025
@github-actions
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 marked this pull request as ready for review January 12, 2026 09:06
@rapid-killer-9 rapid-killer-9 requested a review from a team January 12, 2026 09:06
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
@duwenxin99 duwenxin99 assigned anubhav756 and unassigned duwenxin99 Jan 22, 2026
@rapid-killer-9 rapid-killer-9 self-assigned this Feb 3, 2026
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 3, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 3, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 5, 2026

Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md Outdated
Comment thread docs/en/sdks/python-sdk/core/index.md
Comment thread docs/en/sdks/python-sdk/core/index.md
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

Updated notice type from 'note' to 'info' for better clarity on security recommendations.
@github-actions
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 merged commit c9327e2 into py-sdk-docs Feb 23, 2026
15 checks passed
@rapid-killer-9 rapid-killer-9 deleted the docs-py-sdk-core branch February 23, 2026 08:40
@github-actions
Copy link
Copy Markdown
Contributor

🧨 Preview deployments removed.

rapid-killer-9 added a commit that referenced this pull request Feb 23, 2026
Docs Migration from python SDK repo to genai-toolbox repo.

This branch is used as parent branch for python Sdk docs migration 

child branch: 
1. #2166
2. #2190
3. #2291
4. #2409

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: p2 Moderately-important priority. Fix may not be included in next release. type: docs Improvement to the documentation for an API.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants