Skip to main content

What is a Test Profile?

A test profile gives your evaluator a specific identity with personal information such as name, date of birth, address, phone number, and other relevant details. This allows the evaluator to provide consistent, realistic identity information during conversations with your AI agent.

When to Use Test Profiles

Test profiles are essential when your AI agent needs to:
  • Verify Identity: Confirm the caller’s identity before proceeding with sensitive actions
  • Lookup Records: Find specific accounts, appointments, or orders based on personal information
  • Personalize Interactions: Address the caller by name or reference their specific details
  • Authenticate Users: Verify security questions or personal details

Common Use Cases

ScenarioRequired InformationExample
Healthcare AppointmentName, DOB, Phone Number”I’m calling to cancel my appointment”
Banking SupportName, Account Number, DOB, Address”I need help with my account”
E-commerce ReturnsName, Order Number, Email”I want to return an order”
Hotel ReservationsName, Confirmation Number, Check-in Date”I need to modify my reservation”

How Test Profiles Work

Setup Process

  1. Create Test Data in Your System: Add mock records (appointments, accounts, orders) with specific test information
  2. Create Matching Test Profile: Create a test profile with the same information in Cekura
  3. Attach to Evaluator: Assign the test profile to your evaluator
  4. Run Tests: The evaluator will use the profile information during conversations

Example: Clinic Receptionist

Let’s say you have a clinic receptionist AI agent that can cancel appointments. The agent verifies identity by asking for the patient’s date of birth before cancellation. Step-by-Step Setup:
1

Create mock appointment in your system

Create a test appointment with:
  • Patient Name: John Smith
  • Date of Birth: January 1, 2000
  • Appointment Date: March 15, 2025
  • Appointment ID: APT-12345
2

Create matching test profile in Cekura

Create a test profile with:
  • Name: John Smith
  • Date of Birth: January 1, 2000
  • Additional Notes: “Appointment ID: APT-12345”
3

Create evaluator with instructions

Create an evaluator with instructions: “Call to cancel the appointment scheduled for March 15, 2025. Provide date of birth when asked for verification.”
4

Attach test profile to evaluator

Assign the “John Smith” test profile to this evaluator.
During Testing: When the evaluator converses with your agent:
  1. Evaluator: “Hi, I’d like to cancel my appointment.”
  2. Agent: “I can help with that. Can I have your date of birth for verification?”
  3. Evaluator: “January 1, 2000” (from test profile)
  4. Agent: “Thank you. I see you have an appointment on March 15, 2025. Would you like to cancel this?”
  5. Evaluator: “Yes, please.”
  6. Agent: “Your appointment has been cancelled. Your confirmation number is APT-12345.”

Test Profile Fields

A test profile can include:
  • Name: First and last name
  • Date of Birth: DOB in various formats
  • Address: Full mailing address
  • Phone Number: Contact number
  • Email: Email address
  • Account/Customer ID: Unique identifiers
  • Security Information: Answers to security questions
  • Custom Fields: Any additional information your agent might need
Keep Test Profiles Organized: Use clear naming conventions like “Customer-Banking-Premium” or “Patient-Dental-Regular” to easily identify which test profile to use for different scenarios.

Using Test Profile Variables in Instructions

You can reference test profile fields directly in your evaluator instructions using template variables. This gives you precise control over which values appear in your instructions.

Template Syntax

Use the {{test_profile.field_name}} syntax to insert test profile values into your instructions: Dot notation for simple fields:
{{test_profile.name}}
{{test_profile.phone_number}}
{{test_profile.account_id}}
Dot notation for nested fields:
{{test_profile.address.city}}
{{test_profile.address.zip}}
Bracket notation (useful for keys with spaces):
{{test_profile['customer name']}}
{{test_profile["order id"]}}

Example

Generic instructions:
Call to cancel the appointment. Provide your date of birth when asked.
With template variables:
Call to cancel the appointment scheduled for {{test_profile.appointment_date}}.
When asked for verification, provide your date of birth: {{test_profile.date_of_birth}}.
Your name is {{test_profile.name}} and your patient ID is {{test_profile.patient_id}}.

How It Works

When a test runs, template variables are replaced with actual values from the test profile. For example, if your test profile contains:
{
  "name": "John Smith",
  "date_of_birth": "January 1, 2000",
  "appointment_date": "March 15, 2025",
  "patient_id": "PT-12345"
}
The instructions become:
Call to cancel the appointment scheduled for March 15, 2025.
When asked for verification, provide your date of birth: January 1, 2000.
Your name is John Smith and your patient ID is PT-12345.
If a template variable references a field that doesn’t exist in the test profile, it will be replaced with an empty string. Make sure your test profile includes all fields you reference in your instructions.

When to Use Template Variables

Template variables are especially useful when:
  • You need the evaluator to provide exact values (like specific IDs or dates)
  • You’re testing multiple scenarios with different test profiles but the same instruction structure
  • You want to ensure consistency between your backend system and what the evaluator says

Best Practices

1. Synchronize Test Data

Ensure your test profile information matches exactly what exists in your backend system. Mismatches will cause verification failures.
❌ Incorrect:
System DOB: 01/01/2000
Profile DOB: 1 January 2000
(Agent might not match these formats)

✅ Correct:
System DOB: 01/01/2000
Profile DOB: 01/01/2000

2. Create Multiple Test Profiles

Build a library of test profiles for different scenarios:
  • Happy path scenarios (everything matches perfectly)
  • Edge cases (partial information, multiple matches)
  • Negative scenarios (wrong information, no matches)

3. Update Profiles Regularly

When your system’s data structure changes, update your test profiles accordingly. Outdated profiles lead to failed tests that don’t reflect real issues.

Example: E-commerce Support Agent

Scenario: Testing an AI agent that handles order returns Test Profile Setup:
{
  "name": "Sarah Johnson",
  "email": "sarah.j@email.com",
  "order_number": "ORD-2024-98765",
  "order_date": "February 10, 2025",
  "phone": "+1-555-0123",
  "shipping_address": "123 Main St, Apt 4B, New York, NY 10001"
}
Corresponding System Data: Create a test order in your e-commerce system with:
  • Order ID: ORD-2024-98765
  • Customer Email: sarah.j@email.com
  • Order Date: February 10, 2025
  • Status: Delivered
  • Items: Blue Sweater (Medium), Size: M, Price: $49.99
Evaluator Instructions: “Call to return the blue sweater from your recent order. Provide order number and email when asked. State that the size doesn’t fit and you’d like a refund.” Expected Outcome: “The agent successfully initiates a return, provides a return label, and confirms the refund timeline.”

Testing Without Test Profiles

For evaluators that don’t require identity verification or personalization, test profiles are optional. Examples include:
  • General information inquiries
  • FAQ testing
  • Menu navigation testing
  • Opening hours requests
In these cases, the evaluator’s instructions alone are sufficient to guide the conversation.