[Maxim] Voice simulation runs docs

docs.json

@@ -75,6 +75,7 @@
                                             "offline-evals/via-ui/advanced/presets",
                                             "offline-evals/via-ui/advanced/scheduled-runs",
                                             "offline-evals/via-ui/advanced/customized-reports",
+                                            "offline-evals/via-ui/advanced/tag-reports",
                                             "offline-evals/via-ui/advanced/dataset-evaluation"
                                         ]
                                     }
@@ -189,7 +190,10 @@
                             },
                             {
                                 "group": "Voice Simulation",
-                                "pages": ["simulations/voice-simulation/voice-simulation"]
+                                "pages": [
+                                    "simulations/voice-simulation/voice-simulation",
+                                    "simulations/voice-simulation/simulation-runs"
+                                ]
                             }
                         ]
                     },

offline-evals/via-ui/advanced/tag-reports.mdx

@@ -0,0 +1,21 @@
+---
+title: Tag test runs
+description: Tag your test runs to group and filter them effectively
+---
+
+<Steps>
+<Step>
+
+Tag any test run by clicking the **Add tags** button in the left sidebar of the run report view. Search and select one or more tags from the dropdown. If a tag doesn't exist, it'll be created automatically.
+
+![Add tags](/images/docs/evaluate/how-to/optimize-evaluation-processes/tag-reports/add-tags-to-report.png)
+
+</Step>
+<Step>
+
+Once tagged, filter runs by tag from the runs table. Navigate to the runs page using the **Runs** button in the left sidebar of the Evaluate section.
+
+![Filter runs](/images/docs/evaluate/how-to/optimize-evaluation-processes/tag-reports/filter-reports-by-tag.png)
+
+</Step>
+</Steps>

simulations/meta.json

@@ -7,7 +7,7 @@
 		},
 		"voice-simulation": {
 			"title": "Voice Simulation",
-			"pages": ["voice-simulation"]
+			"pages": ["voice-simulation", "simulation-runs"]
 		}
 	}
 }

simulations/voice-simulation/simulation-runs.mdx

@@ -0,0 +1,59 @@
+---
+title: Voice Simulation Runs
+description: Test your Voice Agent's interaction capabilities with realistic voice simulations across thousands of scenarios.
+---
+
+## Test voice agents at scale with simulated conversations
+
+Run tests with datasets containing multiple scenarios for your voice agent to evaluate performance across different situations.
+
+<Steps>
+
+<Step title="Create a dataset for testing">
+Configure your agent dataset template with:
+- **Agent scenarios**: Define specific situations for testing (e.g., "Update address", "Order an iPhone")
+- **Expected steps**: List the actions and responses you expect
+
+![Voice Agent Dataset](/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-agent-dataset.png)
+</Step>
+
+<Step title="Set up the test run">
+- Navigate to your voice agent and click **Test**
+- **Simulated session** mode will be pre-selected (voice agents can't be tested in single-turn mode)
+- Select your agent dataset from the dropdown
+- Choose relevant evaluators
+
+<Note>
+  Only built-in evaluators are currently supported for voice simulation runs. Custom evaluators will be available soon.
+</Note>
+
+![Configure simulation test run](/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/trigger-voice-simulation-testrun.png)
+
+</Step>
+
+<Step title="Trigger the test run">
+Click **Trigger test run** to start. The system will call your voice agent and simulate conversations for each scenario.
+</Step>
+
+<Step title="Review results">
+Each session runs end-to-end for thorough evaluation:
+- View detailed results for every scenario
+- Text-based evaluators assess turn-by-turn call transcription
+- Audio-based evaluators analyze the call recording
+
+![Simulation test run result](/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-simulation-testrun-report.png)
+</Step>
+
+<Step title="Inspect individual entries">
+Click any entry to see detailed results for that specific scenario.
+
+By default, test runs evaluate these performance metrics from the recording audio file:
+- **Avg latency**: How long the agent took to respond
+- **Talk ratio**: Agent talk time compared to simulation agent talk time
+- **Avg pitch**: The average pitch of the agent's responses
+- **Words per minute**: The agent's speech rate
+
+![Simulation test run entry](/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/single-entry-result.png)
+</Step>
+
+</Steps>