> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Assistant interface reference
> Reference for the controls, message elements, and keyboard shortcuts in the Chronosphere Assistant.
export const AddToDashboardIcon = props => {
return ;
};
export const CollectionIcon = props => {
const drawPath = "M21 6.5c-1.66 0-3 1.34-3 3 0 .07 0 .14.01.21l-2.03.68c-.64-1.21-1.82-2.09-3.22-2.32V5.91C14.04 5.57 15 4.4 15 3c0-1.66-1.34-3-3-3S9 1.34 9 3c0 1.4.96 2.57 2.25 2.91v2.16c-1.4.23-2.58 1.11-3.22 2.32l-2.04-.68C6 9.64 6 9.57 6 9.5c0-1.66-1.34-3-3-3s-3 1.34-3 3 1.34 3 3 3c1.06 0 1.98-.55 2.52-1.37l2.03.68c-.2 1.29.17 2.66 1.09 3.69l-1.41 1.77C6.85 17.09 6.44 17 6 17c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3c0-.68-.22-1.3-.6-1.8l1.41-1.77c1.36.76 3.02.75 4.37 0l1.41 1.77c-.37.5-.59 1.12-.59 1.8 0 1.66 1.34 3 3 3s3-1.34 3-3-1.34-3-3-3c-.44 0-.85.09-1.23.26l-1.41-1.77c.93-1.04 1.29-2.4 1.09-3.69l2.03-.68c.53.82 1.46 1.37 2.52 1.37 1.66 0 3-1.34 3-3S22.66 6.5 21 6.5zm-18 4c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1zM6 21c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1zm5-18c0-.55.45-1 1-1s1 .45 1 1-.45 1-1 1-1-.45-1-1zm1 12c-1.38 0-2.5-1.12-2.5-2.5S10.62 10 12 10s2.5 1.12 2.5 2.5S13.38 15 12 15zm6 4c.55 0 1 .45 1 1s-.45 1-1 1-1-.45-1-1 .45-1 1-1zm3-8.5c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1z";
return ;
};
export const CollectionNavIcon = props => {
const drawPath = "M8.4 18.2C8.8 18.7 9 19.3 9 20C9 21.7 7.7 23 6 23S3 21.7 3 20 4.3 17 6 17C6.4 17 6.8 17.1 7.2 17.3L8.6 15.5C7.7 14.5 7.3 13.1 7.5 11.8L5.5 11.1C5 11.9 4.1 12.5 3 12.5C1.3 12.5 0 11.2 0 9.5S1.3 6.5 3 6.5 6 7.8 6 9.5V9.7L8 10.4C8.6 9.2 9.8 8.3 11.2 8.1V5.9C10 5.6 9 4.4 9 3C9 1.3 10.3 0 12 0S15 1.3 15 3C15 4.4 14 5.6 12.8 5.9V8.1C14.2 8.3 15.4 9.2 16 10.4L18 9.7V9.5C18 7.8 19.3 6.5 21 6.5S24 7.8 24 9.5 22.7 12.5 21 12.5C19.9 12.5 19 11.9 18.5 11.1L16.5 11.8C16.7 13.1 16.3 14.5 15.4 15.5L16.8 17.3C17.2 17.1 17.6 17 18 17C19.7 17 21 18.3 21 20S19.7 23 18 23 15 21.7 15 20C15 19.3 15.2 18.7 15.6 18.2L14.2 16.4C12.8 17.2 11.2 17.2 9.8 16.4L8.4 18.2Z";
return ;
};
export const ServiceIcon = props => {
return ;
};
export const ServiceNavIcon = props => {
return ;
};
export const CSharpIcon = props => ;
export const PipeIcon = props => ;
export const AiMessageIcon = props => ;
This feature is in Early Access (EA), and might not be visible in your app. To learn
more about this program and the features it contains, see the
[Early access](/early-access) page.
The [Assistant](/navigate/assistant) presents the same conversation in two
surfaces in Chronosphere Observability Platform: a side panel that stays open as
you move between pages, and a full page. Use this reference to identify the controls
in each surface, the elements that make up a conversation, and the keyboard shortcuts
that the Assistant supports.
## Panel and page controls
### Side panel header
The side panel header displays the **Assistant** title and these controls:
* ** Copy URL** copies a link to the current conversation.
This control appears only after you send a message, and doesn't appear for
accounts in [temporary mode](/navigate/assistant#availability-and-permissions).
* ** New chat** starts a conversation, ending any
response in progress.
* ** Chat history** opens a searchable list of your recent
conversations. Enter text in **Search chats** to filter the list. When no
conversation matches, the list displays `No chats found`.
* ** Go to chat page** moves the current conversation to
the full-page view.
* ** Close Panel** closes the panel.
### Full page controls
The full page displays the **Assistant** header and a **Chat history** sidebar
containing:
* ** New chat**, which is selected when no conversation
is open.
* A **Recents** list of your saved conversations, most recently updated first.
* ** Close chat history**, which collapses the
sidebar to a rail. The rail displays ** New chat** and
** Open chat history**.
## Message field
The message field accepts multiple lines and expands as necessary. To enter a
manual line break, press Shift + Enter (Shift +
Return on macOS).
### Slash commands
Type `/` at the start of the field to open a menu of
**[Skills](/navigate/assistant/capabilities#skills).** Each entry lists the
command and a description of what it does. Continue typing to filter the menu,
use the arrow keys to select a command, and press Enter
(Return on macOS) or click a command to insert it.
### Send and stop
The circular button at the right of the message field reflects the state of the
conversation:
* ** Send message** submits your prompt.
* ** Stop generating** ends a response in progress.
### Context gauge
When a conversation has consumed part of its context window, a gauge appears next
to the message field displaying the percentage used. Hold the pointer over the
gauge to view a precise token usage count.
The gauge changes color and message as usage increases:
* Under 80%, it reports the percentage and token count.
* At 80% or higher, it turns amber and advises you to clear the chat soon.
* At 100%, it turns red, reports that the context window is full, and advises you
to clear the chat or start a new thread to continue.
Start a [new chat](#side-panel-header) to reset the context window.
## Conversation elements
A conversation alternates between messages you send and responses from the
Assistant. Responses can contain several element types.
### Your messages
Your messages display in a shaded block. When the page you're on differs from the
page of your previous message, a chip preceding the message names the page
context, such as **Dashboard**, **Alert**, or **Metrics explorer**. Hold the
pointer over the chip to view the full URL, which you can click to open in a new
tab. For more information, see
[Page context](/navigate/assistant#page-context).
### Reasoning
While the Assistant works out its approach, it displays animated `Thinking...`
text, or the current step of its reasoning. After it finishes, the reasoning
collapses into a row reporting how many seconds it thought for, which you can
expand to inspect in full.
### Tool calls
The Assistant displays each search, query, and command it runs. A single step
displays as its own row. Two or more consecutive steps collapse into one group
labeled **Ran** followed by a count of tool calls, commands, or both.
Groups expand automatically while the Assistant is working and collapse when it
finishes. Click a group to change its state.
Each step displays its status:
* A spinner while the step is running.
* A green check icon with the step name struck
through after it completes.
Expand a step to view its **Input:** and **Output:**. Shell commands display the
command that ran, prefixed with `$:`, followed by its output. Failed commands
display their error output in red.
Steps that use a [skill](/navigate/assistant/capabilities#skills) name the skill
and report whether the Assistant is using it, used it, or failed to use it. Expand
a failed skill to view the error.
### Code blocks
The Assistant returns queries and structured data in code blocks labeled with
their language. Every code block has a ** Copy code** button.
Code blocks that contain a query also have an **Open in Explorer** button, which
opens the query in the matching explorer with the time range the Assistant used.
This button appears for PromQL, logging queries, change event queries, and
Graphite queries.
Long blocks scroll rather than expanding the conversation. While the Assistant is
still writing a long block, the block header displays `Generating...`.
### Timestamps
The Assistant writes timestamps as chips formatted in your account's
[time zone and clock preferences](/navigate#your-account).
### Investigation cards
When the Assistant starts or checks a deep investigation, it displays an
**Investigation** card rather than raw output. The card names what's being
investigated, such as a dashboard panel or an alert, and displays a status:
* **Investigation in progress**, which displays `Starting investigation` as its
initial summary
* **Report ready for review**
* **Investigation complete**
* **Investigation incomplete**, when the investigation fails
Click **View full investigation** to open the investigation in a new tab.
## Rate a response
Each completed response displays rating controls:
1. Click ** Helpful** or
** Not helpful**.
2. Optional: Add detail in the **Tell us more about your feedback** dialog, and
then click **Submit rating**. To record only the rating, click **Cancel**.
Ratings are recorded per response, and you can't change a response after
submitting it.
## Manage conversations
Unless your role prohibits it, Assistant saves your conversations. You can
[resume](#resume-a-conversation) or [share](#share-a-conversation) your saved
conversations from the [chat history](#side-panel-header).
### Resume a conversation
To resume a saved conversation, open [chat history](#side-panel-header) and select
it. Unless your account is in
[temporary mode](/navigate/assistant#availability-and-permissions), the chat
history retains your 20 most recent conversations.
Observability Platform names each conversation after your first message in it,
truncated if the message is long. You can't rename, delete, or export
conversations.
### Share a conversation
To share a conversation, click ** Copy URL** in the side
panel header, or copy the URL of the Assistant page while the conversation is
open. Observability Platform displays `Copied` to confirm.
When another account opens the link, the conversation appears read-only with an
alert naming the account that shared it. The message field doesn't appear, so
recipients can't continue a conversation you shared. To ask their own questions,
they can start a new chat.
Accounts in [temporary mode](/navigate/assistant#availability-and-permissions)
can't share conversations.
## Errors
When a response fails, the Assistant displays a **Couldn't get a response** alert
next to the message field with **Try again** to resubmit your prompt. The alert
describes the cause:
| Message | Cause |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `We could not reach the assistant. Check your connection and try again.` | Observability Platform couldn't reach the Assistant service. |
| `The assistant rejected this request. If the issue persists, clear the chat or start a new thread.` | The Assistant refused the request, which often indicates a full context window. |
| `Something went wrong. Please try again.` | Any other failure. |
## Keyboard shortcuts
The following table lists the Assistant's supported keyboard shortcuts:
| Shortcut | Action |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| A | Open or close the Assistant side panel. Unavailable on the Assistant page. |
| / | Open the slash command menu, when typed at the start of the message field or after a space. |
| Enter (Return on macOS) | Send the prompt, or accept the selected slash command when the menu is open. |
| Shift+Enter (Shift+Return on macOS) | Insert a line break without sending. |
| Control+Enter (Command+Return on macOS) | Send the prompt. |
To view the shortcuts available on the current page, press Control+/
(Command+/ on macOS).