Simulations

Documentation Index

Fetch the complete documentation index at: https://penseapp.vercel.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Calibrate lets you simulate entire conversations with your agent using simulated users matching the personas of your target audience for specific scenarios defined by you. This guide walks you through setting up and running your first simulation.

​

Create an agent

From the sidebar, click Agents → New agent. You have two options for setting up your agent:

​

Create personas

From the sidebar under End-to-End Tests, click Personas → Add persona. Define WHO the simulated user is - their personality, speaking style, and behavior.

​

Create scenarios

Click Scenarios → Add scenario. Define WHAT the simulated user should accomplish during the conversation.

​

Create metrics

Click Metrics → Add metric. Define how to evaluate whether the agent performed well.

​

Create a simulation

Click Simulations → Add simulation and enter a name. Select the agent, personas, scenarios, and metrics for your simulation. Click Create after filling in the details to save the simulation configuration. This creates the simulation but does not run it yet.

​

Run the simulation

After creating, you’ll see a Launch button. Click it to start a simulation run and choose between:

• Text simulation — text-only conversations (faster)
• Voice simulation — full STT/TTS pipeline with latency metrics

Each run creates one simulated conversation for each persona × scenario combination.

​

Text simulation

After launching a text simulation, the run page opens showing each conversation streaming in real-time. Once conversations complete, results show the metric evaluations for each row. Click any row to view the full transcript. The Overall metrics show the aggregated values for each metric across all conversations.

​

Voice simulation

Voice simulations use the full STT/TTS pipeline for more realistic testing. After launching, conversations stream in real-time like text simulations. Click any row to view the transcript with audio playback for each turn and the full conversation. Once complete, voice simulations show results with the Performance tab displaying aggregated evaluation metrics across all conversations. Switch to the Latency tab to view detailed timing metrics for each component:

• stt/ttft and stt/processing_time — Speech-to-Text latency
• llm/ttft and llm/processing_time — LLM response latency
• tts/ttft and tts/processing_time — Text-to-Speech latency

​

Sharing simulation results publicly

Once a simulation run completes, you can share the results publicly. Open a completed run and click the Share button. This toggles the run to Public and generates a shareable link. Anyone with the link can view the overall metrics, per-conversation results, and transcripts without needing a Calibrate account. Click the Public button again to make the run private.

​

Next steps