> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.chrisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to prompt Hugo AI Agent for Instructions

__This article explains how Hugo instructions work and how to write prompts that shape the AI Agent's behavior clearly.__

Instructions define how Hugo should behave when answering users: tone, boundaries, escalation habits, formatting preferences, and other response rules. They should not replace training resources; factual knowledge belongs in ****AI Agent → Train****.

---

# What are Instructions

Instructions are Hugo's prompting rules. They essentially are ****global behavior prompts**** allowing you to shape Hugo's behavior when he's handling conversations.

They don’t answer questions themselves, they are here to shape how Hugo thinks, speaks, and acts in every situation.

__With Instructions, you can for instance define:__

* ✔ ****Tone & personality**** → professional, friendly, concise, empathetic...
* ✔ ****Communication rules**** → answer length, emoji usage, enforce formal language, usage of bullet points or paragraphs...
* ✔ ****Boundaries**** → diverting from certain topics, topics to avoid or to recommend...
* ✔ ****Reasoning style**** → asking for clarification, providing suggestions, avoiding speculations...

Instructions are a ****set of rules**** that Hugo always keep in mind, and are ****applied to all of your conversations****. They tell our AI Agent ****how to behave, not what to say once****.

||| Instructions should __never__ be used to store information, correct Hugo's knowledge, and define one-off prompts. To correct or add knowledge to Hugo, [visit this article](/en/article/training-hugo-on-your-own-resources-ijkdrl/) to learn how to train Hugo on your resources instead.

__For instance, instruction should__ ****not**** __be used to provide:__

* ✘ ****Direct answers or factual content**** → E.g. __"Our pricing is €49/month."__
* ✘ ****Conditional logic or decision rules**** → E.g. "__If the user asks for X, then do Y."__
* ✘ ****Workflow, routing, or escalation actions**** → E.g. "__Create a ticket / assign to sales / notify an agent."__
* ✘ ****Business rules or policies**** → E.g. __"Refunds are allowed within 14 days."__

| To write effective instructions, focus on behavior — not content. Use ****clear and imperative language**** (“be”, “always”, “never”), keep them ****explicit and unambiguous****, and prefer ****short and unambiguous**** instructions which go straight to the point.

Also note that Hugo is pre-configured with native deep prompts. You do not need to use instructions to have reply in the proper language, avoid hallucinating, or only use the resources at his disposal for instance. Hugo does that natively for you.

Instructions should be focused on ****behaviors you want to change****.

---

# How to create Instructions

To add or manage your instructions, head over to [**Crisp**](https://app.crisp.chat) to hit ⚡️ ****AI Agent****, then navigate to ****Guidance → Instructions****

__Once you're there, simply hit the__ ****New Instruction**** __button to create one, and:__

1. Name your instruction (whichever name helps you manage it better)
2. Provide the instruction prompt, directed to Hugo
3. Save & enable your instruction to activate it

__Easy as that, you're done!__

![How to create Instructions screenshot](https://storage.crisp.chat/users/helpdesk/website/-/a/5/d/c/a5dc91e70024a800/2ced5ecd-f996-450f-a122-55b6f8_1fiw40y.png)

Now that you know how to create instructions, the next question is often: ****"What should I actually write?"****

---

# Start with a guided setup

You can use our ****AI Instructions Generator**** to quickly create a complete setup based on your business.

__What it does:__

* Generates ready-to-use instructions for your AI Agent
* Structures tone, communication style, and boundaries
* Exports your instructions as a ****.csv file**** ready to import into Crisp

__How to use it:__

1. Open the generator
2. Answer a few questions about your business
3. Download the generated ****.csv file****
4. Go to ****AI Agent → Guidance → Instructions**** in Crisp
5. Click ****Import instructions****
6. Upload your file

👉 [**Try the generator**](https://hugo-tool.fly.dev/)

![Start with a guided setup screenshot](https://storage.crisp.chat/users/helpdesk/website/-/3/3/6/8/3368a2cb92637e00/d8c80dd0-6e4c-49c2-8333-1cd6b3_1nucbqw.png)

Once your instructions are imported, you can review, enable, and refine them using the best practices and examples below.

---

# Instruction examples

Here are a few hand-picked examples of good versus bad instruction usages, to help you better redact yours:)

✔ __Example of a good instruction:__

> Never offer medical or health advice. If a user asks about allergies, intolerances, or health impacts of our cookies, do not speculate or give recommendations.  
> Instead, provide only factual ingredient or allergen information if explicitly available, and advise customers to consult a qualified health professional for medical or dietary advice.

✔ __Example of a good instruction:__

> Be concise and factual.  
> Keep answers under 5 sentences unless explicitly asked for more details.  
> Avoid repetition and filler language.

| Good instructional prompts should be imperative and avoid ambiguity. Be specific and provide the necessary details to Hugo for the best results

✘ __Example of an improper usage of instructions:__

> We ship our cookies worldwide. Estimated delivery is between 2 and 4 days in the US, and 5 to 10 days for the rest of the world.

✘ __Example of an improper usage of instructions:__

> If a question is about sales or partnerships, assign it to Romain and mention him.

||| Instructions define how the AI thinks and behaves, they should not be used to dump knowledge, facts, or performing actions.

---

# Frequently Asked Questions

__Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.__

###### Hugo doesn't seem to follow the instructions I provided, why is that?

Make sure that your instruction is indeed saved and enabled. This can be a frequent mistake, and easily overlooked.

__If your instruction is properly enabled, but you still feel like Hugo isn't applying it, make sure that it matches the best practices__

* your instructions ****should not**** be used to convey information / answer questions
* your instructions ****should**** only be used to shape Hugo's behavior, tone and style

Also note that the more instructions (and the longer/vague they are), the more difficult it is for AI Agents to keep them in mind while replying to your conversations.

Instructions can be diluted and become "suggestion" to the AI's ears if they have several dozens to keep track of and apply in each of their response. We recommend focusing instructions for clear and important sets of rules.

###### Can I use Instructions to give Hugo information about our business?

Providing context to Hugo on your business and services is very important, even crucial. This is what allows AI Agent to have perspective and context when answering questions from your users.

However, instructions are not the right place for that.

We have prepared a dedicated setting for you to place this information, in: ****AI Agent → Agent → Settings → Business description****.