Developing a Robust System Prompt for a Personal Tutor in JavaScript

Developing a Robust System Prompt for a Personal Tutor in JavaScript | CodeSignal Learn

Developing a Robust System Prompt for a Personal Tutor

Welcome back! Building on your previous experience with the OpenAI SDK, this course will guide you in developing a RESTful API for a Personal Tutor using JavaScript . In this lesson, we begin by crafting a robust system prompt that provides the DeepSeek model with clear guidelines and ample context for effective educational interactions. You'll learn how to store this prompt in a file and seamlessly load it into your code, setting the foundation for a well-structured tutoring service.

Importance of a Robust System Prompt

Join the 1M+ learners on CodeSignal

Be a part of our community of 1M+ users who develop and demonstrate their skills on CodeSignal

Defining the Tutor's Role

The role section is the starting point of the system prompt. It defines the tutor's identity and primary function. By specifying that the AI is an expert tutor designed to inspire curiosity and empower students, we provide it with a clear understanding of its responsibilities and the context in which it operates. This foundational information helps the tutor align its responses with educational objectives. text # ROLE You are an expert tutor AI designed to inspire curiosity and empower students in their learning journey. Your tone is friendly, supportive, and patient. You adapt your explanations to each student's level, ensuring clarity and engagement while fostering independent thinking. # ROLE You are an expert tutor AI designed to inspire curiosity and empower students in their learning journey. Your tone is friendly, supportive, and patient. You adapt your explanations to each student's level, ensuring clarity and engagement while fostering independent thinking.

Detailing Expertise & Subjects

Following the role definition, it's important to provide the tutor with a comprehensive overview of the subjects it's knowledgeable about. This section equips the tutor with the necessary information to answer student inquiries accurately across various academic domains. By including key subject areas such as Mathematics, Science, and Humanities, the tutor can effectively communicate its educational capabilities to students. text ## Expertise & Subjects - **Mathematics:** From basic arithmetic to advanced calculus, algebra, and statistics. - **Science:** Including Physics, Chemistry, Biology, and Earth Sciences. - **Humanities:** Covering Literature, History, Philosophy, and Social Studies. ## Expertise & Subjects - **Mathematics:** From basic arithmetic to advanced calculus, algebra, and statistics. - **Science:** Including Physics, Chemistry, Biology, and Earth Sciences. - **Humanities:** Covering Literature, History, Philosophy, and Social Studies.

Outlining Tutoring Approach

Building on the expertise areas, the tutoring approach section outlines the different pedagogical methods the tutor should employ. This section ensures that the tutor can provide effective educational support through clear explanations, interactive guidance, engaging examples, and more. By detailing these approaches, the tutor can adapt its teaching style to meet the needs of different students and learning situations. text ## Tutoring Approach - **Clear Explanations:** Break down complex topics into simple, manageable parts. - **Interactive Guidance:** Ask clarifying questions and invite students to reflect on their understanding. - **Engaging Examples & Analogies:** Use relatable examples and analogies to illustrate key concepts. - **Encourage Critical Thinking:** Pose thought-provoking questions and explore multiple perspectives. - **Adaptive Learning:** Tailor your explanations based on the student's background and pace. - **Transparent Communication:** Admit when a topic is outside your scope and recommend additional resources. ## Tutoring Approach - **Clear Explanations:** Break down complex topics into simple, manageable parts. - **Interactive Guidance:** Ask clarifying questions and invite students to reflect on their understanding. - **Engaging Examples & Analogies:** Use relatable examples and analogies to illustrate key concepts. - **Encourage Critical Thinking:** Pose thought-provoking questions and explore multiple perspectives. - **Adaptive Learning:** Tailor your explanations based on the student's background and pace. - **Transparent Communication:** Admit when a topic is outside your scope and recommend additional resources.

Establishing Ethical & Educational Guidelines

To ensure the tutor operates within appropriate educational boundaries, this section defines the ethical guidelines it must follow. By outlining principles such as exam integrity, balanced support, and promoting independent learning, the tutor can maintain a high standard of educational ethics. This section emphasizes the importance of responsible tutoring that upholds academic integrity. text ## Ethical & Educational Guidelines - **Exam Integrity:** Avoid providing direct exam answers or shortcuts that compromise academic honesty. - **Balanced Support:** Provide guidance and reasoning without giving away definitive answers for open-ended questions. - **Promote Independent Learning:** Always encourage further study, exploration, and practice. - **Accuracy & Responsibility:** Ensure that your explanations are correct, reliable, and promote best academic practices. - **Inclusive & Respectful Communication:** Use unbiased, respectful language that accommodates diverse learning styles and backgrounds. ## Ethical & Educational Guidelines - **Exam Integrity:** Avoid providing direct exam answers or shortcuts that compromise academic honesty. - **Balanced Support:** Provide guidance and reasoning without giving away definitive answers for open-ended questions. - **Promote Independent Learning:** Always encourage further study, exploration, and practice. - **Accuracy & Responsibility:** Ensure that your explanations are correct, reliable, and promote best academic practices. - **Inclusive & Respectful Communication:** Use unbiased, respectful language that accommodates diverse learning styles and backgrounds.

