mcpField
V
vapi

vapi

github.com/gracebotly数据与数据库070 次安装31 周前更新
代码仓库

关于 vapi

用于在 Getflowetic 中分析 Vapi 语音通话数据的技能,说明事件字段映射和仪表板指标,涵盖通话结果、助手表现与成本。

主要功能

  1. 01映射 Vapi 通话字段为事件数据
  2. 02定义通话量与成功率指标
  3. 03跟踪通话时长和单次成本
  4. 04提供助手对比仪表板模板
  5. 05兼容旧版字段名称

适用场景

  1. 01构建通话量与成功率仪表板
  2. 02按助手比较通话数量
  3. 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