# Freespace Assistant

<p class="doc-lead">Freespace Assistant answers questions about Freespace ERP and the Field Sale App from the Freespace documentation, without leaving the screen you are on. Ask how to do a task, or press <b>Ask</b> on an error or warning message to find out why it appeared and how to fix it.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/dashboard/freespace-assistant?id=overview">Overview</a>
<a href="#/dashboard/freespace-assistant?id=open">Open Freespace Assistant</a>
<a href="#/dashboard/freespace-assistant?id=ask-a-question">Ask a question</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Using answers</span>
<div class="doc-toc-links">
<a href="#/dashboard/freespace-assistant?id=reading-answers">Reading an answer</a>
<a href="#/dashboard/freespace-assistant?id=ask-from-a-message">Ask from a message</a>
<a href="#/dashboard/freespace-assistant?id=copy-a-message">Copy a message</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/dashboard/freespace-assistant?id=tips">Tips for better answers</a>
<a href="#/dashboard/freespace-assistant?id=good-to-know">Good to know</a>
<a href="#/dashboard/freespace-assistant?id=faq">FAQ</a>
<a href="#/dashboard/freespace-assistant?id=related">Related</a>
</div>
</div>
</div>

<section class="ai-index-only">

**Also known as:** Help, Ask, Assistant, AI assistant, AI help, Chatbot, Support assistant, Question mark button, Ask docs

**ERP location:** Ask AI button in the top bar, next to the documentation book icon. Shortcut: ?

</section>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Freespace Assistant is available on every screen from the top bar. Type a question in your own words and it replies with steps, menu paths, and examples taken from this documentation, plus links to the full pages.

It can help with:

<ul>
<li><b>How-to questions:</b> for example <i>how to create a custom receipt</i> or <i>set footer note in sale invoice</i>.</li>
<li><b>Error and warning messages:</b> what the message means, whether the action is blocked, and how to fix it.</li>
<li><b>Settings:</b> where a setting is and what it changes.</li>
<li><b>Field Sale App questions:</b> mention "app" or "mobile" to get Field Sale App steps.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="open">Open Freespace Assistant</h2>

| **Action** | **How** |
|------------|---------|
| Open Freespace Assistant | Click **Ask AI** in the top bar, next to the documentation book icon |
| Open with the keyboard | Press <kbd>?</kbd> when you are not typing in a field |
| Ask about an error or warning | Click **Ask** on the message |
| Close | Click **Close** at the top right |

> **Note:** <kbd>?</kbd> does nothing while you are typing in a field, so you can still type a question mark in notes and other text boxes.

<hr class="doc-section-divider">

<h2 id="ask-a-question">Ask a question</h2>

<ol>
<li><b>Open Freespace Assistant</b><br>Click <b>Ask AI</b> in the top bar, or press <kbd>?</kbd>.</li>
<li><b>Type your question</b><br>Use your own words. Include the screen name if you know it, for example <i>how to cancel an approved sale invoice</i>.</li>
<li><b>Press Enter</b><br>The answer appears below the question.</li>
<li><b>Open the full page if needed</b><br>Click a link under <b>Read more</b>. The page opens in a new browser tab, so your work in Freespace stays open.</li>
</ol>

<hr class="doc-section-divider">

<h2 id="reading-answers">Reading an answer</h2>

<ul>
<li><b>Direct answer:</b> one or two sentences at the top.</li>
<li><b>Steps:</b> numbered steps with the menu path and button names used in Freespace.</li>
<li><b>Examples:</b> included when the documentation has one.</li>
<li><b>Source markers:</b> the small icons after a sentence show which documentation page it came from.</li>
<li><b>Read more:</b> links to the full documentation pages.</li>
<li><b>Feedback:</b> use the thumbs up or thumbs down below the answer to rate it. Use the copy icon to copy the answer.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="ask-from-a-message">Ask from a message</h2>

Error and warning messages in Freespace show <b>Copy</b> and <b>Ask</b>, next to <b>View Details</b> when that is available.

When you click <b>Ask</b>:

