Skip to content

Configure Lens Prism#

Lens premium subscription feature. See details on Lens Pricing.

This page describes how to configure Lens Prism, the built-in AI-powered assistant for Lens Desktop.

Prerequisites#

Before you start, ensure that:

Set up Lens Prism in Lens Desktop#

  1. Log into the Open AI Platform with your personal or organization email.
  2. In the upper-right corner, select Dashboard and then, in the navigation panel on the left, open the API Keys menu.
  3. Click Create new secret key and, in the following modal, configure the key:

    Parameter Recommended value
    Name Lens Prism
    Project Default project
    Permissions All

    Proceed to the next step by clicking Create secret key.

  4. In the following modal, click Copy, then Done.

    Info

    For security reasons, you cannot view or copy an existing API key again after you have created it. Keep that in mind when configuring Lens Prism, and do not copy anything else until you have the OpenAI API Key field configured. Otherwise, revoke the key and create a new one.

    The video below illustrates creating of an API key:

  5. Open Lens Desktop and navigate to Preferences > Lens Prism AI.

  6. In AI Provider, select OpenAI and specify the following parameters:

    Parameter Recommended value Comments
    OpenAI API Key api-key Paste the API key from the step 4 of this instruction
    Custom Instructions - Optional. Set up personal preferences, such as language, specific details, and so on. These instructions are appended to every prompt as a guidance to personalize and improve Lens Prism responses

    See the configuration example on the screenshot below:

    an example of configs


  1. Log into Azure Portal and navigate to Azure services > AI + machine learning > Azure OpenAI.
  2. In the following table, select already existing or create a new resource.
  3. In the resource menu, click Resource Management > Keys and Endpoint. A menu containing keys, location, and endpoint opens.
  4. Copy the content of the KEY 1 or KEY 2 fields.
  5. Open Lens Desktop and navigate to Preferences > Lens Prism AI.
  6. In AI Provider, select Azure and specify the following parameters:

    Parameter Recommended value Comments
    Azure API Key KEY1/KEY2 Find Azure AI Foundry > Home
    Resource Name resource name Find in Azure AI Foundry > Home
    Model IDs Model name To find, navigate to Azure AI Foundry > Deployments and click the model you need
    API Version Model version Find in the model menu
    Context Window Size - Accordingly to the Azure model settings
    Max Output Tokens - Accordingly to the Azure model settings
    Custom Instructions - Optional. Set up personal preferences, such as language, specific details, and so on. These instructions are appended to every prompt as a guidance to personalize and improve Lens Prism responses

    See the configuration example on the screenshot below:

    an example of configs


  1. Log into the profile of you AI provider.
  2. Obtain the following parameters:

    Parameter Recommended value Comments
    API Key api-key Find in the AI provider profile, or contact organization profile administrator
    Model IDs model-id Find in the AI provider profile, or contact organization profile administrator
    Context Window Size - Accordingly to the LLM settings
    Max Output Tokens - Accordingly to the LLM settings
    Custom Instructions - Optional. Set up personal preferences, such as language, specific details, and so on. These instructions are appended to every prompt as a guidance to personalize and improve Lens Prism responses

    See the configuration example of Gemini LLM on the screenshot below:

    an example of configs


Troubleshooting#

Failed attempts issue in OpenAI API#

After configuring Lens Prism to use OpenAI API, you might get the following error message:

  Failed after 3 attempts. Last error: You exceeded your current quota, please check your plan and billing details...

Make sure that you have obtained appropriate personal or corporate OpenAI subscription plan . To enable your OpenAI API see Enable OpenAI API

Privacy and security#

  • Lens Prism connects only to the LLM endpoint you have configured
  • All communication happens directly between your machine and your selected LLM provider
  • Neither Lens Prism nor Lens Desktop sends any of your cluster data to Lens or third-party services
  • When you use Lens Prism, the LLM does not train on any user-provided data.

Enable Lens Prism for your organization#

To enable Lens Prism for your organization users:

  1. As an administrator, log into the organization Lens Business ID.
  2. In Feature Management, toggle Enable Prism AI.