> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/settings/learnings-for-ai-quote-and-invoice-drafts.md).

# Learnings for AI quote and invoice drafts

Learnings are short notes about how your business writes its quotes and invoices, which Essential follows every time it drafts one with AI. Essential writes them itself by looking at the AI drafts you later sent or signed and how your team changed each draft first: lines you kept adding or removing, prices you corrected, descriptions you rewrote, tax you flipped. When the same change shows up again and again, it becomes a learning such as "Parts and labor on separate lines" or "Round labor to the hour". You can also add learnings of your own.

Learnings sit alongside your prompt templates. A prompt template tells the assistant what to write for a kind of work; a learning tells it how your business writes, whatever the work. The assistant treats learnings as evidence: your prompt and the template's instructions always win over a learning.

## Before you start

* You need the quote prompt permission to manage quote learnings and the invoice prompt permission to manage invoice learnings. Anyone who can open Settings can read them.
* Essential only learns from AI drafts that were later sent or signed. Until at least five of them exist, the list stays empty and a refresh reports that there is not enough to learn from yet.

A learning can apply to one kind of work only. When your team's practice differs by work type, for example a mobilization charge on sprinkler inspections but not on backflow tests, the learning carries a work-type tag such as **Backflow** and Essential follows it only when drafting that kind of work.

## What Essential does overnight

Every night Essential reviews the AI-drafted quotes and invoices of the last six months that went out, compares each with the draft it produced, and updates the list. Before it keeps a new learning, it checks the learning against your newest documents: a practice that your recent quotes or invoices do not confirm is not added. Then:

* It adds a learning when a practice is clear across many documents.
* It keeps a learning it already wrote when the history still supports it, and may sharpen the wording.
* It retires one of its own learnings when the history now contradicts it.

Each learning Essential wrote shows a **Learned by Essential** pill, its work-type tag when it has one, and the numbers behind it, including how it held up on your recent documents. Essential never changes a learning you added or edited, and never brings back one you rejected.

## Add, edit, reject, or refresh

1. Open the **Learnings** card under the prompt templates.
2. To add your own, click **Add learning**, write it as you would tell a new estimator ("Always add a trip charge on service calls"), and click **Add**. It shows an **Added by** pill with your name.
3. To change one Essential wrote, click **Edit**, change the text, and click **Save**. The learning becomes yours: the pill changes to **Added by** you and Essential stops updating it.
4. To remove one, click **Reject** and confirm. A rejected learning is gone for good, and Essential will not suggest it again.
5. To update the list now instead of waiting for the overnight run, click **Refresh learnings**. The button shows progress while Essential reviews your history; this takes a few seconds. A message tells you whether learnings were updated, whether there was nothing new, or whether there are not yet enough sent AI drafts to learn from.

Leaving the page with an unsaved learning draft asks you to confirm first.

> **Where to find it:** For quotes: Settings -> Quotes -> AI Prompts tab -> the Learnings card under Quote Prompt Templates. For invoices: Settings -> Invoicing -> AI Prompts tab -> the Learnings card under Invoice Prompt Templates.

## Related guides

* [Set up quote prompt templates for AI drafting](https://learn.withessential.com/administration/settings/set-up-quote-prompt-templates-for-ai-drafting.md)
* [Set up invoice prompt templates for AI drafting](https://learn.withessential.com/administration/settings/set-up-invoice-prompt-templates-for-ai-drafting.md)
* [Generate a quote draft with AI](https://learn.withessential.com/revenue/quotes/generate-a-quote-draft-with-ai.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.withessential.com/administration/settings/learnings-for-ai-quote-and-invoice-drafts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
