メインコンテンツへスキップ
POST
/
feedback
/
aggregate
フィードバック集計
curl --request POST \
  --url https://api.example.com/feedback/aggregate \
  --header 'Content-Type: application/json' \
  --data '
{
  "after_ms": 1,
  "before_ms": 1,
  "project_id": "<string>",
  "feedback_types": [
    "<string>"
  ],
  "group_by": [],
  "monitor_ids": [
    "<string>"
  ],
  "rating_max": 0.5,
  "rating_min": 0.5,
  "scorer_ids": [
    "<string>"
  ],
  "span_agent_names": [
    "<string>"
  ],
  "span_types": [],
  "tags": [
    "<string>"
  ],
  "time_bucket_seconds": 1
}
'
{
  "after_ms": 123,
  "before_ms": 123,
  "buckets": [
    {
      "scored_count": 123,
      "total_count": 123,
      "group": {},
      "rating_counts": {},
      "rating_sums": {},
      "tag_counts": {},
      "time_bucket_start_ms": 123
    }
  ],
  "time_bucket_seconds": 123
}

ボディ

application/json

時間バケットおよびディメンションごとの集計スコアをクエリするためのクエリです。

after_ms
integer
必須

created_at の下限(この値を含む、エポックからのミリ秒)。

必須範囲: x >= 0
before_ms
integer
必須

created_at の上限(この値を含まない、エポックからのミリ秒)。

必須範囲: x >= 0
project_id
string
必須
:

"entity/project"

feedback_types
string[]

feedback_type を接頭辞でフィルターします

group_by
enum<string>[]

使用可能な値: ['scorer_id', 'span_agent_name', 'span_agent_version', 'span_status_code']。

利用可能なオプション:
scorer_id,
span_agent_name,
span_agent_version,
span_status_code
monitor_ids
string[]

これらの monitor id でフィルターします(完全一致。接頭辞一致にするには末尾に '*' を付けます)。

rating_max
number | null

rating がこの値以下の行のみを含めます

必須範囲: 0 <= x <= 1
rating_min
number | null

rating がこの値以上の行のみを含めます

必須範囲: 0 <= x <= 1
scorer_ids
string[]

これらの scorer id でフィルターします(完全一致。接頭辞一致にするには末尾に '*' を付けます)。

span_agent_names
string[]

span_agent_name がこれらのいずれかに一致するフィードバックにフィルターします(完全一致)。

span_types
enum<string>[]

span のタイプでフィルターします(turn または conversation)。

利用可能なオプション:
agent_turn,
agent_conversation
tags
string[]

指定されたタグのいずれかを含むフィードバックにフィルターします

time_bucket_seconds
integer | null

時間バケットのサイズ(秒)です。たとえば 1 時間バケットの場合は 3600 です

必須範囲: x > 0

レスポンス

正常なレスポンス

集計された Scorer フィードバックの疎な時系列です(空のバケットは省略されます)。

after_ms
integer
必須

解決後の下限(この値を含む、Unix エポックミリ秒、UTC)。

before_ms
integer
必須

解決後の上限(この値を含まない、Unix エポックミリ秒、UTC)。

buckets
FeedbackAggregateBucket · object[]
time_bucket_seconds
integer | null

使用された時間バケットのサイズ(秒)です。バケット化されていない場合は None です。