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

# Configuring AI Insights

> Initialize and secure access to AI Insights for analyzing AI usage and agent performance.

# Configuring AI Insights

AI Insights is the module of Prisme.ai dedicated to monitoring and improving the **usage, performance, and ROI** of AI agents across your platform.

It connects to the **Conversation Service App** and displays analytics dashboards for:

* Usage metrics (volume, trends, activity)
* Model consumption
* User behavior
* Feedback and quality scores

***

## Initialization

To activate AI Insights in a self-hosted environment:

<Steps>
  <Step title="Step 1: Get the API Key from AI Store">
    Open the **AI Store** workspace in AI Builder and:

    * Navigate to `Settings > Advanced`
    * Copy the `apiKey` from the **Conversations Service App**
  </Step>

  <Step title="Step 2: Inject the API Key into AI Insights">
    Open the **AI Insights** workspace:

    * Go to `Settings > Advanced`
    * In the **Conversations Service App** block, paste the copied `apiKey`
    * Click **Save**
  </Step>
</Steps>

***

## SSO Access

If you have your own SSO configured, you can explicitly allow SSO authenticated users to access AI Insight pages :

1. Open **AI Insight** workspace
2. Open **Settings** > **Advanced**
3. **Manage roles**
4. Add your SSO provider technical name after `prismeai: {}` at the very beginning :

```yaml theme={null}
authorizations:
  roles:
    editor: {}
    user:
      auth:
        prismeai: {}
        yourOwnSso: {}
```

<AccordionGroup>
  <Accordion title="How to Add SSO Access">
    1. Open the **AI Insight** workspace
    2. Navigate to `Settings > Advanced`
    3. Under **Roles**, add your SSO technical name in the YAML source code as shown above
    4. Save and redeploy if needed
  </Accordion>
</AccordionGroup>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Protect Access" icon="lock">
    Restrict access to AI Insights to admin and analytics roles only.
  </Card>

  <Card title="Pair with AI Builder" icon="wand-magic">
    Use feedback loops from AI Insights to adjust prompts and agent behavior via AI Builder.
  </Card>
</CardGroup>

***