From de3576eefe032ae83556bd8ceb0b508bffeb66e0 Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Fri, 31 Oct 2025 15:04:02 -0400 Subject: [PATCH 1/5] feat(docs): add component architecture documentation --- src/docs.json | 2 + src/oss/langchain/component-architecture.mdx | 134 +++++++++++++++++++ 2 files changed, 136 insertions(+) create mode 100644 src/oss/langchain/component-architecture.mdx diff --git a/src/docs.json b/src/docs.json index 02ced8e1e0..5e623d869e 100644 --- a/src/docs.json +++ b/src/docs.json @@ -349,6 +349,7 @@ "group": "Conceptual overviews", "icon": "book", "pages": [ + "oss/python/langchain/component-architecture", "oss/python/concepts/memory", "oss/python/concepts/context", "oss/python/langgraph/graph-api", @@ -693,6 +694,7 @@ "group": "Conceptual overviews", "icon": "book", "pages": [ + "oss/javascript/langchain/component-architecture", "oss/javascript/concepts/memory", "oss/javascript/concepts/context", "oss/javascript/langgraph/graph-api", diff --git a/src/oss/langchain/component-architecture.mdx b/src/oss/langchain/component-architecture.mdx new file mode 100644 index 0000000000..b2dbd9a48b --- /dev/null +++ b/src/oss/langchain/component-architecture.mdx @@ -0,0 +1,134 @@ +--- +title: Component architecture +--- + +LangChain's power comes from how its components work together to create sophisticated AI applications. This page provides visual diagrams showing the relationships between different components, helping you understand how they fit together. + +## Core component ecosystem + +The diagram below shows how LangChain's major components connect to form complete AI applications: + +```mermaid +graph TD + %% Input Processing + subgraph "📥 Input Processing" + A[Text Input] --> B[Document Loaders] + B --> C[Text Splitters] + C --> D[Documents] + end + + %% Embedding & Storage + subgraph "🔢 Embedding & Storage" + D --> E[Embedding Models] + E --> F[Vectors] + F --> G[(Vector Stores)] + end + + %% Retrieval + subgraph "🔍 Retrieval" + H[User Query] --> I[Embedding Models] + I --> J[Query Vector] + J --> K[Retrievers] + K --> G + G --> L[Relevant Context] + end + + %% Generation + subgraph "🤖 Generation" + M[Chat Models] --> N[Tools] + N --> O[Tool Results] + O --> M + L --> M + M --> P[AI Response] + end + + %% Orchestration + subgraph "🎯 Orchestration" + Q[Agents] --> M + Q --> N + Q --> K + Q --> R[Memory] + end + + %% Styling + classDef inputStyle fill:#e1f5fe,stroke:#0277bd + classDef embeddingStyle fill:#f3e5f5,stroke:#7b1fa2 + classDef retrievalStyle fill:#e8f5e8,stroke:#388e3c + classDef generationStyle fill:#fff3e0,stroke:#f57c00 + classDef orchestrationStyle fill:#fce4ec,stroke:#c2185b + + class A,B,C,D inputStyle + class E,F,G embeddingStyle + class H,I,J,K,L retrievalStyle + class M,N,O,P generationStyle + class Q,R orchestrationStyle +``` + +### How components connect + +Each component layer builds on the previous ones: + +1. **Input Processing** – Transform raw data into structured documents +2. **Embedding & Storage** – Convert text into searchable vector representations +3. **Retrieval** – Find relevant information based on user queries +4. **Generation** – Use AI models to create responses, optionally with tools +5. **Orchestration** – Coordinate everything through agents and memory systems + +## Component categories + +LangChain organizes components into these main categories: + +| Category | Purpose | Key Components | Use Cases | +|----------|---------|---------------|-----------| +| **[Models](/oss/langchain/models)** | AI reasoning and generation | Chat models, LLMs, Embedding models | Text generation, reasoning, semantic understanding | +| **[Tools](/oss/langchain/tools)** | External capabilities | APIs, databases, etc. | Web search, data access, computations | +| **[Agents](/oss/langchain/agents)** | Orchestration and reasoning | ReAct agents, tool calling agents | Nondeterministic workflows, decision making | +| **[Memory](/oss/langchain/short-term-memory)** | Context preservation | Message history, custom state | Conversations, stateful interactions | +| **[Retrievers](/oss/integrations/retrievers)** | Information access | Vector retrievers, web retrievers | RAG, knowledge base search | +| **[Document Processing](/oss/integrations/document_loaders)** | Data ingestion | Loaders, splitters, transformers | PDF processing, web scraping | +| **[Vector Stores](/oss/integrations/vectorstores)** | Semantic search | Chroma, Pinecone, FAISS | Similarity search, embeddings storage | + +## Common patterns + +### RAG (Retrieval-Augmented Generation) +```mermaid +graph LR + A[User Question] --> B[Retriever] + B --> C[Relevant Docs] + C --> D[Chat Model] + A --> D + D --> E[Informed Response] +``` + +### Agent with tools +```mermaid +graph LR + A[User Request] --> B[Agent] + B --> C{Need Tool?} + C -->|Yes| D[Call Tool] + D --> E[Tool Result] + E --> B + C -->|No| F[Final Answer] +``` + +### Multi-agent system +```mermaid +graph LR + A[Complex Task] --> B[Supervisor Agent] + B --> C[Specialist Agent 1] + B --> D[Specialist Agent 2] + C --> E[Results] + D --> E + E --> B + B --> F[Coordinated Response] +``` + +## Next steps + +Now that you understand how components relate to each other, explore specific areas: + +- **Building your first RAG system**: [Knowledge Base Tutorial](/oss/langchain/knowledge-base) +- **Creating agents**: [Agents Guide](/oss/langchain/agents) +- **Working with tools**: [Tools Guide](/oss/langchain/tools) +- **Setting up memory**: [Memory Guide](/oss/langchain/short-term-memory) +- **Browse integrations**: [All Integrations](/oss/integrations/providers/overview) From 3796201b32b58b08dcbd6584920c2d176b7fc694 Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Sat, 15 Nov 2025 22:59:08 -0500 Subject: [PATCH 2/5] Update src/oss/langchain/component-architecture.mdx Co-authored-by: Lauren Hirata Singh --- src/oss/langchain/component-architecture.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oss/langchain/component-architecture.mdx b/src/oss/langchain/component-architecture.mdx index b2dbd9a48b..0e85dc2a1f 100644 --- a/src/oss/langchain/component-architecture.mdx +++ b/src/oss/langchain/component-architecture.mdx @@ -2,7 +2,7 @@ title: Component architecture --- -LangChain's power comes from how its components work together to create sophisticated AI applications. This page provides visual diagrams showing the relationships between different components, helping you understand how they fit together. +LangChain's power comes from how its components work together to create sophisticated AI applications. This page provides visual diagrams showing the relationships between different components. ## Core component ecosystem From 879833b831a00bc4b5ad538139d84e1c06ef4bb3 Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Sat, 15 Nov 2025 22:59:19 -0500 Subject: [PATCH 3/5] Update src/oss/langchain/component-architecture.mdx Co-authored-by: Lauren Hirata Singh --- src/oss/langchain/component-architecture.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oss/langchain/component-architecture.mdx b/src/oss/langchain/component-architecture.mdx index 0e85dc2a1f..c2827fd222 100644 --- a/src/oss/langchain/component-architecture.mdx +++ b/src/oss/langchain/component-architecture.mdx @@ -123,7 +123,7 @@ graph LR B --> F[Coordinated Response] ``` -## Next steps +## Learn more Now that you understand how components relate to each other, explore specific areas: From e1638667b3968fbef671a9bf1dc6fa9d216bc94a Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Sat, 15 Nov 2025 23:02:29 -0500 Subject: [PATCH 4/5] docs.json --- src/docs.json | 779 ++++++++++++++------------------------------------ 1 file changed, 217 insertions(+), 562 deletions(-) diff --git a/src/docs.json b/src/docs.json index 03cd28d273..944cd19c1b 100644 --- a/src/docs.json +++ b/src/docs.json @@ -347,568 +347,222 @@ ] }, { - "group": "Functional API", - "pages": [ - "oss/python/langgraph/functional-api", - "oss/python/langgraph/use-functional-api" - ] - }, - "oss/python/langgraph/pregel" - ] - } - ] - }, - { - "tab": "Deep Agents", - "pages": [ - "oss/python/deepagents/overview", - { - "group": "Get started", - "pages": [ - "oss/python/deepagents/quickstart", - "oss/python/deepagents/customization" - ] - }, - { - "group": "Core capabilities", - "pages": [ - "oss/python/deepagents/harness", - "oss/python/deepagents/backends", - "oss/python/deepagents/subagents", - "oss/python/deepagents/human-in-the-loop", - "oss/python/deepagents/long-term-memory" - ] - } - ] - }, - { - "tab": "Integrations", - "pages": [ - "oss/python/integrations/providers/overview", - "oss/python/integrations/providers/all_providers", - { - "group": "Popular Providers", - "icon": "user-group", - "pages": [ - "oss/python/integrations/providers/openai", - "oss/python/integrations/providers/anthropic", - "oss/python/integrations/providers/google", - "oss/python/integrations/providers/aws", - "oss/python/integrations/providers/huggingface", - "oss/python/integrations/providers/microsoft", - "oss/python/integrations/providers/ollama" - ] - }, - { - "group": "Integrations by component", - "icon": "plug", - "pages": [ - "oss/python/integrations/chat/index", - "oss/python/integrations/tools/index", - "oss/python/integrations/retrievers/index", - "oss/python/integrations/splitters/index", - "oss/python/integrations/text_embedding/index", - "oss/python/integrations/vectorstores/index", - "oss/python/integrations/document_loaders/index", - "oss/python/integrations/stores/index" - ] - } - ] - }, - { - "tab": "Learn", - "pages": [ - "oss/python/learn", - { - "group": "Tutorials", - "icon": "code", - "pages": [ - { - "group": "LangChain", - "expanded": true, - "pages": [ - "oss/python/langchain/knowledge-base", - "oss/python/langchain/rag", - "oss/python/langchain/sql-agent", - "oss/python/langchain/supervisor" - ] - }, - { - "group": "LangGraph", - "expanded": true, - "pages": [ - "oss/python/langgraph/agentic-rag", - "oss/python/langgraph/sql-agent" - ] - } - ] - }, - { - "group": "Conceptual overviews", - "icon": "book", - "pages": [ - "oss/python/langchain/component-architecture", - "oss/python/concepts/memory", - "oss/python/concepts/context", - "oss/python/langgraph/graph-api", - "oss/python/langgraph/functional-api" - ] - }, - { - "group": "Additional resources", - "icon": "list", - "pages": [ - "oss/python/langchain/academy", - "oss/python/langgraph/case-studies" - ] - } - ] - }, - { - "tab": "Reference", - "pages": [ - "oss/python/reference/overview", - { - "group": "Reference", - "pages": [ - "oss/python/reference/langchain-python", - "oss/python/reference/langgraph-python", - "oss/python/reference/integrations-python", - "oss/python/reference/deepagents-python" - ] - }, - { - "group": "Error troubleshooting", - "pages": [ - "oss/python/common-errors", - { - "group": "Errors", - "pages": [ - "oss/python/langgraph/errors/GRAPH_RECURSION_LIMIT", - "oss/python/langgraph/errors/INVALID_CHAT_HISTORY", - "oss/python/langgraph/errors/INVALID_CONCURRENT_GRAPH_UPDATE", - "oss/python/langgraph/errors/INVALID_GRAPH_NODE_RETURN_VALUE", - "oss/python/langchain/errors/INVALID_PROMPT_INPUT", - "oss/python/langchain/errors/INVALID_TOOL_RESULTS", - "oss/python/langchain/errors/MESSAGE_COERCION_FAILURE", - "oss/python/langgraph/errors/MISSING_CHECKPOINTER", - "oss/python/langchain/errors/MODEL_AUTHENTICATION", - "oss/python/langchain/errors/MODEL_NOT_FOUND", - "oss/python/langchain/errors/MODEL_RATE_LIMIT", - "oss/python/langgraph/errors/MULTIPLE_SUBGRAPHS", - "oss/python/langchain/errors/OUTPUT_PARSING_FAILURE" - ] - } - ] - }, - { - "group": "Release versions", - "pages": [ - "oss/python/versioning", - { - "group": "Releases", - "pages": [ - "oss/python/releases/langchain-v1" - ] - }, - { - "group": "Migration guides", - "pages": [ - "oss/python/migrate/langchain-v1" - ] - } - ] - }, - { - "group": "Policies", - "pages": [ - "oss/python/release-policy", - "oss/python/security-policy" - ] - } - ] - }, - { - "tab": "Contribute", - "pages": [ - "oss/python/contributing/overview", - { - "group": "Contribute", - "icon": "heart-circle-plus", - "pages": [ - "oss/python/contributing/documentation", - "oss/python/contributing/code" - ] - }, - { - "group": "Integrations", - "icon": "plug", - "pages": [ - { - "group": "LangChain", - "pages": [ - "oss/python/contributing/integrations-langchain", - "oss/python/contributing/implement-langchain", - "oss/python/contributing/standard-tests-langchain", - "oss/python/contributing/publish-langchain" - ] - }, - { - "group": "LangGraph", - "pages": [ - "oss/python/contributing/integrations-langgraph", - "oss/python/contributing/implement-langgraph", - "oss/python/contributing/standard-tests-langgraph", - "oss/python/contributing/publish-langgraph" - ] - }, - "oss/python/contributing/comarketing" - ] - } - ] - } - ] - }, - { - "dropdown": "TypeScript", - "icon": "square-js", - "tabs": [ - { - "tab": "LangChain", - "pages": [ - "oss/javascript/langchain/overview", - { - "group": "LangChain v1.0", - "pages": [ - "oss/javascript/releases/langchain-v1", - "oss/javascript/migrate/langchain-v1" - ] - }, - { - "group": "Get started", - "pages": [ - "oss/javascript/langchain/install", - "oss/javascript/langchain/quickstart", - "oss/javascript/langchain/philosophy" - ] - }, - { - "group": "Core components", - "pages": [ - "oss/javascript/langchain/agents", - "oss/javascript/langchain/models", - "oss/javascript/langchain/messages", - "oss/javascript/langchain/tools", - "oss/javascript/langchain/short-term-memory", - "oss/javascript/langchain/streaming", - "oss/javascript/langchain/middleware", - "oss/javascript/langchain/structured-output" - ] - }, - { - "group": "Advanced usage", - "pages": [ - "oss/javascript/langchain/guardrails", - "oss/javascript/langchain/runtime", - "oss/javascript/langchain/context-engineering", - "oss/javascript/langchain/mcp", - "oss/javascript/langchain/human-in-the-loop", - "oss/javascript/langchain/multi-agent", - "oss/javascript/langchain/retrieval", - "oss/javascript/langchain/long-term-memory" - ] - }, - { - "group": "Use in production", - "pages": [ - "oss/javascript/langchain/studio", - "oss/javascript/langchain/test", - "oss/javascript/langchain/deploy", - "oss/javascript/langchain/ui", - "oss/javascript/langchain/observability" - ] - } - ] - }, - { - "tab": "LangGraph", - "pages": [ - "oss/javascript/langgraph/overview", - { - "group": "LangGraph v1.0", - "pages": [ - "oss/javascript/releases/langgraph-v1", - "oss/javascript/migrate/langgraph-v1" - ] - }, - { - "group": "Get started", - "pages": [ - "oss/javascript/langgraph/install", - "oss/javascript/langgraph/quickstart", - "oss/javascript/langgraph/local-server", - "oss/javascript/langgraph/thinking-in-langgraph", - "oss/javascript/langgraph/workflows-agents" - ] - }, - { - "group": "Capabilities", - "pages": [ - "oss/javascript/langgraph/persistence", - "oss/javascript/langgraph/durable-execution", - "oss/javascript/langgraph/streaming", - "oss/javascript/langgraph/interrupts", - "oss/javascript/langgraph/use-time-travel", - "oss/javascript/langgraph/add-memory", - "oss/javascript/langgraph/use-subgraphs" - ] - }, - { - "group": "Production", - "pages": [ - "oss/javascript/langgraph/application-structure", - "oss/javascript/langgraph/studio", - "oss/javascript/langgraph/test", - "oss/javascript/langgraph/deploy", - "oss/javascript/langgraph/ui", - "oss/javascript/langgraph/observability" - ] - }, - { - "group": "LangGraph APIs", - "pages": [ - { - "group": "Graph API", - "pages": [ - "oss/javascript/langgraph/graph-api", - "oss/javascript/langgraph/use-graph-api" - ] - }, - { - "group": "Functional API", - "pages": [ - "oss/javascript/langgraph/functional-api", - "oss/javascript/langgraph/use-functional-api" - ] - }, - "oss/javascript/langgraph/pregel" - ] - } - ] - }, - { - "tab": "Integrations", - "pages": [ - "oss/javascript/integrations/providers/overview", - "oss/javascript/integrations/providers/all_providers", - { - "group": "Popular Providers", - "icon": "user-group", - "pages": [ - { - "group": "OpenAI", - "pages": [ - "oss/javascript/integrations/providers/openai", - "oss/javascript/integrations/chat/openai", - "oss/javascript/integrations/text_embedding/openai" - ] - }, - { - "group": "Anthropic", - "pages": [ - "oss/javascript/integrations/providers/anthropic", - "oss/javascript/integrations/chat/anthropic" - ] - }, - { - "group": "Google", - "pages": [ - "oss/javascript/integrations/providers/google", - "oss/javascript/integrations/chat/google_generative_ai", - "oss/javascript/integrations/text_embedding/google_generativeai" - ] - }, - { - "group": "AWS", - "pages": [ - "oss/javascript/integrations/providers/aws", - "oss/javascript/integrations/chat/bedrock", - "oss/javascript/integrations/text_embedding/bedrock" - ] - }, - { - "group": "Microsoft", - "pages": [ - "oss/javascript/integrations/providers/microsoft", - "oss/javascript/integrations/chat/azure", - "oss/javascript/integrations/text_embedding/azure_openai" - ] - } - ] - }, - { - "group": "General integrations", - "icon": "plug", - "pages": [ - "oss/javascript/integrations/chat/index", - "oss/javascript/integrations/tools/index", - "oss/javascript/integrations/llms/index", - "oss/javascript/integrations/stores/index", - "oss/javascript/integrations/document_transformers/index", - "oss/javascript/integrations/llm_caching/index", - "oss/javascript/integrations/callbacks/index" - ] - }, - { - "group": "RAG integrations", - "icon": "database", - "pages": [ - "oss/javascript/integrations/retrievers/index", - "oss/javascript/integrations/splitters/index", - "oss/javascript/integrations/text_embedding/index", - "oss/javascript/integrations/vectorstores/index", - "oss/javascript/integrations/document_loaders/index", - "oss/javascript/integrations/stores/index" - ] - } - ] - }, - { - "tab": "Learn", - "pages": [ - "oss/javascript/learn", - { - "group": "Tutorials", - "icon": "code", - "pages": [ - "oss/javascript/langchain/knowledge-base", - "oss/javascript/langchain/rag", - "oss/javascript/langchain/sql-agent", - "oss/javascript/langchain/supervisor", - "oss/javascript/langgraph/agentic-rag" - ] - }, - { - "group": "Conceptual overviews", - "icon": "book", - "pages": [ - "oss/javascript/langchain/component-architecture", - "oss/javascript/concepts/memory", - "oss/javascript/concepts/context", - "oss/javascript/langgraph/graph-api", - "oss/javascript/langgraph/functional-api" - ] - }, - { - "group": "LangChain Academy", - "icon": "graduation-cap", - "pages": [ - "oss/javascript/langchain/academy" - ] - }, - { - "group": "Additional resources", - "icon": "list", - "pages": [ - "oss/javascript/langgraph/case-studies" - ] - } - ] - }, - { - "tab": "Reference", - "pages": [ - "oss/javascript/reference/overview", - { - "group": "Reference", - "pages": [ - "oss/javascript/reference/langchain-javascript", - "oss/javascript/reference/langgraph-javascript" - ] - }, - { - "group": "Error troubleshooting", - "pages": [ - "oss/javascript/common-errors", - { - "group": "Errors", - "pages": [ - "oss/javascript/langgraph/errors/GRAPH_RECURSION_LIMIT", - "oss/javascript/langgraph/errors/INVALID_CHAT_HISTORY", - "oss/javascript/langgraph/errors/INVALID_CONCURRENT_GRAPH_UPDATE", - "oss/javascript/langgraph/errors/INVALID_GRAPH_NODE_RETURN_VALUE", - "oss/javascript/langchain/errors/INVALID_PROMPT_INPUT", - "oss/javascript/langchain/errors/INVALID_TOOL_RESULTS", - "oss/javascript/langchain/errors/MESSAGE_COERCION_FAILURE", - "oss/javascript/langgraph/errors/MISSING_CHECKPOINTER", - "oss/javascript/langchain/errors/MODEL_AUTHENTICATION", - "oss/javascript/langchain/errors/MODEL_NOT_FOUND", - "oss/javascript/langchain/errors/MODEL_RATE_LIMIT", - "oss/javascript/langgraph/errors/MULTIPLE_SUBGRAPHS", - "oss/javascript/langchain/errors/OUTPUT_PARSING_FAILURE" - ] - } - ] - }, - { - "group": "Release versions", - "pages": [ - "oss/javascript/versioning", - { - "group": "Releases", - "pages": [ - "oss/javascript/releases/langchain-v1" - ] - }, - { - "group": "Migration guides", - "pages": [ - "oss/javascript/migrate/langchain-v1" - ] - } - ] - }, - { - "group": "Policies", - "pages": [ - "oss/javascript/release-policy", - "oss/javascript/security-policy" - ] - } - ] - }, - { - "tab": "Contribute", - "pages": [ - "oss/javascript/contributing/overview", - { - "group": "Contribute", - "icon": "heart-circle-plus", - "pages": [ - "oss/javascript/contributing/documentation", - "oss/javascript/contributing/code" - ] - }, - { - "group": "Integrations", - "icon": "plug", - "pages": [ - { - "group": "LangChain", - "pages": [ - "oss/javascript/contributing/integrations-langchain", - "oss/javascript/contributing/implement-langchain", - "oss/javascript/contributing/standard-tests-langchain", - "oss/javascript/contributing/publish-langchain" - ] - }, - { - "group": "LangGraph", - "pages": [ - "oss/javascript/contributing/integrations-langgraph", - "oss/javascript/contributing/implement-langgraph", - "oss/javascript/contributing/standard-tests-langgraph", - "oss/javascript/contributing/publish-langgraph" + "group": "LangGraph", + "expanded": true, + "pages": [ + "oss/python/langgraph/agentic-rag", + "oss/python/langgraph/sql-agent" + ] + } + ] + }, + { + "group": "Conceptual overviews", + "icon": "book", + "pages": [ + "oss/python/langchain/component-architecture", + "oss/python/concepts/memory", + "oss/python/concepts/context", + "oss/python/langgraph/graph-api", + "oss/python/langgraph/functional-api" + ] + }, + { + "group": "Additional resources", + "icon": "list", + "pages": [ + "oss/python/langchain/academy", + "oss/python/langgraph/case-studies" + ] + } + ] + }, + { + "tab": "Reference", + "pages": [ + "oss/python/reference/overview", + { + "group": "Reference", + "pages": [ + "oss/python/reference/langchain-python", + "oss/python/reference/langgraph-python", + "oss/python/reference/integrations-python", + "oss/python/reference/deepagents-python" + ] + }, + { + "group": "Errors", + "pages": [ + "oss/python/common-errors" + ] + }, + { + "group": "Releases", + "pages": [ + "oss/python/versioning", + { + "group": "Releases", + "pages": [ + "oss/python/releases/langchain-v1" + ] + }, + { + "group": "Migration guides", + "pages": [ + "oss/python/migrate/langchain-v1" + ] + } + ] + }, + { + "group": "Policies", + "pages": [ + "oss/python/release-policy", + "oss/python/security-policy" + ] + } + ] + }, + { + "tab": "Contribute", + "pages": [ + "oss/python/contributing/overview", + { + "group": "Contribute", + "icon": "heart-circle-plus", + "pages": [ + "oss/python/contributing/documentation", + "oss/python/contributing/code" + ] + }, + { + "group": "Integrations", + "icon": "plug", + "pages": [ + { + "group": "LangChain", + "pages": [ + "oss/python/contributing/integrations-langchain", + "oss/python/contributing/implement-langchain", + "oss/python/contributing/standard-tests-langchain", + "oss/python/contributing/publish-langchain" + ] + }, + { + "group": "LangGraph", + "pages": [ + "oss/python/contributing/integrations-langgraph", + "oss/python/contributing/implement-langgraph", + "oss/python/contributing/standard-tests-langgraph", + "oss/python/contributing/publish-langgraph" + ] + }, + "oss/python/contributing/comarketing" + ] + } + ] + } + ] + }, + { + "dropdown": "TypeScript", + "icon": "square-js", + "tabs": [ + { + "tab": "LangChain", + "pages": [ + "oss/javascript/langchain/overview", + { + "group": "LangChain v1.0", + "pages": [ + "oss/javascript/releases/langchain-v1", + "oss/javascript/migrate/langchain-v1" + ] + }, + { + "group": "Get started", + "pages": [ + "oss/javascript/langchain/install", + "oss/javascript/langchain/quickstart", + "oss/javascript/langchain/philosophy" + ] + }, + { + "group": "Core components", + "pages": [ + "oss/javascript/langchain/agents", + "oss/javascript/langchain/models", + "oss/javascript/langchain/messages", + "oss/javascript/langchain/tools", + "oss/javascript/langchain/short-term-memory", + "oss/javascript/langchain/streaming", + "oss/javascript/langchain/structured-output" + ] + }, + { + "group": "Middleware", + "pages": [ + "oss/javascript/langchain/middleware/overview", + "oss/javascript/langchain/middleware/built-in", + "oss/javascript/langchain/middleware/custom" + ] + }, + { + "group": "Advanced usage", + "pages": [ + "oss/javascript/langchain/guardrails", + "oss/javascript/langchain/runtime", + "oss/javascript/langchain/context-engineering", + "oss/javascript/langchain/mcp", + "oss/javascript/langchain/human-in-the-loop", + "oss/javascript/langchain/multi-agent", + "oss/javascript/langchain/retrieval", + "oss/javascript/langchain/long-term-memory" + ] + }, + { + "group": "Use in production", + "pages": [ + "oss/javascript/langchain/studio", + "oss/javascript/langchain/test", + "oss/javascript/langchain/deploy", + "oss/javascript/langchain/ui", + "oss/javascript/langchain/observability" + ] + } + ] + }, + { + "tab": "LangGraph", + "pages": [ + "oss/javascript/langgraph/overview", + { + "group": "LangGraph v1.0", + "pages": [ + "oss/javascript/releases/langgraph-v1", + "oss/javascript/migrate/langgraph-v1" + ] + }, + { + "group": "Get started", + "pages": [ + "oss/javascript/langgraph/install", + "oss/javascript/langgraph/quickstart", + "oss/javascript/langgraph/local-server", + "oss/javascript/langgraph/thinking-in-langgraph", + "oss/javascript/langgraph/workflows-agents" + ] + }, + { + "group": "Capabilities", + "pages": [ + "oss/javascript/langgraph/persistence", + "oss/javascript/langgraph/durable-execution", + "oss/javascript/langgraph/streaming", + "oss/javascript/langgraph/interrupts", + "oss/javascript/langgraph/use-time-travel", + "oss/javascript/langgraph/add-memory", + "oss/javascript/langgraph/use-subgraphs" ] }, { @@ -1070,6 +724,7 @@ "group": "Conceptual overviews", "icon": "book", "pages": [ + "oss/javascript/langchain/component-architecture", "oss/javascript/concepts/memory", "oss/javascript/concepts/context", "oss/javascript/langgraph/graph-api", From a14de4d0d8df5e09447f689a3da83468eba98cf6 Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Sat, 15 Nov 2025 23:09:26 -0500 Subject: [PATCH 5/5] cr --- src/oss/langchain/component-architecture.mdx | 85 +++++++++----------- 1 file changed, 36 insertions(+), 49 deletions(-) diff --git a/src/oss/langchain/component-architecture.mdx b/src/oss/langchain/component-architecture.mdx index c2827fd222..a66a5838ae 100644 --- a/src/oss/langchain/component-architecture.mdx +++ b/src/oss/langchain/component-architecture.mdx @@ -2,7 +2,7 @@ title: Component architecture --- -LangChain's power comes from how its components work together to create sophisticated AI applications. This page provides visual diagrams showing the relationships between different components. +LangChain's power comes from how its components work together to create sophisticated AI applications. This page provides diagrams showcasing the relationships between different components. ## Core component ecosystem @@ -10,36 +10,36 @@ The diagram below shows how LangChain's major components connect to form complet ```mermaid graph TD - %% Input Processing - subgraph "📥 Input Processing" - A[Text Input] --> B[Document Loaders] - B --> C[Text Splitters] + %% Input processing + subgraph "📥 Input processing" + A[Text input] --> B[Document loaders] + B --> C[Text splitters] C --> D[Documents] end - %% Embedding & Storage - subgraph "🔢 Embedding & Storage" - D --> E[Embedding Models] + %% Embedding & storage + subgraph "🔢 Embedding & storage" + D --> E[Embedding models] E --> F[Vectors] - F --> G[(Vector Stores)] + F --> G[(Vector stores)] end %% Retrieval subgraph "🔍 Retrieval" - H[User Query] --> I[Embedding Models] - I --> J[Query Vector] + H[User Query] --> I[Embedding models] + I --> J[Query vector] J --> K[Retrievers] K --> G - G --> L[Relevant Context] + G --> L[Relevant context] end %% Generation subgraph "🤖 Generation" - M[Chat Models] --> N[Tools] - N --> O[Tool Results] + M[Chat models] --> N[Tools] + N --> O[Tool results] O --> M L --> M - M --> P[AI Response] + M --> P[AI response] end %% Orchestration @@ -49,27 +49,14 @@ graph TD Q --> K Q --> R[Memory] end - - %% Styling - classDef inputStyle fill:#e1f5fe,stroke:#0277bd - classDef embeddingStyle fill:#f3e5f5,stroke:#7b1fa2 - classDef retrievalStyle fill:#e8f5e8,stroke:#388e3c - classDef generationStyle fill:#fff3e0,stroke:#f57c00 - classDef orchestrationStyle fill:#fce4ec,stroke:#c2185b - - class A,B,C,D inputStyle - class E,F,G embeddingStyle - class H,I,J,K,L retrievalStyle - class M,N,O,P generationStyle - class Q,R orchestrationStyle ``` ### How components connect Each component layer builds on the previous ones: -1. **Input Processing** – Transform raw data into structured documents -2. **Embedding & Storage** – Convert text into searchable vector representations +1. **Input processing** – Transform raw data into structured documents +2. **Embedding & storage** – Convert text into searchable vector representations 3. **Retrieval** – Find relevant information based on user queries 4. **Generation** – Use AI models to create responses, optionally with tools 5. **Orchestration** – Coordinate everything through agents and memory systems @@ -85,7 +72,7 @@ LangChain organizes components into these main categories: | **[Agents](/oss/langchain/agents)** | Orchestration and reasoning | ReAct agents, tool calling agents | Nondeterministic workflows, decision making | | **[Memory](/oss/langchain/short-term-memory)** | Context preservation | Message history, custom state | Conversations, stateful interactions | | **[Retrievers](/oss/integrations/retrievers)** | Information access | Vector retrievers, web retrievers | RAG, knowledge base search | -| **[Document Processing](/oss/integrations/document_loaders)** | Data ingestion | Loaders, splitters, transformers | PDF processing, web scraping | +| **[Document processing](/oss/integrations/document_loaders)** | Data ingestion | Loaders, splitters, transformers | PDF processing, web scraping | | **[Vector Stores](/oss/integrations/vectorstores)** | Semantic search | Chroma, Pinecone, FAISS | Similarity search, embeddings storage | ## Common patterns @@ -93,42 +80,42 @@ LangChain organizes components into these main categories: ### RAG (Retrieval-Augmented Generation) ```mermaid graph LR - A[User Question] --> B[Retriever] - B --> C[Relevant Docs] - C --> D[Chat Model] + A[User question] --> B[Retriever] + B --> C[Relevant docs] + C --> D[Chat model] A --> D - D --> E[Informed Response] + D --> E[Informed response] ``` ### Agent with tools ```mermaid graph LR - A[User Request] --> B[Agent] - B --> C{Need Tool?} - C -->|Yes| D[Call Tool] - D --> E[Tool Result] + A[User request] --> B[Agent] + B --> C{Need tool?} + C -->|Yes| D[Call tool] + D --> E[Tool result] E --> B - C -->|No| F[Final Answer] + C -->|No| F[Final answer] ``` ### Multi-agent system ```mermaid graph LR - A[Complex Task] --> B[Supervisor Agent] - B --> C[Specialist Agent 1] - B --> D[Specialist Agent 2] + A[Complex Task] --> B[Supervisor agent] + B --> C[Specialist agent 1] + B --> D[Specialist agent 2] C --> E[Results] D --> E E --> B - B --> F[Coordinated Response] + B --> F[Coordinated response] ``` ## Learn more Now that you understand how components relate to each other, explore specific areas: -- **Building your first RAG system**: [Knowledge Base Tutorial](/oss/langchain/knowledge-base) -- **Creating agents**: [Agents Guide](/oss/langchain/agents) -- **Working with tools**: [Tools Guide](/oss/langchain/tools) -- **Setting up memory**: [Memory Guide](/oss/langchain/short-term-memory) -- **Browse integrations**: [All Integrations](/oss/integrations/providers/overview) +- [Building your first RAG system](/oss/langchain/knowledge-base) +- [Creating agents](/oss/langchain/agents) +- [Working with tools](/oss/langchain/tools) +- [Setting up memory](/oss/langchain/short-term-memory) +- [Browse integrations](/oss/integrations/providers/overview)