human-in-the-loop #659

eyurtsev · 2025-09-26T03:09:19Z

Overview

Add human in the loop page
Link from middleware

Outstanding:

Update code snippets
Update comments in code snippets
Figure out how to consolidate the page structurally (response types is in a few different places).
Add link to reference for HumanInTheLoopMiddleware (we can't do this right now - no reference)
Explain message prefix

Type of change

New documentation page

Checklist

I have read the contributing guidelines
I have tested my changes locally using docs dev
All code examples have been tested and work correctly
I have used root relative paths for internal links
I have updated navigation in src/docs.json if needed
I have gotten approval from the relevant reviewers
(Internal team members only / optional) I have created a preview deployment using the Create Preview Branch workflow

Additional notes

github-actions · 2025-09-26T19:19:25Z

Preview ID generated: preview-eugene-1758914338-69fe33e

github-actions · 2025-09-26T19:25:48Z

Preview ID generated: preview-eugene-1758914717-5b68b8a

Copilot

Pull Request Overview

This PR adds a comprehensive human-in-the-loop documentation page for LangChain, moving detailed middleware documentation from a general middleware page to a dedicated page focused on human oversight capabilities.

Replaces extensive human-in-the-loop middleware documentation with a brief summary and link to the new dedicated page
Creates a new detailed human-in-the-loop documentation page with comprehensive examples and configuration details
Updates link mapping to correct the interrupt reference

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
src/oss/langchain/middleware.mdx	Condenses human-in-the-loop section to summary with link to dedicated page
src/oss/langchain/human-in-the-loop.mdx	Creates comprehensive documentation page covering middleware configuration, interrupt handling, and response types
pipeline/preprocessors/link_map.py	Corrects link reference for interrupt function to use lowercase

Comments suppressed due to low confidence (1)

src/oss/langchain/human-in-the-loop.mdx:1

This documentation link creates a circular reference since it's on the human-in-the-loop page itself. This appears to be copied from the middleware.mdx file and should be removed or replaced with appropriate content for this page.

---

src/oss/langchain/human-in-the-loop.mdx

github-actions · 2025-09-26T19:33:27Z

Preview ID generated: preview-eugene-1758915174-ff34a81

Copilot

Pull Request Overview

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

src/oss/langchain/human-in-the-loop.mdx

Copilot · 2025-09-26T19:33:40Z

src/oss/langchain/human-in-the-loop.mdx

+    You must configure a checkpointer to persist the graph state across interrupts.
+    In production, use a persistent checkpointer like @[AsyncPostgresSaver]. For testing or prototyping, use @[InMemorySaver].


The reference '@[AsyncPostgresSaver]' appears to have a typo - it should be 'AsyncPostgresSaver' (with 'Postgres' not 'Postgress').

src/oss/langchain/human-in-the-loop.mdx

Copilot

Pull Request Overview

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

src/oss/langchain/human-in-the-loop.mdx

github-actions · 2025-09-26T19:40:56Z

Preview ID generated: preview-eugene-1758915627-c75f251

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

src/oss/langchain/human-in-the-loop.mdx

Copilot

Pull Request Overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Copilot · 2025-09-26T19:49:28Z

src/oss/langchain/human-in-the-loop.mdx

+        }),
+    ],
+    // Human-in-the-loop requires checkpointing to handle interrupts.
+    // In production, use a persistent checkpointer like AsyncPostgresSaver.


There's a typo in 'AsyncPostgressSaver'. It should be 'AsyncPostgresSaver' (with an 'e' after 'Postgr').

Suggested change

// In production, use a persistent checkpointer like AsyncPostgresSaver.

// In production, use a persistent checkpointer like AsyncPostgresSaver.

github-actions · 2025-09-26T19:50:37Z

Preview ID generated: preview-eugene-1758916208-c2ce9f6

lnhsingh

some nits

lnhsingh · 2025-09-29T11:11:35Z

src/oss/langchain/human-in-the-loop.mdx

