文本搜索对话消息

通过全文和模糊搜索查找对话转录消息

请求头

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

每页结果数量。最大为 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