Bot Guidance
View as Markdown
The **Guidance** tab (`/ai-bots/{botId}/guidance`) is the default screen when you open an AI Bot. Use it to write structured behavioral rules that the bot follows in customer conversations.
:::note[Required permission]
You need the **`ai:manage`** or **`workspace:manage`** permission to view and edit bot guidance.
:::
## 5 Guidance Categories
Rules are organized into 5 collapsible sections, each showing its current rule count:
1. **Communication Style**: Pronoun usage, tone, reply length, and formatting rules (for example, avoiding Markdown syntax in chat replies).
2. **Clarification & Context**: How the bot asks follow-up questions to clarify needs or collect details such as phone number and address without overwhelming the customer.
3. **Restrictions & Boundaries**: Hard limits on what the bot must never promise or fabricate (for example, unauthorized discounts, free shipping, or out-of-KB product claims).
4. **Spam & Off-topic**: How the bot handles spam, profanity, off-topic messages, or requests to speak with a human.
5. **General & Additional Guidance**: Custom business rules specific to your store or service workflow.
## Add and Edit Rules
1. On the target category header, click **`+`** (or click **Add new guidance** at the bottom of an expanded category).
2. Enter a **Title** (required).
3. Write the detailed instruction in the block editor (type **`/`** to insert bullet lists and formatted blocks).
4. Click **Add** (or **Save changes** when editing an existing rule).
## Enable, Disable, or Delete Rules
Click the **`⋯`** menu on any rule row to:
- **Edit**: Reopen the editor to update the rule title or content.
- **Disable / Enable**: Temporarily turn a rule off without deleting it (disabled rules appear dimmed).
- **Delete**: Permanently remove the rule from the bot.
:::tip[Verify right away]
Guidance updates take effect immediately. Switch to the [Testing](/ai-bots/testing-and-gaps/) tab and send test messages covering your new rules to confirm the bot follows them.
:::
The Guidance tab (/ai-bots/{botId}/guidance) is the default screen when you open an AI Bot. Use it to write structured behavioral rules that the bot follows in customer conversations.
5 Guidance Categories
Section titled “5 Guidance Categories”Rules are organized into 5 collapsible sections, each showing its current rule count:
- Communication Style: Pronoun usage, tone, reply length, and formatting rules (for example, avoiding Markdown syntax in chat replies).
- Clarification & Context: How the bot asks follow-up questions to clarify needs or collect details such as phone number and address without overwhelming the customer.
- Restrictions & Boundaries: Hard limits on what the bot must never promise or fabricate (for example, unauthorized discounts, free shipping, or out-of-KB product claims).
- Spam & Off-topic: How the bot handles spam, profanity, off-topic messages, or requests to speak with a human.
- General & Additional Guidance: Custom business rules specific to your store or service workflow.
Add and Edit Rules
Section titled “Add and Edit Rules”- On the target category header, click
+(or click Add new guidance at the bottom of an expanded category). - Enter a Title (required).
- Write the detailed instruction in the block editor (type
/to insert bullet lists and formatted blocks). - Click Add (or Save changes when editing an existing rule).
Enable, Disable, or Delete Rules
Section titled “Enable, Disable, or Delete Rules”Click the ⋯ menu on any rule row to:
- Edit: Reopen the editor to update the rule title or content.
- Disable / Enable: Temporarily turn a rule off without deleting it (disabled rules appear dimmed).
- Delete: Permanently remove the rule from the bot.