> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/ai-configuration/tuning/testing-changes.md).

# Testing Changes

Use Guideline Studio to preview how your AI will behave before making changes live.

Before publishing any updates to your AI guidelines, we recommend testing them to avoid unexpected behavior in production.

The **Guideline Studio** lets you simulate how your changes will affect AI responses using a set of sample questions—allowing you to preview the impact before going live.

> ⚠️ **Only trying to fix one specific wrong answer?**\
> You may not need to change your guidelines at all. Consider using our [FAQs and human feedback](/docs/ai-configuration/tuning/human-feedback.md) feature instead—it's ideal for correcting individual answers without broad changes to AI behavior.

> 💡 *New to writing guidelines?*\
> Check out our [Best Practices for Writing Guidelines](broken://pages/x7SYVyVx8JpTWthKeb58) to learn how to write clear, effective instructions for the AI.

### See the guideline studio in action

{% embed url="<https://www.loom.com/share/51067f5d64e14b1a88d796bf9e3673d5?sid=4070e53c-d080-4017-8ee2-a3b36ab37748>" %}

***

### 1. Make Your Guideline Changes

Navigate to the **AI Settings** page and adjust your guideline configurations as needed. Once you're ready to test:

➡️ Click **Test Changes** to begin the testing workflow.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2F0RI5Nou7WkLhxSqnMgQ3%2FScreenshot%202025-06-16%20at%2011.47.20%E2%80%AFAM.png?alt=media&amp;token=c8aebe68-5c19-46c2-a20f-f4c923bd0a2c" alt=""><figcaption><p>AI guidelines page with the test changes button</p></figcaption></figure>

***

### 2. Add Test Questions

You’ll be prompted to add test questions—common examples your customers might ask. These will be used to evaluate the impact of your guideline changes.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FMhSAaA9l0riW5IapMpUv%2FScreenshot%202025-06-16%20at%2011.48.35%E2%80%AFAM.png?alt=media&amp;token=2c858c86-b551-426a-bac2-c23463dda0a4" alt=""><figcaption><p>Add your questions and view previous evaluations</p></figcaption></figure>

> 🌟 Tip: Use questions that represent edge cases, high-volume inquiries, or known problem areas.

On this screen, you’ll also see an option to **View Past Test Results**, allowing you to quickly review the outcomes of previous test runs for context or reference.

***

### 3. Run the Test

Once your questions are added, click **Save and Continue**. The test will begin, and you’ll see responses generated using both the old and new guideline versions.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FZPZ7bGZ8Q6RkhoikfLay%2FScreenshot%202025-06-16%20at%2011.49.10%E2%80%AFAM.png?alt=media&amp;token=1b3633c3-bb4b-43f9-9eec-80cf5ccc805e" alt=""><figcaption><p>See the results of your guidelins evaluation</p></figcaption></figure>

***

### 4. Compare Results

After the test completes, you’ll see **side-by-side comparisons** of responses for each test question—old guidelines on the left, new ones on the right.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FcBkva3qRpA8NdgBZmdyK%2FScreenshot%202025-06-16%20at%2011.50.37%E2%80%AFAM.png?alt=media&amp;token=39f3ffb8-c11b-413d-b90c-028002d9f1d9" alt=""><figcaption><p>Compare answers from the new guidelines to the current live guidelines</p></figcaption></figure>

***

### 5. Compare Guidelines Directly

Want to see exactly what changed in your settings? Click **Compare Guidelines** to view your previous and updated configurations side by side.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2F8628VYLaSm7HFkntUx7r%2FScreenshot%202025-06-16%20at%2011.51.05%E2%80%AFAM.png?alt=media&amp;token=3d088835-9937-45e5-a1b8-984ada6280e4" alt=""><figcaption><p>Compare your new and current live guidelnies</p></figcaption></figure>

***

### 6. Publish or Make Further Edits

If you're happy with the test results, click **Publish Settings** to go live with your changes. A confirmation modal will appear for final review.

<figure><img src="https://2864633804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKZ3bWFAIdLAqpW2uafZ4%2Fuploads%2FmDGHMNBUpQVH9Xu1Rh7O%2FScreenshot%202025-06-16%20at%2011.52.01%E2%80%AFAM.png?alt=media&amp;token=e44cf4b9-adb6-4108-aafc-7901772bc360" alt=""><figcaption><p>Publish the new guidelines to your live AI agent</p></figcaption></figure>

If you’d prefer to make further changes, click **Back to Configure AI Agent Settings**. Your unsaved changes will be preserved, and you can continue refining and re-testing.

***