Obtener temas de conversación del agente

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"
}

Devuelve los resultados de la ejecución más reciente de descubrimiento de temas para un agente determinado.

Parámetros de ruta

agent_idstringRequerido

ID del agente

Parámetros de consulta

page_sizeinteger or nullOpcional1-100

Número de grupos de temas de nivel superior que se devolverán.

sort_byenumOpcional

Columna por la que clasificar los temas. Usa conversations para el volumen, sentiment con sort_direction=asc para los temas más negativos y frustration con sort_direction=desc para los que causan más frustración. Los temas sin puntuación siempre se clasifican al final.

Valores permitidos:

sort_directionenumOpcional

Dirección para ordenar los temas.

Valores permitidos:

from_unix_secsinteger or nullOpcional

Inicio de la ventana para consultar temas. Cuando se establece junto con to_unix_secs, las ejecuciones diarias completadas de descubrimiento de temas dentro del intervalo se agregan, por lo que la ventana delimita tanto las métricas como el conjunto de temas. Se redondea al inicio de su día UTC porque las ejecuciones abarcan días UTC completos; aggregated_run_count indica cuántas ejecuciones se han sumado. Omite ambos límites para obtener la última ejecución individual.

to_unix_secsinteger or nullOpcional

Final del intervalo para consultar los temas.

include_evaluation_criteriabooleanOpcionalValor predeterminado: true

Incluye el desglose de evaluación por criterio en las métricas de cada tema. Pasa false para excluirlo: representa la mayor parte de la carga útil y el success_rate ponderado se devuelve en ambos casos.

cursorstring or nullOpcional

Se usa para obtener la página siguiente. El cursor se devuelve en la respuesta.

Respuesta

Respuesta correcta.

topicslist of objects

window_start_unix_secsinteger

window_end_unix_secsinteger

aggregated_run_countintegerOpcionalValor predeterminado: 0

Número de ejecuciones diarias de detección de temas sobre las que se han sumado las métricas devueltas.

has_morebooleanOpcionalValor predeterminado: false

next_cursorstring or nullOpcional

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Respuesta

Errores