Agent-Konversationstickets auflisten

GET

/v1/convai/agents/:agent_id/triage-tickets

GET

/v1/convai/agents/:agent_id/triage-tickets

curl https://api.elevenlabs.io/v1/convai/agents/agent_id/triage-tickets

{
  "agent_conversation_tickets": [
    {
      "agentqa_ticket_id": "string",
      "workspace_id": "string",
      "owner_user_id": "string",
      "agent_id": "string",
      "needs_clustering": true,
      "title": "string",
      "issue_type": "knowledge_gap",
      "labels": [
        "string"
      ],
      "conversation_ids": [
        "string"
      ],
      "first_seen_unix_secs": 1,
      "last_seen_unix_secs": 1,
      "qa_comment": "string",
      "ticket_comments": [
        {
          "comment": "string",
          "created_at_unix_secs": 1,
          "owner_user_id": "string"
        }
      ],
      "turn_comments": [
        {
          "turn_index": 1,
          "comment": "string",
          "created_at_unix_secs": 1,
          "owner_user_id": "string"
        }
      ],
      "status": "open",
      "priority": "low",
      "priority_changes": [
        {
          "priority": "low",
          "changed_by_user_id": "string",
          "changed_at_unix_secs": 1
        }
      ],
      "status_changes": [
        {
          "status": "open",
          "changed_by_user_id": "string",
          "changed_at_unix_secs": 1
        }
      ],
      "source": "qa",
      "assignee_user_id": "string",
      "created_at_unix_secs": 1,
      "updated_at_unix_secs": 1,
      "merged_into_ticket_id": "string",
      "search_match": {
        "field": "title",
        "snippet": "string",
        "highlight_start": 1,
        "highlight_end": 1,
        "turn_index": 1
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Listet die Triage-Tickets für Unterhaltungen eines Agenten auf, standardmäßig nach Erstellungszeitpunkt absteigend, sofern nicht nach Priorität sortiert wird. Diese Tickets betreffen die Leistung des Agenten in einer Unterhaltung (zur Triage mit Architect), nicht Tickets, die ein Agent für Endnutzer eröffnet.

Pfadparameter

agent_idstringErforderlich

Abfrageparameter

page_sizeintegerOptional1-100Standardwert ist 100

Wie viele Agent-Unterhaltungstickets zurückgegeben werden sollen. Darf 100 nicht überschreiten.

conversation_idstring or nullOptional

Tickets nach conversation id filtern.

statusenum or nullOptional

Tickets nach Status filtern.

Erlaubte Werte:

sourceslist of enums or nullOptional

Tickets danach filtern, wie sie erstellt wurden (qa, agent, manual). Wiederholen Sie den Parameter, um nach mehreren Quellen zu filtern.

Erlaubte Werte:

prioritieslist of enums or nullOptional

Filtert Tickets nach Priorität. Wiederholen Sie den Parameter, um nach mehreren Prioritäten zu filtern.

Erlaubte Werte:

sort_byenumOptional

Sortiert nach Erstellungszeitpunkt absteigend oder nach Priorität (dringendste zuerst, dann zuletzt erstellte).

Erlaubte Werte:

owner_user_idstring or nullOptional

Tickets nach Ersteller filtern. Verwenden Sie ‘agent’ für von Agenten erstellte Tickets.

assignee_user_idstring or nullOptional

Tickets nach Bearbeiter filtern. Verwenden Sie ‘unassigned’ für Tickets ohne Bearbeiter.

issue_typeenum or nullOptional

Cluster nach Problemtyp filtern.

labelstring or nullOptional

Tickets nach einem exakten Label filtern.

merged_into_ticket_idstring or nullOptional

Filtert Tickets, die in dieses Ticket zusammengeführt wurden.

searchstring or nullOptional<=200 characters

Suche nach Freitext ohne Beachtung der Groß- und Kleinschreibung in Titel, Beschreibung, Kommentaren und Turn-Kommentaren des Tickets.

cursorstring or nullOptional

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

Antwort

Erfolgreiche Antwort

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstring or nullOptional

Fehler

422

Unprocessable Entity Error

Pfadparameter

Header

Abfrageparameter

Antwort

Fehler