From 95c813e4b85fb5f3e3cdcfe0db231bd9680c6d9c Mon Sep 17 00:00:00 2001 From: Eugene Yurtsev Date: Tue, 22 Oct 2024 11:13:40 -0400 Subject: [PATCH] concept docs more fixes (#27543) Update architecture page --- docs/docs/concepts/architecture.mdx | 42 ++++++++++++++++++--------- docs/docs/concepts/text_splitters.mdx | 2 +- 2 files changed, 29 insertions(+), 15 deletions(-) diff --git a/docs/docs/concepts/architecture.mdx b/docs/docs/concepts/architecture.mdx index a38087ad52f..9e69fefc648 100644 --- a/docs/docs/concepts/architecture.mdx +++ b/docs/docs/concepts/architecture.mdx @@ -1,27 +1,24 @@ import ThemedImage from '@theme/ThemedImage'; import useBaseUrl from '@docusaurus/useBaseUrl'; -In this section, you'll find explanations of the key concepts, providing a deeper understanding of core principles. - -The conceptual guide will not cover step-by-step instructions or specific implementation details — those are found in the [How-To Guides](/docs/how_to/) and [Tutorials](/docs/tutorials) sections. For detailed reference material, please visit the [API Reference](https://python.langchain.com/api_reference/). - ## Architecture LangChain as a framework consists of a number of packages. -### `langchain-core` +### langchain-core + This package contains base abstractions of different components and ways to compose them together. The interfaces for core components like LLMs, vector stores, retrievers and more are defined here. No third party integrations are defined here. The dependencies are kept purposefully very lightweight. -### `langchain` +### langchain The main `langchain` package contains chains, agents, and retrieval strategies that make up an application's cognitive architecture. These are NOT third party integrations. All chains, agents, and retrieval strategies here are NOT specific to any one integration, but rather generic across all integrations. -### `langchain-community` +### langchain-community This package contains third party integrations that are maintained by the LangChain community. Key partner packages are separated out (see below). @@ -30,24 +27,41 @@ All dependencies in this package are optional to keep the package as lightweight ### Partner packages -While the long tail of integrations is in `langchain-community`, we split popular integrations into their own packages (e.g. `langchain-openai`, `langchain-anthropic`, etc). -This was done in order to improve support for these important integrations. +While the long tail of integrations is in `langchain-community`, we split popular integrations into their own packages (e.g. `langchain-openai`, `langchain-anthropic`, etc). This was done in order to improve support for these important integrations. -### [`langgraph`](https://langchain-ai.github.io/langgraph) +For more information see: -`langgraph` is an extension of `langchain` aimed at -building robust and stateful multi-actor applications with LLMs by modeling steps as edges and nodes in a graph. +* A list [LangChain integrations](/docs/integrations/providers/) +* The [LangChain API Reference](https://python.langchain.com/api_reference/) where you can find detailed information about the API reference of each partner package. + +### LangGraph + +`langgraph` is an extension of `langchain` aimed at building robust and stateful multi-actor applications with LLMs by modeling steps as edges and nodes in a graph. LangGraph exposes high level interfaces for creating common types of agents, as well as a low-level API for composing custom flows. -### [`langserve`](/docs/langserve) +For more information, see the [LangGraph documentation](https://langchain-ai.github.io/langgraph). + +### LangServe A package to deploy LangChain chains as REST APIs. Makes it easy to get a production ready API up and running. -### [LangSmith](https://docs.smith.langchain.com) +:::important +LangServe is designed to primarily deploy simple Runnables and work with well-known primitives in langchain-core. + +If you need a deployment option for LangGraph, you should instead be looking at LangGraph Cloud (beta) which will be better suited for deploying LangGraph applications. +::: + +For more information, see the [LangServe documentation](/docs/langserve). + + +### LangSmith A developer platform that lets you debug, test, evaluate, and monitor LLM applications. +For more information, see the [LangSmith documentation](https://docs.smith.langchain.com) + + + :::info[Prerequisites]