エージェント会話チケットを一覧表示

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

エージェントの会話トリアージチケットを一覧表示します。優先度で並べ替えない限り、作成日時の新しい順に表示されます。これらはエンドユーザー向けにエージェントが作成するチケットではなく、会話におけるエージェント自身のパフォーマンスに関するチケット（Architectでのトリアージ用）です。

パスパラメータ

agent_idstring必須

クエリパラメータ

page_sizeintegerオプション1-100デフォルト値 100

返すエージェント会話チケット数です。100を超えることはできません。

conversation_idstringオプション

会話IDでチケットをフィルタリングします。

statusenumオプション

ステータスでチケットをフィルタリングします。

許可された値:

sourcesenumオプション

起票方法（qa、agent、manual）でチケットをフィルタリングします。複数の作成元でフィルタリングするには、パラメータを繰り返してください。

許可された値:

prioritiesenumオプション

優先度でチケットをフィルタリングします。複数の優先度でフィルタリングするには、このパラメータを繰り返し指定します。

許可された値:

sort_byenumオプション

作成日時の新しい順、または優先度順（最も緊急なものを先頭とし、次に作成日時の新しい順）で並べ替えます。

許可された値:

owner_user_idstringオプション

作成者でチケットをフィルタリングします。エージェントが作成したチケットには’agent’を使用してください。

assignee_user_idstringオプション

担当者でチケットをフィルタリングします。担当者がいないチケットには’unassigned’を使用してください。

issue_typeenumオプション

問題タイプでクラスターをフィルタリングします。

labelstringオプション

完全一致するラベルでチケットをフィルタリングします。

merged_into_ticket_idstringオプション

このチケットに統合されたチケットをフィルタリングします。

searchstringオプション<=200 characters

チケットのタイトル、説明、コメント、ターンコメントを対象に、大文字・小文字を区別しない全文検索を行います。

cursorstringオプション

次のページを取得するために使用します。カーソルはレスポンスで返されます。

レスポンス

成功レスポンス。

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringオプション

エラー

422

Triage Tickets List Request Unprocessable Entity Error

パスパラメータ

ヘッダー

クエリパラメータ

レスポンス

エラー