Skip to content

Assistant ​

The assistant is a chat beside every page of the console. Ask it how to do something, ask about your own jobs and customers, or hand it a spreadsheet to bring in. It looks things up for you, and when something should change it shows you a card to check first. Nothing in your records changes until you confirm a card.

Open it with the Ask button at the bottom right of any page, or press Cmd+J (Ctrl+J on Windows). It stays open as you move between pages and knows which page you are on, so "what does this page do?" works anywhere.

What you can ask ​

  • How-to questions. "How do I send a report to council?" It answers from this guide and links the section it used.
  • Your business. "How many jobs are there today?", "What's booked tomorrow?", "Which systems are due in the next 30 days?", "Find the sites in Kandanga." It reads your own records to answer, and only what your role is allowed to see.
  • A customer or a job. "Tell me about Helen Marsh" brings back her sites and tanks, when each is due, her jobs, what she owes, her quotes and recent texts. "What happened on JOB-1042?" gives the field notes, inspection answers, litres pumped, defects and the invoice.
  • Money. "Who owes us money?" lists what is owing and overdue, aged 1 to 30, 31 to 60, 61 to 90 and over 90 days, with the customers who owe the most. It also answers about quotes waiting, accepted or declined.
  • Figures. "How did October go?" gives jobs completed by type and by technician, litres pumped, amounts invoiced and received, quotes won and new customers.
  • Things people wrote. "Which sites have a dog?", "Has anyone complained about a smell?" It searches field notes, office notes, site access and hazard notes, defects, quote notes and texts from customers, and matches close words such as "odour" for "smell".
  • The team, defects and council reports. "Who's free on Thursday?", "What high defects are open?", "Are any council reports overdue?"

Names don't need to be exact. "marsh helen", "41 Kenilworth Rd" and a mobile typed with or without spaces all find the right record, and a near miss such as "Helen Marsch" still finds her. Records it mentions are links, so one click opens the customer, job, invoice, quote or defect beside the conversation.

  • Planning runs. "Help me plan routes for this week." It groups the jobs waiting for a date into day runs by area, explains them, and offers one card per run with the technician, date, start time and stops in driving order. Book run gives those jobs their times on the schedule.
  • Adding records. "Add Jan Brook, 0412 345 678, 4 Ridge Road Kandanga, septic tank pumped March last year, every three years." It shows the customer, site and system it would add.
  • Changing records. "Update these customers from my spreadsheet" or "delete the duplicates". See Change records you already have.
  • Business details. It can fill in your ABN, billing email, GST registration, environmental authority number and time zone.

Bring in a spreadsheet ​

  1. Export your customer list from your old system or Excel. One row per site is best: the customer's name and contact details, the site address and suburb, and any tank details such as type, last pump-out and how often it is pumped.
  2. Choose the paperclip and pick the file, then send. CSV and Excel (.xlsx) files both work.
  3. The assistant reads the columns and shows a card: how many customers, sites and systems it would add, a preview of the first few, and any rows that need a look.
  4. Choose Add them, or tell it what to change first ("the Freq column is in months").

What it takes care of:

  • A customer with several sites, on several rows, becomes one customer with several sites.
  • A customer or site that is already in Rangefront is matched by customer ID, email or name, not added twice.
  • Dates are read day first, the Australian way, including dates saved as spreadsheet numbers.
  • "AWTS", "aerated treatment plant" and similar become the right system type.
  • The next due date is worked out from the last pump-out or service and the interval, when the file does not have one.
  • Customer, site and system numbers are given out from your own series.

Every import can be undone. Choose Undo on the card, or roll it back later from Admin, Import, where each one is listed.

Files can be up to 8 MB and 10,000 rows. Only the first sheet of an Excel file is read, and the first row must be the column headings. Older .xls files need Save as .xlsx or CSV first. The importer in Admin, Import takes the same files.

Change records you already have ​

Say a customer list came across from Xero and you have a spreadsheet with better details. Attach the sheet and say what you want: "Update these customers' phone numbers and emails, matching on customer number." The assistant looks the records up and puts the whole job into one card for you to review. Nothing changes until you press the button at the bottom.

The card shows:

  • Updates. Each record with every change as old value, then new value. Customers, sites and systems can be changed: names, email, phones, notes, billing and site addresses, access and hazard notes, system type, dates, service intervals and status. When a pump-out date or interval changes, the next due date is worked out again and marked as such.
  • Deletions. These sit first, in red. Deleted records are not gone for good: they can be recovered from Admin, Deleted items, or with Undo on the card. A note says what stays behind, such as a customer's sites or open jobs.
  • New records. Customers, sites and systems to add, if the sheet has some that are not in Rangefront yet.
  • Need a look. A row that matches more than one record, or none, is listed here and left alone. The assistant never guesses. Tell it which record you meant and it prepares that row again.

The line at the top counts what is ticked, for example "12 changes to 5 records, 2 deletions". Untick a whole record, or just one change on it, and the count follows. Blank cells in a spreadsheet change nothing, so a half-filled column will not wipe out details.

Press Apply changes to make the ticked ones. Each change is recorded in the audit log. Undo puts the old values back. If someone has edited a record since, Undo leaves that field as it is and says how many it left. You need the permission to edit each kind of record; if your role cannot edit sites, the card says so.

Set up a new business ​

A new business can set up by talking it through. After sign-up the assistant asks what the business is called, how many people work in the field and the office, about your trucks (name, registration, tank size), the depot address, who to invite, and whether you want to bring data across from Xero, QuickBooks, a spreadsheet, or a Google or Outlook calendar. Most questions are a tap. Anything it wants to save shows as a small card to confirm: nothing is saved until you press its button.

Beside the chat, What we've set up lists the business, depot, trucks, team and your data. Open any item to change it by hand. The assistant is told when you do, so it carries on from what is true now. Fill in a form instead switches to the step-by-step forms at any point, and Finish takes you to your schedule or dashboard.

If the assistant is not available (it is off, the account has no AI key, or this is the demo), setup uses the forms. You can also open the assistant later from Setup with the assistant and the forms from the welcome page.

Conversations ​

Each person has their own conversations, which nobody else can open. The pencil at the top of the panel starts a new one, and the clock lists your earlier conversations so you can pick one up again. The setup conversation is kept separately from the one in the panel.

Answers appear as they are written. While the assistant looks something up, each lookup shows with a tick once it is done, and folds into one line when the answer is in. If you scroll up to read while it is still writing, the panel stays where you are; the arrow above the message box takes you back to the newest line.

On a wide screen the panel sits beside the page, and the page narrows to make room. On a smaller screen it opens over the page.

Limits and privacy ​

The assistant uses Claude, from Anthropic, and counts towards the company's monthly AI limit like the other AI features. It needs the Use AI permission and AI switched on in Admin, AI. See AI for what data is sent and how to turn it off.

The assistant can be wrong. Check a card before you confirm it.

Connect an AI agent ​

You can also let Claude, or any AI agent that supports MCP (Model Context Protocol), read your business from outside the console. It gets the same lookups as the assistant, and it can't change anything.

  1. Open Admin, AI. You need the Manage AI permission.
  2. Under AI agents, name a key and choose Make a key. Copy the key straight away; it is shown once.
  3. In your agent, add an MCP server using the server address shown, with the key sent as a Bearer token. For Claude Code, Copy Claude Code command gives you the whole command to paste into a terminal.

A key reads with the permissions of the person who made it. If that person leaves or is made inactive, their keys stop working. Revoke a key from the same list when you no longer need it. Keys only work while the company's account is active and AI is switched on.