You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: fern/test/voice-testing.mdx
+26-51Lines changed: 26 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,38 +6,36 @@ slug: /test/voice-testing
6
6
7
7
## Overview
8
8
9
-
Voice Testing is an end-to-end feature that automates testing of your AI voice agents. Our platform simulates a call from an AI tester that interacts with your voice agent by following a pre-defined call script. After the call, the transcript is sent to a language model (LLM) along with your success criteria. The LLM then determines if the call met the defined objectives.
9
+
Voice Testing is an end-to-end feature that automates testing of your AI voice agents. Our platform simulates a call from an AI tester that interacts with your voice agent by following a pre-defined call script. After the call, the transcript is sent to a language model (LLM) along with your evaluation rubric. The LLM then determines if the call met the defined objectives.
10
10
11
11
## Creating a Test Suite
12
12
13
13
Begin by creating a Test Suite that organizes and executes multiple test cases.
14
14
15
15
<Steps>
16
16
### Step 1: Create a New Test Suite
17
-
- Navigate to the **Test** tab in your dashboard and select **Voice Testing**.
17
+
- Navigate to the **Test** tab in your dashboard and select **Test Suites**.
18
18
- Click the **Create Test Suite** button.
19
19
20
20
### Step 2: Define Test Suite Details
21
21
- Enter a title for your Test Suite.
22
22
- Select a phone number from your organization using the dropdown.
23
+
- Make sure the phone number has an assistant assigned to it (if not, navigate to Phone Numbers tab to complete that action).
23
24
24
25
### Step 3: Add Test Cases
25
26
- Once your Test Suite is created, you will see a table where you can add test cases.
26
-
- Click **Add Test Case** to add a new test case (up to 50 can be added).
27
+
- Click **Add Test** to add a new test case (up to 50 can be added).
27
28
28
29
### Step 4: Configure Each Test Case
29
-
-**Caller Behavior:** Define how the testing agent should behave, including a detailed multi-step prompt that outlines the customer's intent, emotions, and interaction style.
30
-
-**Success Criteria:** List one or more questions that an LLM will use to evaluate if the call was successful.
30
+
-**Script:** Define how the testing agent should behave, including a detailed multi-step prompt to simulate how the customer should behave on the call.
31
+
-**Rubric** List one or more questions that an LLM will use to evaluate if the call was successful.
31
32
-**Attempts:** Choose the number of times (up to 5) the test case should be executed each time the Test Suite is run.
32
33
33
34
### Step 5: Run and Review Tests
34
35
- Click **Run Tests** to execute all test cases one by one.
35
36
- While tests are running, you will see a loading state.
36
37
- Upon completion, a table displays the outcomes with check marks (success) or x-marks (failure).
37
-
- Click on a test row to view detailed results: a dropdown shows each attempt, the LLM's reasoning, the transcript of the call, the defined caller behavior, and the success criteria.
38
-
39
-
### Step 6: Export Results
40
-
- You can export the test results as a CSV file for further analysis.
38
+
- Click on a test row to view detailed results: a dropdown shows each attempt, the LLM's reasoning, the transcript of the call, the defined script, and the success rubric.
41
39
</Steps>
42
40
43
41
## Test Execution and Evaluation
@@ -51,74 +49,51 @@ When you run a Test Suite, the following steps occur:
51
49
- The number of attempts made.
52
50
- The LLM's reasoning for each attempt.
53
51
- The complete call transcript.
54
-
- The configured caller behavior and success criteria.
55
-
-**CSV Export:** Results can be exported for additional review or compliance purposes.
52
+
- The configured script and rubric.
56
53
57
54
## Example Test Cases
58
55
59
-
Below are three example test cases to illustrate how you can configure detailed caller behavior and success criteria.
56
+
Below are three example test cases to illustrate how you can configure detailed simulation scripts and evaluation rubrics.
60
57
61
58
### Example 1: Account Inquiry
62
59
63
-
**Caller Behavior:**
60
+
**Script:**
64
61
Simulate a customer inquiring about their account status with growing concern as unexplained charges appear in their statement.
65
62
66
-
**Example Prompt:**
67
-
```md title="Example Prompt" wordWrap
68
-
[Identity]
69
-
You are a long-time bank customer with a keen eye for your financial details.
70
-
71
-
[Personality]
72
-
Normally calm and polite, you become increasingly anxious when you notice discrepancies on your account statement. Your tone shifts from supportive to urgent as the conversation progresses.
73
-
74
-
[Goals]
75
63
Your primary objective is to clarify several unexplained charges by requesting a detailed breakdown of your recent transactions and ensuring your account balance is accurate.
76
64
77
-
[Interaction Style]
78
65
Begin the call by stating your name and expressing concern over unexpected charges. Ask straightforward questions and press for more details if the explanation is not satisfactory.
79
66
```
80
67
81
-
**Success Criteria:**
82
-
```md title="Success Criteria" wordWrap
68
+
**Rubric:**
69
+
```md title="Rubric" wordWrap
83
70
1. The voice agent clearly presents the current account balance.
84
71
2. The voice agent provides a detailed breakdown of recent transactions.
85
72
3. The response addresses the customer's concerns in a calm and informative manner.
86
73
```
87
74
88
75
### Example 2: Billing Support
89
76
90
-
**Caller Behavior:**
91
-
Simulate a customer who is frustrated and calling about a billing discrepancy.
92
-
93
-
**Example Prompt:**
94
-
```txt title="Example Prompt" wordWrap
95
-
[Identity]
96
-
You are a loyal customer who has always trusted the billing process, but the current bill appears unusually high.
97
-
98
-
[Personality]
99
-
Frustrated and assertive, you express anger over an unexpected charge while remaining focused on obtaining clarification.
100
-
101
-
[Goals]
102
-
Your goal is to understand the discrepancy in your bill by obtaining a detailed explanation, confirming whether an overcharge occurred, and understanding the steps for resolution.
77
+
Unlike in the previous example, this time we will provide a more detailed and step-by-step script for the test agent to follow.
103
78
104
-
[Interaction Style]
105
-
Start the call by clearly stating your billing concern, describing the specific overcharge, and requesting a comprehensive explanation with resolution options.
106
-
```
79
+
**Script:**
80
+
Simulate a customer who is frustrated and calling about a billing discrepancy.
81
+
1. Express anger over an unexpected charge and the current bill appearing unusually high.
82
+
2. Try to get a detailed explanation, confirming whether an overcharge occurred, and understanding the steps for resolution.
83
+
3. End the call.
107
84
108
-
**Success Criteria:**
109
-
```md title="Success Criteria" wordWrap
110
-
1. The voice agent acknowledges the billing discrepancy respectfully without dismissing the concern.
111
-
2. The agent provides a clear explanation of the charges, detailing possible reasons for the discrepancy.
112
-
3. The conversation concludes with a proposed solution or a clear escalation plan to address the overcharge.
85
+
**Rubric:**
86
+
```md title="Rubric" wordWrap
87
+
The voice agent acknowledges the billing discrepancy respectfully without dismissing the concern.
113
88
```
114
89
115
90
### Example 3: Appointment Scheduling
116
91
117
-
**Caller Behavior:**
92
+
This time, we will spin up an even more detailed personality for the test agent. By showing these varied styles of scripts, we hope to show the flexibility of the Voice Testing feature and how you can use it to meet your testing needs.
93
+
94
+
**Script:**
118
95
Simulate a customer trying to schedule an appointment with a hint of urgency due to previous delays.
119
96
120
-
**Example Prompt:**
121
-
```md title="Example Prompt" wordWrap
122
97
[Identity]
123
98
You are an organized customer who values efficiency and punctuality.
124
99
@@ -132,8 +107,8 @@ Your goal is to secure an appointment at your preferred time, while remaining fl
132
107
Begin the call by stating your need for an appointment, specifying a preferred date and time (e.g., next Monday at 3 PM). Request clear confirmation of your slot, and if unavailable, ask for suitable alternatives.
133
108
```
134
109
135
-
**Success Criteria:**
136
-
```md title="Success Criteria" wordWrap
110
+
**Rubric:**
111
+
```md title="Rubric" wordWrap
137
112
1. The voice agent confirms the requested appointment time clearly and accurately.
138
113
2. The agent reiterates the appointment details to ensure clarity.
139
114
3. The scheduling process ends with a definitive confirmation message of the booked appointment.
0 commit comments