インサイト

インサイトは、文字起こし結果をもとに指定した観点の情報を抽出する機能です。

インサイト機能の利用には Enterprise ライセンスが必要です。詳細は料金をご参照ください。

設定方法

POST のリクエストボディの config に、以下のパラメータを設定します。

Name	Type	Default	説明
use_insight	Boolean	false	true にすると、文字起こし結果に基づくインサイト生成を要求します。
insight.prompt	String		インサイト生成時に参照する観点や指示です。省略可能で、use_insight が true の場合のみ適用されます。

キーワードブースティングのために keywords を設定した場合、同じキーワードはインサイト生成でも参考ヒントとして使用されます。 keywords の設定方法はキーワードブースティングを参照してください。

リクエスト例

{
  "use_insight": true,
  "insight": {
    "prompt": "会話内容から顧客の主な要望と後続対応が必要な内容を抽出してください。"
  }
}

POST example: Batch STT sample code

Unified example (presets): Batch STT sample code

結果取得

文字起こしリクエスト後は、既存のバッチ STT 結果取得 API で結果を確認します。 インサイト結果は、基本の文字起こし結果が完了すると同じ応答の results.insight フィールドに含まれます。

GET https://openapi.vito.ai/v1/transcribe/{TRANSCRIBE_ID}

インサイト応答例

応答形式は配列ですが、バッチ STT のインサイトは 1 つのリクエストにつき 1 つのインサイト項目を返します。

Name	説明	Type	Value
results.insight[].title	インサイトのタイトル	string
results.insight[].summary	インサイトの内容	string
results.insight[].category	インサイトの分類	string	일상, 문의, 업무, 스팸

{
  "id": "{TRANSCRIBE_ID}",
  "status": "completed",
  "results": {
    "utterances": [
      {
        "start_at": 4737,
        "duration": 2360,
        "msg": "商品の配送予定を確認したくて連絡しました。",
        "spk": 0,
        "lang": "ja"
      },
      {
        "start_at": 8197,
        "duration": 3280,
        "msg": "確認して本日午後に再度ご案内します。",
        "spk": 1,
        "lang": "ja"
      }
    ],
+   "insight": [
+     {
+       "title": "配送予定の確認依頼",
+       "summary": "顧客は商品の配送予定について問い合わせ、担当者は確認後、本日午後に再度案内する予定です。",
+       "category": "문의"
+     }
+   ]
  }
}

制限事項

• インサイト結果は、基本の文字起こし結果取得応答の results.insight で確認できます。