Voice Agent
Get started

Register an Agent Under Test

Add the voice agent you want Voice Agent to evaluate.

Register an Agent Under Test (AUT) for generated tests and workflows that use telephony. An uploaded recording can instead use an existing agent or the minimal inline agent created in Upload Recordings.

Add an agent

  1. Open Agents in the sidebar.
  2. On Agents (AUT), select Register New Agent.
  3. Enter an Agent Name.
  4. Under Connection, keep Phone (Twilio / PSTN) and enter Phone Number (E.164) * as + followed by 7 to 15 digits. To reach the agent without a phone call, see Register a direct-channel agent.
  5. Select the relevant Vertical.
  6. Choose the Role that describes the AUT.
  7. Add a QA note (optional) if reviewers need concise context.
  8. Save the agent.

Register a direct-channel agent

A Direct channel (no PSTN) agent is tested over a network connection instead of a phone call. It needs no phone number.

Configuration-dependent: Direct-channel agents are off unless the deployment enables them, and only workspace administrators can register them. Members can select and run a registered direct-channel agent.

  1. Under Connection, choose Direct channel (no PSTN).
  2. Choose the Protocol:
    • Audex AgentSession (gRPC, host:port): enter the Agent Endpoint as host:port and choose the Transport.
    • AI Agent Studio: enter the Gateway URL (wss://…), the Org ID, and the Virtual Agent ID, then choose the Channel. Text exchanges messages; Voice speaks to the agent and records the call, so audio metrics apply. AI Agent Studio only accepts connections from origins on its allowlist, so for now Studio agents work only when the dashboard runs locally (http://localhost:3000); deployed dashboards are rejected until the Studio team allowlists them.
  3. Add an Auth Token (optional) if the agent requires one. A token requires TLS. After registration it is never shown again, only reported as set.

The endpoint must be reachable on the public internet; private and internal addresses are rejected. The connection, channel, and token cannot be edited later: delete and register the agent again to change them.

Choose the role carefully

Choose Business Agent (AUT is the business) when the AUT serves customers. Choose Customer Assistant (AUT is the customer) when it represents the customer side of a conversation. Customer Assistant is currently limited to the Healthcare Scheduling vertical, which the UI selects and locks. The chosen role determines the TA’s opposite role in generated scenarios.

Add a behavior definition when it helps

The Agent behavior definition (JSON / JSONC) field is optional in general. Use it to describe stable behavior that helps create or evaluate tests. JSONC comments are accepted.

Important: Never include API keys or secrets. Secret-like fields and values are rejected, but the safest approach is to keep credentials out of this definition entirely.

Keep the definition focused on behavior, capabilities, and expected interaction patterns. Choose it carefully: after registration, the current UI displays the stored definition but does not provide an editor. To correct it, delete and recreate the registration.

Policy Enforcement needs ready rules

Policy Enforcement is the exception: it requires successfully extracted, ready policy rules for the selected AUT. On the Agents page, use the policy status and any warnings to recover. Download Template can help you prepare a valid behavior definition before registration:

  • Not extracted: select Extract policies. If no behavior definition is configured, delete and recreate the registration with one.
  • Needs refresh: select Refresh policies.
  • No policies found: delete and recreate the registration with clearer enforceable rules.
  • Failed: use Retry extraction if the failure was transient. If the stored definition cannot produce usable rules, delete and recreate the registration with a corrected definition.

After extracting or refreshing policies, regenerate the Policy Enforcement scenario and only then run it. A ready status with warnings is still worth reviewing before relying on the rules.

What happens next

Select the AUT in Upload Recordings to evaluate an existing call, or select it in Configure Test Run to create a generated test.

Upload your first recording

Manage a registered agent

On this page