Add Temporal plugin to integrations by drewhoskins-temporal · Pull Request #1331 · google/adk-docs

drewhoskins-temporal · 2026-02-20T01:44:30Z

Document the upcoming Temporal integration. temporalio/sdk-python#1282

netlify · 2026-02-20T01:44:35Z

✅ Deploy Preview for adk-docs-preview ready!

Name	Link
🔨 Latest commit	`81c4957`
🔍 Latest deploy log	https://app.netlify.com/projects/adk-docs-preview/deploys/6997bc827e8e120008e2907a
😎 Deploy Preview	https://deploy-preview-1331--adk-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

google-cla · 2026-02-20T01:44:41Z

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

tconley1428 · 2026-02-20T17:17:21Z

docs/integrations/temporal.md

+        client,
+        task_queue="adk-task-queue",
+        workflows=[WeatherAgentWorkflow],
+        plugins=[TemporalAdkPlugin()],


It's good practice to put the plugin on the client. In this case your code will fail because the pydantic data converter will not be used.

tconley1428 · 2026-02-20T17:17:34Z

docs/integrations/temporal.md

+from temporalio.client import Client
+
+async def start():
+    client = await Client.connect("localhost:7233")


Need the plugin.

tconley1428 · 2026-02-20T17:17:50Z

docs/integrations/temporal.md

