Getting Started

Adding Instructions

Why instructions?

After adding domain knowledge and sources, if during testing you notice that the chatbot still does not respond (to everything) as desired, it may be necessary to manually add instructions. This ensures that the chatbot responds as you wish, for example, if you want specific answers to certain questions or if follow-up questions need to be asked to certain questions. These aspects cannot be generated by the chatbot itself from scraping the website, so you need to teach this to the chatbot.

How to write an instruction?

Just like in domain knowledge, we recommend approaching the chatbot as if it were a colleague and giving instructions in the second person. Be clear about what you expect from the chatbot. Here are some general tips & tricks for writing instructions:

1. Be clear and concise: Formulate instructions clearly and concisely so the chatbot can easily understand and follow them.
2. Provide context: Ensure there is enough context in the instructions so the chatbot can provide the correct answers based on the situation.
3. 'Don't tell, but show': Show the chatbot how to process information by adding examples to instructions.
4. Be specific: Give detailed instructions, especially for specific tasks or interactions with users.
5. Use positive language: Formulate instructions positively to encourage the chatbot.

By following these tips, you create effective instructions that help the chatbot communicate better and support users. See instructions not as strict rules, but as guidelines that help the chatbot adjust its behavior and perform better.

Adding an instruction

In Pulse, you can add new instructions in two places. You can do this in the Instructions menu, where you can create different categories to keep it organized. Additionally, you can add instructions from the Interactive tester by clicking the thumbs down on a generated answer.

Adding vs. editing

Only add a new instruction if there is no existing instruction on this topic yet. If there is already an instruction, edit or supplement it. It is better to have a longer, clear instruction than multiple instructions on the same topic. With multiple instructions on the same topic, it is not clear to the chatbot which one to follow, which can result in conflicting answers.

Domain knowledge vs. instructions

Domain knowledge is always used. Instructions delve deeper into specific topics that may not come up in every conversation.

Before adding a new instruction, it is important to consider whether it is something you expect from the chatbot in every conversation, or only in specific cases. Place general instructions in domain knowledge (for example: You always respond briefly and to-the-point) and specific instructions in Instructions (for example: When there are complaints about a delivery, ask for the order number and inquire about what exactly is wrong).