ConvoRevHelp Center
Menu
Help CenterAI AgentsContact support
AI Agents guide

Configure Your AI Agent

Turn your approved business decisions into a controlled operating brief that tells the agent who it helps, what it can say and do, and when a person must take over.

Quick answer

Build a clear operating brief, then approve it through testing

Define one role and outcome, attach only approved knowledge, set the agent's tone and questions, establish strict boundaries and handoff rules, enable only necessary actions, and test both successful and failure paths before normal customer traffic reaches it.

1 Role2 Rules3 Knowledge4 Test
Before configuration

Start with a controlled operating brief

A good configuration is not every fact about the business pasted into one instruction. It is a focused brief that separates stable behavior from maintained business knowledge and makes the expected result easy to review.

01

One audience

Identify who the agent is prepared to help in this conversation path.

02

One job

State the type of request it should handle and the questions it may ask.

03

One next action

Choose the appropriate outcome it may offer when the customer is ready.

04

One safe fallback

Define where uncertainty, risk, or a request for a person should go.

Managed configuration: ConvoRev uses your approved sources and operating decisions to prepare the agent, then tests the proposed behavior with you before release.
Step 1

Define the role and success condition

State who the agent helps, which conversation it owns, and the next action it may offer. Keep the role narrow enough that a reviewer can tell whether a response was correct.

AudienceWho is asking?

For example: a prospective customer asking about an approved service.

ConversationWhat should it handle?

Answer the defined questions and collect only the necessary details.

OutcomeWhat is the next step?

Offer the approved booking, estimate, application, purchase, or handoff path.

Avoid open-ended autonomy. Do not instruct the agent to pressure customers, conceal that it is an AI, invent missing information, or continue after a person has taken over.
Step 2

Separate instructions from business knowledge

Keep stable operating rules in the agent instructions and changing facts in maintained knowledge sources. This makes updates safer and avoids burying current information inside a long prompt.

Instructions

How the agent behaves

  • Role and approved audience
  • Tone and response style
  • Questions and order constraints
  • Boundaries and escalation rules
  • When to offer the next action
Knowledge

What the agent may know

  • Services and product information
  • Policies and approved FAQs
  • Availability and operating details
  • Current fees or promotions
  • Qualification requirements
Exclude

What should stay out

  • Internal notes and private data
  • Expired offers or old policies
  • Conflicting source versions
  • Passwords or access credentials
  • Unsupported claims or assumptions
Resolve conflicting facts before launch. The agent should not be expected to decide which business policy, price, or promotion is current.
Step 3

Describe the conversation behavior

Use explicit decisions instead of broad instructions such as “be helpful” or “close the sale.” Confirm how the agent should handle the moments that change the direction of a conversation.

DecisionWhat to confirm
Voice and language

Tone, primary language, response length, and any terminology the agent should use or avoid.

Questions

Which details are necessary, when to ask, and whether any questions must follow a specific order.

Contact fields

Which approved answers may be saved and which information should never be requested or stored.

Uncertainty

How to respond to vague, repeated, contradictory, off-topic, or unsupported requests.

Next action

The conditions that make a booking, estimate, application, purchase, or handoff appropriate.

Stop conditions

When to decline, pause, transfer, or wait for a person instead of continuing automatically.

Short examples can clarify tone, but examples strongly influence wording. Avoid temporary facts and test each supported language separately.

Step 4

Define boundaries and human handoff

Create explicit escalation rules for sensitive topics, complaints, uncertainty, requests for a person, and situations your team considers high risk.

Must

Required behavior

Use approved knowledge, protect private information, acknowledge uncertainty, and follow the defined handoff rules.

May

Allowed behavior

Ask the approved questions, save permitted fields, and offer the selected next action when its conditions are met.

Must not

Prohibited behavior

Invent facts, make unsupported promises, request sensitive data, or continue after control has passed to a person.

