retell

Retell 平台技能

概述

Retell 是一个用于构建语音 Agent 的对话式 AI 平台。用户将 Retell Agent 连接到 Getflowetic，以监控通话质量、跟踪 Agent 性能并分析对话模式。

词汇

• call：Retell Agent 与来电者之间的一次语音交互
• agent：配置了大模型后端和语音的 Retell 语音 Agent
• call_status：通话结果——ended 或 completed（成功），其他状态表示失败
• disconnect_reason：通话结束的原因（agent_hangup、user_hangup、error、silence、max_duration）
• duration_ms：通话时长，单位为毫秒
• start_timestamp / end_timestamp：用于记录通话时间的 Unix 时间戳

仪表板的关键指标

• 通话量：一段时间内的总通话次数——基于 started_at 的趋势图
• 成功率：成功通话所占的百分比——核心统计数据
• 平均时长：平均通话时长，单位为毫秒——辅助指标卡片
• Agent 分类：每个 Agent 的通话次数——基于 agent_name/workflow_name 的饼图
• 断开原因：通话结束的原因——用于质量监控的饼图

事件字段映射

Retell 导入路由会将通话数据规范化为标准事件架构。以下字段会出现在 event.state 中：

事件字段	语义类型	仪表板用途
workflow_id	标识符	映射到 agent_id——仅用于计数
workflow_name	维度	映射到 agent_name——用于分类图表
execution_id	代理键	映射到 call_id——“总通话数”KPI
status	维度	成功率百分比——核心统计数据
duration_ms	度量值（平均值）	“平均通话时长”指标卡片
started_at	时间维度	时间序列趋势轴
ended_at	时间维度	仅用于详情
platform	常量	始终为 "retell"——跳过

以下字段也会出现在 event.labels 中：

• agent_id、agent_name、call_id、status

仪表板模板

• voice-analytics：通话量趋势、成功率、平均时长、Agent 分类
• agent-performance：按 Agent 比较、断开原因、质量指标
• quality-monitor：断开原因趋势、错误率、时长异常值

映射启发式规则（旧版别名）

• call_status → status
• agent_id → workflow_id
• agent_name → workflow_name
• call_id → execution_id