> For the complete documentation index, see [llms.txt](https://docs.amigo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.amigo.ai/developer-guide/platform-api/safety/voice-judge.md).

# Voice Judge

The Voice Judge evaluates voice agent calls directly from audio recordings, scoring each call across 10 quality dimensions. Scores measure the voice experience - pronunciation, clarity, pacing, interruption handling - independent of conversational logic or agent prompting.

Results become available through the per-service API after a call has been evaluated.

## Endpoints

### List Recent Voice Judge Results

{% openapi src="<https://api.platform.amigo.ai/v1/openapi.json>" path="/v1/{workspace\_id}/services/{service\_id}/voice-judge/recent" method="get" %}
<https://api.platform.amigo.ai/v1/openapi.json>
{% endopenapi %}

Returns the most recent per-call voice quality scores for a service, ordered newest first.

#### Score Interpretation

All dimension scores range from 0.0 to 1.0:

| Score Range | Severity | Meaning                        |
| ----------- | -------- | ------------------------------ |
| 0.75 - 1.0  | None     | Meets the bar                  |
| 0.5 - 0.74  | Warning  | Minor quality pattern detected |
| 0.25 - 0.49 | Flag     | Notable quality issue          |
| 0.0 - 0.24  | Critical | Significant quality problem    |

#### Error Responses

| Status | Description                                        |
| ------ | -------------------------------------------------- |
| 404    | Service not found in this workspace                |
| 503    | Voice judge result data is temporarily unavailable |

A 200 response with an empty `items` list means no evaluated calls are available for this service. For a 503 response, retry with backoff.

## Dimensions

The voice judge evaluates 10 dimensions, grouped by priority:

### P0 - Critical Quality

* **Latency and Dead Air** - Response latency between turns. Flags prolonged silence (>3s between turns) and extended processing waits without verbal acknowledgment.
* **Pronunciation** - Correct pronunciation of medical terms, drug names, dates, numbers, and patient names. Critical on any factual read-back error.
* **Clarity** - Speech intelligibility and clean audio output. Critical on garbled or unintelligible speech.

### P1 - Important Quality

* **Filler and Silence Management** - Graceful handling of processing pauses. Verbal acknowledgment before a pause, no dead air during the wait, no repeated filler phrases, and filler that matches the result being delivered.
* **Interruption Handling** - Clean barge-in behavior. Agent stops when the caller speaks, no false triggers on background noise, smooth recovery after being interrupted.
* **Audio Consistency** - Absence of volume spikes, pitch anomalies, mid-word cutoffs, or inconsistent voice timbre across turns.

### P2 - Quality Polish

* **Pacing** - Conversational speech rate with appropriate pauses between pieces of information and slower delivery for sensitive content.
* **Warmth and Tone** - Emotional appropriateness matched to the caller's state. Flags flat affect, tonal mismatches, or inappropriate emotional tone.
* **Accent and Language Quality** - Language and accent match to the caller. Critical on wrong language delivery.
* **Voice Identity** - Consistent agent voice and persona across the entire call.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.amigo.ai/developer-guide/platform-api/safety/voice-judge.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.