Chapter 1. Troubleshooting OpenShift Lightspeed

Wait for service pods to finish starting to avoid 502 Bad Gateway errors.

Wait a few minutes after deploying OpenShift Lightspeed and OpenShift Container Platform before trying the interface again.

The OperatorHub displays the OpenShift Lightspeed Operator only for supported architectures. Filtering prevents the Operator from appearing on anything other than the x86_64 architecture.

Reasoning models use tags such as THOUGHT or reasoning to separate inner logic from the final answer.

OpenShift Lightspeed does not control these tags or add them to the output. This feature is part of the model itself.

Use the status codes and error details to identify and resolve common authentication failures when connecting to the OpenShift Lightspeed API.

To resolve the Prompt is too long error, adjust the model parameters or reduce the input length for the query to fit within the supported context window.

This error occurs when the total number of tokens (the input query, RAG context, and expected response) exceeds the model context window.

To resolve truncated or incomplete model responses, increase the response token limit or use follow-up prompts to retrieve the remaining content.

This issue occurs when the model reaches its pre-configured response token limit.

To maintain conversation history, optimize the balance between the context window and response tokens. This prevents earlier dialogue from being truncated when the model reaches its context limit.