+| ✏️ `edit`     | The tool call is executed with modifications.                             | Change the recipient before sending an email        |
+| ❌ `respond`   | The tool call is rejected, with an explanation added to the conversation. | Reject an email draft and explain how to rewrite it |
+
+<Note>


This doesn't need to be in a note callout

lnhsingh · 2025-09-29T11:18:35Z

src/oss/langchain/human-in-the-loop.mdx

+:::
+
+
+<Important>


This should be <Warning> -- we don't have an Important callout

src/oss/langchain/human-in-the-loop.mdx

Co-authored-by: Lauren Hirata Singh <lauren@langchain.dev>

Copilot

Pull Request Overview

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

Copilot · 2025-09-29T13:47:30Z

src/oss/langchain/human-in-the-loop.mdx

+
+<Important>
+    You must configure a checkpointer to persist the graph state across interrupts.
+    In production, use a persistent checkpointer like @[AsyncPostgresSaver]. For testing or prototyping, use @[InMemorySaver].


The @[AsyncPostgresSaver] and @[InMemorySaver] use the same custom link notation that may not render correctly. Consider using standard markdown links or verifying this notation is supported.

Suggested change

In production, use a persistent checkpointer like @[AsyncPostgresSaver]. For testing or prototyping, use @[InMemorySaver].

In production, use a persistent checkpointer like `AsyncPostgresSaver`. For testing or prototyping, use `InMemorySaver`.

Copilot · 2025-09-29T13:47:31Z

src/oss/langchain/human-in-the-loop.mdx

+3. If any calls require human input, the middleware builds a list of `HumanInterrupt` objects and calls @[interrupt].
+4. The agent waits for human responses.
+5. Based on responses, the middleware executes approved or edited calls, synthesizes @[ToolMessage]'s for rejected calls, and resumes execution.


The @[interrupt] and @[ToolMessage] custom link notations are inconsistent with standard markdown linking. Consider using proper markdown links or verify the custom notation is supported throughout the documentation system.

Copilot · 2025-09-29T13:47:31Z

src/oss/langchain/human-in-the-loop.mdx

+
+## Custom HITL logic
+
+For more specialized workflows, you can build custom HITL logic directly using the @[interrupt] primitive and [middleware](/oss/langchain/middleware) abstraction.


Mixed usage of @[interrupt] custom notation and standard markdown link [middleware](/oss/langchain/middleware) in the same sentence creates inconsistency. Consider standardizing the link format throughout the document.

Suggested change

For more specialized workflows, you can build custom HITL logic directly using the @[interrupt] primitive and [middleware](/oss/langchain/middleware) abstraction.

For more specialized workflows, you can build custom HITL logic directly using the [interrupt](/oss/langchain/interrupt) primitive and [middleware](/oss/langchain/middleware) abstraction.

github-actions · 2025-09-29T13:47:40Z

Preview ID generated: preview-eugene-1759153626-dd7e685

github-actions · 2025-09-29T13:56:30Z

Preview ID generated: preview-eugene-1759154154-4ec77fe

github-actions bot added langchain For docs changes to LangChain python For content related to the Python version of LangChain projects oss docs-infra labels Sep 26, 2025

vercel bot had a problem deploying to Preview September 26, 2025 03:09 Failure

vercel bot had a problem deploying to Preview September 26, 2025 18:58 Failure

vercel bot had a problem deploying to Preview September 26, 2025 19:14 Failure

eyurtsev force-pushed the eugene/human-in-the-loop branch from 714614a to cfa130b Compare September 26, 2025 19:18

vercel bot had a problem deploying to Preview September 26, 2025 19:19 Failure

eyurtsev added 8 commits September 26, 2025 15:24

update

69e1fdd

x

61f0311

fixes

f682970

Update

2d18e55

x

68d095d

x

be00f5e

x

ca4603e

x

a044f96

eyurtsev force-pushed the eugene/human-in-the-loop branch from cfa130b to a044f96 Compare September 26, 2025 19:24

