-
Notifications
You must be signed in to change notification settings - Fork 112
reorganize pages #891
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
+118
−118
Closed
reorganize pages #891
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -5,51 +5,6 @@ sidebarTitle: Migrate to v1 | |||||
|
|
||||||
| This guide outlines the major changes between LangChain v1 and previous versions. | ||||||
|
|
||||||
| ## Simplified package | ||||||
|
|
||||||
| The `langchain` package namespace has been significantly reduced in v1 to focus on essential building blocks for agents. The streamlined package makes it easier to discover and use the core functionality. | ||||||
|
|
||||||
| ### Namespace | ||||||
|
|
||||||
| | Module | What's available | Notes | | ||||||
| |--------|------------------|-------| | ||||||
| | `langchain.agents` | `create_agent`, `AgentState` | Core agent creation functionality | | ||||||
| | `langchain.messages` | Message types, content blocks, `trim_messages` | Re-exported from `langchain-core` | | ||||||
| | `langchain.tools` | `tool`, `BaseTool`, injection helpers | Re-exported from `langchain-core` | | ||||||
| | `langchain.chat_models` | `init_chat_model`, `BaseChatModel` | Unified model initialization | | ||||||
| | `langchain.embeddings` | `Embeddings`, `init_embeddings`, | Embedding models | | ||||||
|
|
||||||
| ### `langchain-classic` | ||||||
|
|
||||||
| If you were using any of the following from the `langchain` package, you'll need to install `langchain-classic` and update your imports: | ||||||
|
|
||||||
| - Legacy chains (`LLMChain`, `ConversationChain`, etc.) | ||||||
| - The indexing API | ||||||
| - `langchain-community` re-exports | ||||||
| - Other deprecated functionality | ||||||
|
|
||||||
| <CodeGroup> | ||||||
| ```python v1 (new) | ||||||
| # For legacy chains | ||||||
| from langchain_classic.chains import LLMChain | ||||||
|
|
||||||
| # For indexing | ||||||
| from langchain_classic.indexes import ... | ||||||
| ``` | ||||||
|
|
||||||
| ```python v0 (old) | ||||||
| from langchain.chains import LLMChain | ||||||
| from langchain.indexes import ... | ||||||
| ``` | ||||||
| </CodeGroup> | ||||||
|
|
||||||
| **Installation**: | ||||||
| ```bash | ||||||
| uv pip install langchain-classic | ||||||
| ``` | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Migrate to `create_agent` | ||||||
|
|
||||||
| Pre v1, we recommended you use `langgraph.prebuilt.create_react_agent` to build agents. | ||||||
|
|
@@ -69,7 +24,7 @@ The table below outlines what functionality has changed from `create_react_agent | |||||
| | [Structured output](#structured-output) | prompted output removed, use `ToolStrategy`/`ProviderStrategy` | | ||||||
| | [Streaming node name](#streaming-node-name-rename) | Node name changed from `"agent"` to `"model"` | | ||||||
| | [Runtime context](#runtime-context) | Dependency injection via `context` argument instead of `config["configurable"]` | | ||||||
| | [Namespace](#simplified-namespace) | Streamlined to focus on agent building blocks, legacy code moved to `langchain-classic` | | ||||||
| | [Namespace](#simplified-package) | Streamlined to focus on agent building blocks, legacy code moved to `langchain-classic` | | ||||||
|
|
||||||
| ### Import path | ||||||
|
|
||||||
|
|
@@ -665,6 +620,51 @@ result = agent.invoke( | |||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Simplified package | ||||||
|
|
||||||
| The `langchain` package namespace has been significantly reduced in v1 to focus on essential building blocks for agents. The streamlined package makes it easier to discover and use the core functionality. | ||||||
|
|
||||||
| ### Namespace | ||||||
|
|
||||||
| | Module | What's available | Notes | | ||||||
| |--------|------------------|-------| | ||||||
| | `langchain.agents` | `create_agent`, `AgentState` | Core agent creation functionality | | ||||||
| | `langchain.messages` | Message types, content blocks, `trim_messages` | Re-exported from `langchain-core` | | ||||||
| | `langchain.tools` | `tool`, `BaseTool`, injection helpers | Re-exported from `langchain-core` | | ||||||
| | `langchain.chat_models` | `init_chat_model`, `BaseChatModel` | Unified model initialization | | ||||||
| | `langchain.embeddings` | `Embeddings`, `init_embeddings`, | Embedding models | | ||||||
|
|
||||||
| ### `langchain-classic` | ||||||
|
|
||||||
| If you were using any of the following from the `langchain` package, you'll need to install `langchain-classic` and update your imports: | ||||||
|
|
||||||
| - Legacy chains (`LLMChain`, `ConversationChain`, etc.) | ||||||
| - The indexing API | ||||||
| - `langchain-community` re-exports | ||||||
| - Other deprecated functionality | ||||||
|
|
||||||
| <CodeGroup> | ||||||
| ```python v1 (new) | ||||||
| # For legacy chains | ||||||
| from langchain_classic.chains import LLMChain | ||||||
|
|
||||||
| # For indexing | ||||||
| from langchain_classic.indexes import ... | ||||||
| ``` | ||||||
|
|
||||||
| ```python v0 (old) | ||||||
| from langchain.chains import LLMChain | ||||||
| from langchain.indexes import ... | ||||||
| ``` | ||||||
| </CodeGroup> | ||||||
|
|
||||||
| **Installation**: | ||||||
| ```bash | ||||||
| uv pip install langchain-classic | ||||||
| ``` | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## Breaking changes | ||||||
|
|
||||||
| ### Dropped Python 3.9 support | ||||||
|
|
@@ -699,7 +699,7 @@ The `max_tokens` parameter now defaults to higher values based on the model chos | |||||
|
|
||||||
| ### Legacy code moved to `langchain-classic` | ||||||
|
|
||||||
| Existing functionality outside the focus of standard interfaces and agents has been moved to the [`langchain-classic`](https://pypi.org/project/langchain-classic) package. See the [Simplified namespace](#simplified-namespace) section for details on what's available in the core `langchain` package and what moved to `langchain-classic`. | ||||||
| Existing functionality outside the focus of standard interfaces and agents has been moved to the [`langchain-classic`](https://pypi.org/project/langchain-classic) package. See the [Simplified package](#simplified-package) section for details on what's available in the core `langchain` package and what moved to `langchain-classic`. | ||||||
|
||||||
| Existing functionality outside the focus of standard interfaces and agents has been moved to the [`langchain-classic`](https://pypi.org/project/langchain-classic) package. See the [Simplified package](#simplified-package) section for details on what's available in the core `langchain` package and what moved to `langchain-classic`. | |
| Existing functionality outside the focus of standard interfaces and agents has been moved to the [`langchain-classic`](https://pypi.org/project/langchain-classic) package. See the [Package: Simplified](#package-simplified) section for details on what's available in the core `langchain` package and what moved to `langchain-classic`. |
Copilot uses AI. Check for mistakes.
Positive FeedbackNegative Feedback
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The anchor link '#simplified-package' should be '#simplified-namespace' to match the actual section heading 'Simplified package' which would generate the anchor 'simplified-package', but the table row describes 'Namespace' functionality. This creates inconsistency between the link text and target.
Copilot uses AI. Check for mistakes.