에이전트 대화 주제 가져오기

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선택 사항

주제 순위를 매길 열입니다. 볼륨에는 conversations를 사용하고, 가장 부정적인 주제에는 sort_direction=asc와 함께 sentiment를 사용하며, 가장 불만이 큰 주제에는 sort_direction=desc와 함께 frustration을 사용하세요. 점수가 없는 주제는 항상 마지막 순위가 됩니다.

허용된 값:

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

경로 매개변수

헤더

쿼리 매개변수

응답

오류