yourang.ai Logo
Back to the platform
Documentation
Get started
  • What the platform is
  • First access
  • Platform overview
  • Quick glossary
Dashboard Assistant
  • What the dashboard assistant is
  • How to use it
  • What it can do
  • Safety and privacy
  • Plans and usage limits
Voice agent
  • Basic configuration
  • Voices and language
  • Instructions
  • Prompt tokens
  • Advanced settings
  • Evaluation criteria
  • Testing and playground
  • Updating instructions
  • External Tools
  • Built-in tools
  • MCP servers
Models offered
  • What models are and why they matter
  • Voice models
  • AI models
  • Choosing the right combination
Documents and knowledge base
  • What the knowledge base is
  • Uploading and managing documents
  • How search works during a call
  • Best practices
Calls
  • Call history
  • Transcripts and summaries
  • Audio recordings
  • Filters and search
  • Data export
Call transfers
  • When and why to transfer a call
  • Departments
  • System tools
  • AI after-hours
  • Routing rules
  • Operator app (iOS / Android)
WhatsApp
  • WhatsApp Business in yourang.ai
  • Real-time chat
  • Automations
  • Approved templates
  • WhatsApp contacts and lists
  • WhatsApp AI agents
Actions and campaigns
  • What actions are
  • SMS campaigns
  • Email campaigns
  • Scheduling and batch sends
Reservations
  • Calendar view
  • Availability rules
  • Confirmations and reminders
  • Changes and cancellations
Contacts
  • Customer directory
  • CSV import
  • Lists and segments
  • Custom fields
Shop and catalogue
  • The shop in yourang.ai
  • Product and service catalogue
  • Order management
  • OCR and price-list import
Integrations
  • Connect Apple Calendar
  • Connect HubSpot
  • Integrations overview
  • Calendar
  • WhatsApp
  • SMS and email
  • Business software and PMS
  • Outbound webhooks
Workflows
  • What workflows are
  • Nodes and blocks
  • Triggers and webhooks
  • Practical examples
Call center and dialer
  • What the yourang.ai call center does
  • Outbound campaigns
  • Human operators
  • Contact lists and live sync
  • Operator panel
External APIs and developers
  • yourang.ai for developers
  • API keys and authentication
  • Main endpoints
  • Incoming webhooks
Use cases
  • Hotels and accommodation
  • Restaurant
  • B&Bs and short-term rentals
  • Beauty center and spa
  • Travel agency
Pricing and plans
  • How pricing works
  • Subscription plans
  • Wallet and credits
  • Consumption and invoices
  • Changing, suspending, or cancelling the plan
Management
  • Account and organization
  • Billing and subscription
  • Team and roles
  • Security and privacy
  • Notifications
Business information
  • Business details
  • Location and address
  • Opening hours
  • AI assistant hours
  • Departments and team
Resources
  • Frequently asked questions
  • Complete glossary
  • Support
Documentation›Voice agent›Instructions

Voice agent

Instructions

Write effective instructions for the voice agent

Instructions guide the agent's behaviour in every situation. Clear, well-structured instructions deliver consistent and appropriate responses.

Three core principles

  • Clarity. Write simple, direct sentences. Avoid ambiguity, technical jargon, and circumlocutions. The agent must understand exactly what to do.
  • Specificity. Don't say 'be polite': explain how and when. For example, 'if the customer asks about hours, reply with the exact time and add: we want to make sure everything is perfect for you'.
  • Completeness. Anticipate edge cases and exceptions. Specify what to do if the agent doesn't know the answer or if the customer becomes rude.

What to include in the instructions

Role and purpose
Who you are and what your main mission is (e.g. booking support, service information).
Available information
Data the agent can provide: rates, hours, available services, business rules.
Actions you can take
What you can do: accept bookings, change dates, give information about packages.
Situations requiring an operator
Which requests must be transferred to a human operator (complaints, complex requests).
Security protocols
How to handle sensitive data: never ask for passwords, never share confidential information.
Behaviour when misunderstanding occurs
How to react when you don't understand: ask the customer to repeat, suggest alternatives, offer human support.

Inconsistent instructions cause problems

If the instructions contradict each other (e.g. 'reply in 10 seconds' but also 'always double-check information'), the agent will give unpredictable answers. Always check internal consistency.

Was this page helpful?

PreviousVoices and languageNextPrompt tokens