ConvoRev Help Center
Menu
Help CenterManageContact support
Manage guide

Test Your AI Agent

Play the customer, verify facts and actions, expose edge cases and approve changes before normal contacts rely on them.

Quick answer

Reproduce, diagnose, correct and replay

Start with a defined expected result, run the case in the private test chat, compare the actual facts, action and handoff behavior, then make the smallest approved correction. Replay the failed case and nearby edge cases before relying on the change in live traffic.

1 Define2 Test3 Diagnose4 Correct5 Replay
Testing basics

Test behavior—not just polished wording

A response can sound natural and still fail if it uses the wrong fact, acts outside the approved scope, misses an escalation or creates the wrong next step. Begin each test with explicit expectations.

1 · Test case
Customer messageExpected factsExpected next actionExpected handoff
2 · Test chat
Do you have an appointment tomorrow afternoon?
Let me check the available times.
I would prefer 2:00 PM.
Observe the full reply and action
3 · Review
✓
CorrectnessFacts match approved knowledgeScopeAction stays within permissionSafetyBoundaries and privacy holdOutcomeNext step works as intended
DimensionPass conditionFailure signal
Facts

The reply matches current, client-approved information.

Invented, outdated, conflicting or unsupported claims.

Behavior

The Agent follows its approved purpose, boundaries and tone.

An unapproved promise, action, refusal or change of role.

Handoff

Ambiguous, sensitive and out-of-scope cases reach a person.

The Agent continues when judgment or escalation is required.

Outcome

The correct record, booking, task or next step is produced.

A convincing reply without the intended downstream result.

Define the expected result before reading the reply. Otherwise a smooth answer can make an incorrect fact or action seem acceptable.
Private test workspace

Simulate the customer without creating a normal conversation

The private test chat lets you play the customer and evaluate the selected AI Agent before normal contacts see a change. Test messages remain in the test workspace.

1Select

Confirm the target AI Agent

2Prompt

Send one defined customer case

3Observe

Read facts, tone and action

4Compare

Use the expected result

5Record

Pass, fail and evidence

Safe simulation

Use synthetic names, contact details and examples that do not expose unrelated customer information.

Selected Agent

Confirm which AI Agent the test chat is exercising before judging or changing its behavior.

Saved Agent edit

An instruction or knowledge change may affect the same configuration used in live conversations.

Live account coordination

Coordinate material changes with the person responsible for monitoring and be ready to pause the affected route.

Private messages do not make every adjacent control private. Test messages stay in the test workspace, but saved edits to the Agent or its knowledge can affect the live configuration.
Regression set

Build repeatable tests for the cases that matter

A regression set is a saved group of scenarios with defined expected facts, next actions and handoff behavior. Rerun it whenever knowledge, instructions, routing or connected actions change.

Normal

Common approved questions

High-frequency questions, core offers, qualification steps and the primary conversation outcome.

Prove the expected path
Ambiguous

Missing or conflicting context

Vague requests, contradictory details, fragments, misspellings and several rapid messages.

Test clarification behavior
Difficult

Objections and negative sentiment

Strong objections, upset customers, sensitive complaints and requests for exceptions.

Check tone and escalation
Adversarial

Role and privacy attacks

Attempts to make the Agent ignore its purpose, reveal private instructions or take unapproved actions.

Verify the boundary holds
Out of scope

Decline or hand off

Requests for a person, unsupported topics and cases requiring professional or human judgment.

Confirm a safe next step
Changed

Outdated information

Earlier pricing, policies, hours, availability, offers or terms that should no longer be used.

Verify current knowledge wins
Include every supported language and important business term. A successful English test does not prove equivalent handling of another supported language, name, abbreviation or industry phrase.
Pass and fail

Review the complete behavior

Judge the test against the approved business information and expected outcome—not whether the response merely sounds helpful.

Expected

Define before testing

Approved facts, tone, boundaries, required questions, next action and human-handoff condition.

Observed

Compare after testing

The actual answer, captured information, connected action, routing result and customer confirmation.

ReviewPass whenDo not approve when
Correctness

Facts and claims match the current approved source.

The answer invents or mixes pricing, policy, availability or qualifications.

Scope and tone

The Agent stays in role and communicates appropriately.

A polished answer makes an unauthorized commitment or avoids a needed refusal.

Safety

Privacy, access limits and sensitive-case boundaries hold.

The response exposes private material or proceeds without required oversight.

Escalation

The right cases reach a person with useful context.

The handoff is missed, unnecessary or routed without a usable next action.

Outcome

The intended record, task, booking or action is verified.

Only the visible chat reply succeeds.

Evidence-led correction

Fix a problem found in a live conversation

Keep the affected messages and the expected behavior, reproduce the same situation privately, identify the source of the failure and make the narrowest change that corrects it.

1Preserve

Messages and expected result

2Recreate

Same scenario in test chat

3Diagnose

Find the responsible source

4Correct

Smallest approved change

5Replay

Failed case plus edge cases

Observed failureInspect firstRetest
Wrong fact

Approved knowledge source, freshness and conflicting versions.

The original question and one nearby variation.

Wrong behavior

Agent instructions, purpose, boundaries and escalation rule.

