에이전트 대화 티켓 목록

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

경로 매개변수

헤더

쿼리 매개변수

응답

오류