Skip to main content
DocsCustom IntegrationsAI Agent Instructions

AI Agent Instructions

The AI's behavior is entirely determined by its instructions. Poor instructions = poor customer experience.

Anatomy of Good Instructions

You are [ROLE] for [COMPANY]. Your goal is [PRIMARY OBJECTIVE].

AVAILABLE ACTIONS:
- lookup_customer: Use this to find customer by phone (auto-filled) or email
- update_customer: Use this to change customer details (name, email, address)
- check_balance: Use this when customer asks about their balance
- create_ticket: Use this for issues that need follow-up

WHEN TO USE EACH ACTION:
- Customer asks "check my balance" → lookup_customer first, then share balance
- Customer asks "change my address" → lookup_customer, verify, then update_customer
- Customer reports a problem → create_ticket with details

VERIFICATION RULES:
- ALWAYS verify identity before sharing sensitive data
- ALWAYS verify before making changes (update, delete)

WHAT TO DO IF:
- Customer not found: Ask for email or customer ID
- Verification fails: Offer to transfer to human agent
- Action fails: Apologize and offer alternatives

TONE:
- Professional but friendly
- Patient with confused customers
- Never argue or get defensive

Common Instruction Mistakes

MistakeProblemFix
Too vagueAI guesses when to use actionsBe specific: "Use X when customer says Y"
Missing actionsAI doesn't know action existsList ALL available actions
No edge casesAI freezes on unusual requestsAdd "WHAT TO DO IF" section
Wrong action mappingAI uses wrong actionClearly describe what each action does
Custom Integrations - AI Agent Instructions