获取智能体会话主题

GET

/v1/convai/agents/:agent_id/topics

GET

/v1/convai/agents/:agent_id/topics

curl https://api.elevenlabs.io/v1/convai/agents/agent_id/topics

{
  "topics": [
    {
      "topic_id": "string",
      "label": "string",
      "description": "string",
      "conversation_count": 1,
      "parent_topic_id": "string",
      "x_2d": 1.1,
      "y_2d": 1.1,
      "metrics": {
        "conversation_count": 0,
        "sentiment": {
          "sentiment": {
            "count": 0,
            "sum": 0,
            "min": 1.1,
            "max": 1.1
          },
          "frustration": {
            "count": 0,
            "sum": 0,
            "min": 1.1,
            "max": 1.1
          },
          "positive_count": 0,
          "neutral_count": 0,
          "negative_count": 0
        },
        "evaluation_criteria": [
          {
            "criteria_id": "string",
            "success_count": 0,
            "failure_count": 0,
            "unknown_count": 0
          }
        ]
      },
      "success_rate": 1.1
    }
  ],
  "window_start_unix_secs": 1,
  "window_end_unix_secs": 1,
  "aggregated_run_count": 0,
  "has_more": false,
  "next_cursor": "string"
}

返回指定智能体最新的话题发现运行结果。

路径参数

agent_idstring必需

智能体 ID

查询参数

page_sizeinteger or null可选1-100

要返回的顶级主题组数量。

sort_byenum可选

Column to rank topics by. Use conversations for volume, sentiment with sort_direction=asc for the most negative topics, and frustration with sort_direction=desc for the most frustrated ones. Topics with no score are always ranked last.

允许的值:

sort_directionenum可选

主题排序方向。

允许的值:

from_unix_secsinteger or null可选

查看主题的时间窗口起点。与 to_unix_secs 一同设置时，范围内已完成的每日主题发现运行会汇总，因此该窗口同时限定指标和主题集。由于运行覆盖完整 UTC 日，会向下取整至对应 UTC 日的开始时间；aggregated_run_count 表示汇总的运行数量。省略两个边界可获取单个最新运行。

to_unix_secsinteger or null可选

查看主题的时间窗口结束时间。

include_evaluation_criteriaboolean可选默认为 true

在每个主题的指标中包含按条件划分的评估明细。传入 false 可移除该明细：它会占据大部分负载，但无论是否包含都会返回加权 success_rate。

cursorstring or null可选

用于获取下一页。响应中会返回游标。

响应

成功响应

topicslist of objects

window_start_unix_secsinteger

window_end_unix_secsinteger

aggregated_run_countinteger可选默认为 0

返回指标汇总涵盖的每日主题发现运行次数。

has_moreboolean可选默认为 false

next_cursorstring or null可选

错误

422

Unprocessable Entity Error

路径参数

请求头

查询参数

响应

错误