VocalDocscontracts 1.65.0

LatencyReport

Stage percentiles and ended reasons over the Calls of a window, from stored Turn metrics; a reading of what was stored, not a measurement run.

An object with 15 fields.

Fields

FieldTypeRequiredDescription
by_agentarray of objectyes
callsintegeryesEnded Calls in the window.
ended_reasonsmap of integeryesThe number of ended Calls of the window by ended reason. Every reason is present, so the api fills 0 for a reason no Call ended with, the reasons added in 1.19.0 (canceled, worker_lost), in 1.21.0 (finalize_failed), in 1.22.0 (refused_concurrency, refused_suspended, refused_spend_cap, refused_no_route), in 1.32.0 (recording_announcement_failed, disclosure_failed) in 1.38.0 (refused_unpriced, stage_unpriced) in 1.48.0 (policy_load_failed) in 1.58.0 (workflow_complete, prompt_compose_failed, max_turns) and in 1.61.0 (refused_opted_out, refused_destination, refused_compliance, schedule_expired, busy) included; a reader on an older version that knows fewer reasons must take this version first.
endpoint_fallback_turnsintegeryes
fromstringyesThe start of the window, RFC 3339.
granularityAnalyticsGranularitynoThe rollup rows read. Added in 1.57.0 (roadmap slice 2.11); absent from an older api, which a reader treats as unknown.
groupsarray of LatencyGroupnoOne item per group of group_by; empty when the read named none. Added in 1.57.0 (roadmap slice 2.11); absent from an older api, which a reader treats as unknown.
interrupted_turnsintegeryes
object"latency_report"yes
stage_statsarray of LatencyStageStatsnoEvery stage with p50, p90, p95 and p99 from bucket counts, its Turn count and its adherence to the target. Added in 1.57.0 (roadmap slice 2.11); absent from an older api, which a reader treats as unknown.
stagesobjectyes
stages.endpoint_msPercentilesyes
stages.leading_silence_msPercentilesyes
stages.model_first_token_msPercentilesyes
stages.stt_final_msPercentilesyes
stages.tts_first_byte_msPercentilesyes
stages.voice_to_voice_internal_msPercentilesyes
tostringyesThe end of the window, RFC 3339.
turnsintegeryesCaller Turns with stage metrics.
verbose_includedbooleannoTrue when the read counted verbose Calls (include_verbose=true). Added in 1.57.0 (roadmap slice 2.11); absent from an older api, which a reader treats as unknown.
windowAnalyticsWindowyes

Used by

The operations whose parameters, request body or responses name this shape directly.