Developing and Using a System Prompt for a Personal Tutor

Developing and Using a System Prompt for a Personal Tutor | CodeSignal Learn

Developing a Robust System Prompt for a Personal Tutor

Welcome! In this course, you will learn how to develop a RESTful API for a Personal Tutor . In this lesson, we begin by crafting a robust system prompt that provides the 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

Now that we understand the structure of a system prompt, let's see how to load it into our PHP 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: PHPfunction loadSystemPrompt($filePath) { // Attempt to read the system prompt from the specified file try { if (file_exists($filePath)) { return file_get_contents($filePath); } else { throw new Exception("File not found."); } } catch (Exception $e) { // Print an error message if the file cannot be read echo "Error loading system prompt: " . $e->getMessage(); // Return a default prompt if there's an error return "You are a helpful tutor."; } } // Load the system prompt with the file path $systemPrompt = loadSystemPrompt(__DIR__ . '/data/system_prompt.txt');function loadSystemPrompt($filePath) { // Attempt to read the system prompt from the specified file try { if (file_exists($filePath)) { return file_get_contents($filePath); } else { throw new Exception("File not found."); } } catch (Exception $e) { // Print an error message if the file cannot be read echo "Error loading system prompt: " . $e->getMessage(); // Return a default prompt if there's an error return "You are a helpful tutor."; } } // Load the system prompt with the file path $systemPrompt = loadSystemPrompt(__DIR__ . '/data/system_prompt.txt'); 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. When specifying the file path for your system_prompt.txt, it's best practice to use the __DIR__ constant to ensure the path is always relative to the current script's directory. This helps avoid issues when your code is run from different locations. For example: PHP$systemPrompt = loadSystemPrompt(__DIR__ . '/data/system_prompt.txt');$systemPrompt = loadSystemPrompt(__DIR__ . '/data/system_prompt.txt'); This approach ensures that PHP can reliably locate your system_prompt.txt file regardless of the working directory.

Testing the System Prompt

With the system prompt loaded, we can now integrate it with the model using a PHP HTTP client library like Guzzle to create a tutoring conversation. The sendQuery function is responsible for sending a message to the 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: PHPrequire 'vendor/autoload.php'; use GuzzleHttp\Client; // Initialize the HTTP client $client = new Client([ 'base_uri' => getenv('DEEPSEEK_BASE_URL'), 'headers' => [ 'Authorization' => 'Bearer ' . getenv('DEEPSEEK_API_KEY'), 'Content-Type' => 'application/json', ] ]); function sendQuery($client, $messages) { $response = $client->post('v3/chat/completions', [ 'json' => [ 'model' => 'deepseek-ai/DeepSeek-V3', 'messages' => $messages ] ]); $body = json_decode($response->getBody(), true); return trim($body['choices'][0]['message']['content']); } // Create a tutoring session with system prompt and a student query $session = [ ['role' => 'system', 'content' => $systemPrompt], ['role' => 'user', 'content' => 'Can you explain the basics of algebra?'] ]; // Send the query and get a response $response = sendQuery($client, $session); // Print the student's question and the tutor's explanation echo "Student:\n" . $session[1]['content'] . "\n\n"; echo "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

Testing the System Prompt

Example Tutor Response

Summary and Next Steps