Providing Additional Instructions

Finally, the additional instructions section outlines specific procedural expectations for the tutor to ensure thorough and effective educational interactions. By establishing these instructions, the tutor can deliver a more personalized and comprehensive learning experience. text ## Additional Instructions - Start by understanding the student's current knowledge level and goals. - Use step-by-step explanations and summarize key points at the end of each discussion. - Provide alternative methods or perspectives when possible. - Motivate and empower students to solve problems independently while offering supportive hints when needed. ## Additional Instructions - Start by understanding the student's current knowledge level and goals. - Use step-by-step explanations and summarize key points at the end of each discussion. - Provide alternative methods or perspectives when possible. - Motivate and empower students to solve problems independently while offering supportive hints when needed. By structuring the system prompt in this way, we provide the tutor with a comprehensive framework to operate effectively as an educational assistant.

Loading the System Prompt in JavaScript

Now that we understand the structure of a system prompt, let's see how to load it into our JavaScript code. We will create a loadSystemPrompt function that accepts a file path as an argument. This function will read the system prompt from the specified file and return its content. If an error occurs while reading the file, a default prompt will be returned instead. Here's the code for the loadSystemPrompt function: JavaScriptimport fs from 'fs'; function loadSystemPrompt(filePath) { // Load the tutor system prompt from file try { // Read the system prompt from the specified file return fs.readFileSync(filePath, 'utf8'); } catch (error) { // Print an error message if the file cannot be read console.error(`Error loading system prompt: ${error.message}`); // Return a default prompt if there's an error return "You are a helpful tutor."; } }import fs from 'fs'; function loadSystemPrompt(filePath) { // Load the tutor system prompt from file try { // Read the system prompt from the specified file return fs.readFileSync(filePath, 'utf8'); } catch (error) { // Print an error message if the file cannot be read console.error(`Error loading system prompt: ${error.message}`); // Return a default prompt if there's an error return "You are a helpful tutor."; } } This function uses a try-catch block to handle potential errors, such as the file not being found. If the file is successfully read, its content is returned. Otherwise, an error message is printed, and a default prompt is used. To utilize this function, we load the system prompt into our code by passing the file path as follows: JavaScript// Load the system prompt with the file path const systemPrompt = loadSystemPrompt('data/system_prompt.txt');// Load the system prompt with the file path const systemPrompt = loadSystemPrompt('data/system_prompt.txt'); By loading the system prompt, we ensure that our tutor is equipped with the necessary context and guidelines to interact effectively with students.

Testing the System Prompt

With the system prompt loaded, we can now integrate it with the DeepSeek model using the OpenAI SDK to create a tutoring conversation. The sendQuery function is responsible for sending a message to the DeepSeek model and receiving a response. It uses the loaded system prompt as part of the conversation context. To demonstrate this, let's create a simple tutoring session using the system prompt and a student question. Below is an example using JavaScript. (Note: This example assumes you have installed the OpenAI SDK for Node.js and have set up your API key as required.) JavaScriptimport OpenAI from 'openai'; // Initialize the DeepSeek client const client = new OpenAI(); async function sendQuery(messages) { // Send a query and receive a tutoring explanation const response = await client.chat.completions.create({ model: "deepseek-ai/DeepSeek-V3", messages: messages }); return response.choices[0].message.content.trim(); } // Create a tutoring session with system prompt and a student query const session = [ { role: "system", content: systemPrompt }, { role: "user", content: "Can you explain the basics of algebra?" } ]; // Send the query and get a response sendQuery(session).then((response) => { // Print the student's question and the tutor's explanation console.log(`Student:\n${session[1].content}\n`); console.log(`Tutor:\n${response}`); });import OpenAI from 'openai'; // Initialize the DeepSeek client const client = new OpenAI(); async function sendQuery(messages) { // Send a query and receive a tutoring explanation const response = await client.chat.completions.create({ model: "deepseek-ai/DeepSeek-V3", messages: messages }); return response.choices[0].message.content.trim(); } // Create a tutoring session with system prompt and a student query const session = [ { role: "system", content: systemPrompt }, { role: "user", content: "Can you explain the basics of algebra?" } ]; // Send the query and get a response sendQuery(session).then((response) => { // Print the student's question and the tutor's explanation console.log(`Student:\n${session[1].content}\n`); console.log(`Tutor:\n${response}`); }); In this example, the tutor uses the system prompt to understand its role and respond appropriately to the student's question. The output will be a response from the tutor, demonstrating how the system prompt guides its behavior.

Developing a Robust System Prompt for a Personal Tutor

Importance of a Robust System Prompt

Join the 1M+ learners on CodeSignal

Constructing the System Prompt File

Defining the Tutor's Role

Detailing Expertise & Subjects

Outlining Tutoring Approach

Establishing Ethical & Educational Guidelines

Providing Additional Instructions

Loading the System Prompt in JavaScript

Testing the System Prompt

Example Tutor Response

Summary and Next Steps