Visual Review Agent - Customization

Tailor the Visual Review Agent’s behavior with customizable prompts and visibility rules.

You can customize the Visual Review Agent to refine how it analyzes and presents visual differences. This feature allows you to define prompts and rules that guide the AI’s behavior, helping you focus on meaningful visual changes and reduce unnecessary noise.

Benefits

• Deliver targeted visual feedback that aligns with your visual testing goals.
• Focus reviews on meaningful visual changes by hiding irrelevant updates and highlighting critical ones.
• Reduces noise by ignoring acceptable visual differences.
• Maintains consistency across builds through reusable rules.

Example prompts

Here are sample prompts for customizing how the Visual Review Agent handles different types of visual changes:

Access the prompt manager

When AI is enabled, you can access the Prompt manager in two ways:

• AI Prompt icon: Click the prompt icon directly while reviewing a build.

• Via NL description text option: Click an NL description to open the Prompt manager.

This automatically generates a suggested prompt, which you can choose to edit or discard. You may also provide your own custom prompt.

Once a prompt is submitted, you must confirm it with the AI to run it.

After reviewing the AI’s response, you need to confirm again for the response to be saved for the entire build. The AI processes the prompt using the browsers enabled for that snapshot to deliver accurate and consistent visual insights.

Key capabilities

Explore the main customization features that help you customize, manage, and apply visual review rules effectively:

Manage Ignore rules and Always show rules

You can manage two types of rules in the prompt manager:

• Ignore Rules: Hide specific types of visual changes, such as “ignore color shifts in icons.”

• Always Show Rules: Ensure critical changes are always displayed, such as “always show text updates in the header.”

• Rules can be defined at different levels:
  • Project level: Apply to all snapshots within a project.
  • Snapshot level: Override project rules for that specific snapshot.

Edit prompts directly from the build review page

You can open the prompt manager directly from any build’s review page to:

• Add, edit, or delete prompts and rules.
• Save changes to automatically regenerate AI diffs.
• Revert to the previous filter if needed.

Apply rules inline

When reviewing a diff, you can create or apply rules inline:

• Select Ignore changes like this to hide similar visual differences in future builds.
• Select Always show changes like this to ensure they remain visible in future reviews.

These inline actions automatically generate suggested rules, which you can edit and save at either the snapshot or project level.

Prompt application across builds

• Newly created or edited rules are automatically applied to future builds.
• Existing or in-progress builds continue using the previously active prompts to maintain result consistency.

Prompt limits

To maintain optimal performance and fair usage, the following limits apply:

• Each rule can be up to 400 characters long.
• A daily quota applies for regenerating comparisons after prompt edits. Paid groups can perform up to 200 regenerations per day.

If the quota is exceeded, you can try again the next day when the limit resets.

View audit information

Each rule includes detailed audit information to support collaboration and transparency. The audit log displays:

• The name and email of the last person who edited the rule.
• The timestamp of the last update.
• The build number where the change was made.

Revert to a previous filter

After applying a new set of rules, you can revert to the previous filter directly from the Prompt Manager.

• This restores the diff state and prompts from before the latest edit.
• Useful when testing new prompt configurations or rolling back unhelpful rules.

Best practices

• Keep prompts short and specific to one type of visual behavior.
• Use project-level rules to maintain consistency across Percy builds, and snapshot-level rules to handle specific exceptions.
• Review and refine prompts periodically to align with evolving design or testing standards.