mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-21 00:26:23 +03:00
Magnus Hedemark
7f2842b358
Major deepening of the langchain expert skill based on source audit against official LangChain docs (docs.langchain.com, reference.langchain.com). Changes: - Added references/validation-audit.md documenting all research findings - Deepened references/agent-patterns.md from 74 to 200+ lines: create_react_agent full parameter table, @tool decorator with args_schema/parse_docstring, streaming events, multi-agent supervisor - Deepened references/lcel-reference.md from 79 to 180+ lines: RunnablePassthrough.assign(), RunnableParallel dict shorthand, RunnableLambda, RunnableConfig, .with_fallbacks(), .configurable_fields() - Deepened references/rag-strategies.md with advanced retrieval patterns - Deepened references/production-deployment.md with LangSmith Datasets/ Evaluation Runs/Prompt Hub - Added new references/callbacks.md (BaseCallbackHandler, event table, agent auditing patterns, async callbacks) - Deepened references/faq-and-troubleshooting.md with Pydantic v1/v2, streaming+tools, checkpoint serialization guidance All API surface claims verified against official documentation. v1.0.3 -> v1.1.0
35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
# LangChain Skill — Research Validation Audit
|
|
|
|
**Date:** 2026-07-09
|
|
**Sources:** docs.langchain.com, reference.langchain.com, GitHub source
|
|
|
|
## Claims Verified Correct
|
|
|
|
| Claim | Source | Status |
|
|
|-------|--------|--------|
|
|
| `create_agent` from `langchain.agents` is the v1.0+ recommended pattern | docs.langchain.com migration guide | ✓ Verified |
|
|
| `create_react_agent` from `langgraph.prebuilt` is deprecated in v1.0 | reference.langchain.com deprecation warning | ✓ Verified |
|
|
| `RunnablePassthrough.assign()` exists and works as documented | reference.langchain.com | ✓ Verified |
|
|
| `RunnableParallel` and `RunnableBranch` exist in `langchain_core.runnables` | reference.langchain.com | ✓ Verified |
|
|
| `@tool` decorator has `args_schema`, `parse_docstring`, `return_direct` params | reference.langchain.com | ✓ Verified |
|
|
| `BaseCallbackHandler` in `langchain_core.callbacks` | LangChain GitHub source | ✓ Verified |
|
|
| LangSmith has Datasets, Evaluation Runs, Prompt Hub | docs.langchain.com | ✓ Verified |
|
|
|
|
## Corrections Needed
|
|
|
|
| Finding | Impact | Action |
|
|
|---------|--------|--------|
|
|
| `create_history_aware_retriever` is in `langchain_classic.chains` (deprecated module) | RAG reference should note it's classic/migration path | Add deprecation note |
|
|
| `@tool` defaults `parse_docstring=False` — LLMs miss parameter descriptions | Agents may fail to call tools correctly | Document `parse_docstring=True` recommendation |
|
|
| Docs show `from langchain.tools import tool` (not `from langchain_core.tools`) | Import path correction | Update templates and agent reference |
|
|
| `create_react_agent` has 18+ parameters documented that our skill doesn't mention | Significant depth gap | Expand agent reference with real params |
|
|
|
|
## New Content Added
|
|
|
|
| Topic | Source | File |
|
|
|-------|--------|------|
|
|
| Callbacks system with event handlers | FutureAGI article + GitHub source | `references/callbacks.md` |
|
|
| create_react_agent full parameter reference | reference.langchain.com | `references/agent-patterns.md` |
|
|
| Parse docstring pattern for @tool | GitHub issue #34292 | `references/agent-patterns.md` |
|
|
| LangSmith evaluation/experiment workflow | docs.langchain.com | `references/production-deployment.md` |
|