Agent-Konversationsthemen abrufen

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

Gibt die Ergebnisse der neuesten Themenfindung für einen bestimmten Agenten zurück.

Pfadparameter

agent_idstringErforderlich

ID des Agenten

Abfrageparameter

page_sizeinteger or nullOptional1-100

Anzahl der zurückzugebenden Themengruppen der obersten Ebene.

sort_byenumOptional

Spalte für die Rangfolge von Themen. Verwenden Sie conversations für das Volumen, sentiment mit sort_direction=asc für die negativsten Themen und frustration mit sort_direction=desc für die frustriertesten. Themen ohne Wert werden immer zuletzt eingeordnet.

Erlaubte Werte:

sort_directionenumOptional

Sortierrichtung für Themen.

Erlaubte Werte:

from_unix_secsinteger or nullOptional

Beginn des Zeitfensters für die Themenanzeige. Zusammen mit to_unix_secs werden die abgeschlossenen täglichen Topic-Discovery-Durchläufe im Bereich aggregiert. Das Fenster begrenzt somit die Metriken und die Themenmenge. Der Wert wird auf den Beginn des UTC-Tags abgerundet, da Durchläufe ganze UTC-Tage abdecken; aggregated_run_count gibt an, wie viele Durchläufe summiert wurden. Lassen Sie beide Grenzen weg, um den einzelnen neuesten Durchlauf abzurufen.

to_unix_secsinteger or nullOptional

Ende des Zeitfensters zur Anzeige von Themen.

include_evaluation_criteriabooleanOptionalStandardwert ist true

Nehmen Sie die Aufschlüsselung der Bewertung nach Kriterien in die Metriken jedes Themas auf. Übergeben Sie false, um sie wegzulassen: Sie macht den Großteil der Nutzlast aus, und die gewichtete success_rate wird in jedem Fall zurückgegeben.

cursorstring or nullOptional

Wird zum Abrufen der nächsten Seite verwendet. Der Cursor wird in der Antwort zurückgegeben.

Antwort

Erfolgreiche Antwort

topicslist of objects

window_start_unix_secsinteger

window_end_unix_secsinteger

aggregated_run_countintegerOptionalStandardwert ist 0

Anzahl der täglichen Durchläufe zur Themenermittlung, über die die zurückgegebenen Metriken summiert wurden.

has_morebooleanOptionalStandardwert ist false

next_cursorstring or nullOptional

Fehler

422

Unprocessable Entity Error

Pfadparameter

Header

Abfrageparameter

Antwort

Fehler