Skip to content

Add Deep Agents integration page (Python)#4883

Draft
DABH wants to merge 2 commits into
mainfrom
deepagents-docs
Draft

Add Deep Agents integration page (Python)#4883
DABH wants to merge 2 commits into
mainfrom
deepagents-docs

Conversation

@DABH

@DABH DABH commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

What

Documentation for the upcoming Temporal ↔ LangChain Deep Agents integration (temporalio.contrib.deepagents):

  • docs/develop/python/integrations/deepagents.mdx — full integration guide: install (pip install "temporalio[deepagents]", Python ≥ 3.11), Hello World worker/workflow, explicit Workflow-vs-Activity tool choice (activity_as_tool / tool_as_activity), durable backends (TemporalBackend), sub-agent durability, human-in-the-loop (native LangGraph interrupt → Temporal Query + Update), continue-as-new (run_deep_agent), streaming via workflow streams, composing with an observability plugin, and runtime behavior/limitations.
  • sidebars.js — Python Integrations entry (alphabetical).
  • src/components/IntegrationsGrid/integrations-data.json — discovery-grid entry.

All code blocks are sourced with SNIPSTART markers that map 1:1 to @@@SNIPSTART markers in the samples (11 snippets), so snipsync quotes real, tested sample code rather than hand-maintained blocks.

Status

Draft until the upstream pieces merge — the page documents:

The integration is experimental, and the page carries the standard maturity admonition.

┆Attachments: EDU-6716 Add Deep Agents integration page (Python)

@vercel

vercel Bot commented Jul 14, 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 14, 2026 11:35pm

Request Review


:::

## Hello World

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'Hello World' should use sentence-style capitalization.

@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation and navigation/discovery entries for the upcoming Temporal ↔ LangChain Deep Agents integration (temporalio.contrib.deepagents) in the Python SDK docs.

Changes:

  • Adds a new integration guide page: docs/develop/python/integrations/deepagents.mdx
  • Adds the Deep Agents page to the Python Integrations sidebar section
  • Adds a Deep Agents card entry to the Integrations discovery grid data

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
docs/develop/python/integrations/deepagents.mdx New Deep Agents integration guide (currently includes Snipsync placeholders).
sidebars.js Adds Deep Agents to Python → Integrations navigation.
src/components/IntegrationsGrid/integrations-data.json Adds a Deep Agents entry for the IntegrationsGrid discovery UI.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +84 to +85
<!--SNIPSTART python-deepagents-hello-world-workflow-->
<!--SNIPEND-->

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch — populated in 0d5901b. All 11 blocks now contain the extracted code plus the source-file link line, matching the checked-in snipsync output used on neighboring pages like strands-agents.mdx. One note: yarn snipsync can't fetch these yet because the deepagents_plugin samples haven't merged to samples-python main. The bodies were synced verbatim from the samples PR sources in snipsync's exact format, so the first snipsync run after the samples merge should be a no-op for this page. This docs PR should land after the samples PR so the source links resolve.

Comment on lines +29 to +37
{
"name": "Deep Agents",
"description": "Make LangChain Deep Agents durable with Temporal Workflows and Activities.",
"tags": [
"Agent framework"
],
"sdk": "Python",
"href": "/develop/python/integrations/deepagents"
},

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in 0d5901b — moved the Deep Agents entry to its alphabetical position, after the Datadog entries and before Google ADK. Entry content is unchanged.

Fill each snipsync wrapper on the Deep Agents page with the code and
source link extracted from the samples-python deepagents_plugin sources,
matching the checked-in snipsync output used across the docs. Move the
Deep Agents entry in integrations-data.json to its alphabetical slot
after the Datadog entries.
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.

2 participants