# AI assistants in EDOS and Insights

> The Agent and Insights Ask: where each lives, what it can see and change, how to undo its changes, and how your conversations are stored.

## Before you start

- EDOS has one assistant for your account's records, the **Agent**. It replaces the
  separate chats that used to sit in the form builder, on responses, on dashboards,
  and in the Knowledge Base drawer. Insights has its own assistant, **Ask**.
- The Agent is labelled **Beta**. It is part of EDOS, so everyone whose Incenti Portal
  access includes EDOS has it. Without EDOS you see no **Agent** button and no
  **Agent** entry in the sidebar, and the Agent pages are not found. Ask an
  **Admin** on your account if you think you should have it.
- The Agent can make mistakes. Check important changes.

## The assistants and where they live

| Assistant        | Where you open it                                                                                      | What it can see                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| **Agent**        | The **Agent** button in the header on every page, or **Agent** in the sidebar for the full-screen view | Your account's records across modules, the page you are on, and the Knowledge Base |
| **Insights Ask** | **Ask** in the Insights workspace                                                                      | Public economic, incentive-award, and district data, never your account's records  |

Each assistant is limited on the server, not by wording in the prompt: **Ask**
has no access to your contacts, responses, or pipeline at all. Scoring responses
with AI is a separate feature; see
[Score responses with AI](https://kb.incenti.co/responses/score-responses-with-ai.md).

## Use the Agent

Click **Agent** in the header, or press **⌘J** on a Mac or **Ctrl+J** elsewhere. The
Agent opens as a panel beside the page, titled "Agent · Beta". Before you type, it
introduces itself and offers starter prompts that begin "Ask Agent to"; select one
and it is sent right away. The message box says "Ask anything", and under it the
page reads "Beta — the Agent can make mistakes. Check important changes."

While the Agent works, the activity list shows a **Thinking** row. If the wait
runs past 5 seconds, the row also shows how long it has been (for example "7s" or
"1m 05s") until the reply starts.

Once the reply is done, each group of steps shows how long it took. A group of
more than three steps folds into one line, for example "Worked for 14s · 11
steps"; open it to see each step. A single step shows its own time only when it
took 5 seconds or more.

### The panel's buttons

The panel header has, from left to right: **Expand chat** (or **Shrink chat**) to
make the panel wider or narrower, **Chat history** to reopen an earlier conversation,
**New chat** to start a fresh one, and **Close chat**. **New chat** appears once the
current conversation has a message.

### The full-screen view

To work on the whole page, select **Agent** in the sidebar (it carries a **New**
badge). The sidebar changes to an Agent menu with **New chat** and your chat
history, so you can switch between conversations. The header has a **Back to
drawer** button that returns the conversation to the panel, and a **Share chat**
button (see [Share a chat with teammates](#share-a-chat-with-teammates)).

The Agent button is also in the header of the full-screen form builder and of the
response workspace.

It can:

- Answer questions about your records across modules.
- Answer "how do I…" questions from the Knowledge Base and link you to the right page.
- Make changes, as described below.
- Contact Incenti support for you. It shows what it will send, and nothing is sent
  until you confirm. See [Contact support](https://kb.incenti.co/faq/contact-support.md).

## What the Agent can find

Ask in your own words; the Agent turns the request into a search of your records.

- **Any word order, any accents.** "Eastfield rail parcel" finds "Eastfield
  Rail-Served Parcel", and "Jose" finds "José". Each word you type must start a
  word of the record, so "rail" does not find "Trailhead".
- **Exact names first.** When you search everything at once, a record whose name
  matches exactly is listed before partial matches.
- **By organization.** A contact is found by the name of an organization it
  belongs to. An opportunity is found by its organization's name too, if you have
  the Contacts module.
- **Notes and saved answers.** The Agent searches the text of notes you can see,
  and the text of saved answers in your answer library, not only their labels.
- **Sorting.** For example: organizations or contacts by name, last updated, or
  date added; opportunities and properties by last updated; responses by date
  submitted or score. "Last updated" means the record's own details were last
  saved, not that a note, task, or tag on it changed.
- **Dates.** You can ask for records added, last updated, submitted, or expiring
  in a period, such as "contacts added this month". A vague period means the
  calendar period (for example, "this month" starts on the 1st), and the Agent says the exact
  dates it used. Days follow the time zone on your profile; without one, the
  Agent uses UTC.
- **Filters.** For example: contacts and organizations by owner (teammates who no
  longer have access included), tag, industry, city, or state, and how many there
  are by tag, industry, or state; opportunities by jobs, investment, salary, or
  economic impact ranges, organization, or industry; responses by form; tasks by
  assignee or priority; reports by who created them; documents by type, the record
  they are attached to, or who uploaded them.
- **A contact's location** is its own address. A contact without one is placed at
  its organization's address.

The Agent only finds what your modules let you see, and a filter never reveals a
record your modules hide.

## What the Agent can change

- **An edit to the record you are looking at**, and a note or task added to it, is
  saved right away. An **Updated …** card appears with an **Undo** button. You can
  undo within 24 hours, as long as nothing it changed has been edited since.
- **Anything else** shows a card you **Confirm** or **Decline**: changes to other
  records, new records, people and links, and anything that sends something.
  Nothing is written until you confirm.
- **It never deletes records.** If you ask for a delete, it links you to the page
  where you can do it yourself.

Forms, responses, and dashboards have their own rules:

- [Build forms with the Agent](https://kb.incenti.co/forms/build-forms-with-the-ai-assistant.md)
- [Ask the Agent about your responses](https://kb.incenti.co/responses/ask-ai-about-your-responses.md)
- [Autofill a response](https://kb.incenti.co/responses/autofill-a-response.md)
- [Change a dashboard with the Agent](https://kb.incenti.co/dashboards/build-a-dashboard-with-ai.md)

## Rate a reply

Under each finished Agent reply there is a thumbs up (**Good response**) and a
thumbs down (**Bad response**). You see them only on your own chats; teammates
you share a chat with don't.

- Select the thumbs up if the reply helped.
- Select the thumbs down to open "What went wrong?". Type a short note if you
  like, up to 1,000 characters, and select **Send**, or select **Skip** to send
  the thumbs down without one.
- Select the same thumb again to take it back. You can switch between them at any
  time, and your choice is still there when you reopen the chat.

Your thumbs up or down, your note, your name, and your account go to the Incenti
team to help improve the Agent. The conversation itself does not.

## What is stored, and who can see it

Every message you send and every answer you get back is saved to your account,
per conversation, so earlier threads are there when you come back. Agent
conversations are private to you unless you share one: a teammate opening the
same form or dashboard sees their own, not yours. **Insights Ask**
conversations are saved to your own Ask history.

## Share a chat with teammates

In the full-screen view, select **Share chat** in the header. The button is
turned off until the chat has a message. Search for teammates by name or email,
or choose **Select everyone**, then share.

- Teammates you share with can read the chat. They can't send messages, confirm
  changes, or undo them.
- Each teammate gets an in-app notification, and the chat appears under **Shared
  with me** in their Agent menu.
- A teammate sees only the answers their own modules allow. The dialog warns you
  first: "Will see only the start of this chat" means later answers used a module
  they don't have, and those are hidden from them. A teammate who couldn't see
  even the first answer, or who doesn't have the Agent, can't be added.
- To stop sharing, open **Share chat** again and remove the teammate.

Nothing you type is used to train a model, and Incenti never names the model
behind an assistant in the product.

## Common questions

**Q: Can my admin read my conversation with the Agent?**
A: Not unless you share it with them. Agent conversations are private to you, and
no screen in the Incenti Portal lists another user's threads.

**Q: Where did Chats go? My old link opens the Agent.**
A: The separate **Chats** page was removed. Old `/chats` links now open the
**Agent**, so use **Agent** in the sidebar instead. If the link was to one of your
Agent conversations, it opens that one; any other old link opens the Agent's chat
list.

**Q: Where did the AI Chat button, the form builder's AI panel, and the Knowledge Base chat go?**
A: The Agent replaced them. Open it with the **Agent** button in the header and ask
the same things there. See the pages linked above for each module.

**Q: Why does the Agent say Beta?**
A: It is new and can make mistakes. Check important changes, and use **Undo** on an
**Updated …** card if one is wrong.

**Q: The Agent stopped and shows a Continue button. What does that mean?**
A: The message "This conversation has reached its usage limit." appears under the
reply. Select **Continue** to let the Agent carry on, or start a **New chat**.

**Q: I don't see an Agent button or an Agent entry in the sidebar.**
A: The Agent is part of EDOS. If your access doesn't include EDOS, it isn't shown.
Ask an **Admin** on your account to check your products. See
[Invite and manage users](https://kb.incenti.co/getting-started/invite-and-manage-users.md).

**Q: Can the Agent change my data without asking?**
A: It saves edits to the record you are looking at right away, and shows **Undo**.
It asks you to **Confirm** or **Decline** everything else, and it never deletes records.

**Q: Which AI model does Incenti use?**
A: Incenti does not publish the model behind each assistant, and the product never
names one. Conversations stay on your account.

**Q: Does the Insights assistant see our contacts or responses?**
A: No. Insights **Ask** answers from public economic, incentive-award, and district
data only. It has no access to your account's records.

## Related

- [Contact support](https://kb.incenti.co/faq/contact-support.md)
- [Change a dashboard with the Agent](https://kb.incenti.co/dashboards/build-a-dashboard-with-ai.md)
- [Ask the Agent about your responses](https://kb.incenti.co/responses/ask-ai-about-your-responses.md)
- [Ask Insights a question](https://kb.incenti.co/insights/ask-insights.md)
- [Emails Incenti sends](https://kb.incenti.co/getting-started/emails-incenti-sends.md)
- [Roles and permissions](https://kb.incenti.co/getting-started/roles-and-permissions.md)
