# Generative AI for Self-Hosted Environments

> Generative AI (GenAI) features enable users to engage with their data using natural language, making valuable insights accessible without the need for extensive technical knowledge. GenAI features can be enabled or disabled by a Sisense Administrator.

*Source: https://docs.sisense.com/main/SisenseLinux/genai-selfhosted.htm*

---

Last updated: June 11, 2026

|  |  |
| --- | --- |
| [Tier](https://www.sisense.com/pricing/#pricing) | [Deployment](https://docs.sisense.com/main/SisenseLinux/introduction-to-sisense-cloud-managed-services.md#ComparisonofManagedCloudandSelfHosted) |
| Enterprise | On-Prem |

Sisense Intelligence empowers analytics through advanced Generative AI capabilities. While fully integrated into Sisense Managed Cloud environments, self-hosted customers can now leverage Generative AI through an independently managed infrastructure. This enables on-premises or self-hosted environments to maintain complete control while benefiting from powerful AI-driven analytics.

**Note:**

This topic is specifically for setting up self-hosted Generative AI. For more background and general information about Generative AI, see [Generative AI (Cloud-Linked Features) - Empowering Your Analytics Experience](https://docs.sisense.com/main/SisenseLinux/genai.md).

## Uniqueness of Self-Hosted Environments

In self-hosted scenarios, customers directly manage their own infrastructure, including the provisioning and maintenance of both the Vector Database (MongoDB Atlas VDB) and Large Language Model (LLM) services, through Azure OpenAI or OpenAI APIs. This setup provides enhanced data sovereignty and deeper integration possibilities within customers' own IT ecosystems.

## Prerequisites

For the successful use of AI capabilities in a self-hosted environment, ensure the following:

- Sisense version L2025.2 or newer, regularly updated to align with evolving beta features
- MongoDB Atlas Cluster (minimum recommended size: M10)
- Public Network Access - Open web access through an IP allowlist
- Public IP Defined and accessible for your Sisense instance
- Monitor and manage the deployment in line with Sisense guidance
- Accept that additional services may be required as the architecture matures

## Getting Started

Before enabling Cloud-Linked Features (Generative AI), ensure you have access to your LLM key and Vector DB connection string.

- For detailed instructions on how to set up your LLM, and supported models, see [Setting Up Your LLM](https://docs.sisense.com/main/SisenseLinux/llm-setup.md).
- For detailed instructions on how to set up your VDB, see [Setting Up Your Vector Database (VDB)](https://docs.sisense.com/main/SisenseLinux/vdb-setup.md).

## Enabling Cloud-Linked Features (Generative AI)

Cloud-Linked Features can be enabled (or disabled) as follows by a Sisense Administrator:

1. Search for “Sisense Intelligence” in the search bar or open the App Configuration drop-down.
2. Click **Feature Management**.

   ![Admin CloudLinked SelfHosted Enable](https://docs.sisense.com/main/Resources/Images/Admin_CloudLinked_SelfHosted_Enable_1009x588.png)
3. Enable **Cloud-Linked Features** via the toggle.  
   When this toggle is disabled, you will not be able to access the GenAI features that require your own LLM (Narrative is controlled separately).

## Configuring Your Provider

1. In the **Admin** tab, select **Sisense Intelligence > Provider Configuration**.

   ![Admin ProviderConfig SelfHosted](https://docs.sisense.com/main/Resources/Images/Admin_ProviderConfig_SelfHosted_1009x889.png)
2. Click **I agree** to consent to the Generative AI terms and conditions.

### Connecting Your LLM

To enable Generative AI features, Sisense requires integration with a supported Large Language Model (LLM). This section outlines how to connect your LLM.

1. In the **Admin** tab, select **Sisense Intelligence > Provider Configuration** (see the figure above).
2. In the Bring your own LLM section, click **+ Add Provider**.

   In order to proceed, you must configure your own LLM API key.
3. Open the **LLM Provider** drop-down list and select your preferred provider.
4. Once you have selected your provider, enter the configuration details, including your LLM API key, to complete the setup.

- Azure OpenAI:

|  |  |  |
| --- | --- | --- |
| Name | Description | Example |
| Model Name | Model deployment name you chose during the deployment process on your LLM platform. | my-gpt-4o-mini |
| Base URL | Endpoint URL of your LLM instance. | https://MyLLM.openai.azure.com/ |
| API Key | API key for authenticating and authorizing your requests to the model's API. | `<your_api_key>` |

- OpenAI:

|  |  |  |
| --- | --- | --- |
| Name | Description | Example |
| Model Name | Model name corresponding to your OpenAI API key (see the [OpenAI supported models list](https://platform.openai.com/docs/pricing)). This should be the exact model identifier used for API requests.  **Note:** Ensure that the key permissions are set to **All** (not Restricted/ReadOnly). See [Setting Up Your LLM](https://docs.sisense.com/main/SisenseLinux/llm-setup.md) for more information. | gpt-4o-mini-2024-07-18 |
| Base URL | Endpoint URL of your LLM instance. | https://api.openai.com/v1/ |
| Organization | Only applicable if you use the OpenAI organization. If troubleshooting becomes necessary, and this field is filled in, try removing it. |  |
| API Key | API key for authenticating and authorizing your requests to the model's API. It is usually `sk-proj-<the rest of the key>`. | sk-proj-<the\_rest\_of\_your\_api\_key> |

![LLM TestSave SelfHosted](https://docs.sisense.com/main/Resources/Images/LLM_TestSave_SelfHosted.png)

1. Click **Test** to validate your configuration.
2. Once the test is successful, click **Save** to apply your configuration.

### Connecting your Vector Database

To set up your vector database connection:

1. In the **Admin** tab, select **Sisense Intelligence > Provider Configuration** (see the figure above).
2. In the Bring your own VDB section, click **+ Add VDB**.
3. In the Vector Database Connection String field, paste the [connection string](https://docs.sisense.com/main/SisenseLinux/vdb-setup.md) for your supported vector database to connect to your vector database.

   ![VectorDB SelfHosted](https://docs.sisense.com/main/Resources/Images/VectorDB_SelfHosted.png)
4. Click **Test** to validate the connection.
5. Once the test is successful, click **Save** to apply your configuration.

#### API Reference

To set up your Vector DB connection via REST API:

1. Under **Admin**, navigate to **REST API** and select version **2.0**.
2. Use `POST ​​/settings/ai/vdb/` to add or update the VDB connection string used for AI settings configuration.
3. Use the `POST /ai/vdb/test` method to test the connection to your VDB.