OpenAI Integration to Workstation

Last Updated June 13, 2024

Download as PDF

Brief Overview

Say Hello to Your New Productivity Partner: OpenAI in Workstation!

This powerful collaboration enhances your experience with three key features: a

1. QuickSync: Offers a concise summary of search results that includes an Ask the AI for deeper exploration
2. Auto-correct: Search results auto-correct eliminates the need for precise spelling.
3. ChatGPT: This widget offers interactive and dynamic conversations with realistic and contextual responses.

Set up this integration on the Console's Integrations page for effortless knowledge retrieval.

Get to Know

Integrate OpenAI into your Workstation to get the following features:

OpenAI Enterprise search capabilities

Click on the Expand button on a search result to open the QuickSync page.

It is divided into three sections, all generated using OpenAI:

1. Summary: Get a concise summary of the query, providing you with a quick overview of the key details.
2. Parameters: 8 fields are selected based on relevance and importance to ensure you have the info you need at a glance.
3. Ask the AI: Want to dig deeper? Ask the AI anything related to the record, allowing you to retrieve specific details or explore related topics effortlessly.

Enterprise Search Auto-Correct

Users no longer need to worry about precise spelling or exact matches. Our improved search capability will intelligently understand their intent and provide the most relevant results, even if there are minor errors or misspellings in the search query.

Learn more about Enterprise Search here.

Here's how it works:

• Open-source library (non-AI): An open-source library will fix common grammar and vocabulary mistakes in search queries.
• OpenAI integration: The integration with OpenAI will take search query corrections to the next level using AI-based algorithms.

Note of the following:

• Query Length: AI correction will be applied to search queries with 10 characters or more, as longer expressions benefit more from AI improvements.
• Minimum Query Length: Both AI and non-AI corrections will be applied only if the search query has 3 characters or more.

ChatGPT

Interact with ChatGPT directly from Workstation! Send an input to the ChatGPT powerful language model to generate a human-like text in response.

Here's what you can do with ChatGPT's responses from Workstation:

• Click Copy to copy the entire response
• Click Clear to clear the chat and start over
• Right click to copy, paste, and apply text correction
• Select a portion of the response to copy

Additional Capabilities

Full Conversation

Enjoy an expanded conversation screen via Workstation to make having full conversations with ChatGPT more efficient and get all of your questions answered.

Click the reply button inside the chat's answer to your initial question to open a full conversation screen.

History

Easily access and manage your previous conversations with the History feature.

Retrieve old conversations through the query dropdown, or by clicking History in the ChatGPT full conversation expansion.

• The widget can save up to 10 conversations
• Users can delete old conversations

Permalink

Organizations can now direct their users to the Workstation ChatGPT page instead of the public ChatGPT. This means that you can now have a more secure and controlled environment for your team to communicate and collaborate without the risk of public access.

Add ChatGPT

To add the ChatGPT widget, click the Settings icon in your Workstation navbar and go to the Integrations tab. Then, click Connect next to ChatGPT.

Security Overview

Read more about Workstation's integration security and Workstation's Enterprise Search.

Admin Configuration

The OpenAI integration is configured by an API key by the organization's admin on the Console. Once it's been configured and enabled, it will automatically be added to the Workstations on that system.

OpenAI can be integrated using OpenAI directly, or you can integrate to OpenAI via Azure or Mulesoft.

• Microsoft Azure is a cloud computing platform that  provides cloud-based services for building, deploying, and managing applications and services through Microsoft-managed data centers

• Mulesoft is a middleware platform designed to facilitate communication and data sharing between diverse software applications. This integration offers numerous benefits, including streamlined standardization, increased scalability, and enhanced security

Enable and disable OpenAI features

Admins can choose which OpenAI features to include in your organization's Workstations. The toggles appear in the console in the configuration set up pop-up.

Toggles have three states:

Customize ChatGPT Widget

Now you can customize the ChatGPT widget title and placeholder text. Add your customized text to the following fields:

• ChatGPT homepage widget title

• ChatGPT input field placeholder text

Requirements for configuration

Here are the requirements for configuring OpenAI via the WalkMe Console:

• API Key
• Completion algorithm from OpenAI / or Azure deployment name
• Embedding Model / or Azure embedding model name
• Azure Resource Name (required if using Azure)
• Azure API version (required if using Azure)

Use this table to determine which fields are required for each feature then follow the relevant configuration instructions to integrate OpenAI to Workstation:

Configure to OpenAI directly

Step 1: Get the API key from OpenAI

To configure Workstation to OpenAI, you'll need to generate an OpenAI key:

1. Go to OpenAI API Keys: https://platform.openai.com/account/api-keys
2. Click Create a new secret key. A popup will appear with your key.
3. Copy the key that was generated and paste it somewhere safe and convenient, you'll need it later
   • Tip: Go ahead and paste this into the API Key field in the OpenAI integration setup on the WalkMe Console

Step 2: Complete the setup on Console

1. Go to the Workstation Integrations page on WalkMe Console: https://console.walkme.com/workstation/integrations
2. Search for OpenAI
3. Click Set Up
4. Paste the API key from step 1 into the API key field
5. Type gpt-3.5-turbo into the Completion algorithm field
   • This is the OpenAI model that we support. You can read more about the models on the OpenAI site.
   • Track model deprecations over time using OpenAI documentation at: https://platform.openai.com/docs/deprecations
6. Click Save
7. Now you can enable the integration, click Enable
8. The ChatGPT widget will automatically be added to all of the Workstations on this system

Configure via Azure

Step 1: Configure OpenAI on Azure

Follow Microsoft's guide to learn how to create an OpenAI deployment and resource via Azure

Tip: After you've created and deployed the OpenAI model, go to the Deployment tab and copy the deployment name and embedding model and paste them into the relevant fields in the OpenAI integration setup on the WalkMe Console

Step 2: Configure set up on WalkMe Console

1. Go to the Workstation Integrations page on WalkMe Console: https://console.walkme.com/workstation/integrations
2. Search for OpenAI
3. Click Set Up
4. Depending on which OpenAI features you want, you'll need to copy the following information from the Azure OpenAI studio:
   1. API key: Go to Settings->Resource, copy the key from the Key column (you may need admin permissions)
   2. Deployment name: Go to the Deployment tab and copy the name under the Deployment name column (we recommend using: text-davinci-003)
   3. Embedding model: Go to Deployment tab and copy the embedding model under the Deployment name column (we recommend using text-embedding-ada-002) 
      • You can read more about the models on the OpenAI site.
   4. Resource name: You can easily find this by clicking your account's icon in the top right corner -> copy what's under the Current resource.
   5. Azure API version: Find this by:
      1. From the Azure OpenAI studio, go to Playground -> Completions.
      2. Click View Code to open a sample code pop-up.
      3. Copy the value next to the openai_api_version key.

Configure via Mulesoft

1. To configure with Mulesoft, follow all the steps for Configure with OpenAI directly
2. You will also need the following:
   1. api key
   2. text completion algorithm
   3. Mulesoft url (resource name)

Limitations

• The ChatGPT integration is only available for Workstation Electron version 1.0 or higher

Character Limitations for Widget Customization

• Title: 22 characters max

• Placeholder: 55 characters max