From 25b8cc7e3d9aae8de94849550d1fe6555843f684 Mon Sep 17 00:00:00 2001 From: Harrison Chase Date: Thu, 27 Jul 2023 17:18:19 -0700 Subject: [PATCH] Harrison/update memory docs (#8384) Co-authored-by: Bagatur --- .../modules/memory/chat_messages/index.mdx | 17 + .../docs/modules/memory/index.mdx | 66 ++-- .../modules/memory/{ => types}/buffer.mdx | 2 +- .../memory/{ => types}/buffer_window.mdx | 2 +- .../{ => types}/entity_summary_memory.mdx | 2 +- .../docs/modules/memory/types/index.mdx | 8 + .../modules/memory/{ => types}/summary.mdx | 2 +- .../vectorstore_retriever_memory.mdx | 2 +- .../static/img/memory_diagram.png | Bin 0 -> 113244 bytes .../modules/memory/{ => types}/kg.ipynb | 0 .../memory/{ => types}/summary_buffer.ipynb | 0 .../memory/{ => types}/token_buffer.ipynb | 0 .../memory/chat_messages/get_started.mdx | 23 ++ docs/snippets/modules/memory/get_started.mdx | 299 +++++++----------- .../memory/{how_to => types}/buffer.mdx | 0 .../{how_to => types}/buffer_window.mdx | 0 .../entity_summary_memory.mdx | 0 .../memory/{how_to => types}/summary.mdx | 0 .../vectorstore_retriever_memory.mdx | 0 19 files changed, 208 insertions(+), 215 deletions(-) create mode 100644 docs/docs_skeleton/docs/modules/memory/chat_messages/index.mdx rename docs/docs_skeleton/docs/modules/memory/{ => types}/buffer.mdx (77%) rename docs/docs_skeleton/docs/modules/memory/{ => types}/buffer_window.mdx (83%) rename docs/docs_skeleton/docs/modules/memory/{ => types}/entity_summary_memory.mdx (78%) create mode 100644 docs/docs_skeleton/docs/modules/memory/types/index.mdx rename docs/docs_skeleton/docs/modules/memory/{ => types}/summary.mdx (91%) rename docs/docs_skeleton/docs/modules/memory/{ => types}/vectorstore_retriever_memory.mdx (84%) create mode 100644 docs/docs_skeleton/static/img/memory_diagram.png rename docs/extras/modules/memory/{ => types}/kg.ipynb (100%) rename docs/extras/modules/memory/{ => types}/summary_buffer.ipynb (100%) rename docs/extras/modules/memory/{ => types}/token_buffer.ipynb (100%) create mode 100644 docs/snippets/modules/memory/chat_messages/get_started.mdx rename docs/snippets/modules/memory/{how_to => types}/buffer.mdx (100%) rename docs/snippets/modules/memory/{how_to => types}/buffer_window.mdx (100%) rename docs/snippets/modules/memory/{how_to => types}/entity_summary_memory.mdx (100%) rename docs/snippets/modules/memory/{how_to => types}/summary.mdx (100%) rename docs/snippets/modules/memory/{how_to => types}/vectorstore_retriever_memory.mdx (100%) diff --git a/docs/docs_skeleton/docs/modules/memory/chat_messages/index.mdx b/docs/docs_skeleton/docs/modules/memory/chat_messages/index.mdx new file mode 100644 index 00000000000..de4a335a7a3 --- /dev/null +++ b/docs/docs_skeleton/docs/modules/memory/chat_messages/index.mdx @@ -0,0 +1,17 @@ +--- +sidebar_position: 1 +--- +# Chat Messages + +:::info +Head to [Integrations](/docs/integrations/memory/) for documentation on built-in memory integrations with 3rd-party databases and tools. +::: + +One of the core utility classes underpinning most (if not all) memory modules is the `ChatMessageHistory` class. +This is a super lightweight wrapper which exposes convenience methods for saving Human messages, AI messages, and then fetching them all. + +You may want to use this class directly if you are managing memory outside of a chain. + +import GetStarted from "@snippets/modules/memory/chat_messages/get_started.mdx" + + \ No newline at end of file diff --git a/docs/docs_skeleton/docs/modules/memory/index.mdx b/docs/docs_skeleton/docs/modules/memory/index.mdx index aa365e4fe0b..d8f9d25590a 100644 --- a/docs/docs_skeleton/docs/modules/memory/index.mdx +++ b/docs/docs_skeleton/docs/modules/memory/index.mdx @@ -1,34 +1,62 @@ --- sidebar_position: 3 --- - # Memory -🚧 _Docs under construction_ 🚧 +Most LLM applications have a conversational interface. An essential component of a conversation is being able to refer to information introduced earlier in the conversation. +At bare minimum, a conversational system should be able to access some window of past messages directly. +A more complex system will need to have a world model that it is constantly updating, which allows it to do things like maintain information about entities and their relationships. -:::info -Head to [Integrations](/docs/integrations/memory/) for documentation on built-in memory integrations with 3rd-party tools. -::: +We call this ability to store information about past interactions "memory". +LangChain provides a lot of utilities for adding memory to a system. +These utilities can be used by themselves or incorporated seamlessly into a chain. -By default, Chains and Agents are stateless, -meaning that they treat each incoming query independently (like the underlying LLMs and chat models themselves). -In some applications, like chatbots, it is essential -to remember previous interactions, both in the short and long-term. -The **Memory** class does exactly that. +A memory system needs to support two basic actions: reading and writing. +Recall that every chain defines some core execution logic that expects certain inputs. +Some of these inputs come directly from the user, but some of these inputs can come from memory. +A chain will interact with its memory system twice in a given run. +1. AFTER receiving the initial user inputs but BEFORE executing the core logic, a chain will READ from its memory system and augment the user inputs. +2. AFTER executing the core logic but BEFORE returning the answer, a chain will WRITE the inputs and outputs of the current run to memory, so that they can be referred to in future runs. -LangChain provides memory components in two forms. -First, LangChain provides helper utilities for managing and manipulating previous chat messages. -These are designed to be modular and useful regardless of how they are used. -Secondly, LangChain provides easy ways to incorporate these utilities into chains. +![memory-diagram](/img/memory_diagram.png) + + +## Building memory into a system +The two core design decisions in any memory system are: +- How state is stored +- How state is queried + +### Storing: List of chat messages +Underlying any memory is a history of all chat interactions. +Even if these are not all used directly, they need to be stored in some form. +One of the key parts of the LangChain memory module is a series of integrations for storing these chat messages, +from in-memory lists to persistent databases. + +- [Chat message storage](/docs/modules/memory/chat_messages/): How to work with Chat Messages, and the various integrations offered + +### Querying: Data structures and algorithms on top of chat messages +Keeping a list of chat messages is fairly straight-forward. +What is less straight-forward are the data structures and algorithms built on top of chat messages that serve a view of those messages that is most useful. + +A very simply memory system might just return the most recent messages each run. A slightly more complex memory system might return a succinct summary of the past K messages. +An even more sophisticated system might extract entities from stored messages and only return information about entities referenced in the current run. + +Each application can have different requirements for how memory is queried. The memory module should make it easy to both get started with simple memory systems and write your own custom systems if needed. + +- [Memory types](/docs/modules/memory/types/): The various data structures and algorithms that make up the memory types LangChain supports ## Get started -Memory involves keeping a concept of state around throughout a user's interactions with an language model. A user's interactions with a language model are captured in the concept of ChatMessages, so this boils down to ingesting, capturing, transforming and extracting knowledge from a sequence of chat messages. There are many different ways to do this, each of which exists as its own memory type. - -In general, for each type of memory there are two ways to understanding using memory. These are the standalone functions which extract information from a sequence of messages, and then there is the way you can use this type of memory in a chain. - -Memory can return multiple pieces of information (for example, the most recent N messages and a summary of all previous messages). The returned information can either be a string or a list of messages. +Let's take a look at what Memory actually looks like in LangChain. +Here we'll cover the basics of interacting with an arbitrary memory class. import GetStarted from "@snippets/modules/memory/get_started.mdx" + +## Next steps + +And that's it for getting started! +Please see the other sections for walkthroughs of more advanced topics, +like custom memory, multiple memories, and more. + diff --git a/docs/docs_skeleton/docs/modules/memory/buffer.mdx b/docs/docs_skeleton/docs/modules/memory/types/buffer.mdx similarity index 77% rename from docs/docs_skeleton/docs/modules/memory/buffer.mdx rename to docs/docs_skeleton/docs/modules/memory/types/buffer.mdx index 25273742d66..51ef409d75b 100644 --- a/docs/docs_skeleton/docs/modules/memory/buffer.mdx +++ b/docs/docs_skeleton/docs/modules/memory/types/buffer.mdx @@ -4,6 +4,6 @@ This notebook shows how to use `ConversationBufferMemory`. This memory allows fo We can first extract it as a string. -import Example from "@snippets/modules/memory/how_to/buffer.mdx" +import Example from "@snippets/modules/memory/types/buffer.mdx" diff --git a/docs/docs_skeleton/docs/modules/memory/buffer_window.mdx b/docs/docs_skeleton/docs/modules/memory/types/buffer_window.mdx similarity index 83% rename from docs/docs_skeleton/docs/modules/memory/buffer_window.mdx rename to docs/docs_skeleton/docs/modules/memory/types/buffer_window.mdx index 31826ffcef3..fab7ed42ba1 100644 --- a/docs/docs_skeleton/docs/modules/memory/buffer_window.mdx +++ b/docs/docs_skeleton/docs/modules/memory/types/buffer_window.mdx @@ -4,6 +4,6 @@ Let's first explore the basic functionality of this type of memory. -import Example from "@snippets/modules/memory/how_to/buffer_window.mdx" +import Example from "@snippets/modules/memory/types/buffer_window.mdx" diff --git a/docs/docs_skeleton/docs/modules/memory/entity_summary_memory.mdx b/docs/docs_skeleton/docs/modules/memory/types/entity_summary_memory.mdx similarity index 78% rename from docs/docs_skeleton/docs/modules/memory/entity_summary_memory.mdx rename to docs/docs_skeleton/docs/modules/memory/types/entity_summary_memory.mdx index 8a6edbe5773..5387cf575a5 100644 --- a/docs/docs_skeleton/docs/modules/memory/entity_summary_memory.mdx +++ b/docs/docs_skeleton/docs/modules/memory/types/entity_summary_memory.mdx @@ -4,6 +4,6 @@ Entity Memory remembers given facts about specific entities in a conversation. I Let's first walk through using this functionality. -import Example from "@snippets/modules/memory/how_to/entity_summary_memory.mdx" +import Example from "@snippets/modules/memory/types/entity_summary_memory.mdx" diff --git a/docs/docs_skeleton/docs/modules/memory/types/index.mdx b/docs/docs_skeleton/docs/modules/memory/types/index.mdx new file mode 100644 index 00000000000..c9f29673f6b --- /dev/null +++ b/docs/docs_skeleton/docs/modules/memory/types/index.mdx @@ -0,0 +1,8 @@ +--- +sidebar_position: 2 +--- +# Memory Types + +There are many different types of memory. +Each have their own parameters, their own return types, and are useful in different scenarios. +Please see their individual page for more detail on each one. diff --git a/docs/docs_skeleton/docs/modules/memory/summary.mdx b/docs/docs_skeleton/docs/modules/memory/types/summary.mdx similarity index 91% rename from docs/docs_skeleton/docs/modules/memory/summary.mdx rename to docs/docs_skeleton/docs/modules/memory/types/summary.mdx index 878617cf33f..330bd2b59b1 100644 --- a/docs/docs_skeleton/docs/modules/memory/summary.mdx +++ b/docs/docs_skeleton/docs/modules/memory/types/summary.mdx @@ -4,6 +4,6 @@ Conversation summary memory summarizes the conversation as it happens and stores Let's first explore the basic functionality of this type of memory. -import Example from "@snippets/modules/memory/how_to/summary.mdx" +import Example from "@snippets/modules/memory/types/summary.mdx" diff --git a/docs/docs_skeleton/docs/modules/memory/vectorstore_retriever_memory.mdx b/docs/docs_skeleton/docs/modules/memory/types/vectorstore_retriever_memory.mdx similarity index 84% rename from docs/docs_skeleton/docs/modules/memory/vectorstore_retriever_memory.mdx rename to docs/docs_skeleton/docs/modules/memory/types/vectorstore_retriever_memory.mdx index decbfbdd535..6f71e624b3a 100644 --- a/docs/docs_skeleton/docs/modules/memory/vectorstore_retriever_memory.mdx +++ b/docs/docs_skeleton/docs/modules/memory/types/vectorstore_retriever_memory.mdx @@ -6,6 +6,6 @@ This differs from most of the other Memory classes in that it doesn't explicitly In this case, the "docs" are previous conversation snippets. This can be useful to refer to relevant pieces of information that the AI was told earlier in the conversation. -import Example from "@snippets/modules/memory/how_to/vectorstore_retriever_memory.mdx" +import Example from "@snippets/modules/memory/types/vectorstore_retriever_memory.mdx" diff --git a/docs/docs_skeleton/static/img/memory_diagram.png b/docs/docs_skeleton/static/img/memory_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..af682575dd6021486aff825da53b1ecb64006b33 GIT binary patch literal 113244 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

_uyWug70Mh4%;^SYJ_)cNL>6c` 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

    c_~3%cfHFC*WV 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 + +``` + [HumanMessage(content='hi!', additional_kwargs={}), + AIMessage(content='whats up?', additional_kwargs={})] +``` + + \ No newline at end of file diff --git a/docs/snippets/modules/memory/get_started.mdx b/docs/snippets/modules/memory/get_started.mdx index 0914adb127c..53ddf5fa387 100644 --- a/docs/snippets/modules/memory/get_started.mdx +++ b/docs/snippets/modules/memory/get_started.mdx @@ -1,55 +1,25 @@ -We will walk through the simplest form of memory: "buffer" memory, which just involves keeping a buffer of all prior messages. We will show how to use the modular utility functions here, then show how it can be used in a chain (both returning a string as well as a list of messages). - -## ChatMessageHistory -One of the core utility classes underpinning most (if not all) memory modules is the `ChatMessageHistory` class. This is a super lightweight wrapper which exposes convenience methods for saving Human messages, AI messages, and then fetching them all. - -You may want to use this class directly if you are managing memory outside of a chain. - - - - -```python -from langchain.memory import ChatMessageHistory - -history = ChatMessageHistory() - -history.add_user_message("hi!") - -history.add_ai_message("whats up?") -``` - - -```python -history.messages -``` - - - -``` - [HumanMessage(content='hi!', additional_kwargs={}), - AIMessage(content='whats up?', additional_kwargs={})] -``` - - - -## ConversationBufferMemory - -We now show how to use this simple concept in a chain. We first showcase `ConversationBufferMemory` which is just a wrapper around ChatMessageHistory that extracts the messages in a variable. - -We can first extract it as a string. - +Let's take a look at how to use ConversationBufferMemory in chains. +ConversationBufferMemory is an extremely simple form of memory that just keeps a list of chat messages in a buffer +and passes those into the prompt template. ```python from langchain.memory import ConversationBufferMemory -``` - -```python memory = ConversationBufferMemory() memory.chat_memory.add_user_message("hi!") memory.chat_memory.add_ai_message("whats up?") ``` +When using memory in a chain, there are a few key concepts to understand. +Note that here we cover general concepts that are useful for most types of memory. +Each individual memory type may very well have its own parameters and concepts that are necessary to understand. + +### What variables get returned from memory +Before going into the chain, various variables are read from memory. +This have specific names which need to align with the variables the chain expects. +You can see what these variables are by calling `memory.load_memory_variables({})`. +Note that the empty dictionary that we pass in is just a placeholder for real variables. +If the memory type you are using is dependent upon the input variables, you may need to pass some in. ```python memory.load_memory_variables({}) @@ -58,199 +28,146 @@ memory.load_memory_variables({}) ``` - {'history': 'Human: hi!\nAI: whats up?'} + {'history': "Human: hi!\nAI: whats up?"} ``` -We can also get the history as a list of messages +In this case, you can see that `load_memory_variables` returns a single key, `history`. +This means that your chain (and likely your prompt) should expect and input named `history`. +You can usually control this variable through parameters on the memory class. +For example, if you want the memory variables to be returned in the key `chat_history` you can do: +```python +memory = ConversationBufferMemory(memory_key="chat_history") +memory.chat_memory.add_user_message("hi!") +memory.chat_memory.add_ai_message("whats up?") +``` + + +``` + {'chat_history': "Human: hi!\nAI: whats up?"} +``` + + + +The parameter name to control these keys may vary per memory type, but it's important to understand that (1) this is controllable, (2) how to control it. + +### Whether memory is a string or a list of messages + +One of the most common types of memory involves returning a list of chat messages. +These can either be returned as a single string, all concatenated together (useful when they will be passed in LLMs) +or a list of ChatMessages (useful when passed into ChatModels). + +By default, they are returned as a single string. +In order to return as a list of messages, you can set `return_messages=True` ```python memory = ConversationBufferMemory(return_messages=True) memory.chat_memory.add_user_message("hi!") memory.chat_memory.add_ai_message("whats up?") ``` - - -```python -memory.load_memory_variables({}) -``` - ``` - {'history': [HumanMessage(content='hi!', additional_kwargs={}), - AIMessage(content='whats up?', additional_kwargs={})]} + {'history': [HumanMessage(content='hi!', additional_kwargs={}, example=False), + AIMessage(content='whats up?', additional_kwargs={}, example=False)]} ``` -## Using in a chain -Finally, let's take a look at using this in a chain (setting `verbose=True` so we can see the prompt). +### What keys are saved to memory + +Often times chains take in or return multiple input/output keys. +In these cases, how can we know which keys we want to save to the chat message history? +This is generally controllable by `input_key` and `output_key` parameters on the memory types. +These default to None - and if there is only one input/output key it is known to just use that. +However, if there are multiple input/output keys then you MUST specify the name of which one to use + +### End to end example + +Finally, let's take a look at using this in a chain. +We'll use an LLMChain, and show working with both an LLM and a ChatModel. + +#### Using an LLM ```python from langchain.llms import OpenAI -from langchain.chains import ConversationChain +from langchain.prompts import PromptTemplate +from langchain.chains import LLMChain +from langchain.memory import ConversationBufferMemory llm = OpenAI(temperature=0) -conversation = ConversationChain( +# Notice that "chat_history" is present in the prompt template +template = """You are a nice chatbot having a conversation with a human. + +Previous conversation: +{chat_history} + +New human question: {question} +Response:""" +prompt = PromptTemplate.from_template(template) +# Notice that we need to align the `memory_key` +memory = ConversationBufferMemory(memory_key="chat_history") +conversation = LLMChain( llm=llm, + prompt=prompt, verbose=True, - memory=ConversationBufferMemory() + memory=memory ) ``` ```python -conversation.predict(input="Hi there!") -``` - - - +# Notice that we just pass in the `question` variables - `chat_history` gets populated by memory +conversation({"question": "hi"}) ``` - > Entering new ConversationChain chain... - Prompt after formatting: - The following is a friendly conversation between a human and an AI. The AI is talkative and provides lots of specific details from its context. If the AI does not know the answer to a question, it truthfully says it does not know. - - Current conversation: - - Human: Hi there! - AI: - - > Finished chain. - - - - - - " Hi there! It's nice to meet you. How can I help you today?" -``` - - +#### Using a ChatModel ```python -conversation.predict(input="I'm doing well! Just having a conversation with an AI.") -``` - - - -``` +from langchain.chat_models import ChatOpenAI +from langchain.prompts import ( + ChatPromptTemplate, + MessagesPlaceholder, + SystemMessagePromptTemplate, + HumanMessagePromptTemplate, +) +from langchain.chains import LLMChain +from langchain.memory import ConversationBufferMemory - > Entering new ConversationChain chain... - Prompt after formatting: - The following is a friendly conversation between a human and an AI. The AI is talkative and provides lots of specific details from its context. If the AI does not know the answer to a question, it truthfully says it does not know. - - Current conversation: - Human: Hi there! - AI: Hi there! It's nice to meet you. How can I help you today? - Human: I'm doing well! Just having a conversation with an AI. - AI: - - > Finished chain. - - - - - - " That's great! It's always nice to have a conversation with someone new. What would you like to talk about?" -``` - - - - -```python -conversation.predict(input="Tell me about yourself.") -``` - - - -``` - - - > Entering new ConversationChain chain... - Prompt after formatting: - The following is a friendly conversation between a human and an AI. The AI is talkative and provides lots of specific details from its context. If the AI does not know the answer to a question, it truthfully says it does not know. - - Current conversation: - Human: Hi there! - AI: Hi there! It's nice to meet you. How can I help you today? - Human: I'm doing well! Just having a conversation with an AI. - AI: That's great! It's always nice to have a conversation with someone new. What would you like to talk about? - Human: Tell me about yourself. - AI: - - > Finished chain. - - - - - - " Sure! I'm an AI created to help people with their everyday tasks. I'm programmed to understand natural language and provide helpful information. I'm also constantly learning and updating my knowledge base so I can provide more accurate and helpful answers." -``` - - - -## Saving Message History - -You may often have to save messages, and then load them to use again. This can be done easily by first converting the messages to normal python dictionaries, saving those (as json or something) and then loading those. Here is an example of doing that. - - -```python -import json - -from langchain.memory import ChatMessageHistory -from langchain.schema import messages_from_dict, messages_to_dict - -history = ChatMessageHistory() - -history.add_user_message("hi!") - -history.add_ai_message("whats up?") +llm = ChatOpenAI() +prompt = ChatPromptTemplate( + messages=[ + SystemMessagePromptTemplate.from_template( + "You are a nice chatbot having a conversation with a human." + ), + # The `variable_name` here is what must align with memory + MessagesPlaceholder(variable_name="chat_history"), + HumanMessagePromptTemplate.from_template("{question}") + ] +) +# Notice that we `return_messages=True` to fit into the MessagesPlaceholder +# Notice that `"chat_history"` aligns with the MessagesPlaceholder name. +memory = ConversationBufferMemory(memory_key="chat_history", return_messages=True) +conversation = LLMChain( + llm=llm, + prompt=prompt, + verbose=True, + memory=memory +) ``` ```python -dicts = messages_to_dict(history.messages) +# Notice that we just pass in the `question` variables - `chat_history` gets populated by memory +conversation({"question": "hi"}) ``` -```python -dicts -``` - - -``` - [{'type': 'human', 'data': {'content': 'hi!', 'additional_kwargs': {}}}, - {'type': 'ai', 'data': {'content': 'whats up?', 'additional_kwargs': {}}}] -``` - - - - -```python -new_messages = messages_from_dict(dicts) -``` - - -```python -new_messages -``` - - - -``` - [HumanMessage(content='hi!', additional_kwargs={}), - AIMessage(content='whats up?', additional_kwargs={})] -``` - - - -And that's it for the getting started! There are plenty of different types of memory, check out our examples to see them all diff --git a/docs/snippets/modules/memory/how_to/buffer.mdx b/docs/snippets/modules/memory/types/buffer.mdx similarity index 100% rename from docs/snippets/modules/memory/how_to/buffer.mdx rename to docs/snippets/modules/memory/types/buffer.mdx diff --git a/docs/snippets/modules/memory/how_to/buffer_window.mdx b/docs/snippets/modules/memory/types/buffer_window.mdx similarity index 100% rename from docs/snippets/modules/memory/how_to/buffer_window.mdx rename to docs/snippets/modules/memory/types/buffer_window.mdx diff --git a/docs/snippets/modules/memory/how_to/entity_summary_memory.mdx b/docs/snippets/modules/memory/types/entity_summary_memory.mdx similarity index 100% rename from docs/snippets/modules/memory/how_to/entity_summary_memory.mdx rename to docs/snippets/modules/memory/types/entity_summary_memory.mdx diff --git a/docs/snippets/modules/memory/how_to/summary.mdx b/docs/snippets/modules/memory/types/summary.mdx similarity index 100% rename from docs/snippets/modules/memory/how_to/summary.mdx rename to docs/snippets/modules/memory/types/summary.mdx diff --git a/docs/snippets/modules/memory/how_to/vectorstore_retriever_memory.mdx b/docs/snippets/modules/memory/types/vectorstore_retriever_memory.mdx similarity index 100% rename from docs/snippets/modules/memory/how_to/vectorstore_retriever_memory.mdx rename to docs/snippets/modules/memory/types/vectorstore_retriever_memory.mdx