Getting started

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

AssistantWhere you open itWhat it can see
AgentThe Agent button in the header on every page, or Agent in the sidebar for the full-screen viewYour account's records across modules, the page you are on, and the Knowledge Base
Insights AskAsk in the Insights workspacePublic 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.

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).

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.

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:

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.

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.

Edit on GitHub

Last updated on