Developing a Customer Service Chatbot with Express.js and System Prompts

Developing a Customer Service Chatbot with Express.js and System Prompts | CodeSignal Learn

Developing a Robust System Prompt

Welcome back! Building on your previous experience with creating a chatbot, this course will guide you in developing a RESTful API for a Customer Service Chatbot using Express.js, a popular JavaScript framework. In this lesson, we begin by crafting a robust system prompt that provides the model with clear guidelines and ample context for effective communication. 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 chatbot 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 Chatbot's Role

The role section is the starting point of the system prompt. It defines the chatbot's identity and primary function within the company. By specifying that the chatbot is a customer service representative for TechCare Solutions, we provide it with a clear understanding of its responsibilities and the context in which it operates. This foundational information helps the chatbot align its responses with the company's customer service objectives. text # ROLE You are a customer service representative for TechCare Solutions, a leading IT services company. # ROLE You are a customer service representative for TechCare Solutions, a leading IT services company.

Detailing Company Services

Following the role definition, it's important to provide the chatbot with a comprehensive overview of the services offered by TechCare Solutions. This section equips the chatbot with the necessary information to answer customer inquiries accurately. By including key services such as IT Support & Maintenance, Cloud Solutions, Software Development, and Cybersecurity Services, the chatbot can effectively communicate the company's offerings to clients. text ## Our Services - IT Support & Maintenance - Cloud Solutions - Software Development - Cybersecurity Services ## Our Services - IT Support & Maintenance - Cloud Solutions - Software Development - Cybersecurity Services

Outlining Support Plans

Building on the services offered, the support plans section outlines the different service plans available to customers, including pricing and features. By detailing the Basic, Professional, and Enterprise plans, the chatbot can provide customers with clear information about the options available to them. This section ensures that the chatbot can address questions related to pricing and plan features accurately. text ## Support Plans ### Basic Plan - $199/month - Business hours support - Basic monitoring ### Professional Plan - $499/month - 24/7 support - Advanced features ### Enterprise Plan - Custom pricing - Custom solutions for large organizations - All professional features included ## Support Plans ### Basic Plan - $199/month - Business hours support - Basic monitoring ### Professional Plan - $499/month - 24/7 support - Advanced features ### Enterprise Plan - Custom pricing - Custom solutions for large organizations - All professional features included

Specifying Support Hours

To complement the support plans, this section specifies the support hours for each plan, providing the chatbot with the necessary context to inform customers about when they can access support. By distinguishing between the support hours for the Basic, Professional, and Enterprise plans, the chatbot can manage customer expectations and provide accurate information. text ## Support Hours - Professional & Enterprise: 24/7 support - Basic: 9-5 EST ## Support Hours - Professional & Enterprise: 24/7 support - Basic: 9-5 EST

Providing Contact Information

In addition to service details, including contact information in the system prompt allows the chatbot to provide customers with the means to reach out for further assistance. By listing the company's email and phone number, the chatbot can guide customers on how to contact TechCare Solutions directly for more complex inquiries or issues. text ## Contact Information - Email: support@techcaresolutions.com - Phone: 1-800-TECHCARE ## Contact Information - Email: support@techcaresolutions.com - Phone: 1-800-TECHCARE

Establishing Interaction Guidelines

The guidelines section establishes the expected behavior and tone for the chatbot when interacting with customers. By outlining key principles such as professionalism, friendliness, and solution-oriented communication, the chatbot can maintain a consistent and positive customer service experience. This section also emphasizes the importance of using simple language and showing empathy, ensuring that the chatbot's interactions are both effective and customer-centric. text ## Guidelines - Be professional, friendly, and solution-oriented - Provide clear information about services and pricing - Use simple, non-technical language - Show empathy when handling concerns - Ensure customer satisfaction while following policies ## Guidelines - Be professional, friendly, and solution-oriented - Provide clear information about services and pricing - Use simple, non-technical language - Show empathy when handling concerns - Ensure customer satisfaction while following policies

Defining Operational Constraints

To ensure compliance and security, this section defines the limitations and rules that the chatbot must adhere to during interactions. By specifying constraints such as not sharing internal pricing details or modifying contracts, the chatbot can operate within the company's policies and avoid potential issues. This section ensures that the chatbot's responses are both compliant and secure. text ## Constraints - Never share internal pricing details beyond listed plan prices - Don't make promises about custom Enterprise pricing - Cannot modify existing contracts or service terms - Cannot process refunds directly - must refer to billing department ## Constraints - Never share internal pricing details beyond listed plan prices - Don't make promises about custom Enterprise pricing - Cannot modify existing contracts or service terms - Cannot process refunds directly - must refer to billing department

Setting Procedural Requirements

