The _AI Controls_ page lets Organization Admins manage Global Agent availability, customize AI context, configure model providers, and set data retention policies.

## AI Controls settings

Access organization-level AI Controls from _Settings > AI Controls_.

The _AI Controls_ page includes:

- **Global Agent availability**: Show or hide Global Agent and enable or disable it for your organization.
- **Audit**: View all user activity within Global Agent across your organization.
- **AI context**: Provide instructions and upload reference files to help Agents understand your business.
- **Model providers**: Enable or disable specific AI model providers.
- **Data retention and privacy**: Configure how long Amplitude stores AI conversation data.
- **Disable all AI**: Contact Amplitude support to turn off all AI features across your organization.

## Global Agent availability

Control whether Global Agent appears in your organization's interface.

- **Navigation visibility**: Toggle **Show Global Agent in sidebar** to show or hide Global Agent from the left-side navigation bar for all users.
- **Feature access**: Toggle **Enable Global Agent for organization** to allow or block users from interacting with Global Agent features.

{% callout type="note" heading="" %}
These settings affect all users in your organization. Individual users can't override organization-level visibility or access settings.
{% /callout %}

## Audit

The _Audit_ tab gives organization admins visibility into how users interact with Global Agent across the organization. Use this tab to monitor usage and verify that Global Agent operates as expected.

### View the audit log

1. Navigate to _Settings > AI Controls_.
2. Select the **Audit** tab.
3. Review the table of Global Agent threads.

The audit log displays all Global Agent conversation threads from users in your organization. Each entry shows details about the thread, including the user who initiated it and when the conversation occurred.

### Use cases for audit

Use the audit log to:

- **Monitor adoption**: Track how many users engage with Global Agent and how often.
- **Verify appropriate use**: Ensure users interact with Global Agent according to your organization's guidelines.
- **Troubleshoot issues**: Investigate specific conversations when users report problems or unexpected behavior.
- **Inform context improvements**: Identify patterns in user questions to improve your AI context configuration.

{% callout type="note" heading="" %}
Only organization admins can access the Audit tab. Individual users can't view other users' Global Agent activity.
{% /callout %}

## AI context

Provide custom instructions that teach Agents (both Global and Specialized) how your business works. For guidance on writing effective context, refer to [AI context](/docs/amplitude-ai/ai-context).

### Two levels of context

Agents use two layers of context: Organization and Project.

- **Organization context**: Applies to all projects. Use for company-wide standards like business model, KPI definitions, standard terminology, and global filters. Limit: 10,000 characters.
- **Project context**: Applies to one project. Use for product-specific events, metrics, segments, and overrides to org defaults. Limit: 10,000 characters.

At runtime, Agents receive both context sources. Project context overrides organization context when they conflict.

### Text instructions

Enter your context as structured markdown text. Use headings, bullets, and backticks to make it easy for Agents to parse.

To add text instructions:

1. Navigate to _Settings > AI Controls_.
2. In the _AI Context_ section, select the **Organization** or **Project** tab.
3. Enter your instructions in the text field.
4. Select **Save**.

### File uploads

Upload reference files for Agents to use alongside your text instructions. Files provide additional context without consuming your 10,000-character instruction limit.

Supported file formats:

| Type         | Formats                       | Size limit |
| ------------ | ----------------------------- | ---------- |
| Documents    | TXT, MD, HTML, DOC, DOCX, PDF | 25 MB      |
| Spreadsheets | CSV, XLS, XLSX                | 25 MB      |

The 50-document storage limit applies separately to each scope: you can store up to 50 documents at the organization level and up to 50 documents in each project. Each scope's limit covers both manually uploaded files and any files synced from external sources.

To upload a file:

1. Navigate to the _AI Context_ section of the _AI Controls_ page.
2. Select **Upload file**.
3. Choose one or more files to upload.

Use file uploads for:

- Data dictionaries or event catalogs in spreadsheet format.
- Product requirement documents or specifications.
- Style guides or documentation standards.

