Zelos AI¶

Zelos AI is the assistant inside the Zelos desktop app. It can inspect the current workspace, query live or recorded telemetry, change workspace views, work with notebooks, and answer questions about Zelos using the documentation for your app version.

Zelos AI is designed for Zelos work: telemetry, the current workspace, the desktop app, Zelos Cloud, the SDK, the CLI, and extensions. It does not act as a general-purpose assistant for unrelated topics.

Open Zelos AI¶

Open AI Chat from the app sidebar. You must be signed in to an organization. If AI Chat is not present, see Zelos AI is unavailable.

You can also ask from Home: typing there starts a new chat and shows it in the sidebar, already sent. To continue the chat you already have, use the box in the sidebar.

The opening suggestions adapt to the workspace:

With a trace open, ask what happened, find unusual behavior, compare around the cursor, run checks, or build an analysis layout.
With live data connected, ask what is happening now, which signals are worth watching, what changed recently, or for a live monitoring layout.
With no data source, ask Zelos AI to open a .trz file or connect to an agent such as localhost:2300.

Press Enter to send and Shift+Enter for a new line. While Zelos AI is working, select Stop to stop the turn.

Find or return to a chat¶

The AI Chat root shows your recent chats below the new-chat hero and composer. Use the rail search to filter those chats by title. While a term is present, Zelos hides the hero, composer, and any open conversation so only matching recents remain. Clear the term to return to the conversation you were viewing.

Press ↓ in the search field to enter the recent-chat list, then use ↑ and ↓ to move between rows. Opening a result ends the search and shows that chat.

An open chat's detail header names the conversation. Its Back to Chats icon or Esc returns to the root, and its ⋮ offers the same Rename, Archive, and Delete actions as the chat's row in Recents. Rename edits the title in the header.

Ask a question about telemetry¶

State the outcome and time range you care about. Useful prompts include:

What caused the current spike? Compare pack current and cell voltage over the last 30 seconds.

Find every fault or diagnostic signal in this trace and tell me what changed first.

Check whether cell temperature stayed below 60 °C over the visible range.

Zelos AI discovers signals before querying them and reports the signals and time range used as evidence. A diagnostic conclusion is still an interpretation of the available data, not a replacement for your system's safety process.

Data and time scope¶

Zelos AI works in the current workspace mode:

Live — data from the connected agent or agents.
Trace — data from the open .trz file or files.
None — no telemetry is available until a trace is opened or an agent is connected.

Words such as "now," "the last minute," and "around the cursor" refer to the workspace timeline, not the current calendar time. If a requested range falls outside the loaded data, Zelos AI should report that limitation rather than extrapolate.

Build or change a workspace view¶

Ask in terms of the result you want:

Create a tab named Thermal Review with plots for every cell temperature and a value panel for the maximum.

Zelos AI can:

create, activate, and rename layout tabs;
create panels, add or remove signals, rename panels, and change supported display options;
move the time cursor, set the visible time range, control playback, and return a live workspace to the live tail;
connect or disconnect live agents and open or close trace files;
run extension actions exposed by a connected agent.

The current workspace is supplied to Zelos AI at the start of every turn. If a panel, tab, trace, or signal is not present in that snapshot or returned by a tool, Zelos AI should discover it before acting rather than guess its identifier.

Create and edit notebooks¶

Use a notebook when you want a durable, repeatable analysis rather than a chat answer:

Create a notebook that finds the weakest battery cell, charts it, and records the pass/fail threshold.

Every Python cell has an Ask AI button that opens the chat with that cell attached, ready for your question; a cell that failed also offers Fix with AI.

A failed Python cell with Fix with AI and Ask AI in its toolbar — A cell that raised offers **Fix with AI** beside **Ask AI**.

The AI composer with a cell attached as a chip above an empty prompt — The cell rides along as a chip; you type only your question.

Zelos AI can create notebooks, read and edit cells, run cells, inspect kernel state, retrieve full cell output, and interrupt a run. Notebook code runs on your machine, so the app asks for permission before the assistant creates, edits, or runs a notebook.