<ul>
<li>Freespace Assistant opens with the message already entered.</li>
<li>The screen and action where the message appeared are added for you, for example <i>This error occurred while saving and approving Sale Invoice</i>. You do not need to type them.</li>
<li>The answer explains what the message means, whether the action is blocked or can continue, and how to fix it.</li>
<li>If the message contains values such as a balance, limit, or date, the answer explains them.</li>
</ul>

**Example**

A Sale Invoice shows *Credit Limit for Customer Exceeded. Current Balance: 115905, New Transaction: 100000, Total: 215905, Allowed Limit: 50000* when you click **Save And Approve**. Click **Ask**. Freespace Assistant explains that the customer's balance plus this invoice is over the allowed credit limit, and lists the documented ways to resolve it: reduce the invoice total, collect the outstanding amount, or have an administrator add you to **Users allowed to bypass**.

> **Note:** The screen and action are sent only with <b>Ask</b>. The message on screen stays the same.

<hr class="doc-section-divider">

<h2 id="copy-a-message">Copy a message</h2>

Click <b>Copy</b> on an error or warning message to copy its text. The button changes to <b>Copied</b>. Paste the text into an email or chat when you contact your Freespace ERP support representative, and include the transaction number.

<hr class="doc-section-divider">

<h2 id="tips">Tips for better answers</h2>

<ul>
<li><b>Name the screen:</b> <i>set footer note in sale invoice</i> gets a better answer than <i>footer note</i>.</li>
<li><b>Say what you want to do:</b> <i>how to cancel</i>, <i>how to change</i>, <i>where to set</i>.</li>
<li><b>Say which product:</b> add "app" or "mobile" for the Field Sale App. Add "Android" or "iPhone" when steps differ by phone.</li>
<li><b>Use Ask on errors:</b> it adds the screen and action automatically, which gives a more accurate answer than typing the message yourself.</li>
<li><b>One question at a time:</b> ask a separate question for each task.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="good-to-know">Good to know</h2>

<ul>
<li><b>AI-generated answers:</b> answers are generated from this documentation. Check important steps, especially before cancelling or changing approved transactions.</li>
<li><b>Documentation only:</b> Freespace Assistant does not read your company data, transactions, or settings. It explains how Freespace works, not what is in your account.</li>
<li><b>Topics not documented:</b> if a topic or message is not in the documentation, Freespace Assistant says so. Contact your Freespace ERP support representative in that case.</li>
<li><b>Internet connection:</b> Freespace Assistant needs an internet connection.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>How do I open Freespace Assistant?</b><br>
Click <b>Ask AI</b> in the top bar, or press <kbd>?</kbd> when you are not typing in a field.</p>

<p><b>What is the difference between Freespace Assistant and Global Search?</b><br>
Freespace Assistant answers <i>how</i> questions from the documentation. <a href="#/dashboard/global-search">Global Search</a> opens screens, transactions, customers, items, and reports in your company.</p>

<p><b>Can Freespace Assistant see my invoices or customers?</b><br>
No. It answers from the documentation only. When you click <b>Ask</b> on a message, only the message text, the screen name, and the action are sent.</p>

<p><b>Why did I get "I couldn't find documentation" as the answer?</b><br>
The topic or message is not covered in the documentation yet. Use <b>Copy</b> on the message and share it with your Freespace ERP support representative.</p>

<p><b>Does it answer Field Sale App questions?</b><br>
Yes. Mention "app", "mobile", or "Field Sale App" in your question.</p>

<p><b>Where do the Read more links open?</b><br>
In a new browser tab, so the screen you are working on stays open.</p>

<p><b>The answer looks wrong. What should I do?</b><br>
Use the thumbs down below the answer, then check the linked documentation page or contact your Freespace ERP support representative.</p>

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/dashboard/global-search">Global Search</a> — open screens, transactions, and records</li>
<li><a href="#/dashboard/keyboard-shortcuts">Keyboard Shortcuts</a> — list, form, and top-bar keys</li>
<li><a href="#/dashboard/README">Home Dashboard</a> — top bar and quick buttons</li>
<li><a href="#/version-releases/web?id=v5-35-1">Web release 5.35.1</a> — when Freespace Assistant was added</li>
</ul>
