> ## 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.

# Agrégat de feedback

> Agréger le feedback typé du scorer (tags, scores) par intervalles de temps.



## OpenAPI

````yaml /fr/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: Agrégat de feedback
      description: >-
        Agréger le feedback typé du scorer (tags, scores) par intervalles de
        temps.
      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: Réponse réussie
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Erreur de validation
components:
  schemas:
    FeedbackAggregateReq:
      additionalProperties: false
      description: Requête pour agréger les scores par intervalle de temps et dimension.
      properties:
        after_ms:
          description: >-
            Borne inférieure incluse sur created_at (millisecondes depuis
            l’époque Unix).
          minimum: 0
          title: After Ms
          type: integer
        before_ms:
          description: >-
            Borne supérieure exclue sur created_at (millisecondes depuis
            l’époque Unix).
          minimum: 0
          title: Before Ms
          type: integer
        feedback_types:
          description: Filtre sur feedback_type par préfixe
          items:
            type: string
          title: Feedback Types
          type: array
        group_by:
          description: >-
            Valeurs autorisées : ['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: >-
            Filtre sur ces ID de monitor (correspondance exacte ; ajoutez '*' en
            suffixe pour une correspondance par préfixe).
          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: Inclure uniquement les lignes avec un score <= à cette valeur
          title: Rating Max
        rating_min:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          description: Inclure uniquement les lignes avec un score >= à cette valeur
          title: Rating Min
        scorer_ids:
          description: >-
            Filtre sur ces ID de scorer (correspondance exacte ; ajoutez '*' en
            suffixe pour une correspondance par préfixe).
          items:
            type: string
          title: Scorer Ids
          type: array
        span_agent_names:
          description: >-
            Filtre sur les feedbacks dont span_agent_name correspond à l’une de
            ces valeurs (exact).
          items:
            type: string
          title: Span Agent Names
          type: array
        span_types:
          description: Filtre par type de span (tour de conversation ou conversation).
          items:
            enum:
              - agent_turn
              - agent_conversation
            type: string
          title: Span Types
          type: array
        tags:
          description: Filtre sur les feedbacks incluant l’un des tags indiqués
          items:
            type: string
          title: Tags
          type: array
        time_bucket_seconds:
          anyOf:
            - exclusiveMinimum: 0
              type: integer
            - type: 'null'
          description: >-
            Taille de l’intervalle de temps en secondes, par ex. 3600 pour des
            intervalles d’1 h
          title: Time Bucket Seconds
      required:
        - project_id
        - after_ms
        - before_ms
      title: FeedbackAggregateReq
      type: object
    FeedbackAggregateRes:
      description: >-
        Série temporelle clairsemée de feedback agrégé du scorer (intervalles
        vides omis).
      properties:
        after_ms:
          description: Borne inférieure incluse résolue, époque Unix en ms (UTC).
          title: After Ms
          type: integer
        before_ms:
          description: Borne supérieure exclue résolue, époque Unix en ms (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: >-
            Taille de l’intervalle de temps utilisée (secondes). None en
            l’absence d’intervalles.
          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: Une ligne (intervalle de temps, groupe) de feedback agrégé du scorer.
      properties:
        group:
          additionalProperties:
            type: string
          description: >-
            Valeurs des dimensions de group-by pour cette ligne (par ex.
            {'scorer_id': '...'}).
          title: Group
          type: object
        rating_counts:
          additionalProperties:
            type: integer
          description: Nombre de lignes portant chaque clé de score (par ex. '_rating_').
          title: Rating Counts
          type: object
        rating_sums:
          additionalProperties:
            type: number
          description: >-
            Somme des valeurs de chaque clé de score ; le client calcule avg =
            sum/count.
          title: Rating Sums
          type: object
        scored_count:
          description: >-
            Lignes ayant émis un score (au moins un tag ou une note). Exclut les
            lignes d’agent-monitor qui n’ont émis aucun score — à utiliser pour
            le volume de scores.
          title: Scored Count
          type: integer
        tag_counts:
          additionalProperties:
            type: integer
          description: Nombre de chaque tag de scorer.
          title: Tag Counts
          type: object
        time_bucket_start_ms:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Début de l’intervalle de temps, époque Unix en ms (UTC). None en
            l’absence d’intervalles.
          title: Time Bucket Start Ms
        total_count:
          description: Nombre de lignes de feedback dans cet intervalle/groupe.
          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

````