The confirmation offers two scopes:

Just once permits that notebook operation for the current turn.
Allow for this conversation permits work on that notebook for the rest of the chat. A different notebook asks again.

Assistant messages that changed a notebook offer an Undo action while the saved checkpoint is still safe to restore. Undo restores the document; it does not rewind the Python kernel, so restored cells appear stale until run again.

Ask how to use Zelos¶

Ask concrete product questions using the name of the screen, command, or API:

How do I share a trace with my organization?

Does SignalFrame.to_pandas put time in a column or in the index?

For product questions, Zelos AI searches the published documentation for the installed app version before answering and links the supporting pages. A link supports only the claim covered by that section. If the documentation does not establish an answer, Zelos AI should say so instead of filling the gap from memory.

Confirmations and safety¶

Zelos AI uses the action's declared effect to decide whether it can run without approval.

Operation	What happens
Read telemetry or documentation	Runs without confirmation.
Add or adjust ordinary workspace views	Runs immediately and remains visible in the workspace.
Delete panels, close a trace, or disconnect the only live agent	The app shows a confirmation before continuing.
Create, edit, or run a notebook	The app asks for notebook-scoped permission.
Run an agent or extension tool that can write state or operate hardware	The app shows a confirmation before continuing.

Read the confirmation text, then choose Confirm or Cancel. For notebooks, choose Just once, Allow for this conversation, or Deny. Zelos AI does not need a second typed confirmation in chat; the confirmation card is the approval boundary.

An extension action can reach real hardware. A failed action may still have had an effect, and a timed-out action can have an unknown outcome. When Zelos AI reports an unconfirmed outcome, verify the target state before retrying so the command is not issued twice.

Review, revise, and undo a conversation¶

Hover a message to reveal its actions. Depending on the message, you can:

copy the message;
edit one of your prompts and regenerate from that point;
regenerate the latest response;
reset the workspace to the checkpoint captured before a prompt;
undo notebook document changes made by an assistant turn;
rate an answer with Good response or Bad response;
save an answer as a notebook.

Recent chats are scoped to your account and selected organization. Use either a recent row's menu or the open chat's header menu to rename, archive, or permanently delete a thread.

Limitations¶

Zelos AI can inspect only data available in the current workspace and through its listed tools. It cannot infer missing samples or unrecorded hardware state.
Signal and event results are bounded. Broad requests may require several tool calls, and stopping a long turn can leave an already-started operation to finish in the background.
Product answers are bounded by the published documentation. Missing, stale, or conflicting documentation can produce an incomplete answer; inspect the cited section when the distinction matters.
Workspace changes happen in the desktop app. Organization administration, billing, AI credit management, and cloud resource management happen in the console.
The model can make mistakes. For a consequential decision, ask it to name the signals, range, checks, and documentation used, then verify those inputs.

Troubleshooting Zelos AI¶

Zelos AI is unavailable¶

Confirm that you are signed in and have an active organization. AI can also be disabled by an organization owner, by Zelos, or by a temporary rollout or service restriction. An owner can inspect AI controls in Zelos Cloud → Billing; owners and admins can inspect organization usage under AI usage.

Out of AI credit¶

The chat shows Out of AI credit and offers Open billing. Only an organization owner can manage billing or buy credits. Ask an owner if you do not see the Billing page.

The request is rate limited or the provider connection drops¶

Wait briefly and retry. Use Try again on a chat that failed to load. If the same telemetry tool fails again with the same arguments, change the range or signal selection instead of repeating an identical request.

A confirmation is waiting¶

Open AI Chat and respond to the confirmation card. A pending confirmation keeps the turn open; a hidden chat cannot approve itself.

The answer used the wrong data¶

Check the current workspace mode, open traces, connected agents, cursor, and visible range. Then ask Zelos AI to name the exact signals and range it queried. Rephrase the request with explicit signal names or a bounded time range.