Start a run

Before starting, connect a LiveKit or Retell agent and add at least one test to your suite. When the run is created, Egma saves the test and persona behavior versions, project persona settings, and grader selection, versions, settings, and thresholds. Queued simulations and retries use that saved selection. Changes to models, voices, or grading policy apply to future runs.

Start the run

Open Runs and select Create a run.
Choose your test suite.
Choose the agent and one of its connections. Review the run settings.
Select Start run.
Open the run to follow its simulations. Starting successfully does not mean the tests passed.

Run egma pull to refresh the agent and connection IDs in egma/config.yaml. Use the IDs for the agent and connection you want to test:

egma run create appointment-booking \
  --agent "$EGMA_AGENT_ID" \
  --connection "$EGMA_CONNECTION_ID" \
  --name "Appointment booking check"

appointment-booking names a direct directory under egma/tests/. EGMA_AGENT_ID and EGMA_CONNECTION_ID are shell variables you set to the IDs from your configuration.The command pushes your local Egma project changes, starts the run, prints its ID and results URL, and returns. A zero exit code means the run started. It does not mean that simulation execution or grading passed.If the pre-run push is refused, no run starts. Resolve the reported test change or invalid content first.

Next steps

Review a run to inspect conversations and grades.

Get started

Core Philosophies

Platform

Integrations

Support

Start a run

Start the run

Next steps

​Start the run

​Next steps

Start the run

Next steps