Skip to main content
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. 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.

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.

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, and on a proposal 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.