Skip to content

docs(integrations): fix nonexistent pip extras and stale ADK imports - #2019

Open
GWeale wants to merge 2 commits into
google:mainfrom
GWeale:docs-audit-integrations
Open

docs(integrations): fix nonexistent pip extras and stale ADK imports#2019
GWeale wants to merge 2 commits into
google:mainfrom
GWeale:docs-audit-integrations

Conversation

@GWeale

@GWeale GWeale commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

The integrations pages are partner-authored, so this slice deliberately touches only the places where those pages use ADK's own API surface — install extras, import paths, constructor arguments — and leaves the partner content alone.

Changes

  • docs/integrations/bigquery-agent-analytics.md, docs/integrations/express-mode.md, docs/integrations/gke-code-executor.md — installed extras that do not exist (google-adk[bigquery], google-adk[vertexai], google-adk[gke]); now [gcp], [gcp] and [extensions] respectively.
  • docs/integrations/bigquery.md, docs/integrations/bigtable.md, docs/integrations/spanner.md — no install step at all, so the samples fail on a base google-adk; each page now opens with a short Installation section for pip install "google-adk[gcp]".
  • docs/integrations/bigquery.md — every snippet imported from google.adk.tools.bigquery, which does not resolve; now google.adk.integrations.bigquery.
  • docs/integrations/gke-code-executor.mdCodeExecutionInput imported from google.adk.code_executors, which does not export it; now google.adk.code_executors.code_execution_utils.
  • docs/integrations/spanner.md — the RAG sample constructed SpannerCredentialsConfig() with no arguments, but it requires credentials, an external access token key, or a client ID and secret; now passes ADC credentials, with the google.auth import the snippet was missing.
  • docs/integrations/code-execution.md — described a built_in_code_execution tool; it is the BuiltInCodeExecutor code executor, set on the agent's code_executor field rather than in tools.
  • docs/integrations/environment-toolset.mdmax_output_chars was listed as a LocalEnvironment parameter (and misspelled max_output chars); it is an EnvironmentToolset constructor parameter and is now documented there.
  • docs/integrations/google-search.md — claimed google_search works only with Gemini 2 models; now just Gemini models.

How this was produced

Part of a page-by-page audit of the Python docs against the google/adk-python v2.5.0 source: every import resolved against a real 2.5.0 install, every constructor kwarg checked against model_fields / inspect.signature, every documented default read off the field. A second independent pass re-derived each claim from source rather than trusting the finding, and a third conformed the new wording to the surrounding pages. mkdocs build --strict is clean.

Only Python tabs and language-neutral prose were touched — this audit had no ground truth for the Go / Java / TypeScript SDKs.

Split out of a larger audit branch so each area can be reviewed on its own.

@netlify

netlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit ace77a3
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/6a6a998d70efea0007a851b8
😎 Deploy Preview https://deploy-preview-2019--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

1 participant