vapi について
GetfloweticでVapiの音声通話データを分析するスキルです。イベント項目の対応付けと、通話結果、アシスタントの実績、コストを追跡するダッシュボード指標を定義します。
主な機能
- 01Vapiの通話項目をイベントデータに対応付け
- 02通話数と成功率の指標を定義
- 03通話時間と1回あたりのコストを追跡
- 04アシスタント比較用ダッシュボードを提示
- 05旧フィールド名にも対応
活用シーン
- 01通話数と成功率のダッシュボード作成
- 02アシスタント別の通話件数比較
- 03通話時間と支出の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gracebotly/ flowetic-app --skill vapiインストール後、Claude Code で/vapiを入力して読み込まれたか確認します。
同梱ファイルfield-semantics.yaml
詳細
Vapi プラットフォームスキル
概要
Vapi は、電話エージェントを構築するための音声 AI プラットフォームです。ユーザーは Vapi アシスタントを Getflowetic に接続し、通話のパフォーマンスを監視したり、コストを追跡したり、会話の結果を分析したりできます。
用語
- call:アシスタントと発信者の間で行われる、1 回の音声によるやり取り
- assistant:システムプロンプト、モデル、音声が設定された Vapi 音声エージェント
- ended_reason:通話が終了した理由(hangup、voicemail、error、silence-timeout、max-duration)
- cost:通話時間とモデルの使用状況に基づく、1 回の通話あたりのコスト(USD)
- transcript:会話の全文
- status:通話の結果 —
ended(成功)またはその他の値(失敗)
ダッシュボードの主要指標
- 通話数:時間経過に伴う通話の合計数 — started_at に基づくトレンドチャート
- 成功率:status=success の通話の割合 — 主要指標
- 平均通話時間:通話の平均時間(ミリ秒) — 補助指標カード
- 通話あたりのコスト:合計コストを通話数で割った値 — 補助指標
- アシスタント別内訳:アシスタントごとの通話数 — assistant_name/workflow_name に基づく円グラフ
イベントフィールドのマッピング
Vapi のインポートルートは、通話データを標準のイベントスキーマに正規化します。event.state に表示されるフィールドは次のとおりです。
| イベントフィールド | 意味の種類 | ダッシュボードでの用途 |
|---|---|---|
| workflow_id | identifier | assistant_id にマッピング — 件数のカウントのみ |
| workflow_name | dimension | アシスタント名にマッピング — 内訳チャート |
| execution_id | surrogate_key | call_id にマッピング — 「通話総数」KPI |
| status | dimension | 成功率 — 主要指標 |
| duration_ms | measure (avg) | 「平均通話時間」指標カード |
| started_at | time_dimension | 時系列トレンドの軸 |
| ended_at | time_dimension | 詳細のみ |
| platform | constant | 常に「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 対応