docs: add pre/post processing best practices by twishabansal · Pull Request #2435 · googleapis/mcp-toolbox

twishabansal · 2026-02-09T06:20:38Z

Description

Should include a concise description of the changes (bug or feature), it's
impact, along with a summary of the solution

PR Checklist

Thank you for opening a Pull Request! Before submitting your PR, there are a
few things you can do to make sure it goes smoothly:

Make sure you reviewed
CONTRIBUTING.md
Make sure to open an issue as a
bug/issue
before writing your code! That way we can discuss the change, evaluate
designs, and agree on the general idea
Ensure the tests and linter pass
Code coverage does not decrease (if any source code was changed)
Appropriate docs were updated (if necessary)
Make sure to add ! if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Explicitly document that these capabilities are typically provided by orchestration frameworks (like LangChain, LangGraph) rather than the Toolbox SDK itself, but that Toolbox tools are designed to leverage them.

Co-authored-by: Averi Kitsch <akitsch@google.com>

gemini-code-assist · 2026-02-09T06:20:52Z

Summary of Changes

Hello @twishabansal, I'm Gemini Code Assist¹! 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 significantly enhances the existing documentation for pre/post-processing by introducing a dedicated 'Best Practices' section. These new guidelines aim to equip developers with actionable strategies to improve the security, observability, performance, and error handling capabilities of their tools and agents, fostering the creation of more robust, efficient, and maintainable systems.

Highlights

Documentation Enhancement: A new, comprehensive 'Best Practices' section has been added to the pre/post-processing documentation, providing guidelines for various aspects of tool and agent development.
Security & Guardrails: New recommendations cover the principle of least privilege, input sanitization to protect against PII leakage, and prompt injection defense mechanisms.
Observability & Debugging: Guidelines for structured logging with correlation IDs and redundant logging for improved testability have been introduced.
Performance & Cost Optimization: Best practices for token economy (stripping unnecessary data) and caching for read-heavy tools are now included to optimize performance and reduce costs.
Error Handling: Advice on implementing graceful degradation and enabling self-correction for LLMs through well-formatted error messages has been added.

Changelog

docs/en/samples/pre_post_processing/_index.md
- Added a new top-level section titled 'Best Practices'.
- Included a 'Security & Guardrails' sub-section with advice on least privilege, input sanitization, and prompt injection defense.
- Added an 'Observability & Debugging' sub-section, recommending structured logging and redundant logging for testability.
- Introduced a 'Performance & Cost Optimization' sub-section, covering token economy and caching strategies.
- Provided an 'Error Handling' sub-section with guidance on graceful degradation and self-correction.

Activity

The pull request was created by twishabansal.
No human activity (comments, reviews) has occurred 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.

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. ↩

gemini-code-assist

Code Review

This pull request adds a new 'Best Practices' section to the pre/post-processing documentation. The new content is well-structured and provides valuable guidance on security, observability, performance, and error handling. I have one minor suggestion to improve the clarity of a heading in the new documentation.

github-actions · 2026-02-09T06:23:53Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2435/

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

github-actions · 2026-02-09T06:28:34Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2435/

github-actions · 2026-02-11T08:14:30Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2435/

github-actions · 2026-02-16T17:50:37Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2435/

github-actions · 2026-02-18T06:58:40Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2435/

github-actions · 2026-02-18T07:17:35Z

🧨 Preview deployments removed.

## Description > Should include a concise description of the changes (bug or feature), it's > impact, along with a summary of the solution ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [ ] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [ ] Ensure the tests and linter pass - [ ] Code coverage does not decrease (if any source code was changed) - [ ] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 06e01ae

twishabansal and others added 30 commits February 3, 2026 14:11

refactor: consolidate quickstart tests into universal runner

8416378

Apply suggestion from @gemini-code-assist[bot]

6df2ad2

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Apply suggestion from @gemini-code-assist[bot]

d39acac

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Apply suggestion from @gemini-code-assist[bot]

ad4a509

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Update run_tests.sh

56c6913

move files around

28006fc

fix paths

3f32a9a

move files around

73e0edc

move file around fix

66df3bf

rename file

35fa735

docs: add pre/post processing docs for langchain python

8b33b0c

remove not needed files

db8c3a3

gemini code review

f169874

lint

49cb2f3

license header

8de1697

Update docs/en/samples/pre_post_processing/python/langchain/agent.py

37a60ea

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

logic fix

d7faf77

fix import

ca6f31a

Highlight tool level processing

3a150c7

docs: clarify that pre/post processing is an orchestration feature

19271eb

Explicitly document that these capabilities are typically provided by orchestration frameworks (like LangChain, LangGraph) rather than the Toolbox SDK itself, but that Toolbox tools are designed to leverage them.

add sample tests

3c61ee0

license fix

9517dab

update requirements file

cee59d5

Fix tests

911069a

add more test case + remove flaky test

336743f

better tests

3265f7e

more reliable agent queries

da1f463

fix merge issues

b43af71

unnecessary file change removal

9210e55

more reliable tests

a212aed

twishabansal and others added 7 commits February 9, 2026 10:28

Update docs/en/samples/pre_post_processing/_index.md

fe01519

Co-authored-by: Averi Kitsch <akitsch@google.com>

clarify description for pre and post processing.

77af793

Merge branch 'main' into processing-docs

4885f6e

remove extra print

f598543

Merge branch 'main' into processing-docs

d829ee7

fix link checker issue

22657c9

docs: add pre/post processing best practices

33a98db

twishabansal marked this pull request as ready for review February 9, 2026 06:20

twishabansal requested a review from a team February 9, 2026 06:20

blunderbuss-gcf Bot assigned duwenxin99 Feb 9, 2026

gemini-code-assist Bot reviewed Feb 9, 2026

View reviewed changes

Comment thread docs/en/samples/pre_post_processing/_index.md Outdated

Update docs/en/samples/pre_post_processing/_index.md

2d6a2a7

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Base automatically changed from processing-docs to main February 10, 2026 16:41

Merge branch 'main' into processing-best-practice

b29bb21

Merge branch 'main' into processing-best-practice

d929329

Yuan325 approved these changes Feb 17, 2026

View reviewed changes

Comment thread docs/en/samples/pre_post_processing/golden.txt Outdated

twishabansal and others added 2 commits February 18, 2026 12:24

remove golden txt

7d80ef3

Merge branch 'main' into processing-best-practice

1cc9d74

twishabansal enabled auto-merge (squash) February 18, 2026 06:55

twishabansal merged commit 06e01ae into main Feb 18, 2026
14 checks passed

twishabansal deleted the processing-best-practice branch February 18, 2026 07:16

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: add pre/post processing best practices#2435

docs: add pre/post processing best practices#2435
twishabansal merged 59 commits into
mainfrom
processing-best-practice

twishabansal commented Feb 9, 2026

Uh oh!

gemini-code-assist Bot commented Feb 9, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

github-actions Bot commented Feb 11, 2026

Uh oh!

github-actions Bot commented Feb 16, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 18, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

twishabansal commented Feb 9, 2026

Description

PR Checklist

Uh oh!

gemini-code-assist Bot commented Feb 9, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

github-actions Bot commented Feb 11, 2026

Uh oh!

github-actions Bot commented Feb 16, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 18, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants