Skip to content

Add Python Google GenAI plugin integration guide - #4991

Open
brianstrauch wants to merge 2 commits into
mainfrom
python-google-genai-integration
Open

Add Python Google GenAI plugin integration guide#4991
brianstrauch wants to merge 2 commits into
mainfrom
python-google-genai-integration

Conversation

@brianstrauch

@brianstrauch brianstrauch commented Jul 29, 2026

Copy link
Copy Markdown
Member

What does this PR do?

Documents the GoogleGenAIPlugin shipped in Temporal Python SDK 1.31.0, as docs/develop/python/integrations/google-genai.mdx.

The page mirrors the structure of the existing Google ADK and LangGraph plugin guides and covers: calling a model from a Workflow, tools as Activities (activity_as_tool vs. plain Workflow methods), multi-turn chat, structured output, MCP tool servers, streaming via WorkflowStream, the Files API, the Interactions API and managed agents, Vertex AI, and Activity timeouts and retries.

Also adds the page to the Python sidebar, the Python landing page, and the integrations grid.

Notes to reviewers

Blocked on temporalio/samples-python#319. Every code block on the page uses a python-google-genai-* Snipsync ID from that PR, and the source links point at samples-python main. Until #319 merges:

  • the blob/main/google_genai/... links 404
  • the nightly Snipsync job would open a PR blanking those blocks

The blocks are pre-populated with the extracted code, so the page renders correctly today — but this should land after #319 or alongside it.

Two other things worth a look:

  • The first commit adds AI, Google, Gemini, and Vertex to the Temporal.Headings Vale exceptions, following the pattern from fix(vale): reduce Temporal.Headings false positives on proper nouns #4983. Without them the "Run against Vertex AI" heading is flagged as title case. It's split into its own commit so it's easy to drop if you'd rather I rename the heading instead. Repo-wide Temporal.Headings suggestions stay at 481.
  • The integrations grid entry is tagged Agent framework, matching how Pydantic AI and the OpenAI Agents SDK are tagged, though the Gen AI SDK is really a model API rather than an agent framework. Happy to change it if there's a better tag.

yarn build passes and vale --config .vale-ci.ini is clean on the new page.

🤖 Generated with Claude Code

┆Attachments: EDU-6845 Add Python Google GenAI plugin integration guide

brianstrauch and others added 2 commits July 29, 2026 12:17
Add AI, Google, Gemini, and Vertex to the Temporal.Headings exceptions,
following the pattern set in #4983. Without them, headings that name a
model platform ("Run against Vertex AI") are flagged as title case.

Verified: repo-wide Temporal.Headings suggestions stay at 481, and the
headings-good / headings-bad fixtures are unchanged in outcome.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Document the GoogleGenAIPlugin shipped in Temporal Python SDK 1.31.0,
mirroring the structure of the Google ADK and LangGraph plugin guides:
calling a model from a Workflow, tools as Activities, chat, structured
output, MCP tool servers, streaming, files, the Interactions API and
managed agents, Vertex AI, and Activity timeouts and retries.

Code blocks use the python-google-genai-* Snipsync IDs from the samples
and are pre-populated so the page renders before the next sync. The
samples live in temporalio/samples-python#319, which is not merged yet,
so the blob/main links 404 until it lands.

Also add the page to the Python sidebar, the Python landing page, and
the integrations grid.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@brianstrauch
brianstrauch requested a review from a team as a code owner July 29, 2026 19:18
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jul 29, 2026 7:19pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

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