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, or press Cmd+L (macOS) or Ctrl+L (Windows/Linux). The AI Chat item appears only when Zelos AI is available to your account. If it is not present, see Zelos AI is unavailable.

Zelos AI needs you to be signed in and to belong to an organization. While you are signed out, the view shows Sign in to chat with Zelos with a sign-in button. When you are signed in without an organization, it shows No organization yet.

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.

A new chat shows a greeting and a row of suggestions. When a trace is open, a line under the greeting names it. Selecting a suggestion puts its full prompt in the composer, so you can edit it before you send it. The suggestions depend on what is in front of you, checked in this order:

Workspace state	Suggestions
A notebook tab is active	Explain this, Run it, Fix the errors, Add a chart, Tidy the prose
A trace is open	What happened?, Read the logs, Build me a view, Did it pass?, Write it up
Live agents are connected	What's live?, Watch the logs, Live dashboard, Health check, Last minute
No data source	Open the latest, My notebooks, Connect live, New notebook, What can you do?

What each suggestion asks:

Explain this explains the active notebook cell by cell. Run it runs every cell in order and reports what succeeded and failed. Fix the errors diagnoses and fixes failed cells, then runs them again. Add a chart adds and runs a plot of the most informative signal. Tidy the prose rewrites the notebook's prose and leaves the code alone.
What happened? summarizes the trace as an investigation report. Read the logs reads the trace's event tables and leads with errors and warnings. Build me a view creates an analysis layout. Did it pass? proposes pass/fail checks and runs the well-justified ones. Write it up investigates the trace and records the findings in a notebook with its cells run.
What's live? summarizes the live system state. Watch the logs reads the most recent entries in the live event tables. Live dashboard creates a compact live monitoring layout. Health check runs live sanity checks. Last minute analyzes the last minute of live data.
Open the latest opens the most recent trace in your organization and summarizes it. My notebooks lists the notebooks published in your organization. Connect live connects to localhost:2300 and checks that live signals are flowing. New notebook creates a notebook to start an analysis in. What can you do? searches the documentation for a short tour of what Zelos AI can do.

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

The chat takes text. A pasted or dropped image or file is not sent. The app shows Images and files can't be sent to Zelos AI when it happens. Paste the text itself, or describe what you see.

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, including showing full signal names so signals with the same name from different sources can be told apart;
move every panel from one source or signal to another in one step, across a tab or the whole workspace — after a bus rename, or to point a layout at another unit — keeping each panel's position, colors, and formats;
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;
list the traces and notebooks in your organization's Zelos Cloud library, open a cloud trace, read a published notebook, and open a published notebook in a read-only tab;
find the marketplace extension that does a job, then install, configure, start, and stop extensions, open an app extension, read their logs, and run the actions they expose — for example, converting a CAN log to a .trz with the CAN extension's Convert CAN Log action, which runs without starting the extension.

Zelos AI sees a snapshot of the current workspace, refreshed before each step it takes. A very large workspace is shortened to fit, other tabs before the active one, and the snapshot says what it left out; Zelos AI reads a tab in full when it needs one. It checks that a signal exists before binding it to a panel: a signal your sources do not have is reported with the closest real names instead of being added. If a panel, tab, trace, or signal is not in the 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.

In a notebook you can edit, every Python cell has an Ask AI button. It opens the chat with that cell attached, ready for your question. A cell that failed also offers Fix with AI. To detach the cell before you send, select the X on its chip.

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, interrupt a run, and read or set a notebook's tags. 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.

While a conversation holds this permission, the composer shows a badge such as 1 notebook allowed. Select it to see the notebooks, and select the X beside one to revoke it. A revoke applies to the next tool call. It does not stop a run that has already started.

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, documentation, extension details, or the cloud library	Runs without confirmation.
Add or adjust ordinary workspace views	Runs immediately and remains visible in the workspace.
Delete panels or close a trace	The app shows a confirmation before continuing.
Disconnect the only connected agent	The app shows a confirmation before continuing. Disconnecting one of several agents does not ask.
Install, start, stop, restart, or configure an extension	The app shows a confirmation before continuing. Configuring saves the settings, then starts the extension or restarts it if it is running.
Replace all of a notebook's tags	The app shows a confirmation before continuing. Adding tags does not ask.
Create, edit, or run a notebook	The app asks for notebook-scoped permission.
Run any other agent or extension tool that is not read-only, such as an extension action	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, AI settings, 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 belong to an organization. AI can also be turned off for an organization by its owner or by Zelos, or be off for everyone for a short time. While AI is off for your organization, the AI Chat item does not appear in the sidebar. If an owner turned it off, an organization owner can turn it back on in the console. If Zelos turned it off, owners cannot. Owners and admins can see the organization's usage under AI usage in the console.

A chat shows an error¶

An error appears as a banner above the conversation. Select the X to dismiss it. The banner says what went wrong:

Message	What to do
AI is disabled for this team. Ask the team owner to re-enable it.	Ask an organization owner to turn AI back on in the console.
AI is temporarily unavailable. Try again in a few minutes.	Wait, then send the message again.
Too many requests in a short window. Wait a moment and try again.	Wait a moment, then send the message again.
The AI provider connection dropped before the response finished. Try again in a moment.	Send the message again, or regenerate the response.
A request to verify your email	Select Verify email, verify your address in the console, then send the message again.
Out of AI credit	The organization has no AI credit left. Select the button on the banner to open the console, or ask an organization owner to add credit.
Chat error: followed by a message	Read the message. Send again once the cause is fixed.
Sign in again to chat.	Your session ended. Sign in again.
Couldn't start a new chat.	Send the message again.

A chat that fails to open shows a full-pane state instead:

AI is unavailable means the app cannot reach the Zelos agent. Restart the desktop app.
Couldn't load this chat means the conversation's history did not load. Select Try again, open a different chat, or start a new one.

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.