Skip to main content
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 pipeline 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.

Settings overview

All configuration lives at Settings → Airia Agent. The page is organized into tabs:
TabWhat you configure
Access & PrivacyWhich users can access Airia Agent; fallback agent for everyone else
InterfacesView the agent’s active deployment and interface configuration
ToolsConnect tools and MCP servers; enable or disable individual tools
Sub-agentsAdd catalog agents Airia Agent can delegate tasks to
System PromptsWrite custom instructions that shape the agent’s behavior
Compute SandboxControl which users get isolated sandbox execution; manage Skills Repositories

Required permissions

ActionRolesPermission
View Airia Agent settingsAdmin, Platform Admin, Read-only Admin, Project Admin, End UserSettings > Airia Agent > Read
Enable, disable, and configureAdmin, Platform AdminSettings > Airia Agent > Manage
New to Airia Agent? Follow this order to avoid revisiting steps:
  1. Enable Airia Agent — provision the agent for your tenant
  2. Access & Privacy — decide who can use it and set a fallback agent
  3. Extending Airia Agent — read this before configuring tools or sub-agents
  4. Tools & MCP and/or Sub-agents — wire up capabilities
  5. System Prompts — customize behavior for your organization
  6. Compute Sandbox and Skills Repositories — optional, for advanced tool execution isolation

Enable Airia Agent

Provision or unprovision Airia Agent for your tenant

Access & Privacy

Control who can use Airia Agent and configure the fallback experience

Extending Airia Agent

Choose between tools, MCP servers, and sub-agents

Tools & MCP

Connect tools and external MCP servers

Sub-agents

Delegate tasks to specialized catalog agents

System Prompts

Customize Airia Agent’s behavior with tenant-specific instructions

Interfaces

View the agent’s active deployment and interface configuration

Compute Sandbox

Run complex, code-driven tasks and process large datasets beyond the model’s context window

Skills Repositories

Manage custom code and files available at execution time

Version Management

Apply platform updates and review changelogs

Troubleshooting

Diagnose common setup and access problems