> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.hoop.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Session Analyzer Configuration

> Configure an AI provider and risk rules to analyze ad-hoc terminal sessions in real time

<Note>
  This guide covers ad-hoc sessions (Web App terminal & `hoop exec` CLI). For per-request analysis on HTTP Proxy resources, see [AI Session Analyzer for HTTP Proxy](/docs/setup/configuration/ai-session-analyzer-configuration-http-proxy). For the conceptual overview, see the [AI Session Analyzer guide](/docs/learn/features/ai-session-analyzer).
</Note>

## Prerequisites

* Either [create an account in our managed instance](https://use.hoop.dev) or [deploy your own hoop.dev instance](/docs/setup/deployment/overview)
* Have admin access to your hoop.dev instance
* A valid AI provider account and API key

## Configure the AI Provider

In the Web App, open the **Discover** section in the main sidebar and select **AI Session Analyzer**, then open the **Configure** tab.

<Frame>
  <img src="https://mintcdn.com/hoopdev/lrDzNzGWUdt3RXEx/images/configure/ai-session-analyzer/configure-provider.png?fit=max&auto=format&n=lrDzNzGWUdt3RXEx&q=85&s=f31cd94ae40f86f26fdec1e5982f4e0b" alt="AI Session Analyzer Configure tab with provider selection" width="1024" height="482" data-path="images/configure/ai-session-analyzer/configure-provider.png" />
</Frame>

1. Select one provider:
   * Azure OpenAI
   * OpenAI
   * Anthropic
   * Custom (OpenAI-compatible API)
2. Enter the AI model
3. Enter the API key
4. Click **Save**

Required fields cannot be empty, and credentials are validated before save. On success, the UI shows: `Configuration saved.`

## Create the First Rule

In **AI Session Analyzer > Rules**:

<Frame>
  <img src="https://mintcdn.com/hoopdev/lrDzNzGWUdt3RXEx/images/configure/ai-session-analyzer/rules-create-new.png?fit=max&auto=format&n=lrDzNzGWUdt3RXEx&q=85&s=08eab9c2dc2062b00a3bcb726078cee2" alt="AI Session Analyzer Rules tab with the Create new rule button" width="1024" height="482" data-path="images/configure/ai-session-analyzer/rules-create-new.png" />
</Frame>

1. Click **Create new rule**
2. Add a **Name** and optional **Description**
3. Configure rule scope (roles and attributes)
4. Select risk action behavior (for example, allow or block)
5. Save the rule

## Run a Command in Terminal

Open a terminal session and run a command. The command is evaluated in real time using your configured provider and rules.

## Verify the Result

Confirm the resulting action and risk status in the terminal and in session details.

## Troubleshooting

### Rules Tab Is Empty

**Check:**

1. Configure tab was completed first
2. Provider, model, and API key are valid
3. Configuration was saved successfully

### Save Is Blocked

**Check:**

1. All required fields are filled
2. API key is valid for selected provider/model
3. Custom provider fields are complete (if using OpenAI-compatible API)

### Analyzer Not Applying Rules in Session

**Check:**

1. At least one rule exists and is active
2. Rule scope (roles/attributes) matches the current session
3. Commands are running in Web Terminal where analyzer status is shown