> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utilified.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Joule

> Joule is the AI assistant built into UMS. Ask it about your data, get answers as tables, charts and links, and approve any changes it proposes.

Joule is the AI assistant built into UMS. Ask it about your accounts, sites, connections, invoices, agreements and more, in plain English. It answers from your organisation's live data and can make changes for you once you approve them.

## Open Joule

* Click the Joule button beside your name at the bottom of the sidebar.
* Or press **⌘J** (Mac) / **Ctrl+J** (Windows and Linux). The same shortcut closes it.

Joule opens in a panel beside the page you're on, so you can keep working while it answers.

### Ask Joule from search

Type a question into search (**⌘K** / **Ctrl+K**), then choose **Ask Joule: "…"** or press **⌘↵** / **Ctrl+↵**. A new Joule conversation opens with your question. See [Navigating UMS](https://docs.utilified.com/getting-started/navigating-ums.md#search).

## Start a conversation

A new conversation greets you and offers suggested prompts for the page you're on. For example, on **Invoices** you'll see prompts such as "Find unpaid invoices", and on **Agreements** "Show expiring soon". On a record's page, Joule offers to answer anything about that record. Click a prompt or type your own question in **Ask Joule...**, then press `Enter`.

Joule knows which page and record you're looking at, so you can ask "what's wrong with this invoice?" without naming it.

## Conversations

Joule keeps your past conversations.

| Control | What it does |
| - | - |
| **Conversation history** (panel header) | Opens **Conversations**, your past conversations. Click one to pick it up again, or delete it. |
| **New conversation** | Starts a fresh conversation. Available in the panel header and on the **Conversations** list. |
| **Close panel** | Closes Joule. Your conversation is kept. |

## How Joule answers

Joule replies in text, and adds visual answers where they help:

* Tables of records, such as a list of invoices or connections
* Charts of trends, such as spend or usage over time
* Record cards and summary figures for a single account, site or invoice
* Links that take you straight to the page it's talking about

## What Joule can see and do

Joule works as you. It can only see the records you can see in UMS, and it follows the same permissions as your role.

### Making changes

If your role lets you create or edit records, Joule can propose changes as well as answer questions. If your role is read-only, Joule only reads.

Joule never changes anything without your approval:

**1. Joule proposes a plan**

A plan card lists each change Joule wants to make and the values it will use. Steps marked **Irreversible** can't be undone.

**2. You approve or cancel**

Click **Approve** to let Joule run the plan, or **Cancel** to stop.

**3. Joule runs only what you approved**

Your approval covers only the steps in that plan, for a short time. An irreversible step runs once, exactly as shown (**Runs exactly as shown**). For other steps, Joule may adjust the values while the plan runs (**Proposed values (Joule may change them while the plan runs)**).

## Solar and battery studies

On a completed solar and battery study in [Scenarios](https://docs.utilified.com/scenarios.md), and on a [proposal](https://docs.utilified.com/proposals.md) built from one, Joule is a co-pilot. It knows the recommended system, the shortlist, the objective and any warnings, and suggests questions that fit the study, such as:

* "Why was this system recommended?"
* "Why no battery?" and "What would make the battery pay?"
* "Compare the top two options"
* "Explain this warning"
* "What changes if we optimise for payback?"
* "Draft an RFQ email for installers"

Each question only appears when the study has an answer for it. Solar and battery studies need modelling and DER-modelling access for your organisation, and proposals need proposal access.

## Limits

* A message can be up to 4,000 characters.
* Each person has a daily Joule usage limit. If you reach it, Joule tells you, and the limit resets at midnight Sydney time.
* If you send many messages quickly, Joule asks you to wait a moment.
* A very long conversation can't continue. Start a new one.

## Related

* [Contact Utilified](https://docs.utilified.com/help.md) for help from the Utilified team
* [Connect Claude and other AI assistants](https://docs.utilified.com/mcp-connector.md) to use your UMS data from outside the app


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.