Normal path, exception and explicit stop condition.

Wrong timing

Schedule, active hours, timezone and availability source.

Open, closed and boundary-time scenarios.

Wrong route

Human-alert, assignment and destination configuration.

Intended owner, fallback and delivered context.

Action failed

Required fields, permissions, connection and destination system.

Success, missing input and temporary failure.

Use synthetic test data. Do not paste unrelated customer records into the test workspace. Replace names, contact details and other personal information with safe examples.
Agent edits

Change the live source carefully

An instruction editor beside a private test may write to the same AI Agent used in live conversations. Confirm the target, impact and monitoring owner before saving.

Confirm the target

Verify the exact AI Agent and account before opening or saving an instruction or knowledge change.

Change one source

Correct the smallest responsible knowledge item, instruction, rule or connected action.

Coordinate live impact

Tell the person monitoring the affected route and be prepared to pause it if behavior becomes unsafe or uncertain.

Preserve the baseline

Keep the accepted version and test cases so you can compare behavior and recover intentionally.

Before savingTarget, evidence, expected change and monitoring owner
After savingOriginal case, related edges and end-to-end outcome
A broad rewrite can create unrelated regressions. Prefer a narrow correction tied to evidence, then rerun the baseline before approving the change.
Connected actions

Test the result beyond the chat reply

A convincing sentence does not prove a booking, contact update, task, handoff or connected-system action worked. Verify the destination record and the customer's actual next step.

ActionVerify in the destinationAlso test
Booking

Correct date, time, timezone, availability and customer confirmation.

Unavailable time, changed preference and missing required detail.

Contact update

Correct contact, approved field, value and source context.

Invalid format, omitted answer and a later correction.

Task or handoff

Correct owner, due time, reason, usable context and notification path.

Unavailable owner, fallback route and duplicate prevention.

Connected system

The intended external record exists once and contains the right data.

Temporary connection failure, permission error and recovery behavior.

Visible reply passed

Inspect the destination anyway

The Agent may describe a successful action even when the downstream record is missing, incomplete or routed incorrectly.

Destination record passed

Check the customer experience

Verify that the customer receives the correct confirmation, time, instructions and next step without conflicting messages.

Only describe an action as integrated after it has been tested. When a workflow relies on automation, export or human handling, verify and describe that method accurately.
Approval and release

Approve the behavior and preserve the baseline

Reviewers should approve correctness, scope, tone, safety, escalation and the actual next action. Accepted cases become the regression baseline for future changes.

  1. Rerun the failed case.Confirm the original problem is corrected without relying on memory or a similar prompt.
  2. Test nearby variations.Change wording, order, missing details and one boundary condition to expose brittle behavior.
  3. Verify connected outcomes.Inspect the destination record, timezone, owner, confirmation and recovery behavior.
  4. Check escalation and privacy.Confirm ambiguous, sensitive and out-of-scope cases still reach the approved human path.
  5. Record the accepted result.Save the prompt, expected facts, action, handoff and observed evidence as the baseline.
  6. Release with monitoring.Use controlled scope, watch real conversations and be prepared to pause or correct the affected route.
Rerun the baseline after meaningful changes. Knowledge refreshes, instruction edits, routing changes, connected-action changes and major product updates can all affect previously accepted behavior.
Troubleshooting

Resolve common testing problems

Test answer changes between runs

Control the test conditions

Use the same Agent, prompt, knowledge state and relevant conversation context; then judge against the same expected result.

Correct reply, wrong fact

Inspect the knowledge source

Find outdated or conflicting approved information and correct the narrowest responsible source before replaying.

Text passes, action fails

Inspect the destination

Check required fields, permissions, connection state, timezone, owner and the resulting record—not only the visible reply.

Correction breaks another case

Rerun the regression set

Reduce the scope of the edit, restore the accepted baseline if needed and retest normal plus boundary scenarios.

Preserve evidence before editing. Keep the prompt, selected Agent, knowledge state, observed reply, downstream result and expected behavior so the cause can be diagnosed rather than guessed.
Common questions

AI Agent testing questions

Can private test messages affect normal contacts?

The messages remain in the private test workspace. However, saved edits to the selected AI Agent, its instructions or knowledge may affect the configuration used for live conversations.

How many scenarios should I test?

Cover the most common approved questions plus ambiguous, difficult, adversarial, outdated, escalation and connected-action cases. Prioritize business impact and known risk over an arbitrary count.

Why did a polished response fail?

Wording quality is only one dimension. The answer fails if it uses the wrong fact, exceeds scope, misses a handoff, exposes private material or produces the wrong next action.

Should I edit the Agent directly from the test area?

Only after confirming the target Agent, evidence, expected correction and live impact. Make the narrowest approved change, coordinate monitoring and rerun the baseline.

When can I approve a change?

After the failed case, related edge cases, escalation behavior and connected outcomes pass the defined expectations—and the appropriate reviewer approves the result.

Need testing help?

Send the test case and expected result

Include the ConvoRev account, selected AI Agent, synthetic prompt, relevant knowledge or instruction change, observed reply, downstream result and expected behavior. Remove credentials and real customer information that is not required to diagnose the issue.

Email ConvoRev support