Skip to content

docs: handoffs conceptual part #1037

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
eyurtsev wants to merge 16 commits into from
Closed

docs: handoffs conceptual part #1037

eyurtsev wants to merge 16 commits into from
+1,824 −251

Conversation

@eyurtsev
Copy link
Collaborator

@eyurtsev eyurtsev commented Oct 20, 2025 •
edited by lnhsingh
Loading

@github-actions github-actions bot added langchain For docs changes to LangChain oss labels Oct 20, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Oct 20, 2025

Preview ID generated: preview-eugene-1760992295-3339f36

eyurtsev
eyurtsev commented Oct 20, 2025
View reviewed changes
src/oss/langchain/multi-agent.mdx
2. It passes control (and state) to the **next agent**.
3. The **new agent** interacts directly with the user until it decides to hand off again or finish.
1. The **current agent** decides it needs to transfer control to another agent.
2. It updates a state variable (e.g., `active_agent`) using a tool that modifies the graph state.
Copy link
Collaborator Author

@eyurtsev eyurtsev Oct 20, 2025

Choose a reason for hiding this comment

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

Shouldn't mention graph state potentially

@github-actions github-actions bot added python For content related to the Python version of LangChain projects ci labels Oct 23, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 17, 2025

Mintlify preview ID generated: preview-eugene-1763415532-08e3889

@github-actions github-actions bot removed the python For content related to the Python version of LangChain projects label Nov 18, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 18, 2025

Mintlify preview ID generated: preview-eugene-1763491147-89abda6

@lnhsingh lnhsingh marked this pull request as ready for review November 18, 2025 18:39
@github-actions
Copy link
Contributor

github-actions bot commented Nov 18, 2025

Mintlify preview ID generated: preview-eugene-1763492502-3bab9b3

@github-actions
Copy link
Contributor

github-actions bot commented Nov 19, 2025

Mintlify preview ID generated: preview-eugene-1763575958-88c8cd6

@github-actions
Copy link
Contributor

github-actions bot commented Nov 19, 2025

Mintlify preview ID generated: preview-eugene-1763577327-bfe51c2

@langchain-ai langchain-ai deleted a comment from zachcdmx Dec 9, 2025
Copilot AI review requested due to automatic review settings December 9, 2025 19:15
@github-actions
Copy link
Contributor

github-actions bot commented Dec 9, 2025

❌ Import check failed

This PR contains imports from langchain_core that should be imported from langchain instead.

Detailed issues 
Analyzing diff for import issues...
 Found 3 import issues:

File: src/oss/langchain/customer-support-handoffs.mdx
Line: 123
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import ToolMessage
Suggested: from langchain.messages import ToolMessage
--------------------------------------------------------------------------------
File: src/oss/langchain/customer-support-handoffs.mdx
Line: 333
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage
Suggested: from langchain.messages import HumanMessage
--------------------------------------------------------------------------------
File: src/oss/langchain/customer-support-handoffs.mdx
Line: 590
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import ToolMessage
Suggested: from langchain.messages import ToolMessage
--------------------------------------------------------------------------------

 Found 3 import issues that need to be fixed.

Why this is a problem

The langchain package re-exports many modules and classes from langchain_core. When possible, imports should use langchain instead of langchain_core for:

  • Better user experience (single import source)
  • Consistency across documentation
  • Reduced cognitive load for users

How to fix

Replace the imports as suggested above. For example:

  • ❌ from langchain_core.messages import HumanMessage
  • ✅ from langchain.messages import HumanMessage

🤖 Automated check

This check is based on the latest analysis of langchain re-exports from langchain_core.

@github-actions
Copy link
Contributor

github-actions bot commented Dec 9, 2025

Mintlify preview ID generated: preview-eugene-1765307828-644c1d7

Copilot AI reviewed Dec 9, 2025
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This pull request adds conceptual documentation for handoffs in multi-agent systems to the LangChain documentation. The changes significantly expand the multi-agent documentation by:

  • Restructuring the multi-agent patterns section with better organization
  • Adding detailed explanations of tool calling and handoffs patterns
  • Including new examples, use cases, and best practices
  • Adding internal links to related documentation
  • Updating dependencies (lock file changes)

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated no comments.

File Description
src/oss/langchain/multi-agent.mdx Major expansion of multi-agent documentation with detailed handoffs section, examples, and best practices
uv.lock Dependency updates including new packages (langchain, anthropic, etc.) and version bumps

@sydney-runkle
Copy link
Contributor

sydney-runkle commented Dec 16, 2025

Closing, we've consolidated content into #1866

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@lnhsingh lnhsingh Awaiting requested review from lnhsingh lnhsingh is a code owner

@katmayb katmayb Awaiting requested review from katmayb katmayb is a code owner

Assignees

No one assigned

Labels

ci langchain For docs changes to LangChain oss

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@eyurtsev @sydney-runkle @lnhsingh