会話メッセージをスマート検索

curl -G https://api.elevenlabs.io/v1/convai/conversations/messages/smart-search \
     -d agent_id=agent_id \
     -d branch_id=branch_id \
     -d cursor=cursor \
     -d page_size=1 \
     --data-urlencode "text_query=Customer asking to cancel and get money back"

{
  "results": [
    {
      "conversation_id": "conversation_id",
      "agent_id": "agent_id",
      "transcript_index": 1,
      "chunk_text": "chunk_text",
      "score": 1.1,
      "conversation_start_time_unix_secs": 1,
      "agent_name": "agent_name",
      "chunk_highlights": [
        {
          "value": "value",
          "is_hit": true
        }
      ]
    }
  ],
  "has_more": true,
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  },
  "next_cursor": "next_cursor"
}

完全一致するキーワードではなく、意味や意図に基づく意味的類似性で会話の文字起こしを検索し、関連するメッセージを表示します。

クエリパラメータ

text_querystring必須

意味的類似性一致用の検索クエリテキスト

agent_idstringオプション

同じ基盤リソースに解決されるエージェントID（agent_…）または音声エンジン外部ID（seng_）。

branch_idstringオプション

ブランチIDで会話をフィルタリングします。

page_sizeintegerオプション1-50デフォルト値 20

1ページあたりの結果数です。最大50件です。

cursorstringオプション

次のページを取得するために使用します。カーソルはレスポンスで返されます。

レスポンス

成功レスポンス。

resultslist of objects

has_moreboolean

利用可能な結果がさらにあるかどうか

metaobjectオプション

next_cursorstringオプション

結果の次のページを取得するためのカーソル

エラー

422

Messages Search Request Unprocessable Entity Error

ヘッダー

クエリパラメータ

レスポンス

エラー