关于 vapi
用于在 Getflowetic 中分析 Vapi 语音通话数据的技能,说明事件字段映射和仪表板指标,涵盖通话结果、助手表现与成本。
主要功能
- 01映射 Vapi 通话字段为事件数据
- 02定义通话量与成功率指标
- 03跟踪通话时长和单次成本
- 04提供助手对比仪表板模板
- 05兼容旧版字段名称
适用场景
- 01构建通话量与成功率仪表板
- 02按助手比较通话数量
- 03查看通话时长与支出
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gracebotly/ flowetic-app --skill vapi安装后在 Claude Code 中输入/vapi确认已加载。
附带文件field-semantics.yaml
详细介绍
Vapi 平台技能
概述
Vapi 是一个用于构建电话 Agent 的语音 AI 平台。用户将 Vapi 助手连接到 Getflowetic,以监控通话表现、追踪成本并分析对话结果。
术语
- call:助手与来电者之间的一次语音交互
- assistant:配置了系统提示词、模型和语音的 Vapi 语音 Agent
- ended_reason:通话终止的原因(挂断、语音信箱、错误、静默超时、最长时长)
- cost:根据通话时长和模型用量计算的单次通话成本,单位为美元
- transcript:对话的完整文本
- status:通话结果——
ended(成功)或其他值(失败)
仪表板关键指标
- 通话量:一段时间内的总通话数——基于 started_at 的趋势图
- 成功率:status=success 的通话所占百分比——重点统计数据
- 平均时长:平均通话时长,单位为毫秒——辅助指标卡片
- 单次通话成本:总成本除以通话次数——辅助指标
- 助手明细:各助手的通话数——基于 assistant_name/workflow_name 的饼图
事件字段映射
Vapi 导入路由会将通话数据规范化为标准事件架构。以下字段会出现在 event.state 中:
| 事件字段 | 语义类型 | 仪表板用途 |
|---|---|---|
| workflow_id | 标识符 | 映射到 assistant_id——仅用于计数 |
| workflow_name | 维度 | 映射到助手名称——用于明细图表 |
| execution_id | 代理键 | 映射到 call_id——“总通话数” KPI |
| status | 维度 | 成功率百分比——重点统计数据 |
| duration_ms | 度量值(平均值) | “平均通话时长”指标卡片 |
| started_at | 时间维度 | 时间序列趋势轴 |
| ended_at | 时间维度 | 仅用于详情 |
| platform | 常量 | 始终为 "vapi"——跳过 |
这些字段也会出现在 event.labels 中:
- assistant_id、assistant_name、call_id、status
仪表板模板
- voice-analytics:通话量趋势、成功率、平均时长、助手明细
- assistant-performance:按助手比较通话数和时长
- cost-tracker:成本趋势、单次通话成本、总支出
映射启发规则(旧版别名)
以下字段名变体应映射到上述规范名称:
- duration:call_duration_seconds | duration | call_length → duration_ms
- status:status | call_status | outcome → status
- cost:cost_usd | cost | price → cost
评论
支持 Markdown