# Add AI agents that work on your tables

> Give a script or an AI assistant its own name, token and access, review what it changes before it is written, and undo everything it wrote.

Source: https://artavolo.com/page/ai-agents

An AI agent is a program or an AI assistant that works on your tables like a colleague: it has its own name, its own token and only the access you give it, and everything it changes is credited to it. With review on, nothing it changes is written until a person accepts it.

## Make an agent

Workspace owners make and manage agents.

1. Open a base and click **Settings** at the top right.
2. Choose **AI agents**.
3. Under **New agent**, give it a **Name**, such as "Invoice bot".
4. Under **Its changes**, choose **I review its changes** or **Writes directly**. A new agent is reviewed unless you change this.
5. Under **This base**, choose **Read** or **Read and change**.
6. Click **Make the agent**.
7. Copy its token with **Copy** and keep it like a password. It is shown only once.

## Connect it

The token works wherever an API token does:

- AI assistants such as Claude, ChatGPT or Le Chat: the AI connector at `/mcp` on your Artavolo address, with the token as the bearer token.
- Scripts: the data API at `/api/v2`, with the token in the `API-KEY` header, or the Airtable-compatible API at `/v0`.

The full reference, with examples, is in the [AI agents guide](https://artavolo.com/docs/agents).

## Review what an agent proposes

When an agent in review mode changes a record, the change waits as a proposal, one per field. A line over the table says which agent proposes how many changes.

1. Click **Review** on that line. **Proposed changes** opens beside the table.
2. For each change, read the record, the field, the value now (struck through), the value proposed and the agent's reason, if it gave one.
3. Click **Accept** or **Reject**, or use **Accept all** or **Reject all** for a whole batch.

![The Proposed changes panel beside a table: three changes from the planning assistant, each with the old value struck through, the new value, a reason, and Accept and Reject buttons](https://artavolo.com/site/templates/default/assets/img/app/screens/review.webp)

An accepted change is written as your edit, and the record's history credits both, for example "Invoice bot, accepted by Dana". If someone changed the cell after the agent looked, the proposal is stale and nothing is written.

## Undo what an agent wrote

1. In **AI agents**, find the agent.
2. Click **Undo its last 24 hours**.

Changed records get their values back, records it added go to the trash and records it deleted come back. A cell someone changed after the agent keeps that person's value. Changes a person accepted are that person's edits and stay.

## Good to know

- An agent follows the same rules as a person: hidden tables stay hidden from it, and rules on who sees which records apply to it too.
- In review mode, new records are added at once and deletes go to the trash, where they can be restored. Only changes to existing records wait for review.
- People who can change the table accept or reject proposals. People who can only read, guests and agents cannot.
- Each agent shows its changes this week and the share of its proposals that were accepted.
- **New token** makes a new token and stops the old one. **Remove** ends its token and access and rejects its undecided proposals; what it already changed stays, credited to it.
- Through the API, owners can undo up to 30 days of an agent's work.

## Related

- [Get fixes and ideas from the planning assistant](https://artavolo.com/page/planning-assistant)
- [Connect Claude, ChatGPT or Le Chat to your bases](https://artavolo.com/page/connect-claude-chatgpt)
- [REST API and tokens](https://artavolo.com/page/rest-api-and-tokens)
- [Audit log](https://artavolo.com/page/audit-log)
