[GH-ISSUE #3229] Subagents docs: "Streaming" section is about tracing/metadata, not streaming #2720

Open
opened 2026-06-05 17:26:27 -04:00 by yindo · 0 comments
Owner

Originally created by @Edison-A-N on GitHub (Mar 20, 2026).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/3229

Page

https://docs.langchain.com/oss/python/deepagents/subagents#streaming

Problem

The Streaming section under the Subagents page has nothing to do with streaming. Its actual content is about:

  • Setting name on agents/subagents
  • Using lc_agent_name metadata in LangSmith traces to differentiate agents

This is tracing / agent identification, not streaming. Users looking for actual subagent streaming guidance (e.g., how to consume streaming tokens from subagents via astream_events, astream, etc.) will be misled by the heading.

Multiple GitHub issues confirm this confusion:

Suggestion

Either:

  1. Rename the section to something like "Tracing / Agent Identification" to accurately describe the content, or
  2. Add actual streaming content (how to consume subagent streaming output) and move the tracing/metadata info to its own section.
Originally created by @Edison-A-N on GitHub (Mar 20, 2026). Original GitHub issue: https://github.com/langchain-ai/docs/issues/3229 ## Page https://docs.langchain.com/oss/python/deepagents/subagents#streaming ## Problem The **Streaming** section under the Subagents page has nothing to do with streaming. Its actual content is about: - Setting `name` on agents/subagents - Using `lc_agent_name` metadata in LangSmith traces to differentiate agents This is tracing / agent identification, not streaming. Users looking for actual subagent streaming guidance (e.g., how to consume streaming tokens from subagents via `astream_events`, `astream`, etc.) will be misled by the heading. Multiple GitHub issues confirm this confusion: - langchain-ai/deepagents#1501 — "Is subagent support stream output?" - langchain-ai/deepagents#337 — "Add support for streaming intermediate steps from subagent to UI" - langchain-ai/deepagentsjs#284 — "Is subagent streaming supported in JS? The Python docs show this is possible..." ## Suggestion Either: 1. **Rename** the section to something like "Tracing / Agent Identification" to accurately describe the content, or 2. **Add actual streaming content** (how to consume subagent streaming output) and move the tracing/metadata info to its own section.
yindo added the external label 2026-06-05 17:26:27 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#2720