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
- Open the form in the builder.
- Click Agent in the header, or press ⌘J on a Mac or Ctrl+J elsewhere. The panel opens beside the canvas, titled "Agent · Beta".
- Ask in plain language: "split this into two pages", "add a table of annual jobs and wages", "score this on job quality".
- 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.
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.
- 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.
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
Last updated on