mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-12 03:56:53 +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
2.2 KiB
2.2 KiB
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 |