Pobierz tematy rozmów agenta

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

Zwraca wyniki najnowszego uruchomienia wykrywania tematów dla danego agenta.

Parametry ścieżki

agent_idstringWymagany

ID agenta

Parametry zapytania

page_sizeinteger or nullOpcjonalny1-100

Liczba grup tematów najwyższego poziomu do zwrócenia.

sort_byenumOpcjonalny

Kolumna do rankingu tematów. Użyj conversations dla liczby rozmów, sentiment z sort_direction=asc dla najbardziej negatywnych tematów oraz frustration z sort_direction=desc dla tematów wywołujących największą frustrację. Tematy bez oceny zawsze trafiają na koniec rankingu.

Dozwolone wartości:

sort_directionenumOpcjonalny

Kierunek sortowania tematów.

Dozwolone wartości:

from_unix_secsinteger or nullOpcjonalny

Początek przedziału wyświetlania tematów. W połączeniu z to_unix_secs ukończone dzienne wykonania wykrywania tematów z tego zakresu są agregowane, więc przedział określa metryki i zestaw tematów. Wartość jest zaokrąglana w dół do początku dnia UTC, ponieważ wykonania obejmują całe dni UTC; aggregated_run_count podaje liczbę zsumowanych wykonań. Pomiń obie granice, aby pobrać jedno najnowsze wykonanie.

to_unix_secsinteger or nullOpcjonalny

Koniec przedziału czasu, dla którego wyświetlane są tematy.

include_evaluation_criteriabooleanOpcjonalnyDomyślnie true

Uwzględnia podział oceny według kryteriów w metrykach każdego tematu. Przekaż false, aby go pominąć: stanowi większość danych, a ważony success_rate jest zwracany w obu przypadkach.

cursorstring or nullOpcjonalny

Służy do pobrania następnej strony. Kursor jest zwracany w odpowiedzi.

Odpowiedź

Pomyślna odpowiedź

topicslist of objects

window_start_unix_secsinteger

window_end_unix_secsinteger

aggregated_run_countintegerOpcjonalnyDomyślnie 0

Liczba dziennych uruchomień wykrywania tematów, dla których zsumowano zwrócone metryki.

has_morebooleanOpcjonalnyDomyślnie false

next_cursorstring or nullOpcjonalny

Błędy

422

Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Parametry zapytania

Odpowiedź

Błędy