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

会話の文字起こしメッセージを全文検索およびあいまい検索します。

ヘッダー

xi-api-keystringオプション

クエリパラメータ

text_querystring必須

全文検索およびあいまい一致用の検索クエリテキスト

agent_idstring or nullオプション

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

visited_agent_idslist of strings or nullオプション

これらのエージェントのいずれかが参加した会話をフィルタリングします。指定できる値は50件までです。

visited_agent_branch_idslist of strings or nullオプション

これらのエージェントブランチのいずれかが参加した会話をフィルタリングします。指定できる値は50件までです。

triggered_procedure_idslist of strings or nullオプション

これらのプロシージャのいずれかがトリガーされた会話をフィルタリングします。指定できる値は50件までです。

call_successfulenum or nullオプション

成功評価の結果

許可された値:
call_start_before_unixinteger or nullオプション

この開始日時までの会話をフィルタリングするためのUnixタイムスタンプ(秒)。

call_start_after_unixinteger or nullオプション

この開始日時より後の会話をフィルタリングするためのUnixタイムスタンプ(秒)。

call_duration_min_secsinteger or nullオプション

通話の最小時間(秒)。

call_duration_max_secsinteger or nullオプション

通話の最大時間(秒)。

rating_maxinteger or nullオプション1-5

総合評価の最大値(1~5)。

rating_mininteger or nullオプション1-5

総合評価の最小値(1~5)。

has_feedback_commentboolean or nullオプション

ユーザーフィードバックコメントがある会話をフィルタリングします。

user_idstring or nullオプション

開始したユーザーのIDで会話をフィルタリングします。

evaluation_paramslist of strings or nullオプション

評価フィルターです。繰り返し指定できるパラメータです。形式:criteria_id:result。resultにはsuccess|failure|unknownのいずれかを指定します。例:eval=value_framing:success

data_collection_paramslist of strings or nullオプション
データ収集フィルター。繰り返し指定できるパラメータです。形式:id:op:value。opにはeq|neq|gt|gte|lt|lte|inのいずれかを指定します。inでは値をパイプで区切ります。空の値はフィールドが収集されなかった会話に一致します(id:eq:)。空の値を指定したneqは、フィールドが収集された会話に一致します(id:neq:)。eqは完全一致です。gt|gte|lt|lteには数値が必要です。
dynamic_variable_paramslist of strings or nullオプション
動的変数フィルター。繰り返し指定できるパラメータです。形式:name:op:value。opにはeq|neq|gt|gte|lt|lte|inのいずれかを指定します。inでは値をパイプで区切ります。値を空にすると、変数が設定されていない会話に一致します(name:eq:)。空の値を伴うneqは、変数が設定されている会話に一致します(name:neq:)。eqは完全一致です。gt|gte|lt|lteには数値が必要です。':'を含む名前は指定できません。
tool_nameslist of strings or nullオプション

通話中に使用されたツール名で会話をフィルタリングします。

tool_names_successfullist of strings or nullオプション

成功した呼び出しがあるツール名で会話をフィルタリングします。

tool_names_erroredlist of strings or nullオプション

エラーになった呼び出しがあるツール名で会話をフィルタリングします。

include_invalid_tool_callsbooleanオプションデフォルト値 false

実行されなかったツール呼び出しも一致対象にします。

main_languageslist of strings or nullオプション

検出された主要言語(言語コード)で会話をフィルタリングします。

exclude_statuseslist of enums or nullオプション

指定したステータスの会話を除外します。進行中/処理中の会話をリストビューで非表示にする場合に便利です。

許可された値:
termination_reasonslist of strings or nullオプション

保存されているtermination_reason(metadata.termination_reason)で会話をフィルタリングします。複数のいずれかに一致させるには、パラメータを繰り返してください。

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

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

summary_modeenumオプションデフォルト値 exclude

レスポンスに文字起こしの要約を含めるかどうか。

許可された値:
conversation_initiation_sourceenum or nullオプションデフォルト値 unknown

会話開始に使用できるソースを表す列挙型です。

text_onlyboolean or nullオプション
conversation_product_typeenum or nullオプション

結果を単一の会話プロダクト画面に限定します。

許可された値:
branch_idstring or nullオプション

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

version_idstring or nullオプション

バージョンIDで会話をフィルタリングします。

topic_idslist of strings or nullオプション

トピック検出中に割り当てられたトピックIDで会話をフィルタリングします。

sort_byenumオプション

検索結果の並べ替え順です。‘search_score’は検索スコア順、‘created_at’は会話開始時刻順で並べ替えます。

許可された値:
cursorstring or nullオプション

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

レスポンス

成功レスポンス。

resultslist of objects
has_moreboolean

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

metaobjectオプション
next_cursorstring or nullオプション

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

エラー

422
Unprocessable Entity Error