Skip to content

Add LangChain Deep Agents + MongoDB Atlas VFS tutorial - #230

Merged
mikikob-mongodb merged 2 commits into
mongodb-developer:mainfrom
mikikob-mongodb:langchain-vfs-tutorial
Sep 4, 2026
Merged

Add LangChain Deep Agents + MongoDB Atlas VFS tutorial#230
mikikob-mongodb merged 2 commits into
mongodb-developer:mainfrom
mikikob-mongodb:langchain-vfs-tutorial

Conversation

@mikikob-mongodb

Copy link
Copy Markdown
Contributor

Summary

  • Adds a multi-agent research pipeline tutorial using LangChain Deep Agents with MongoDB Atlas VFS (langchain-mongodb-deepagents-vfs)
  • Four sub-agents coordinate through a shared durable workspace backed by MongoDB Atlas + S3 to analyze a real federal rulemaking docket (DOE air-cleaner efficiency standards)
  • Demonstrates hybrid $rankFusion search across mixed formats (PDF, XLSX, DOCX), kill/resume durability via manifest.json run receipts, and a golden-answer acceptance test

What's included

  • src/vfs_demo/ — backend wiring, agent definitions, manifest system, metrics
  • scripts/ — seed corpus, control arms (ripgrep + StoreBackend), discovery, pipeline, resume
  • notebook/walkthrough.ipynb — end-to-end tutorial notebook (Beats 1-3)
  • tests/golden_answer.py — deterministic regex acceptance test (6 checks)
  • corpus/ — vendored docket files (binary files via Git LFS)
  • tools/fetch_docket.py — provenance script documenting how the corpus was assembled

Test plan

  • python scripts/00_seed_corpus.py seeds corpus to S3 and verifies searchability
  • python scripts/02_discovery.py runs hybrid search with 3x reproducibility
  • python scripts/03_pipeline.py --run-id test-001 completes all 4 stages
  • python scripts/03_pipeline.py --run-id kill-001 --kill-after 2 + python scripts/04_resume.py --run-id kill-001 resumes from checkpoint
  • python tests/golden_answer.py --run-id kill-001 passes 6/6 golden-answer checks
  • Notebook runs end-to-end via papermill notebook/walkthrough.ipynb

🤖 Generated with Claude Code

Multi-agent research pipeline that searches a 45-file federal rulemaking
docket (DOE air cleaner efficiency standards) across PDFs, spreadsheets,
and DOCX files using hybrid $rankFusion search, then survives being
killed mid-run via a manifest-based resume mechanism.

Includes:
- Corpus: DOE docket EERE-2021-BT-STD-0035 (public domain)
- Scripts: seed, discovery, control arms (ripgrep + StoreBackend),
  pipeline runner with --kill-after, resume
- Source: CompositeBackend wiring, agent definitions with production
  prompts, manifest system, metrics
- Notebook: walkthrough.ipynb covering all three beats
- Tests: deterministic golden answer acceptance test (regex, not LLM)
- Tools: regulations.gov docket fetcher

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mikikob-mongodb
mikikob-mongodb requested a review from a team as a code owner September 3, 2026 23:01
GitHub blocks LFS uploads to public forks, preventing push.
All binary files are well under the 100 MB per-file limit.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mikikob-mongodb
mikikob-mongodb merged commit 70b3715 into mongodb-developer:main Sep 4, 2026
3 checks passed
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.

1 participant