エージェント会話チケットを作成

POST

/v1/convai/triage-tickets

POST

/v1/convai/triage-tickets

curl -X POST https://api.elevenlabs.io/v1/convai/triage-tickets \
     -H "Content-Type: application/json" \
     -d '{
  "conversation_id": "conversation_id"
}'

{
  "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": "owner_user_id"
    }
  ],
  "turn_comments": [
    {
      "turn_index": 1,
      "comment": "comment",
      "created_at_unix_secs": 1,
      "owner_user_id": "owner_user_id"
    }
  ],
  "status": "open",
  "priority_changes": [
    {
      "changed_by_user_id": "changed_by_user_id",
      "changed_at_unix_secs": 1,
      "priority": "low"
    }
  ],
  "status_changes": [
    {
      "status": "open",
      "changed_at_unix_secs": 1,
      "changed_by_user_id": "changed_by_user_id"
    }
  ],
  "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,
    "turn_index": 1
  }
}

Architectでトリアージするため、会話におけるエージェントのパフォーマンスに関するチケットを作成します。問題の内容を説明する全体コメントおよび／またはターンレベルのコメントを指定してください。

リクエスト

This endpoint expects an object.

conversation_idstring必須

このチケットに関する会話。

titlestringオプション1-120 characters

トリアージリストに表示される1行見出しです。デフォルトではコメントから生成され、生成できない場合は会話の要約タイトルが使用されます。会話のオープンチケットにコメントを追加する場合は無視されます。

qa_commentstringオプション1-10000 characters

このチケットの対象となる問題。単一のターンではなく、会話全体を対象にします。

turn_commentslist of objectsオプション

問題が発生した箇所に関する任意のターン単位のコメント。

priorityenumオプション

チケットにどの程度緊急の対応が必要かを示します。会話にすでにオープンチケットがある場合、その優先度がこれより低ければ、この優先度に引き上げられます。

許可された値:

レスポンス

成功レスポンス。

agentqa_ticket_idstring

workspace_idstring

owner_user_idstring

agent_idstring

needs_clusteringboolean

labelslist of strings

conversation_idslist of strings

ticket_commentslist of objects

turn_commentslist of objects

statusenum

許可された値:

priority_changeslist of objects

status_changeslist of objects

sourceenum

許可された値:

created_at_unix_secsinteger

updated_at_unix_secsinteger

titlestringオプション

チケットの1行見出しです。Noneになるのは、タイトル機能が導入される前に作成されたチケットのみです。

issue_typeenumオプション

first_seen_unix_secsintegerオプション

last_seen_unix_secsintegerオプション

qa_commentstringオプション

priorityenumオプション

許可された値:

merged_into_ticket_idstringオプション

このチケットが統合された先のチケットです。ステータスが「merged」の間に設定されます。

assignee_user_idstringオプション

search_matchobjectオプション

リストのsearchクエリが一致した場所です。検索されたリストでのみ設定されます。

エラー

422

Triage Tickets Create Request Unprocessable Entity Error

ヘッダー

リクエスト

レスポンス

エラー