Skip to main content

Prerequisites

  • Role: Admin or Platform Admin (to enable, disable, or configure)
  • Permission: Settings > Airia Agent > Manage
Read-only Admin, Project Admin, and End User roles can view the Airia Agent settings page with the Settings > Airia Agent > Read permission, but cannot make changes.

Enable Airia Agent

1

Open Airia Agent settings

Navigate to Settings → Airia Agent.
2

Toggle Airia Agent on

Click the Enable Airia Agent toggle at the top of the page.
3

Wait for provisioning

The platform provisions a hidden Library project and an Airia Agent deployment in the background. This takes a few seconds. The page refreshes automatically when provisioning is complete.
4

Verify the experience

Sign in as an end user (or use a test account) and confirm that Airia Agent appears in the Chat sidebar.
Once enabled, Airia Agent is immediately available to users based on the access mode you configure in Access & Privacy.

Disable Airia Agent

Disabling Airia Agent is destructive. The platform permanently removes all tool configurations, sub-agent links, interface definitions, and the underlying deployment. Custom system prompt text is not preserved across a disable/re-enable cycle. Export or copy any configuration you want to reuse before disabling.
1

Open Airia Agent settings

Navigate to Settings → Airia Agent.
2

Toggle Airia Agent off

Click the Enable Airia Agent toggle to turn it off.
3

Confirm the action

Acknowledge the confirmation dialog. The platform removes the agent deployment, pipeline, and project content.
Users who previously had access will no longer see Airia Agent in Chat. If you have a fallback agent configured, they are automatically routed there. If not, their Chat sidebar returns to standard catalog browsing.

What gets created on enable

ResourceDetails
Library projectA hidden project that houses the agent pipeline; not visible in the standard project list
Airia Agent deploymentA deployment of type Airia Agent; powers the Chat experience
Default configurationTool list starts empty; access defaults to all users

What gets removed on disable

ResourceRemoved?
Library project and pipelineYes — permanently deleted
Airia Agent deploymentYes — permanently deleted
Tool and MCP configurationYes
Sub-agent linksYes
Interface definitionsYes
Custom system promptYes — not preserved
Access mode settingYes — resets to “all users” on next enable