Skip to main content

Agent operations

An agent operation (AO) is the unit of work in Airbyte Agents. Every time an agent processes a prompt, reasons about data, or calls a tool, it consumes AOs. AOs measure the processing intensity of a task, not just the number of requests.

Airbyte derives AOs from a combination of two factors:

  • Tool calls. Each action an agent takes against a connector counts as a tool call. Listing records, fetching a single record, searching the Context Store, and writing data back to a source are all tool calls.
  • Token usage. The input and output tokens an agent consumes while reasoning about your prompt contribute to the AO count.

Simple tasks typically make fewer tool calls and use fewer tokens, so they consume fewer AOs. Complex reasoning tasks that span multiple connectors, require iterative lookups, or produce long responses consume more.

What produces agent operations

Any interaction with an agent consumes AOs. The source of the interaction determines how Airbyte tracks it.

SourceDescriptionTracked as a session?
ChatA conversation with an agent in the web app.Yes
AutomationA single run of a scheduled, webhook-triggered, or manually triggered automation.Yes
Automation Builder ChatA conversation inside the Automation Builder while designing an automation.Yes
MCPTool calls from agents connected through the Model Context Protocol.No
APIDirect calls to the Airbyte Agents API.No
SDKCalls from an agent built with the Airbyte Agents SDK.No

Sources tracked as sessions appear on the Sessions page, where you can review the full conversation and tool calls. Sources that aren't tracked as sessions still consume AOs and appear in the Usage panel on the Billing page.

How AOs relate to billing

Your plan determines how many AOs you receive each month, whether you can exceed that allowance, and how much overage costs. For plan details, usage monitoring, and payment management, see Billing and pricing.