Managing Multiple Tutoring Sessions

Welcome to the next step in your journey of creating a personal tutor with DeepSeek! In the previous lessons, you learned how to send queries to DeepSeek's language model, explored model parameters, maintained tutoring session history, and personalized AI behavior with system prompts. Now, we will focus on managing multiple tutoring sessions. This is crucial for applications where you need to handle several educational interactions simultaneously, such as a tutoring platform serving multiple students. By the end of this lesson, you will be able to create and manage multiple tutoring sessions using DeepSeek's API, setting the stage for more complex educational interactions.

In a tutoring application, each educational interaction should be treated as a separate session. To achieve this, we use unique identifiers for each tutoring session. This ensures that queries and explanations are correctly associated with their respective sessions. In our code example, we use the uuid library to generate a unique identifier for each tutoring session. When a new tutoring session is created, a unique session_id is generated, and an empty history is initialized.

import uuid

# Store all active tutoring sessions
tutoring_sessions = {}

# Define a common system prompt for all sessions
system_prompt = {
    "role": "system",
    "content": "You are a knowledgeable and patient tutor, ready to assist with various academic subjects."
}

# Create a new tutoring session with a unique identifier
def create_session():
    session_id = str(uuid.uuid4())  # Create unique session identifier
    tutoring_sessions[session_id] = []  # Initialize empty tutoring history
    tutoring_sessions[session_id].append(system_prompt)  # Add system prompt to tutoring history
    return session_id

In this example, we store tutoring history in a dictionary called tutoring_sessions, where each key is a unique session_id. When a student sends a query, it is added to the tutoring history, ensuring that the model has access to the full context when generating an explanation. This approach helps create a seamless and coherent educational interaction between the student and the AI tutor.

Once a tutoring session is established, you can send queries and receive explanations from the DeepSeek model. It's important to maintain the context by sending the full tutoring history to the model. However, keep in mind that language models have a context window, which limits the amount of conversation history they can process at once. If the conversation becomes too large, you should trim the history by cutting the oldest messages and passing only the most recent ones.

In the following code example, we use the send_query function to handle this process. The function takes a session_id and a user_query as inputs, adds the query to the tutoring history, and requests an explanation from the AI. The explanation is then processed and added to the tutoring history, ensuring continuity in the educational interaction.

from openai import OpenAI

# Initialize the DeepSeek client
client = OpenAI()

def send_query(session_id, user_query):
    # Verify tutoring session exists
    if session_id not in tutoring_sessions:
        raise ValueError("Tutoring session not found!")
    # Add student's query to history
    tutoring_sessions[session_id].append({"role": "user", "content": user_query})    
    # Get AI explanation using tutoring history
    response = client.chat.completions.create(
        model="deepseek-ai/DeepSeek-V3",
        messages=tutoring_sessions[session_id],
    )
    # Extract and clean AI's explanation
    answer = response.choices[0].message.content.strip()
    # Add AI's explanation to history
    tutoring_sessions[session_id].append({"role": "assistant", "content": answer})
    # Return AI's explanation
    return answer