retell について
Retell Platform Skillは、Retellの音声エージェントの通話データをGetfloweticのダッシュボード向けに正規化する方法を示します。通話指標、フィールド対応、性能と品質の監視用テンプレートを定義します。
主な機能
- 01通話数と成功率の指標
- 02平均通話時間の追跡
- 03エージェント別・切断理由別の内訳
- 04イベントフィールドの正規化マッピング
- 05音声分析ダッシュボードのテンプレート
活用シーン
- 01通話数と成功率の監視
- 02エージェント間の性能比較
- 03切断理由の傾向と通話時間の外れ値の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gracebotly/ flowetic-app --skill retellインストール後、Claude Code で/retellを入力して読み込まれたか確認します。
同梱ファイルfield-semantics.yaml
詳細
Retell Platform Skill
概要
Retell は、音声エージェントを構築するための会話型 AI プラットフォームです。ユーザーは Retell エージェントを Getflowetic に接続して、通話品質の監視、エージェントのパフォーマンスの追跡、会話パターンの分析を行います。
用語
- call:Retell エージェントと発信者との単一の音声インタラクション
- agent:LLM バックエンドと音声を備えた、設定済みの Retell 音声エージェント
- call_status:通話結果 —
endedまたはcompletedは成功、それ以外は失敗 - disconnect_reason:通話が終了した理由(agent_hangup、user_hangup、error、silence、max_duration)
- duration_ms:通話時間(ミリ秒)
- start_timestamp / end_timestamp:通話時間の Unix タイムスタンプ
ダッシュボードの主要指標
- 通話量:一定期間の総通話数 — started_at のトレンドチャート
- 成功率:成功した通話の割合 — 主要指標
- 平均通話時間:平均通話時間(ミリ秒)— 補助指標カード
- エージェント別内訳:エージェントごとの通話数 — 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-performance:エージェントごとの比較、切断理由、品質指標
- quality-monitor:切断理由のトレンド、エラー率、通話時間の外れ値
マッピングのヒューリスティクス(レガシーエイリアス)
- call_status → status
- agent_id → workflow_id
- agent_name → workflow_name
- call_id → execution_id
コメント
Markdown 対応