io.enterpriseai.model.UsageEvent

Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/model/UsageEvent.java. Retour à l'index de la référence du SDK Java.

remarque

Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.

Modèle UsageEvent

Usage Event v1 (contracts/v1/usage-event.schema.json) : un événement de consommation avec unités, prix et coûts.

Champs :

Nom	Type	Requis	Description
schemaVersion	String	oui	Version du contrat, majeure 1 (1.x) ; les versions mineures restent rétrocompatibles.
eventId	String	oui	Identifiant de l'événement de consommation.
occurredAt	OffsetDateTime	oui	Date à laquelle l'usage a eu lieu.
tenantId	String	oui	Locataire de l'agent. default par défaut.
projectId	String	oui	Identifiant du projet, espace de travail d'un tenant qui porte les agents, les bases de connaissances, les quotas et les secrets.
environment	String	oui	Environnement de la consommation.
agentId	String	oui	Identifiant de l'agent consommateur.
sessionId	String	oui	Identifiant de la session.
runId	String	oui	Identifiant du run.
taskId	String	oui	Identifiant de la tâche.
requestId	String	oui	Identifiant de la requête de la plateforme.
providerRequestId	String	oui	Identifiant de requête donné par le fournisseur, peut être null.
traceId	String	oui	Identifiant de trace W3C, 32 caractères hexadécimaux en minuscules, pour relier l'événement à une trace.
usageType	String	oui	Type de consommation, par exemple llm, embeddings, tool ou sandbox.
provider	String	oui	Fournisseur qui a servi l'appel.
modelId	String	oui	Modèle de l'appel, comparé aux motifs de modèle des grilles tarifaires.
deploymentId	String	oui	Déploiement de modèle qui tournait sur le GPU pendant l'échantillon.
region	String	oui	Région de traitement, par exemple eu-west-1.
units	Map<String, Object>	oui	Unités consommées, par exemple la table construite par TokenUnits.of.
pricing	JsonNode	oui	Prix appliqué, en objet JSON.
cost	JsonNode	oui	Coût de la consommation, en objet JSON.
status	String	oui	Statut du coût : estimated, measured ou reconciled.
source	String	oui	Émetteur de l'événement, par exemple gateway, litellm, adapter, runtime ou sandbox.
labels	Map<String, String>	oui	Étiquettes de la machine sous forme de table de chaînes, qui remplacent les étiquettes actuelles, par exemple {"zone": "a"}.