> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getdecipher.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Context

> Give your QA agent product-specific knowledge to eliminate false positives

Agent Context lets you give Decipher's QA agent plain-language rules about your product's expected behavior. This helps the agent distinguish real bugs from known quirks — like a staging environment that 403s on first load or a cookie consent popup that appears intermittently.

<img src="https://mintcdn.com/decipherai/TqM-AqYzM2n4TRgN/images/agent-context.gif?s=9f0ad2bac476c0cffe4a6e95f19b8c24" alt="Agent Context rules in project settings" width="720" height="405" data-path="images/agent-context.gif" />

## Setup

Go to your project **Settings > Testing** tab. In the **Agent Context** section, click **Add Rule** and describe the behavior in plain language. Rules take effect immediately.

## How It Works

Active rules are injected into the agent's context during **step validation** and **assertion validation**. When the agent evaluates whether a step succeeded or an assertion passed, it checks its observations against your rules. Behaviors you've marked as expected are filtered out.

Rules are interpreted with full reasoning — you don't need exact string matches or CSS selectors. "The debug toolbar at the bottom of the screen" is enough.

## Examples

| Category               | Rule                                                                                           |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| Environment quirks     | "Staging uses mock payment processing. 'Test Mode' in the header is expected."                 |
| Environment quirks     | "API responses in staging can take up to 10 seconds. Don't flag timeouts under 15s."           |
| Intentional UI states  | "New accounts see an empty dashboard with an onboarding checklist. Not a bug."                 |
| Intentional UI states  | "The old settings page redirects to the new one. The redirect is intentional."                 |
| Known temporary issues | "Profile image upload shows a brief error before succeeding. Ignore if upload completes."      |
| Known temporary issues | "Search results page flashes 'no results' before populating. Wait 2 seconds before asserting." |

## Best Practices

* **Be specific** — "Ignore the red banner on the checkout page" over "ignore red banners."
* **Keep rules current** — Remove rules when the behavior is fixed. Stale rules can mask real bugs.

## Managing Rules

Click any rule to view, edit, or toggle it. Each rule shows its creation date and current status.

* **Toggle active/inactive** — Only active rules are used during test runs.
* **Edit** — Changes take effect on the next run.
* **Delete** — Permanently remove a rule.

***

*Need help? [Contact our support team](mailto:team@getdecipher.com).*