> ## Documentation Index
> Fetch the complete documentation index at: https://explore.airia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Airia Agent

> A platform-managed AI assistant that gives every user in your tenant a single, unified chat experience.

Airia Agent is a tenant-wide system agent managed and versioned by Airia. When enabled, it appears in the **Chat** interface for every user you grant access to, replacing the need for users to discover and select individual agents themselves.

Unlike agents you build in Agent Studio, Airia Agent is automatically provisioned and maintained by the platform. You control what it can do — which tools it can call, which agents it can delegate to, who can access it, and how it presents itself — but Airia handles the underlying agent logic and releases updates over time.

## How it works

When you enable Airia Agent, the platform provisions a hidden project and deployment in the background. From that point on:

* Users with access see **Airia Agent** in their Chat sidebar instead of a list of catalog agents
* You connect tools, MCP servers, and sub-agents to extend what it can do
* You optionally customize its behavior with a system prompt
* Airia publishes periodic updates with new capabilities; you choose when to apply them

Users without access are routed to a fallback catalog agent of your choice.

## Token consumption & cost

Every Airia Agent conversation consumes tokens beyond the visible chat text. Some of that consumption comes from Airia's own agent logic, and some comes from choices you make when configuring the agent:

* **Airia's base system prompt** — Airia Agent ships with a platform-managed system prompt that is not visible to you or your users. It is sent to the model on every turn alongside any [custom instructions](/admin-hub/airia-agent/system-prompt) you add, so it contributes to the token footprint of every message regardless of your configuration.
* **Your system prompt** — [custom instructions](/admin-hub/airia-agent/system-prompt) are appended to the base prompt and sent on every turn, so longer prompts increase the token footprint of each message
* **Tools & MCP servers** — each connected [tool or MCP server](/admin-hub/airia-agent/tools-and-mcp) adds its definition to the model's context, and tool calls consume additional tokens for both the call and its response
* **Tool response history** — the [**Save tool responses to history**](/admin-hub/airia-agent/tools-and-mcp#tool-response-history) setting, when enabled, appends full tool call inputs and outputs to the conversation history sent to the model on every subsequent turn. This can meaningfully increase token consumption on longer conversations, especially with tools that return large payloads.
* **Sub-agents** — delegating to a [sub-agent](/admin-hub/airia-agent/sub-agents) triggers its own model call with its own system prompt, tools, and context, on top of Airia Agent's own consumption

Because of this, token consumption and cost can vary drastically from one conversation to the next depending on factors like the user's prompt, how long the conversation runs, and how many tools or sub-agents get invoked along the way — and some of that variance comes from parts of the agent you don't control. Use [Feeds](/feeds/token-consumption) to monitor actual consumption and [Billing](/admin-hub/payments-billing/billing-and-token-consumption) to track cost.

<Tip>
  Since Airia Agent's per-conversation cost is hard to predict, use [Budgets & Spend](/admin-hub/budgets-and-spend/overview) to set daily, weekly, or monthly spending limits at the company, project, or user level. This gives you a safety net against unexpectedly expensive conversations without having to precisely forecast consumption up front.
</Tip>

## Settings overview

All configuration lives at **Settings → Airia Agent**. The page is organized into tabs:

| Tab                  | What you configure                                                             |
| -------------------- | ------------------------------------------------------------------------------ |
| **Access & Privacy** | Which users can access Airia Agent; fallback agent for everyone else           |
| **Interfaces**       | View the agent's active deployment and interface configuration                 |
| **Tools**            | Connect tools and MCP servers; enable or disable individual tools              |
| **Sub-agents**       | Add catalog agents Airia Agent can delegate tasks to                           |
| **System Prompts**   | Write custom instructions that shape the agent's behavior                      |
| **Compute Sandbox**  | Control which users get isolated sandbox execution; manage Skills Repositories |

## Required permissions

| Action                         | Roles                                                           | Permission                      |
| ------------------------------ | --------------------------------------------------------------- | ------------------------------- |
| View Airia Agent settings      | Admin, Platform Admin, Read-only Admin, Project Admin, End User | Settings > Airia Agent > Read   |
| Enable, disable, and configure | Admin, Platform Admin                                           | Settings > Airia Agent > Manage |

## Recommended setup sequence

New to Airia Agent? Follow this order to avoid revisiting steps:

1. [Enable Airia Agent](/admin-hub/airia-agent/enabling-airia-agent) — provision the agent for your tenant
2. [Access & Privacy](/admin-hub/airia-agent/access-and-privacy) — decide who can use it and set a fallback agent
3. [Extending Airia Agent](/admin-hub/airia-agent/extending-airia-agent) — read this before configuring tools or sub-agents
4. [Tools & MCP](/admin-hub/airia-agent/tools-and-mcp) and/or [Sub-agents](/admin-hub/airia-agent/sub-agents) — wire up capabilities
5. [System Prompts](/admin-hub/airia-agent/system-prompt) — customize behavior for your organization
6. [Compute Sandbox](/admin-hub/airia-agent/compute-sandbox) and [Skills Repositories](/admin-hub/airia-agent/skills-repositories) — optional, for advanced tool execution isolation

***

<CardGroup cols={2}>
  <Card title="Enable Airia Agent" icon="toggle-on" href="/admin-hub/airia-agent/enabling-airia-agent">
    Provision or unprovision Airia Agent for your tenant
  </Card>

  <Card title="Access & Privacy" icon="users" href="/admin-hub/airia-agent/access-and-privacy">
    Control who can use Airia Agent and configure the fallback experience
  </Card>

  <Card title="Extending Airia Agent" icon="puzzle-piece" href="/admin-hub/airia-agent/extending-airia-agent">
    Choose between tools, MCP servers, and sub-agents
  </Card>

  <Card title="Tools & MCP" icon="wrench" href="/admin-hub/airia-agent/tools-and-mcp">
    Connect tools and external MCP servers
  </Card>

  <Card title="Sub-agents" icon="share-nodes" href="/admin-hub/airia-agent/sub-agents">
    Delegate tasks to specialized catalog agents
  </Card>

  <Card title="System Prompts" icon="terminal" href="/admin-hub/airia-agent/system-prompt">
    Customize Airia Agent's behavior with tenant-specific instructions
  </Card>

  <Card title="Interfaces" icon="window" href="/admin-hub/airia-agent/interfaces">
    View the agent's active deployment and interface configuration
  </Card>

  <Card title="Compute Sandbox" icon="box" href="/admin-hub/airia-agent/compute-sandbox">
    Run complex, code-driven tasks and process large datasets beyond the model's context window
  </Card>

  <Card title="Skills Repositories" icon="code" href="/admin-hub/airia-agent/skills-repositories">
    Manage custom code and files available at execution time
  </Card>

  <Card title="Version Management" icon="arrows-rotate" href="/admin-hub/airia-agent/version-management">
    Apply platform updates and review changelogs
  </Card>

  <Card title="Troubleshooting" icon="circle-question" href="/admin-hub/airia-agent/troubleshooting">
    Diagnose common setup and access problems
  </Card>
</CardGroup>