Passer au contenu principal
POST
/
feedback
/
aggregate
Agrégat de feedback
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
}

Corps

application/json

Requête pour agréger les scores par intervalle de temps et dimension.

after_ms
integer
requis

Borne inférieure incluse sur created_at (millisecondes depuis l’époque Unix).

Plage requise: x >= 0
before_ms
integer
requis

Borne supérieure exclue sur created_at (millisecondes depuis l’époque Unix).

Plage requise: x >= 0
project_id
string
requis
Exemple:

"entity/project"

feedback_types
string[]

Filtre sur feedback_type par préfixe

group_by
enum<string>[]

Valeurs autorisées : ['scorer_id', 'span_agent_name', 'span_agent_version', 'span_status_code'].

Options disponibles:
scorer_id,
span_agent_name,
span_agent_version,
span_status_code
monitor_ids
string[]

Filtre sur ces ID de monitor (correspondance exacte ; ajoutez '*' en suffixe pour une correspondance par préfixe).

rating_max
number | null

Inclure uniquement les lignes avec un score <= à cette valeur

Plage requise: 0 <= x <= 1
rating_min
number | null

Inclure uniquement les lignes avec un score >= à cette valeur

Plage requise: 0 <= x <= 1
scorer_ids
string[]

Filtre sur ces ID de scorer (correspondance exacte ; ajoutez '*' en suffixe pour une correspondance par préfixe).

span_agent_names
string[]

Filtre sur les feedbacks dont span_agent_name correspond à l’une de ces valeurs (exact).

span_types
enum<string>[]

Filtre par type de span (tour de conversation ou conversation).

Options disponibles:
agent_turn,
agent_conversation
tags
string[]

Filtre sur les feedbacks incluant l’un des tags indiqués

time_bucket_seconds
integer | null

Taille de l’intervalle de temps en secondes, par ex. 3600 pour des intervalles d’1 h

Plage requise: x > 0

Réponse

Réponse réussie

Série temporelle clairsemée de feedback agrégé du scorer (intervalles vides omis).

after_ms
integer
requis

Borne inférieure incluse résolue, époque Unix en ms (UTC).

before_ms
integer
requis

Borne supérieure exclue résolue, époque Unix en ms (UTC).

buckets
FeedbackAggregateBucket · object[]
time_bucket_seconds
integer | null

Taille de l’intervalle de temps utilisée (secondes). None en l’absence d’intervalles.