# Change a dashboard with the Agent

> Ask the Agent to build a new dashboard, add, change, resize, or move charts, rename a dashboard, or change its filters, and undo what it did.

## Before you start

- **Dashboards** appears in the sidebar when your account's plan includes
  the Dashboards module.
- Any user in the account, admin or member, can use the Agent on a dashboard.
- The Agent is labelled **Beta** and can make mistakes. Check important changes.
- It only charts your own account's data: opportunities, contacts, forms and
  form responses, properties, programs and incentives, tasks, incentive awards,
  and tracked metric values.
- There is no separate dashboard chat any more. **Build with AI** under
  **New dashboard** opens the Agent.

## Steps

### Change the dashboard you are looking at

1. Open the dashboard and click **Agent** in the header (**⌘J** on a Mac,
   **Ctrl+J** elsewhere). The panel opens beside the page.
2. Ask for what you want: add a chart, change a chart, resize or move one, rename
   the dashboard, or change its filters.
3. The change is saved right away. An **Updated …** card appears in the conversation
   with an **Undo** button.
4. If the dashboard looks wrong, click **Undo**. It restores the previous charts,
   layout, title, and filters.

Undo works for 24 hours. It is blocked if the dashboard was edited since the
Agent's change, so undo before you edit.

### Questions about your data

Ask things like "how many opportunities closed last quarter?" and the Agent answers
in the conversation. A question changes nothing.

### Changes that need your confirmation

Some changes show a card with **Confirm** and **Decline** instead of saving at once:

- Creating a dashboard.
- Removing a chart.
- Any change to a saved KPI: creating, changing, or deleting one.

Nothing is written until you confirm. A declined card reads "Declined — nothing
was changed."

### Build a new dashboard with the Agent

1. On **Dashboards**, click **New dashboard**, then **Build with AI**. On an account
   with no dashboards yet, click **Build with AI** under "Create your first dashboard."
2. The Agent panel opens on a new conversation and sends "I want to build a new
   dashboard. Ask me what it should show before you create it." The Agent asks what
   you want to see. Your earlier conversations stay in the Agent's history.
3. Describe the dashboard: the numbers, charts, and filters you want.
4. The Agent shows a card with **Confirm** and **Decline**. Click **Confirm** to create
   the dashboard, then open it from the card or the Dashboards list.

To start from a ready-made dashboard instead, click **New dashboard**, then
**Use a template**; see
[Create a dashboard from a template](https://kb.incenti.co/dashboards/create-a-dashboard-from-a-template.md). You can
then ask the Agent to adjust it.

### Chat history and privacy

Open **Agent** in the sidebar for the full-screen view, which lists your earlier
threads. Your conversations are private to you. The dashboards and charts the Agent
creates belong to the account and are visible to everyone in it.

## What happens next

- A saved change is live straight away. Other people see it the next time they open
  the dashboard. The Agent does not notify anyone.
- You can still edit charts by hand; see [Edit a dashboard](https://kb.incenti.co/dashboards/edit-a-dashboard.md).

## Common questions

**Q: The Agent changed a chart I didn't ask for. How do I undo it?**
A: Click **Undo** on the **Updated …** card in the conversation. It restores the
dashboard as it was before that change. If you have edited the dashboard since, or
more than 24 hours have passed, Undo is not available; fix the chart by hand or ask
the Agent to change it back.

**Q: Where did the dashboard AI Chat go?**
A: The Agent replaced it. Open it with the **Agent** button in the header, or click
**New dashboard**, then **Build with AI**, to build a new dashboard with it.

**Q: Can the Agent resize a chart?**
A: Yes. Ask it to resize or move a chart, and it saves the change with **Undo**.

**Q: I asked the Agent a question. Did it change my dashboard?**
A: No. Data questions get an answer in the conversation. Only a request to change
something saves anything, and it shows an **Updated …** card when it does.

**Q: Why did the Agent show Confirm and Decline instead of saving?**
A: Creating a dashboard, removing a chart, and any saved-KPI change always need your
confirmation. Click **Confirm** to apply it or **Decline** to discard it.

**Q: Can the Agent chart data from other accounts, or from Insights?**
A: No. Every chart it builds uses your own account's records. For regional data, use
Insights.

**Q: Can anyone else in my account read my conversation with the Agent?**
A: No. Conversations are private to you. The charts and dashboards it creates are
visible to everyone in the account.

## Related

- [AI assistants in EDOS and Insights](https://kb.incenti.co/getting-started/ai-assistants.md)
- [Create a dashboard from a template](https://kb.incenti.co/dashboards/create-a-dashboard-from-a-template.md)
- [Edit a dashboard](https://kb.incenti.co/dashboards/edit-a-dashboard.md)
- [Filters and drill-down](https://kb.incenti.co/dashboards/filters-and-drill-down.md)
- [Metric definitions](https://kb.incenti.co/dashboards/metric-definitions.md)
- [Chart fields reference](https://kb.incenti.co/dashboards/chart-fields-reference.md)
