> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 피드백 집계

> 유형 지정 Scorer 피드백(tags, 평점)을 시간 버킷별로 집계합니다.



## OpenAPI

````yaml /ko/weave/reference/service-api/openapi.json post /feedback/aggregate
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /feedback/aggregate:
    post:
      tags:
        - Feedback
      summary: 피드백 집계
      description: 유형 지정 Scorer 피드백(tags, 평점)을 시간 버킷별로 집계합니다.
      operationId: feedback_aggregate_feedback_aggregate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackAggregateReq'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackAggregateRes'
          description: 성공 응답
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: 검증 오류
components:
  schemas:
    FeedbackAggregateReq:
      additionalProperties: false
      description: 시간 버킷 및 차원별 집계 점수에 대한 쿼리입니다.
      properties:
        after_ms:
          description: created_at의 포함 하한입니다(에포크 이후 밀리초).
          minimum: 0
          title: After Ms
          type: integer
        before_ms:
          description: created_at의 제외 상한입니다(에포크 이후 밀리초).
          minimum: 0
          title: Before Ms
          type: integer
        feedback_types:
          description: feedback_type을 접두사 기준으로 필터링
          items:
            type: string
          title: Feedback Types
          type: array
        group_by:
          description: >-
            허용값: ['scorer_id', 'span_agent_name', 'span_agent_version',
            'span_status_code'].
          items:
            enum:
              - scorer_id
              - span_agent_name
              - span_agent_version
              - span_status_code
            type: string
          title: Group By
          type: array
        monitor_ids:
          description: 이 monitor ids로 필터링합니다(정확히 일치, 접두사 일치는 접미사 '*' 사용).
          items:
            type: string
          title: Monitor Ids
          type: array
        project_id:
          examples:
            - entity/project
          title: Project Id
          type: string
        rating_max:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          description: 평점이 이 값 이하인 행만 포함
          title: Rating Max
        rating_min:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          description: 평점이 이 값 이상인 행만 포함
          title: Rating Min
        scorer_ids:
          description: 이 scorer ids로 필터링합니다(정확히 일치, 접두사 일치는 접미사 '*' 사용).
          items:
            type: string
          title: Scorer Ids
          type: array
        span_agent_names:
          description: span_agent_name이 다음 값 중 하나와 정확히 일치하는 피드백으로 필터링합니다.
          items:
            type: string
          title: Span Agent Names
          type: array
        span_types:
          description: span 유형(turn 또는 conversation)으로 필터링합니다.
          items:
            enum:
              - agent_turn
              - agent_conversation
            type: string
          title: Span Types
          type: array
        tags:
          description: 지정된 tags 중 하나라도 포함하는 피드백으로 필터링
          items:
            type: string
          title: Tags
          type: array
        time_bucket_seconds:
          anyOf:
            - exclusiveMinimum: 0
              type: integer
            - type: 'null'
          description: '시간 버킷 크기(초)입니다. 예: 1시간 버킷의 경우 3600'
          title: Time Bucket Seconds
      required:
        - project_id
        - after_ms
        - before_ms
      title: FeedbackAggregateReq
      type: object
    FeedbackAggregateRes:
      description: 집계된 Scorer 피드백의 희소 시계열입니다(빈 버킷은 생략됨).
      properties:
        after_ms:
          description: 확정된 포함 하한으로, Unix 에포크 밀리초(UTC)입니다.
          title: After Ms
          type: integer
        before_ms:
          description: 확정된 제외 상한으로, Unix 에포크 밀리초(UTC)입니다.
          title: Before Ms
          type: integer
        buckets:
          items:
            $ref: '#/components/schemas/FeedbackAggregateBucket'
          title: Buckets
          type: array
        time_bucket_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          description: 사용된 시간 버킷 크기(초)입니다. 버킷이 없으면 None입니다.
          title: Time Bucket Seconds
      required:
        - after_ms
        - before_ms
      title: FeedbackAggregateRes
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    FeedbackAggregateBucket:
      description: 집계된 Scorer 피드백의 (time bucket, group) 행 하나입니다.
      properties:
        group:
          additionalProperties:
            type: string
          description: '이 행의 group-by 차원 값입니다(예: {''scorer_id'': ''...''}).'
          title: Group
          type: object
        rating_counts:
          additionalProperties:
            type: integer
          description: '각 평점 키를 포함하는 행 수입니다(예: ''_rating_'').'
          title: Rating Counts
          type: object
        rating_sums:
          additionalProperties:
            type: number
          description: 각 평점 키 값의 합계입니다. 평균은 클라이언트가 avg = sum/count로 계산합니다.
          title: Rating Sums
          type: object
        scored_count:
          description: >-
            점수를 생성한 행입니다(최소 하나의 tag 또는 평점). 아무 점수도 생성하지 않은 agent-monitor 행은
            제외됩니다. 점수 볼륨에는 이 값을 사용하세요.
          title: Scored Count
          type: integer
        tag_counts:
          additionalProperties:
            type: integer
          description: 각 Scorer tag의 개수입니다.
          title: Tag Counts
          type: object
        time_bucket_start_ms:
          anyOf:
            - type: integer
            - type: 'null'
          description: 시간 버킷 시작 시각으로, Unix 에포크 밀리초(UTC)입니다. 버킷이 없으면 None입니다.
          title: Time Bucket Start Ms
        total_count:
          description: 이 버킷/group의 피드백 행 수입니다.
          title: Total Count
          type: integer
      required:
        - total_count
        - scored_count
      title: FeedbackAggregateBucket
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````