クエリパラメータ
cursor string or null オプション
次のページを取得するために使用します。カーソルはレスポンスで返されます。
agent_id string or null オプション
同じ基盤リソースに解決されるエージェントID(agent_…)または音声エンジン外部ID(seng_)。
visited_agent_ids list of strings or null オプション
これらのエージェントのいずれかが参加した会話をフィルタリングします。指定できる値は50件までです。
visited_agent_branch_ids list of strings or null オプション
これらのエージェントブランチのいずれかが参加した会話をフィルタリングします。指定できる値は50件までです。
triggered_procedure_ids list of strings or null オプション
これらのプロシージャのいずれかがトリガーされた会話をフィルタリングします。指定できる値は50件までです。
call_successful enum or null オプション
許可された値: success failure unknown error
call_start_before_unix integer or null オプション
この開始日時までの会話をフィルタリングするためのUnixタイムスタンプ(秒)。
call_start_after_unix integer or null オプション
この開始日時より後の会話をフィルタリングするためのUnixタイムスタンプ(秒)。
call_duration_min_secs integer or null オプション
call_duration_max_secs integer or null オプション
rating_max integer or null オプション 1-5
rating_min integer or null オプション 1-5
user_id string or null オプション
開始したユーザーのIDで会話をフィルタリングします。
evaluation_params list of strings or null オプション
評価フィルターです。繰り返し指定できるパラメータです。形式:criteria_id:result。resultにはsuccess|failure|unknownのいずれかを指定します。例:eval=value_framing:success
data_collection_params list 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_params list 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には数値が必要です。':'を含む名前は指定できません。
data_collection_ids list of strings or null オプション
各会話サマリーに含めるデータ収集フィールドID。繰り返し指定できるパラメータです。省略した場合、data_collection_resultsは返されません。
evaluation_criteria_ids list of strings or null オプション
各会話の概要に含める評価基準IDです。繰り返し指定できるパラメータです。省略した場合、evaluation_criteria_resultsは返されません。
main_languages list of strings or null オプション
検出された主要言語(言語コード)で会話をフィルタリングします。
page_size integer オプション 1-100デフォルト値 30
返す会話の最大数です。100を超えることはできず、デフォルトは30です。
summary_mode enum オプション デフォルト値 exclude
許可された値: exclude include
search string or null オプション Deprecated
文字起こしメッセージに対する全文検索またはあいまい検索
conversation_initiation_source enum or null オプション デフォルト値 unknown
text_only boolean or null オプション
conversation_product_type enum or null オプション
許可された値: agents speech_engine
branch_id string or null オプション
version_id string or null オプション
parent_conversation_id string or null オプション
サブエージェント会話の親会話IDで会話をフィルタリングします。
topic_ids list of strings or null オプション
トピック検出中に割り当てられたトピックIDで会話をフィルタリングします。
exclude_statuses list of enums or null オプション
指定したステータスの会話を除外します。進行中/処理中の会話をリストビューで非表示にする場合に便利です。
許可された値: initiated in-progress processing done failed
tag_ids list of strings or null オプション
conversation-tagsエンドポイントで割り当てられた会話タグIDで会話をフィルタリングします。
workflow_node_entered_id string or null オプション
指定されたノードに入った会話のみにフィルタリングします。
termination_reasons list of strings or null オプション
保存されているtermination_reason(metadata.termination_reason)で会話をフィルタリングします。複数のいずれかに一致させるには、パラメータを繰り返してください。
guardrail_types list of enums or null オプション
これらのタイプのガードレールのいずれかがトリガーされた会話(metadata.triggered_guardrails.guardrail_type)にフィルタリングします。複数のいずれかに一致させるには、パラメータを繰り返してください。
custom_guardrail_names list of strings or null オプション
これらの名前を持つカスタムガードレールのいずれかがトリガーされた会話(metadata.triggered_guardrails.guardrail_name)にフィルタリングします。名前を持つのはカスタムガードレールのみです。複数のいずれかに一致させるには、パラメータを繰り返してください。
sort_direction enum オプション
通話開始時刻で会話を並べ替える方向。デフォルトは降順(新しい順)です。
許可された値: asc desc
レスポンス
conversations list of objects
next_cursor string or null オプション