Wyświetl zgłoszenia rozmów agenta

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

Wyświetl zgłoszenia triage rozmów agenta, domyślnie od najnowszych, chyba że są sortowane według priorytetu. To zgłoszenia dotyczące działania agenta w rozmowie (do triage z Architect), a nie zgłoszenia otwierane przez agenta dla użytkowników końcowych.

Parametry ścieżki

agent_idstringWymagany

Parametry zapytania

page_sizeintegerOpcjonalny1-100Domyślnie 100

Ile zgłoszeń rozmów agenta zwrócić. Maksymalnie 100.

conversation_idstringOpcjonalny

Filtruj zgłoszenia według ID rozmowy.

statusenumOpcjonalny

Filtruj zgłoszenia według statusu.

Dozwolone wartości:

sourcesenumOpcjonalny

Filtruj zgłoszenia według sposobu utworzenia (qa, agent, manual). Powtórz parametr, aby filtrować według kilku źródeł.

Dozwolone wartości:

prioritiesenumOpcjonalny

Filtruj zgłoszenia według priorytetu. Powtórz parametr, aby filtrować według wielu priorytetów.

Dozwolone wartości:

sort_byenumOpcjonalny

Order by most recently created, by priority (most urgent first, then most recently created), or by most recently reported (the newest report merged into the issue, else its creation).

Dozwolone wartości:

owner_user_idstringOpcjonalny

Filtruj zgłoszenia według twórcy. Użyj „agent” dla zgłoszeń utworzonych przez agenta.

assignee_user_idstringOpcjonalny

Filtruj zgłoszenia według przypisanej osoby. Użyj „unassigned” dla zgłoszeń bez przypisanej osoby.

issue_typeenumOpcjonalny

Filtruj klastry według typu problemu.

labelstringOpcjonalny

Filtruj zgłoszenia według dokładnej etykiety.

merged_into_ticket_idstringOpcjonalny

Filtruj zgłoszenia scalone z tym zgłoszeniem.

searchstringOpcjonalny<=200 characters

Wyszukiwanie pełnotekstowe bez rozróżniania wielkości liter w tytule, opisie, komentarzach i komentarzach do tur zgłoszenia.

cursorstringOpcjonalny

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

Odpowiedź

Pomyślna odpowiedź

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOpcjonalny

Błędy

422

Triage Tickets List Request Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Parametry zapytania

Odpowiedź

Błędy