Chapter 1. Operating OpenShift Lightspeed
There are different ways you can access the OpenShift Lightspeed user interface.
- Clicking the OpenShift Lightspeed chat window floating icon in the lower-right of the screen
- Using the Actions dropdown list on specific resources in the OpenShift Container Platform web console
- Using the Node options icon from a list of resources in the OpenShift Container Platform web console
The following topics provide information about submitting questions to Red Hat OpenShift Lightspeed.
1.1. Using the chat window to ask a question
This procedure explains how to use the Red Hat OpenShift Lightspeed icon to ask a question using natural language.
Procedure
Click the Red Hat OpenShift Lightspeed icon in the lower-right corner of the screen.
This action presents the Red Hat OpenShift Lightspeed user interface.
- Enter a question.
Click the Submit button.
Lightspeed returns information based on your question.
1.2. Using the Actions dropdown list to ask a question
This procedure explains how to use the Actions dropdown list to ask OpenShift Lightspeed a question.
Procedure
-
Navigate to a resource in the OpenShift Container Platform web console. For example, click Workloads
Pods and then click the name of a pod. Click the Actions dropdown list and select Ask OpenShift Lightspeed.
This presents the Red Hat OpenShift Lightspeed user interface.
- Enter a question.
Click the Submit button.
Lightspeed returns information based on your question.
1.3. Using the Node options icon to ask a question
This procedure explains how to use the Node options to ask OpenShift Lightspeed a question.
Procedure
-
Navigate to a resource in the OpenShift Container Platform web console. For example, click Workloads
Pods. Click the Node options icon in the row for a pod and select Ask OpenShift Lightspeed.
This action presents the Red Hat OpenShift Lightspeed natural language interface.
- Enter a question.
Click the Submit button.
The Lightspeed natural language interface returns information based on your query.
1.4. About Lightspeed conversations
OpenShift Lightspeed is designed to answer questions about OpenShift, Kubernetes, and additional OpenShift components, such as OpenShift Virtualization, OpenShift Pipelines, and OpenShift Service Mesh.
OpenShift Lightspeed will not answer questions that are unrelated to the targeted topics. In some cases, you may need to rephrase an ambiguously worded question because OpenShift Lightspeed could not correctly interpret what you asked. Conversation history helps provide context that OpenShift Lightspeed references when generating answers. Using specific language helps increase the success of responses. For example, instead of asking "How do I start a virtual machine?" try asking "How do I start a virtual machine in OpenShift Virtualization?"
Conversation history does not persist if you reload the console page. Reloading the console page performs the same action as clicking the New Chat button. Conversation history is also erased if OpenShift Lightspeed is restarted.
1.5. Providing feedback for a conversation
OpenShift Lightspeed includes an integrated feedback system. This procedure explains how to provide feedback to Red Hat for a specific OpenShift Lightspeed question and response.
Prerequisites
- You have installed the OpenShift Lightspeed Operator and deployed the OpenShift Lightspeed service.
Procedure
- Click the Red Hat OpenShift Lightspeed icon in the lower-right corner of the screen.
- Enter a question into the Send message field:
Click the Submit button.
Lightspeed returns information.
To provide feedback on a particular question and response, click the thumbs up or thumbs down button.
This action presents a field that allows you to enter additional information.
Click the Submit button.
Your rating, any text you entered, the specific question you asked OpenShift Lightspeed, and the response are all sent to Red Hat for review.
1.6. Sample conversation overview
The following examples are intended to serve as samples you can use to start a conversation with OpenShift Lightspeed. In some cases, the conversation includes an initial question and then one or more follow-up questions. Rephrasing questions or asking a more precise follow-up question can help increase the success of the reply.
Some of the examples suggest specific workflows to follow in the user interface. Be sure to ask the follow-up questions without starting a new dialog. OpenShift Lightspeed uses the entire conversation as context, so follow-up questions should help refine answers.
1.6.1. Asking a general question
This procedure shows how to ask OpenShift Lightspeed a general question about the OpenShift Container Platform.
Procedure
- Click the Red Hat OpenShift Lightspeed icon in the lower-right corner of the screen.
Enter the following question into the Send message field:
What is an OpenShift imagestream used for?
Click the Submit button.
Lightspeed returns information that provides an explanation of an imagestream and details about usage.
1.6.3. Attaching a resource object to your question
This procedure explains how to attach a resource object to provide additional context for your question.
Procedure
-
Navigate to a supported resource in the OpenShift Container Platform web console. For example, click Workloads
Pods and then click the name of a pod. - Click the Red Hat OpenShift Lightspeed icon in the lower-right corner of the screen.
- Click the plus icon in the Red Hat OpenShift Lightspeed user interface to attach a resource object.
Select the resource object to attach to the question.
TipYou can attach the following resources:
-
CronJob
,DaemonSet
,Deployment
,Job
,Pod
,ReplicaSet
andStatefulSet
from Workloads in the OpenShift Container Platform web console. -
Alert
from Observe in the OpenShift Container Platform web console. -
Services
,Routes
,Ingresses
, andNetworkPolicies
from Networking in the OpenShift Container Platform web console.
-
- Enter a question.
Click the Submit button.
Lightspeed returns information based on your question.
1.6.4. Using Lightspeed to troubleshoot alerts
This procedure shows how to use OpenShift Lightspeed to troubleshoot alerts.
Procedure
- In the OpenShift Container Platform web console, select the Administrator perspective.
-
Click Observe
Alerting. - Click the AlertmanagerReceiversNotConfigured alert.
- Copy the title and text of the warning.
- Click the Red Hat OpenShift Lightspeed icon in the lower-right corner of the screen.
In the Red Hat OpenShift Lightspeed user interface, enter the following text:
What should I do about this alert?
- Paste the title and text associated with the alert.
Click the Submit button.
Lightspeed references the alert information to provide context when generating the information it returns.
1.7. Starting a new chat conversation
When you ask follow-up questions, OpenShift Lightspeed references the conversation history to provide additional context that influences the replies it generates. Whenever you initiate a new conversation with OpenShift Lightspeed you should clear the chat history.
This procedure explains how to clear the chat history and start a new conversation.
Procedure
In the Red Hat OpenShift Lightspeed natural language interface, click New chat.
This action clears the history of your previous conversation.
- Enter a question.
Click the Submit button.
OpenShift Lightspeed only references the new question when generating a response.