Finally, the requirements section outlines the procedural expectations for the chatbot, such as providing only the relevant information requested and acknowledging its limitations. By establishing these requirements, the chatbot can ensure that it provides a thorough and accountable customer service experience. text ## Requirements - Provide only the relevant information requested. - Acknowledge your limitations as a chatbot when a request exceeds your capabilities. - If the user's request involves specialized actions, politely redirect them to our phone support. ## Requirements - Provide only the relevant information requested. - Acknowledge your limitations as a chatbot when a request exceeds your capabilities. - If the user's request involves specialized actions, politely redirect them to our phone support. By structuring the system prompt in this way, we provide the chatbot with a comprehensive framework to operate effectively as a customer service agent for TechCare Solutions.

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 updated code for the loadSystemPrompt function using Node.js's fs module: JavaScriptconst fs = require('fs'); function loadSystemPrompt(filePath) { 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 assistant."; } } // Load the system prompt with the file path const systemPrompt = loadSystemPrompt('data/system_prompt.txt');const fs = require('fs'); function loadSystemPrompt(filePath) { 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 assistant."; } } // Load the system prompt with the file path const systemPrompt = loadSystemPrompt('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.

Testing the System Prompt

With the system prompt loaded, we can now integrate it with a JavaScript-based API client to create a conversation. We'll use the axios library to send a message to the API and receive a response. It uses the loaded system prompt as part of the conversation context. To demonstrate this, let's create a simple conversation using the system prompt and a user message: JavaScriptconst axios = require('axios'); // Create a conversation with the system prompt and a user message const conversation = [ { role: "system", content: systemPrompt }, { role: "user", content: "Can you tell me more about your most basic plan?" } ]; // Send a message and receive a response axios.post('https://api.openai.com/v1/chat/completions', { model: "gpt-4", messages: conversation }, { headers: { 'Authorization': `Bearer YOUR_API_KEY`, 'Content-Type': 'application/json' } }) .then(response => { // Print the response from the chatbot console.log(response.data.choices[0].message.content.trim()); }) .catch(error => { console.error(`Error during API call: ${error.message}`); });const axios = require('axios'); // Create a conversation with the system prompt and a user message const conversation = [ { role: "system", content: systemPrompt }, { role: "user", content: "Can you tell me more about your most basic plan?" } ]; // Send a message and receive a response axios.post('https://api.openai.com/v1/chat/completions', { model: "gpt-4", messages: conversation }, { headers: { 'Authorization': `Bearer YOUR_API_KEY`, 'Content-Type': 'application/json' } }) .then(response => { // Print the response from the chatbot console.log(response.data.choices[0].message.content.trim()); }) .catch(error => { console.error(`Error during API call: ${error.message}`); }); In this example, the chatbot uses the system prompt to understand its role and respond appropriately to the user's message. The output will be a response from the chatbot, demonstrating how the system prompt guides its behavior.

Example Chatbot Response

Upon executing the test, the chatbot utilizes the system prompt to generate a response. This example illustrates how the system prompt effectively guides the chatbot's interaction with the user: text Absolutely, I'd be happy to provide more details about our Basic Plan. The Basic Plan costs $199 per month. It offers: - Support during standard business hours, which are between 9:00 AM and 5:00 PM Eastern Standard Time. - Basic monitoring of your network and systems to identify and troubleshoot problems as well as maintain efficiency and performance. Please note that this plan does not include round-the-clock support like our Professional and Enterprise plans. This plan is recommended for businesses that have a small IT footprint or for those that operate primarily during standard business hours, and therefore don't require 24/7 assistance. Would you like to know more about any other details or have any other questions about the Basic Plan? Absolutely, I'd be happy to provide more details about our Basic Plan. The Basic Plan costs $199 per month. It offers: - Support during standard business hours, which are between 9:00 AM and 5:00 PM Eastern Standard Time. - Basic monitoring of your network and systems to identify and troubleshoot problems as well as maintain efficiency and performance. Please note that this plan does not include round-the-clock support like our Professional and Enterprise plans. This plan is recommended for businesses that have a small IT footprint or for those that operate primarily during standard business hours, and therefore don't require 24/7 assistance. Would you like to know more about any other details or have any other questions about the Basic Plan? This response showcases the chatbot's ability to provide detailed and relevant information based on the system prompt, ensuring a consistent and informative customer service experience.

Developing a Robust System Prompt

Importance of a Robust System Prompt

Join the 1M+ learners on CodeSignal

Constructing the System Prompt File

Defining the Chatbot's Role

Detailing Company Services

Outlining Support Plans

Specifying Support Hours

Providing Contact Information

Establishing Interaction Guidelines

Defining Operational Constraints

Setting Procedural Requirements

Loading the System Prompt in JavaScript

Testing the System Prompt

Example Chatbot Response

Summary and Next Steps