> ## 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. # Flux de requêtes d’appels ## OpenAPI ````yaml /fr/weave/reference/service-api/openapi.json post /calls/stream_query openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: [] security: [] paths: /calls/stream_query: post: tags: - Calls summary: Flux de requêtes d’appels operationId: calls_query_stream_calls_stream_query_post parameters: - in: header name: accept required: false schema: default: application/jsonl title: Accept type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/CallsQueryReq' required: true responses: '200': content: application/json: schema: {} description: Réponse réussie '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Erreur de validation security: - HTTPBasic: [] - HTTPBearer: [] components: schemas: CallsQueryReq: additionalProperties: false properties: columns: anyOf: - items: type: string type: array - type: 'null' title: Columns expand_columns: anyOf: - items: type: string type: array - type: 'null' description: Colonnes à développer, c.-à-d. les références à d’autres objets examples: - - inputs.self.message - inputs.model.prompt title: Expand Columns filter: anyOf: - $ref: '#/components/schemas/CallsFilter' - type: 'null' include_costs: anyOf: - type: boolean - type: 'null' default: false description: >- Bêta, susceptible d’être modifié. Si la valeur est true, la réponse inclura les éventuels coûts de modèle pour chaque appel. title: Include Costs include_feedback: anyOf: - type: boolean - type: 'null' default: false description: >- Bêta, susceptible d’évoluer. Si la valeur est true, la réponse inclura un feedback pour chaque appel. title: Include Feedback include_storage_size: anyOf: - type: boolean - type: 'null' default: false description: >- Bêta, susceptible d’évoluer. Si la valeur est true, la réponse inclura la taille de stockage d’un appel. title: Include Storage Size include_total_storage_size: anyOf: - type: boolean - type: 'null' default: false description: >- Bêta, susceptible d’évoluer. Si la valeur est true, la réponse inclura la taille totale de stockage d’une trace. title: Include Total Storage Size include_usernames: anyOf: - type: boolean - type: 'null' default: false description: >- Si true, la réponse tentera de résoudre le wb_user_id de chaque appel en nom d’utilisateur pendant la durée de cette requête. title: Include Usernames limit: anyOf: - type: integer - type: 'null' title: Limit offset: anyOf: - type: integer - type: 'null' title: Offset project_id: title: Project Id type: string query: anyOf: - $ref: '#/components/schemas/Query' - type: 'null' return_expanded_column_values: anyOf: - type: boolean - type: 'null' default: true description: >- Si la valeur est true, la réponse inclura les valeurs brutes des colonnes développées. Si la valeur est false, le champ response expand_columns sera utilisé uniquement pour le filtrage et le tri. Cela est utile pour les clients qui souhaitent résoudre eux-mêmes les références, par exemple pour des raisons de performances. title: Return Expanded Column Values sort_by: anyOf: - items: $ref: '#/components/schemas/SortBy' type: array - type: 'null' title: Sort By required: - project_id title: CallsQueryReq type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object CallsFilter: additionalProperties: false properties: call_ids: anyOf: - items: type: string type: array - type: 'null' title: Call Ids input_refs: anyOf: - items: type: string type: array - type: 'null' title: Input Refs op_names: anyOf: - items: type: string type: array - type: 'null' title: Op Names output_refs: anyOf: - items: type: string type: array - type: 'null' title: Output Refs parent_ids: anyOf: - items: type: string type: array - type: 'null' title: Parent Ids thread_ids: anyOf: - items: type: string type: array - type: 'null' title: Thread Ids trace_ids: anyOf: - items: type: string type: array - type: 'null' title: Trace Ids trace_roots_only: anyOf: - type: boolean - type: 'null' title: Trace Roots Only turn_ids: anyOf: - items: type: string type: array - type: 'null' title: Turn Ids wb_run_ids: anyOf: - items: type: string type: array - type: 'null' title: Wb Run Ids wb_user_ids: anyOf: - items: type: string type: array - type: 'null' title: Wb User Ids title: CallsFilter type: object Query: additionalProperties: false properties: $expr: anyOf: - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Expr required: - $expr title: Query type: object SortBy: additionalProperties: false properties: direction: enum: - asc - desc title: Direction type: string field: title: Field type: string required: - field - direction title: SortBy 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 AndOperation: description: |- ET logique. Toutes les conditions doivent être évaluées à true. Exemple : ``` { "$and": [ {"$eq": [{"$getField": "op_name"}, {"$literal": "predict"}]}, {"$gt": [{"$getField": "summary.usage.tokens"}, {"$literal": 1000}]} ] } ``` properties: $and: items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $And type: array required: - $and title: AndOperation type: object OrOperation: description: "OU logique. Au moins une condition doit être vraie.\n\nExemple\_:\n ```\n {\n \"$or\": [\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"a\"}]},\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"b\"}]}\n ]\n }\n ```" properties: $or: items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Or type: array required: - $or title: OrOperation type: object NotOperation: description: "NON logique. Inverse la condition.\n\nExemple\_:\n ```\n {\n \"$not\": [\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"debug\"}]}\n ]\n }\n ```" properties: $not: maxItems: 1 minItems: 1 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Not type: array required: - $not title: NotOperation type: object EqOperation: description: "Vérifie l'égalité entre deux opérandes.\n\nExemple\_:\n ```\n {\n \"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"predict\"}]\n }\n ```" properties: $eq: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Eq type: array required: - $eq title: EqOperation type: object GtOperation: description: "Comparaison «\_supérieur à\_».\n\nExemple\_:\n ```\n {\n \"$gt\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $gt: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Gt type: array required: - $gt title: GtOperation type: object LtOperation: description: "Comparaison «\_inférieur à\_».\n\nExemple\_:\n ```\n {\n \"$lt\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $lt: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Lt type: array required: - $lt title: LtOperation type: object GteOperation: description: "Comparaison «\_supérieur ou égal à\_».\n\nExemple\_:\n ```\n {\n \"$gte\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $gte: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Gte type: array required: - $gte title: GteOperation type: object LteOperation: description: "Comparaison inférieure ou égale.\n\nExemple\_:\n ```\n {\n \"$lte\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $lte: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Lte type: array required: - $lte title: LteOperation type: object InOperation: description: "Vérification d'appartenance.\n\nRenvoie true si l'opérande de gauche figure dans la liste fournie comme second opérande.\n\nExemple\_:\n ```\n {\n \"$in\": [\n {\"$getField\": \"op_name\"},\n [{\"$literal\": \"predict\"}, {\"$literal\": \"generate\"}]\n ]\n }\n ```" properties: $in: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' type: array title: $In type: array required: - $in title: InOperation type: object ContainsOperation: description: "Correspondance de sous-chaîne insensible à la casse.\n\nNe fait pas partie de MongoDB. Ajout spécifique à Weave.\n\nExemple\_:\n ```\n {\n \"$contains\": {\n \"input\": {\"$getField\": \"display_name\"},\n \"substr\": {\"$literal\": \"llm\"},\n \"case_insensitive\": true\n }\n }\n ```" properties: $contains: $ref: '#/components/schemas/ContainsSpec' required: - $contains title: ContainsOperation type: object LiteralOperation: description: "Représente une valeur constante dans le langage de requête.\n\nIl peut s'agir de n'importe quelle valeur standard sérialisable en JSON.\n\nExemple\_:\n ```\n {\"$literal\": \"predict\"}\n ```" properties: $literal: anyOf: - type: string - type: integer - type: number - type: boolean - additionalProperties: $ref: '#/components/schemas/LiteralOperation' type: object - items: $ref: '#/components/schemas/LiteralOperation' type: array - type: 'null' title: $Literal required: - $literal title: LiteralOperation type: object GetFieldOperator: description: "Accède à un champ de l'appel tracé.\n\nPrend en charge la notation par points pour l'accès aux champs imbriqués, par ex. `summary.usage.tokens`.\n\nFonctionne uniquement avec les champs présents dans `CallSchema`, notamment\_:\n- Les champs de premier niveau comme `op_name`, `trace_id`, `started_at`\n- Les champs imbriqués comme `inputs.input_name`, `summary.usage.tokens`, etc.\n\nExemple\_:\n ```\n {\"$getField\": \"op_name\"}\n ```" properties: $getField: title: $Getfield type: string required: - $getField title: GetFieldOperator type: object ConvertOperation: description: "Convertit la valeur d'entrée dans un type spécifique (par ex. `int`, `bool`, `string`).\n\nExemple\_:\n ```\n {\n \"$convert\": {\n \"input\": {\"$getField\": \"inputs.value\"},\n \"to\": \"int\"\n }\n }\n ```" properties: $convert: $ref: '#/components/schemas/ConvertSpec' required: - $convert title: ConvertOperation type: object ContainsSpec: description: "Spécification de l’opération `$contains`.\n\n- `input`\_: la chaîne à rechercher.\n- `substr`\_: la sous-chaîne à rechercher.\n- `case_insensitive`\_: si la valeur est true, la correspondance est insensible à la casse." properties: case_insensitive: anyOf: - type: boolean - type: 'null' default: false title: Case Insensitive input: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Input substr: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Substr required: - input - substr title: ContainsSpec type: object ConvertSpec: description: "Spécifie les détails de conversion pour `$convert`.\n\n- `input`\_: l'opérande à convertir.\n- `to`\_: le type de destination." properties: input: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Input to: enum: - double - string - int - bool - exists title: To type: string required: - input - to title: ConvertSpec type: object securitySchemes: HTTPBasic: scheme: basic type: http HTTPBearer: scheme: bearer type: http ````