Agent-Konversationstickets auflisten

GET

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

GET

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

curl -G https://api.elevenlabs.io/v1/convai/agents/agent_id/triage-tickets \
     -d assignee_user_id=assignee_user_id \
     -d conversation_id=conversation_id \
     -d cursor=cursor \
     -d issue_type=knowledge_gap \
     -d label=label \
     -d merged_into_ticket_id=merged_into_ticket_id \
     -d owner_user_id=owner_user_id \
     -d page_size=1 \
     -d priorities=low \
     -d search=search \
     -d sort_by=created_at \
     -d sources=qa \
     -d status=open

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

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_idstringOptional

Tickets nach conversation id filtern.

statusenumOptional

Tickets nach Status filtern.

Erlaubte Werte:

sourcesenumOptional

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

Erlaubte Werte:

prioritiesenumOptional

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_idstringOptional

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

assignee_user_idstringOptional

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

issue_typeenumOptional

Cluster nach Problemtyp filtern.

labelstringOptional

Tickets nach einem exakten Label filtern.

merged_into_ticket_idstringOptional

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

searchstringOptional<=200 characters

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

cursorstringOptional

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_cursorstringOptional

Fehler

422

Triage Tickets List Request Unprocessable Entity Error

Pfadparameter

Header

Abfrageparameter

Antwort

Fehler