Passer au contenu principal
POST
/
trace
/
usage
Utilisation de la trace
curl --request POST \
  --url https://api.example.com/trace/usage \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "filter": {
    "op_names": [
      "<string>"
    ],
    "input_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "parent_ids": [
      "<string>"
    ],
    "trace_ids": [
      "<string>"
    ],
    "call_ids": [
      "<string>"
    ],
    "thread_ids": [
      "<string>"
    ],
    "turn_ids": [
      "<string>"
    ],
    "trace_roots_only": true,
    "wb_user_ids": [
      "<string>"
    ],
    "wb_run_ids": [
      "<string>"
    ]
  },
  "query": {
    "$expr": {
      "$and": [
        {
          "$literal": "<string>"
        }
      ]
    }
  },
  "include_costs": false,
  "limit": 10000
}
'
{
  "call_usage": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

Autorisations

​
Authorization
string
header
requis

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Corps

application/json

Requête visant à calculer l’Utilisation par appel pour une trace, avec cumul des descendants.

Cet Endpoint renvoie des métriques d’Utilisation pour chaque appel de la trace, où les métriques de chaque appel incluent la somme de sa propre Utilisation et de celle de tous ses descendants. Utilisez-le pour la Vue de trace lorsque vous souhaitez afficher des métriques cumulées par appel.

Remarque : tous les appels correspondants sont chargés en Mémoire pour l’agrégation. Pour des ensembles de résultats très volumineux (>10k appels), envisagez d’utiliser des filtres plus spécifiques ou une pagination au niveau de l’application.

​
project_id
string
requis
​
filter
CallsFilter · object

Filtre pour sélectionner les appels. Utilisez généralement trace_ids pour obtenir tous les appels d’une trace.

​
query
Query · object

Conditions de requête supplémentaires pour filtrer les appels.

​
include_costs
boolean
défaut:false

Si la valeur est true, inclure les calculs de coût dans l’Utilisation.

​
limit
integer
défaut:10000

Nombre maximal d’appels à traiter. Sert de limite de sécurité pour éviter une utilisation de la mémoire sans borne.

Réponse

Réponse réussie

Réponse contenant les métriques d’Utilisation par appel (chacune inclut les contributions des descendants).

​
call_usage
Call Usage · object
​
unfinished_call_ids
string[]