Configuring Insights

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

Configuring Insights

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 Insights in a self-hosted environment:

1. Step 1: Get the API Key from Agent Creator

   Open the Agent Creator workspace in Builder and:

   • Navigate to Settings > Advanced
   • Copy the apiKey from the Conversations Service App
2. Step 2: Inject the API Key into Insights

   Open the Insights workspace:

   • Go to Settings > Advanced
   • In the Conversations Service App block, paste the copied apiKey
   • Click Save

---

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 :

authorizations:
  roles:
    editor: {}
    user:
      auth:
        prismeai: {}
        yourOwnSso: {}

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

---

Best Practices

Protect Access

Restrict access to Insights to admin and analytics roles only.

Pair with Builder

Use feedback loops from Insights to adjust prompts and agent behavior via Builder.

---