eyurtsev changed the title ~~human-in-the-loop (wip)~~ human-in-the-loop Sep 26, 2025

eyurtsev marked this pull request as ready for review September 26, 2025 19:26

eyurtsev requested review from lnhsingh and katmayb as code owners September 26, 2025 19:26

Copilot AI review requested due to automatic review settings September 26, 2025 19:26

Copilot AI reviewed Sep 26, 2025

View reviewed changes

src/oss/langchain/human-in-the-loop.mdx Outdated Show resolved Hide resolved

vercel bot deployed to Preview September 26, 2025 19:29 View deployment

Copilot AI review requested due to automatic review settings September 26, 2025 19:32

Copilot AI reviewed Sep 26, 2025

View reviewed changes

vercel bot deployed to Preview September 26, 2025 19:37 View deployment

x

eb6b085

eyurtsev force-pushed the eugene/human-in-the-loop branch from 82ae034 to eb6b085 Compare September 26, 2025 19:39

x

bf8b251

Copilot AI review requested due to automatic review settings September 26, 2025 19:39

Copilot AI reviewed Sep 26, 2025

View reviewed changes

src/oss/langchain/human-in-the-loop.mdx Outdated Show resolved Hide resolved

src/oss/langchain/human-in-the-loop.mdx Outdated Show resolved Hide resolved

Update src/oss/langchain/human-in-the-loop.mdx

e7a411d

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings September 26, 2025 19:48

eyurtsev commented Sep 26, 2025

View reviewed changes

src/oss/langchain/human-in-the-loop.mdx Outdated Show resolved Hide resolved

Update src/oss/langchain/human-in-the-loop.mdx

4901574

Copilot AI reviewed Sep 26, 2025

View reviewed changes

vercel bot deployed to Preview September 26, 2025 19:54 View deployment

lnhsingh approved these changes Sep 29, 2025

View reviewed changes

Update src/oss/langchain/human-in-the-loop.mdx

cea4c87

Co-authored-by: Lauren Hirata Singh <lauren@langchain.dev>

Copilot AI review requested due to automatic review settings September 29, 2025 13:46

Copilot AI reviewed Sep 29, 2025

View reviewed changes

vercel bot deployed to Preview September 29, 2025 13:51 View deployment

x

9f8acee

vercel bot deployed to Preview September 29, 2025 13:59 View deployment

eyurtsev merged commit 3c78d86 into main Sep 29, 2025
14 of 15 checks passed

eyurtsev deleted the eugene/human-in-the-loop branch September 29, 2025 18:00

		You must configure a checkpointer to persist the graph state across interrupts.
		In production, use a persistent checkpointer like @[AsyncPostgresSaver]. For testing or prototyping, use @[InMemorySaver].

	// In production, use a persistent checkpointer like AsyncPostgresSaver.
	// In production, use a persistent checkpointer like AsyncPostgresSaver.


		## Custom HITL logic

		For more specialized workflows, you can build custom HITL logic directly using the @[interrupt] primitive and [middleware](/oss/langchain/middleware) abstraction.

		:::


		<Important>

human-in-the-loop #659

human-in-the-loop #659

Conversation

eyurtsev commented Sep 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview

Type of change

Checklist

Additional notes

Uh oh!

github-actions bot commented Sep 26, 2025

Uh oh!

github-actions bot commented Sep 26, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

github-actions bot commented Sep 26, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Copilot AI Sep 26, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Sep 26, 2025

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Copilot AI Sep 26, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Sep 26, 2025

Uh oh!

lnhsingh left a comment

Choose a reason for hiding this comment

Uh oh!

lnhsingh Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

lnhsingh Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Copilot AI Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Sep 29, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Sep 29, 2025

Uh oh!

github-actions bot commented Sep 29, 2025

Uh oh!

Uh oh!

Uh oh!

eyurtsev commented Sep 26, 2025 •

edited

Loading