> ## 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.

# Enable Airia Agent

> Provision or unprovision Airia Agent for your tenant.

## Prerequisites

* **Role**: Admin or Platform Admin (to enable, disable, or configure)
* **Permission**: Settings > Airia Agent > Manage

<Note>
  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.
</Note>

## Enable Airia Agent

<Steps>
  <Step title="Open Airia Agent settings">
    Navigate to **Settings → Airia Agent**.
  </Step>

  <Step title="Toggle Airia Agent on">
    Click the **Enable Airia Agent** toggle at the top of the page.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Verify the experience">
    Sign in as an end user (or use a test account) and confirm that **Airia Agent** appears in the Chat sidebar.
  </Step>
</Steps>

Once enabled, Airia Agent is immediately available to users based on the access mode you configure in [Access & Privacy](/admin-hub/airia-agent/access-and-privacy).

## Disable Airia Agent

<Warning>
  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.
</Warning>

<Steps>
  <Step title="Open Airia Agent settings">
    Navigate to **Settings → Airia Agent**.
  </Step>

  <Step title="Toggle Airia Agent off">
    Click the **Enable Airia Agent** toggle to turn it off.
  </Step>

  <Step title="Confirm the action">
    Acknowledge the confirmation dialog. The platform removes the agent deployment, pipeline, and project content.
  </Step>
</Steps>

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

| Resource               | Details                                                                                   |
| ---------------------- | ----------------------------------------------------------------------------------------- |
| Library project        | A hidden project that houses the agent pipeline; not visible in the standard project list |
| Airia Agent deployment | A deployment of type Airia Agent; powers the Chat experience                              |
| Default configuration  | Tool list starts empty; access defaults to all users                                      |

## What gets removed on disable

| Resource                     | Removed?                                   |
| ---------------------------- | ------------------------------------------ |
| Library project and pipeline | Yes — permanently deleted                  |
| Airia Agent deployment       | Yes — permanently deleted                  |
| Tool and MCP configuration   | Yes                                        |
| Sub-agent links              | Yes                                        |
| Interface definitions        | Yes                                        |
| Custom system prompt         | Yes — **not preserved**                    |
| Access mode setting          | Yes — resets to "all users" on next enable |