会話を一覧表示

ユーザーが所有するエージェントのすべての会話を取得します。特定のエージェントに限定することもできます。

ヘッダー

xi-api-keystringオプション

クエリパラメータ

cursorstring or nullオプション

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

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には数値が必要です。':'を含む名前は指定できません。
data_collection_idslist of strings or nullオプション

各会話サマリーに含めるデータ収集フィールドID。繰り返し指定できるパラメータです。省略した場合、data_collection_resultsは返されません。

evaluation_criteria_idslist of strings or nullオプション

各会話の概要に含める評価基準IDです。繰り返し指定できるパラメータです。省略した場合、evaluation_criteria_resultsは返されません。

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オプション

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

page_sizeintegerオプション1-100デフォルト値 30

返す会話の最大数です。100を超えることはできず、デフォルトは30です。

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

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

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

文字起こしメッセージに対する全文検索またはあいまい検索

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で会話をフィルタリングします。

parent_conversation_idstring or nullオプション

サブエージェント会話の親会話IDで会話をフィルタリングします。

topic_idslist of strings or nullオプション

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

exclude_statuseslist of enums or nullオプション

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

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

conversation-tagsエンドポイントで割り当てられた会話タグIDで会話をフィルタリングします。

workflow_node_entered_idstring or nullオプション

指定されたノードに入った会話のみにフィルタリングします。

termination_reasonslist of strings or nullオプション

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

guardrail_typeslist of enums or nullオプション

これらのタイプのガードレールのいずれかがトリガーされた会話(metadata.triggered_guardrails.guardrail_type)にフィルタリングします。複数のいずれかに一致させるには、パラメータを繰り返してください。

custom_guardrail_nameslist of strings or nullオプション
これらの名前を持つカスタムガードレールのいずれかがトリガーされた会話(metadata.triggered_guardrails.guardrail_name)にフィルタリングします。名前を持つのはカスタムガードレールのみです。複数のいずれかに一致させるには、パラメータを繰り返してください。
sort_directionenumオプション

通話開始時刻で会話を並べ替える方向。デフォルトは降順(新しい順)です。

許可された値:

レスポンス

成功レスポンス。

conversationslist of objects
has_moreboolean
next_cursorstring or nullオプション

エラー

422
Unprocessable Entity Error