Usage and cost

See what your Coworkers, Knowledge Bases, system jobs, teams and people have used and what it cost, for a month or a custom period.

For: Everyone signed in · Last updated

The Usage & cost tab of Governance shows what your Coworkers, Knowledge Bases and system jobs have used, taken from the record of every call they make. Every figure is a real total for the period you pick.

Everyone who is signed in can open it. What you see depends on who you are:

  • With the people_manager or executive ability, you see usage across all Teams.
  • With the manage_coworkers or manage_apps ability, you see the usage of the Coworkers you supervise or the Apps you built.
  • Otherwise, you see the usage of the teams you belong to: calls made by those teams' Coworkers and Knowledge Bases, in every table below. Usage with no team, such as system jobs, is not included. If you are not on a team, the view shows no usage.

Choose a period#

The Period switch has three options:

  • This month covers the whole current calendar month.
  • Last month covers the whole previous calendar month.
  • Custom shows From and To date boxes. Both dates are included, so a period from the 1st to the 7th includes all of the 7th. Until you choose both dates, and the end is on or after the start, the page says "Choose a start and end date (the end on or after the start)."

If the figures cannot be loaded, the page says "Usage couldn't be loaded. Try again in a moment."

Totals#

When the period has any usage, five tiles appear: Total cost (in US dollars), Calls, Input tokens, Output tokens and Errors. A small cost is never rounded down to nothing: an amount under one cent reads <$0.01, and only a cost of exactly zero reads $0.00.

Some calls are made with a model whose price is not on file. Those are shown as Unpriced instead of a dollar amount. When all of a period's calls are unpriced, Total cost reads Unpriced with the number of calls. When only some are, Total cost is the amount for the calls that have a price and a note beneath it says how many calls it leaves out. Calls, tokens and errors always include every call. When there is none, you see No usage in this period, with a note that calls made by Coworkers and system jobs appear as they happen. If you see usage for your teams only, the note reads "Usage for the teams you belong to appears here as it happens. If you are not on a team, there is nothing to show."

The rollups#

Up to five tables break the same period down. Each has the columns Calls, Input tokens, Output tokens, Errors and Cost, and lists the highest cost first. A table with no usage says "No usage in this period."

Table One row per Notes
Coworkers Coworker Calls made for that Coworker, such as chat and conversation summaries.
Knowledge Bases Knowledge Base Reading documents into a Knowledge Base and searching it. Search queries that are not tied to one Knowledge Base appear as Search embedding, and the work of ranking search results appears as Search rerank. Work that could not be matched to a Knowledge Base appears as No Knowledge Base recorded.
System jobs Background job, by name Jobs other than the Knowledge Base ones above.
Teams Team Cost counted through the Coworker's or Knowledge Base's team. Usage with no team appears as Unassigned.
Users Person Usage from a person's own API key, or made for them such as a Coworker chat they started. Usage not made for anyone appears as Unassigned.

In each table, a row whose calls are all unpriced shows Unpriced in the Cost column. A row with only some unpriced calls shows its amount followed by "· N unpriced".

Usage already recorded stays in every table, including the Coworkers and Knowledge Bases tables, even when the matching area is switched off on Settings, then Features. Once an area is off and the period you are viewing has no usage for it, its table is not shown.

A Coworker, Knowledge Base, team or person that has been deleted appears for the usage it generated, with · removed after its name.