TriggerRisk, uncertainty, complaint, or human request
ContextCollect only the approved details and summarize
OwnerPause and send to the named person or queue
Ownership changes at handoff. When the agent pauses for a person, the team owns the response until the AI is intentionally resumed.
Step 5

Set response controls deliberately

Depending on the approved deployment, controls may be available for response pacing, message splitting, language, processing depth, or conversation limits. Use them to support the operating brief—not to compensate for unclear instructions.

Pacing

Choose a natural delay without making urgent handoffs wait unnecessarily.

Message format

Keep responses readable for the channel and avoid excessive splitting.

Language

Confirm supported languages, fallback behavior, and approved terminology.

Processing

Use the approved response setting and validate quality with the regression set.

Conversation limit

Send a long or unresolved exchange to a safe pause or owned human queue.

Next-action timing

Offer the approved outcome only when the required context is present.

Availability varies by deployment. Use only the controls shown in the approved account configuration and confirm unfamiliar settings with ConvoRev before changing them.
Step 6

Add only the knowledge and abilities the role needs

Attach approved sources and enable the minimum actions required for the use case. Every system action needs a successful test and a controlled failure test.

  1. 1

    Attach approved knowledge

    Use current, authoritative sources with a named owner for future corrections.

  2. 2

    Enable the necessary action

    A booking, contact update, task, or connected-system action should have one clear business purpose.

  3. 3

    Define required information

    List the fields needed to complete the action and the safe behavior when one is missing or invalid.

  4. 4

    Confirm the destination

    Verify the calendar, queue, record, or workflow that should receive the completed result.

Approval gate

Test the agent before customer traffic arrives

Use controlled test conversations and record the expected result. Correct the underlying source or rule, then repeat the same scenario until the behavior is accepted.

  • A common question with a current, approved answer.
  • An incomplete or ambiguous request that requires clarification.
  • An objection, complaint, or request for a person.
  • An out-of-scope question and an instruction-bypass attempt.
  • A stale, conflicting, or unsupported fact the agent must not invent.
  • Every handoff trigger, receiving queue, and pause condition.
  • Every enabled action with valid required information.
  • Every enabled action with a missing or invalid required field.

Agent approval gate

Do not route normal traffic to the agent until its role, knowledge, boundaries, handoffs, and enabled actions have passed the documented test set.

After approval

Make changes from evidence

Review real conversations

Look for repeated unanswered questions, confusing phrasing, weak qualification, unnecessary handoffs, and incorrect next actions.

Change one layer at a time

Update the source, instruction, field, or action responsible for the issue instead of rewriting the entire agent at once.

Repeat the regression set

Retest previously approved scenarios after any material knowledge, behavior, routing, or action change.

Keep approval ownership clear

Assign a person who can confirm business facts, policy exceptions, and customer-facing changes.

Troubleshooting

When the agent's behavior is not what you expected

The agent gives a confident but incorrect answer

Check which knowledge source supported the response, whether a conflicting or outdated source is attached, and whether the instructions encourage guessing. Correct the authoritative source, reinforce the uncertainty rule, and repeat the same test.

The agent asks too many questions

Review which fields are actually required for the approved next action. Remove unnecessary questions, define when each question should be asked, and confirm whether known contact details can be reused safely.

The agent offers the next step too early

Define the conditions that must be present before the offer appears. Test both a qualified and an unqualified conversation to confirm the boundary.

The handoff does not reach the right team

Verify the trigger, receiving queue, assignment coverage, notification path, and the fields or summary passed with the conversation. Test the complete route with a new controlled conversation.

A system action fails

Pause the affected action for normal traffic. Confirm the connection, destination, permissions, required fields, and failure behavior, then test success and invalid-input cases again.

A configuration change does not affect an existing chat

An active conversation may retain earlier context or assignment. Test the revised configuration with a fresh controlled conversation before diagnosing the new rule as ineffective.

Need configuration help?

Send one controlled example

Include the account, agent, test question, expected response or action, actual result, and whether the conversation was new or already active. Do not include customer passwords or sensitive personal information.

Email ConvoRev support