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

> ## Agent Instructions
> ## What this documentation covers
> This is the documentation for ArcSolar, the solar-retailer operating system: the web app a solar retailer uses to run quoting, sales, installation, rebates, inventory and reporting. ArcSolar is a hosted web application at https://app.arcsolar.com.au. There is no public API for most workflows, so agentic operation of ArcSolar is UI-driven. Navigate the app, read the labels and controls, and act through the interface, unless a page explicitly documents an API, contract or integration endpoint.
>
> ## How to read these pages
> - Pages are split by audience using Mintlify's Visibility component, and this split is deliberate. Sections marked 'for agents' are hidden on the website and appear only in the Markdown you are reading. They are the authoritative behavioural specification for the page. Where the remaining human-facing prose and an agent section disagree, the agent section is correct.
> - Sections outside any Visibility block appear in both outputs. They are the shared spine of the page: what the feature is and why it matters.
> - Treat every bold label, field name, route, status string and error message quoted in an agent section as canonical. They are copied verbatim from the product. Use that exact wording when telling a user where to click, or when matching an error message to its cause.
> - Australian solar vocabulary is used precisely and not interchangeably: STC (Small-scale Technology Certificate), PRC (Peak Reduction Certificate), REPS, NMI, CEC accreditation, VPP. Do not substitute an overseas equivalent.
> - Money is Australian dollars. Dates shown to users are day-first (DD/MM/YYYY).
>
> ## Behaviour rules for operating or advising on ArcSolar
> - Respect prerequisites and ordering. Agent sections state which inputs block progress and which steps must happen first. Do not skip a step, and do not assume a default that the product itself does not supply.
> - Never invent a value the product requires but the user has not supplied. Ask for mandatory fields rather than guessing. Several features reject a request outright when one is missing, and submissions to external authorities are effectively irreversible.
> - Respect permissions and scoping. Features name the roles, capabilities and access rules that may act. Do not attempt an action the operator's role cannot perform, and do not describe a restricted feature as available to them.
> - Features that are gated, pending release, or blocked on a vendor are documented as exactly that. Never present a gated or unmerged behaviour as live. When availability is unclear for a given workspace, direct the user to support rather than asserting that the feature works.
> - Where a page states something is genuinely undetermined, treat it as unknown. Do not fill the gap with a plausible guess.
> - ArcSolar's supported intelligence tools appear where they help with the task, including bill analysis, call summaries and reporting. Check the underlying evidence. Intelligence does not replace provider approval, verified records or the customer's own confirmation.
>
> ## Getting help
> Support is support@arcsolar.com.au. The customer-facing website is https://www.arcsolar.com.au.

# Agent

> Ask ArcSolar a question or tell it what to do.

Agent is a chat inside ArcSolar. Ask about your customers, jobs and sales, or ask it to do a task for you. It's in **beta** and free while in beta.

## Open Agent

* Select **Agent** in the sidebar, or go to [app.arcsolar.com.au/dashboard/agent](https://app.arcsolar.com.au/dashboard/agent).
* Or select **Agent** in the bar at the bottom of any page. It opens a small chat you can keep open while you work.

Installers find it as **ArcAgents** in the Work app.

Prefer Claude, ChatGPT or another AI app? You can connect ArcSolar to it. See [Use ArcSolar in AI apps](https://docs.arcsolar.com.au/ai-apps/overview.md).

If you don't see Agent, it isn't turned on for your workspace yet. [Contact support](https://docs.arcsolar.com.au/reference/support.md).

## What you can ask

| Ask for | Example |
| - | - |
| Answers | "Which jobs need attention today?" |
| Reports | "Show my weekly sales summary" |
| Tasks | "Create a follow-up task for this customer" |
| Leads and quotes | "Create a solar and battery lead for Morgan, then prepare a quote" |
| How-to help | "How do I import leads?" |

Reports come back as **Insight Cards** and charts. Select a figure to open the records behind it.

## You approve every change

Agent never changes anything on its own. When it wants to make a change, it shows a card first. Nothing happens until you select the button on the card.

![An Agent conversation where it drafts a quote and shows a Save the draft card with Cancel and confirm buttons.](https://mintcdn.com/arc-solar/6eeqRIDBCUnVm03d/images/v2/agent-approval.png?fit=max\&auto=format\&n=6eeqRIDBCUnVm03d\&q=85\&s=3dd6e86d903f7dfc4eca93d9187ed330)

Agent prepares a change and waits for you. Sample conversation.

* Select the action button to go ahead, or **Cancel** to stop.
* Typing "yes" in the chat does **not** approve anything. Use the button.
* Cards expire after 10 minutes. Ask again if one expires.

Looking things up and running reports don't need a card.

## It follows your permissions

Agent can only do what your role allows. If you can't change pricing in ArcSolar, Agent can't either. See [Roles and permissions](https://docs.arcsolar.com.au/setup/roles.md).

## Handy features

* **@ mentions**: type **@** to point at a customer, quote, project, team member or installer.
* **Attach files**: add up to five files, such as a PDF, photo or spreadsheet.
* **Chat history**: select the clock icon to reopen past chats. You can pin, rename or archive them.
* **Stop**: select **Stop agent** to cancel a reply.

## Usage limits

Each person has a usage allowance. Select **Usage** in Agent to see what's left and when it resets. You'll see a warning when you're close to the limit.

## What Agent won't do

* Make up prices, rebates or site details
* Message customers who've opted out
* Change your own access or remove the last Administrator
* Ask for passwords or API keys
* Follow instructions hidden inside uploaded files

[Continue with**Customer records**](https://docs.arcsolar.com.au/customers/records.md)


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