{% callout type="note" heading="" %}
File uploads supplement your text instructions—they don't replace them. Use text instructions for rules and definitions, and file uploads for detailed reference material.
{% /callout %}

{{##

## Model providers

Enable or disable specific AI model providers for your organization.

| Provider  | Models                     |
| --------- | -------------------------- |
| Anthropic | Claude Sonnet, Claude Opus |
| Google    | Gemini Flash, Gemini Pro   |
| OpenAI    | GPT                        |

Toggle each provider on or off based on your organization's policies. Amplitude recommends keeping all providers enabled for the best experience.

{% callout type="warning" heading="" %}
Disabling a provider may degrade performance across certain AI features. Only disable a provider if your organization's security or compliance policies require it.
{% /callout %}
##}}

## Data retention and privacy

Configure how long Amplitude stores AI conversation data.

### Data privacy

Amplitude doesn't store your data with third-party AI providers. Amplitude and its partners never use your data for model training.

### Retention period

Set the retention period to control how long Amplitude stores conversation logs before automatic deletion. Adjust this setting based on your organization's data governance requirements.

For detailed information about AI data handling, privacy, and security, refer to [Privacy and security](/docs/amplitude-ai/privacy-and-security).

## Disable all AI

To disable Global Agent for your organization, use the toggles in the [Global Agent availability](#global-agent-availability) section. You can also toggle other individual AI features on or off from _Settings > AI Controls_.

To disable all Amplitude AI features across your entire organization, contact [Amplitude Support](https://amplitude.com/contact-us). Amplitude processes opt-out requests and disables all AI functionality for your organization.

{% callout type="note" heading="" %}
Disabling individual features from the settings page doesn't turn off all AI. For a complete AI opt-out, contact Amplitude Support.
{% /callout %}

## Frequently asked questions

{% accordion title="Who can access AI Controls?" %}
Only organization administrators can access and modify AI Controls. This includes Global Agent availability, audit logs, model provider settings, data retention policies, and the option to disable all AI. Individual users can't change these settings.
{% /accordion %}

{% accordion title="What can I see in the Audit tab?" %}
The Audit tab displays a table of all Global Agent conversation threads across your organization. You can view which users initiated conversations and when they occurred. Use this information to monitor adoption, verify appropriate use, and identify opportunities to improve your AI context configuration.
{% /accordion %}

{% accordion title="What's the character limit for context?" %}
10,000 characters each for org context and project context (20,000 total). This is roughly 1,500–2,000 words—plenty for most use cases.

If you're hitting the limit, you're probably including too much detail. Focus on definitions and rules that apply to the majority of questions, not edge cases.
{% /accordion %}

{% accordion title="What file types can I upload as context?" %}
You can upload documents (TXT, MD, HTML, DOC, DOCX, PDF up to 25 MB) and spreadsheets (CSV, XLS, XLSX up to 25 MB). Use file uploads for detailed reference material like data dictionaries or product specs that would exceed the 10,000-character instruction limit.
{% /accordion %}

{% accordion title="How many files can my organization upload?" %}
The 50-document limit applies separately to each scope. You can store up to 50 documents at the organization level and up to 50 documents in each project. Each scope's limit covers both manually uploaded files and any files synced from external sources. If you reach the limit, remove unused files before uploading new ones.
{% /accordion %}

{% accordion title="What happens if I disable a model provider?" %}
Disabling a provider removes that provider's models from all AI features in your organization. This may degrade performance if the disabled provider handles specific tasks. Amplitude recommends keeping all providers enabled unless your security or compliance policies require otherwise.
{% /accordion %}

{% accordion title="How do I re-enable AI after disabling it?" %}
An organization administrator can re-enable Global Agent and other individual AI features by navigating to _Settings > AI Controls_ and toggling the features back on. If you requested a full AI opt-out through Amplitude Support, contact support again to re-enable AI features for your organization.
{% /accordion %}