Skip to main content

AgentBudgetDimension

One effective budget dimension at TURN, SESSION, or PLAYER_DAY scope.

type AgentBudgetDimension {
  name: String!
  scope: String!
  limit: BigInt!
  reserved: BigInt!
  consumed: BigInt!
  remaining: BigInt!
  unit: String!
}

Fields​

AgentBudgetDimension.name ● String! non-null scalar​

REQUESTS, INPUT_TOKENS, OUTPUT_TOKENS, REASONING_TOKENS, PROVIDER_COST, TOOL_ROUNDS, WALL_CLOCK_MS, TOOL_CALLS, or COMPILES.

AgentBudgetDimension.scope ● String! non-null scalar​

TURN, SESSION, or PLAYER_DAY limit scope.

AgentBudgetDimension.limit ● BigInt! non-null scalar​

Effective hard limit.

AgentBudgetDimension.reserved ● BigInt! non-null scalar​

Worst-case active reservation.

AgentBudgetDimension.consumed ● BigInt! non-null scalar​

Durably consumed amount.

AgentBudgetDimension.remaining ● BigInt! non-null scalar​

Non-negative remaining amount.

AgentBudgetDimension.unit ● String! non-null scalar​

Dimension unit, for example tokens, requests, microusd, or ms.

Member Of​

AgentBudget object