+    print(result)
+```
+
+### Using custom tools as Activities


Using activities as tools, not the reverse.

koverholt

Thanks for the PR and contribution! Exciting to see the ongoing plugin work in the linked PR.

I left some comments to address. And I'm going to apply the blocked label to this PR until the updated SDK/integration is released and ready for us to test (let us know!).

You'll also need to sign the CLA per the bot's failing CI test, you can find more details in https://github.com/google/adk-docs/pull/1331/checks?check_run_id=64235775129.

koverholt · 2026-02-20T16:45:43Z

docs/integrations/temporal.md

+---
+catalog_title: Temporal
+catalog_description: Resilient, scalable agents, long-running agents and tools, human approvals, safe versioning, and more using the world's leading durable execution provider.
+catalog_icon: /adk-docs/integrations/assets/temporal.svg


The icon reference here has .svg, but the uploaded icon is in .png format, so the card icon is currently broken.

koverholt · 2026-02-20T16:47:38Z

docs/assets/temporal.png

Logos and assets for integrations should be placed in docs/integrations/assets/.

koverholt · 2026-02-20T16:51:53Z

docs/integrations/temporal.md

@@ -0,0 +1,248 @@
+---
+catalog_title: Temporal
+catalog_description: Resilient, scalable agents, long-running agents and tools, human approvals, safe versioning, and more using the world's leading durable execution provider.


Please shorten this description to ~10 words and remove superlative language like "using the world's leading durable execution provider" to be consistent with the other integrations.

koverholt · 2026-02-20T16:54:20Z

docs/integrations/temporal.md

+| Human-in-the-loop | Your Agent Workflow can wait for [Signals](https://docs.temporal.io/signals) and [Updates](https://docs.temporal.io/messages#updates) to wait for human input, and clients can send those to resume the Agent |
+| Deterministic runtime | `TemporalAdkPlugin` replaces non-deterministic calls with Temporal-safe equivalents |
+| Debuggability | Every LLM call and tool execution is visible as an Activity in the Temporal UI, making it trivial to debug faults. |
+| Observability | Work with your favorite Observability solution using OpenTelemetry, with cross-process spans that are resilient to crashes.


Add missing closing pipe delimiter:

Suggested change

| Observability | Work with your favorite Observability solution using OpenTelemetry, with cross-process spans that are resilient to crashes.

| Observability | Work with your favorite Observability solution using OpenTelemetry, with cross-process spans that are resilient to crashes. |

koverholt · 2026-02-20T16:57:54Z

docs/integrations/temporal.md

+- **Durable execution**: Never lose progress. If your agent crashes or stalls,
+  Temporal automatically recovers from the last successful step - no manual
+  [session resumption](https://google.github.io/adk-docs/runtime/resume/#resume-a-stopped-workflow)
+  required.
+- **Built-in retries and rate limiting**: Configurable
+  [retry policies](https://docs.temporal.io/encyclopedia/retry-policies) with
+  backoff, plus mechanisms for handling backpressure from LLM providers.
+- **Long-running and ambient agents**: Support for agents that run for hours,
+  days, or indefinitely using blocking awaits and
+  [worker versioning](https://docs.temporal.io/production-deployment/worker-deployments/worker-versioning).
+- **Human-in-the-loop**: Pause execution until a human approves, then resume
+  where you left off. Temporal's
+  [task routing](https://docs.temporal.io/task-routing) scalably routes incoming
+  signals (such as user chats or approvals) to the correct workflow.
+- **Long-running tools**: Execute tools that take minutes or hours as
+  [Activities](https://docs.temporal.io/activities) with heartbeating, timeouts,
+  and retries - no separate microservices needed.
+- **Observability and debugging**: Inspect every step of your agent's execution,
+  replay workflows deterministically, and pinpoint failures using the
+  [Temporal UI](https://docs.temporal.io/web-ui).
+- **Safe versioning**: Deploy new agent versions without breaking in-flight
+  executions via
+  [worker versioning](https://docs.temporal.io/production-deployment/worker-deployments/worker-versioning).


Consider reducing these use cases to fewer bullets down to 4-5 total, it's a lot for readers to take in near the top of the doc. Combine bullets where possible, and focus on core benefits instead of listing all features.

koverholt · 2026-02-20T17:15:45Z

docs/integrations/temporal.md

+
+- **Durable execution**: Never lose progress. If your agent crashes or stalls,
+  Temporal automatically recovers from the last successful step - no manual
+  [session resumption](https://google.github.io/adk-docs/runtime/resume/#resume-a-stopped-workflow)


Change the absolute link to a site-relative path:

Suggested change

[session resumption](https://google.github.io/adk-docs/runtime/resume/#resume-a-stopped-workflow)

[session resumption](/adk-docs/runtime/resume/#resume-a-stopped-workflow)

koverholt · 2026-02-20T17:16:50Z

docs/integrations/temporal.md

+- A [Gemini API key](https://aistudio.google.com/app/api-keys) (or any
+  [supported model](https://google.github.io/adk-docs/agents/models/))


Change the absolute link to a site-relative path:

Suggested change

- A [Gemini API key](https://aistudio.google.com/app/api-keys) (or any

[supported model](https://google.github.io/adk-docs/agents/models/))

- A [Gemini API key](https://aistudio.google.com/app/api-keys) (or any

[supported model](/adk-docs/agents/models/))

koverholt · 2026-02-20T17:17:47Z

docs/integrations/temporal.md

+
+### Using MCP tools
+
+Execute [MCP](https://google.github.io/adk-docs/mcp/) tools as Temporal


Change the absolute link to a site-relative path:

Suggested change

Execute [MCP](https://google.github.io/adk-docs/mcp/) tools as Temporal

Execute [MCP](/adk-docs/mcp/) tools as Temporal

koverholt · 2026-02-20T17:18:53Z

docs/integrations/temporal.md

+from datetime import timedelta
+from temporalio import activity
+from temporalio.contrib.google_adk_agents.workflow import activity_tool
+from temporalio.workflow import ActivityConfig


ActivityConfig is not used in this code sample.

koverholt · 2026-02-20T17:25:15Z

docs/integrations/temporal.md

+from temporalio.workflow import ActivityConfig
+
+@activity.defn
+async def get_weather(city: str) -> str:


There are a few other issues across code samples such as:

get_weather is used in the first code sample but not defined until the fourth code sample.

Agent is imported in the first code sample but not the others

You can consider either:

Defining all necessary imports in each code sample so that each sample is standalone (likely works best for this integration).

Defining all imports in one code block at the top, then each subsequent code sample is additive.

Add Temporal plugin to integrations

81c4957

tconley1428 reviewed Feb 20, 2026

View reviewed changes

koverholt requested changes Feb 20, 2026

View reviewed changes

koverholt added do not merge blocked labels Feb 20, 2026

	\| Observability \| Work with your favorite Observability solution using OpenTelemetry, with cross-process spans that are resilient to crashes.
	\| Observability \| Work with your favorite Observability solution using OpenTelemetry, with cross-process spans that are resilient to crashes. \|

	[session resumption](https://google.github.io/adk-docs/runtime/resume/#resume-a-stopped-workflow)
	[session resumption](/adk-docs/runtime/resume/#resume-a-stopped-workflow)

		- A [Gemini API key](https://aistudio.google.com/app/api-keys) (or any
		[supported model](https://google.github.io/adk-docs/agents/models/))


		### Using MCP tools

		Execute [MCP](https://google.github.io/adk-docs/mcp/) tools as Temporal

	Execute [MCP](https://google.github.io/adk-docs/mcp/) tools as Temporal
	Execute [MCP](/adk-docs/mcp/) tools as Temporal

Conversation

drewhoskins-temporal commented Feb 20, 2026

Uh oh!

netlify bot commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for adk-docs-preview ready!

Uh oh!

google-cla bot commented Feb 20, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

koverholt left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

netlify bot commented Feb 20, 2026 •

edited

Loading