Chat history management in LangChain - Mini Project: Build & Apply

Chat History Management

📖 Scenario: You are building a simple chatbot application that remembers the conversation history. This helps the chatbot respond better by knowing what was said before.

🎯 Goal: Create a chat history manager that stores messages, limits history size, and retrieves the recent conversation.

📋 What You'll Learn

Create a list called chat_history to store messages

Add a variable max_history to limit stored messages

Write a function add_message to add new messages and keep history within limit

Write a function get_recent_history to return the last few messages

💡 Why This Matters

🌍 Real World

Chatbots need to remember past messages to respond naturally and keep conversations coherent.

💼 Career

Managing chat history is a key skill for developers building conversational AI and customer support bots.

1

Create the chat history list

Create a list called chat_history and initialize it as empty to store chat messages.

LangChain

# Create an empty list called chat_history
# Your code here

Hint

Use square brackets [] to create an empty list named chat_history.

2

Set the maximum history size

Create a variable called max_history and set it to 5 to limit how many messages are stored.

LangChain

chat_history = []
# Set max_history to 5
# Your code here

Hint

Use a simple assignment to create max_history with value 5.

3

Add messages and keep history size

Write a function called add_message that takes a message string, appends it to chat_history, and removes the oldest message if the list is longer than max_history.

LangChain

chat_history = []
max_history = 5

# Define add_message function
# Your code here

Hint

Use append to add messages and pop(0) to remove the oldest message when needed.

4

Retrieve recent chat history

Write a function called get_recent_history that returns a copy of the current chat_history list.

LangChain

chat_history = []
max_history = 5

def add_message(message):
    chat_history.append(message)
    if len(chat_history) > max_history:
        chat_history.pop(0)

# Define get_recent_history function
# Your code here

Hint

Return a copy of chat_history to avoid accidental changes outside the function.

Practice

1. What is the main purpose of ConversationBufferMemory in Langchain chat applications?

easy

A. To store and manage past chat messages for context

B. To generate new chat messages automatically

C. To connect to external databases

D. To format chat messages for display

Solution

1. Step 1: Understand the role of chat history

   Chat history helps keep track of previous messages to maintain context in conversations.

2. Step 2: Identify what ConversationBufferMemory does

   This class stores and retrieves past messages so the chat app remembers what was said.

3. Final Answer:

   To store and manage past chat messages for context -> Option A

4. Quick Check:

   Chat history storage = A [OK]

Hint: Remember: ConversationBufferMemory saves past messages [OK]

Common Mistakes:

• Thinking it generates new messages
• Confusing it with database connectors
• Assuming it formats messages for UI

2. Which of the following is the correct way to initialize a ConversationBufferMemory instance in Langchain?

easy

A. memory = ConversationBufferMemory.create()

B. memory = ConversationBufferMemory()

C. memory = ConversationBufferMemory.new()

D. memory = ConversationBufferMemory.load()

Solution

1. Step 1: Recall the standard initialization pattern

   In Langchain, classes are usually instantiated by calling the class name with parentheses.

2. Step 2: Check the options for correct syntax

   Only ConversationBufferMemory() follows this pattern; others are invalid or do not exist.

3. Final Answer:

   memory = ConversationBufferMemory() -> Option B

4. Quick Check:

   Standard class instantiation = D [OK]

Hint: Use parentheses to create instances: ClassName() [OK]

Common Mistakes:

• Using .load(), .new(), or .create() which are not valid here
• Forgetting parentheses when creating an instance
• Confusing with static methods

3. Given this code snippet, what will print(memory.load_memory_variables({})) output?

from langchain.memory import ConversationBufferMemory
memory = ConversationBufferMemory()
memory.chat_memory.add_user_message('Hello')
memory.chat_memory.add_ai_message('Hi there!')

medium

A. {'history': 'Human: Hello\nAI: Hi there!\n'}

B. {'history': 'Hi there!\nHello\n'}

C. {'history': ''}

D. Error: method not found

Solution

1. Step 1: Understand how messages are added

   User and AI messages are added in order: 'Hello' then 'Hi there!'.

2. Step 2: Check how load_memory_variables returns history

   It returns a dictionary with key 'history' and a string showing messages prefixed by 'Human:' and 'AI:' in order.

3. Final Answer:

   {'history': 'Human: Hello\nAI: Hi there!\n'} -> Option A

4. Quick Check:

   History shows messages in order with labels = C [OK]

Hint: History shows messages in order with 'Human:' and 'AI:' labels [OK]

Common Mistakes:

• Mixing message order
• Expecting empty history
• Assuming method does not exist

4. What is wrong with this code snippet that tries to add chat history?

from langchain.memory import ConversationBufferMemory
memory = ConversationBufferMemory()
memory.add_user_message('Hello')

medium

A. You must import a different class for adding messages

B. You need to call memory.save() before adding messages

C. The message text must be a list, not a string

D. ConversationBufferMemory has no method add_user_message directly

Solution

1. Step 1: Check method availability on ConversationBufferMemory

   The method add_user_message is not directly on ConversationBufferMemory but on its chat_memory attribute.

2. Step 2: Identify correct usage

   Correct usage is memory.chat_memory.add_user_message(), not memory.add_user_message().

3. Final Answer:

   ConversationBufferMemory has no method add_user_message directly -> Option D

4. Quick Check:

   Use chat_memory to add messages = B [OK]

Hint: Add messages via memory.chat_memory, not memory directly [OK]

Common Mistakes:

• Calling add_user_message on memory instead of chat_memory
• Thinking message must be a list
• Assuming save() is required before adding

5. You want to build a chat app that remembers only the last 3 messages. Which approach using ConversationBufferMemory is best to achieve this?

hard

A. Use ConversationBufferMemory with a custom buffer size of 3

B. Use ConversationBufferMemory without changes; it stores all messages

C. Manually delete older messages from chat_memory after each addition

D. Create a new ConversationBufferMemory instance for every message

Solution

1. Step 1: Understand ConversationBufferMemory limitations

   ConversationBufferMemory stores all past messages without a built-in parameter to limit the number of messages (unlike ConversationBufferWindowMemory).

2. Step 2: Identify the best approach among options

   Manually deleting older messages from memory.chat_memory.messages after each addition (e.g., memory.chat_memory.messages = memory.chat_memory.messages[-3:]) keeps only the last 3.

3. Final Answer:

   Manually delete older messages from chat_memory after each addition -> Option C

4. Quick Check:

   Manual management for custom limits = B [OK]

Hint: Manually prune memory.chat_memory.messages to last 3 after adds [OK]

Common Mistakes:

• ConversationBufferMemory lacks message count limit parameter (use WindowMemory for that)
• Not limiting buffer and storing unlimited history
• Recreating instance loses all prior context