# Build forms with the Agent

> Ask the Agent to add and arrange fields, tables, pages, scoring, rules, and CRM mappings in the form builder, and undo a change on a draft form.

## Before you start

- Open a form in the builder. The Agent button is in the builder's header, as it
  is on every page. The old **Form Builder AI** panel and **AI Chat** button are gone.
- The Agent is labelled **Beta** and can make mistakes. Check important changes.
- What happens to an edit depends on the form's status. A **draft** form that is
  open in the builder is changed right away. A live (active) or closed form, or a
  form you are not looking at, gets a confirmation card first.

## Steps

### Ask for a change

1. Open the form in the builder.
2. Click **Agent** in the header, or press **⌘J** on a Mac or **Ctrl+J** elsewhere.
   The panel opens beside the canvas, titled "Agent · Beta".
3. Ask in plain language: "split this into two pages", "add a table of annual jobs
   and wages", "score this on job quality".
4. On a draft form, the change is saved at once and the canvas reloads to show it.
   An **Updated …** card appears in the conversation with an **Undo** button.

### Undo a change on a draft form

Click **Undo** on the **Updated …** card. The form goes back to the version it had
before that change.

> **Warning:** **Undo** is blocked if the form was edited since the Agent's change, and it is only
> offered for 24 hours. If you want to undo something, do it before you edit the form
> by hand.

### Confirm a change on a live or closed form

For a live or closed form, or a form you are not looking at, the Agent shows a card
describing the change. Click **Confirm** to apply it or **Decline** to discard it.
Nothing is written until you confirm.

### The "Set up contact fields" shortcut

If you try to activate, share, or send a form that isn't collecting an email
address, the readiness dialog offers a **Set up contact fields** button. It takes
you into the builder and sends the Agent a request to find or create fields for
first name, last name, email, and organization name, and map each one to the
matching CRM record. Review what it did, and use **Undo** if you'd rather do it by
hand.

### Conversations

Click **Agent** in the sidebar to open the conversation on the **Agent** page, which
lists your earlier threads. **New chat** in the panel starts a fresh one.
Conversations are private to you.

## What the Agent can do

| Area           | What it can change                                                                                                                         |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Fields         | Add, remove, update, duplicate, and move a field.                                                                                          |
| Tables         | Add, remove, and update columns; set the row count; split one table into two or merge two into one.                                        |
| Pages          | Add, remove, rename, reorder, merge, split, and move fields between pages.                                                                 |
| Sections       | Add and remove a section on a page.                                                                                                        |
| Scoring        | Turn scoring on or off, and add, update, or remove criteria.                                                                               |
| Rules          | Add, update, and remove conditional rules.                                                                                                 |
| CRM mapping    | Set or remove a field's **Auto Populate** target.                                                                                          |
| Field groups   | Add a group, change where it saves, or remove it.                                                                                          |
| Property pages | Add or remove the page set, change its minimum and maximum, change whether properties are saved, and add, remove, or restore fields on it. |

It can also review the form and suggest improvements without changing anything.
Ask it what's missing and it will answer rather than edit.

## What happens next

- **Changes to a draft form are saved straight away.** The canvas reloads to show
  them.
- **The Agent cannot create, publish, archive, or delete a form.** It also can't
  change a form's title or description, or edit admin templates. Activating a form
  is always a step you take on the **Publish** tab; see
  [Publish and share a form](https://kb.incenti.co/forms/publish-and-share-a-form.md).
- **It can't upload files or write a form from a document.** Starting from a
  document is the **Smart Document Form** option on
  [Create a form](https://kb.incenti.co/forms/create-a-form.md).

## Common questions

**Q: Can the AI build the form for me?**
A: It can do most of the mechanical work: adding and arranging fields, tables,
pages and sections, writing scoring criteria and conditional rules, and mapping
fields to your CRM. You still choose the questions and review the result, and you
still activate the form yourself.

**Q: I asked for something and I don't like the result. How do I undo it?**
A: On a draft form, click **Undo** on the **Updated …** card. It restores the
previous version of the form. If the form was edited since, Undo is blocked. On a
live or closed form, decline the card before it is applied.

**Q: Where did the Form Builder AI panel and the AI Chat button go?**
A: The Agent replaced them. Click **Agent** in the builder's header.

**Q: Why did the Agent show Confirm and Decline instead of changing my form?**
A: The form is live or closed, or you asked about a form that isn't the one open in
the builder. Those changes need your confirmation.

**Q: Can a colleague see my conversation with the Agent?**
A: No. Conversations are private to you. Someone else editing the same form gets
their own.

**Q: Can the Agent publish the form or change its title?**
A: No. It can't create, publish, archive, or delete forms, and it can't change a
form's title or description.

**Q: Why did a request already appear in the Agent when I opened the builder?**
A: You arrived through the **Set up contact fields** button on the readiness
warning, which sends the Agent a request to add and map first name, last name,
email, and organization name fields.

## Related

- [AI assistants in EDOS and Insights](https://kb.incenti.co/getting-started/ai-assistants.md)
- [Build a form: fields, pages, and rules](https://kb.incenti.co/forms/build-a-form.md)
- [Field types reference](https://kb.incenti.co/forms/field-types-reference.md)
- [Conditional rules](https://kb.incenti.co/forms/conditional-rules.md)
- [Map fields to your CRM](https://kb.incenti.co/forms/map-fields-to-your-crm.md)
- [Publish and share a form](https://kb.incenti.co/forms/publish-and-share-a-form.md)
