> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI field

> Set up AI fields in AI Table to generate content automatically using custom prompts that analyze your record data.

## What is an AI field

In AI Table, fields that **generate content with AI** are called **AI fields**. They can produce content based on a prompt and references to other fields, and they update dynamically — reading the current record, analyzing docs, images, video, etc. — to complete tasks that usually need external tools.

When configuring an AI field, you can pick a preset from the AI field center.

You can also build one with a custom prompt.

AI field output supports these types:

* Text
* [Number](/aitable/fields/field-types/number)
* [Single select and multi-select](/aitable/fields/field-types/select)
* [Currency](/aitable/fields/field-types/currency)
* Image
* Video

## Add an AI field

Pick a preset from the AI field center:

1. Click **+ Add field**.
2. Click **More AI fields**.
3. Hover any AI field and click **Use**.
4. Or search in the search box.
5. If nothing fits, [submit a request](https://docs.dingtalk.io/notable/share/form/v01Pd6l24NVoJZ2q7Ma_6HPhPqS_fVR4vpe).

## Customize the AI field prompt

When creating an AI field, you can write or edit the prompt manually. Tips:

* Describe the task and its context in detail — the more context, the better.
* State both what to do and what NOT to do — reduces errors.
* Add examples — e.g. "here are positive and negative feedback examples".
* Break complex instructions into steps for cleaner output.
* Name each field clearly in the prompt; use **Insert field** to insert a field-name variable.
* Include conditional logic — e.g. additional output when a specific field is filled.

To build a custom AI field:

1. Click **+ Add field**.
2. Click **+ Create AI field**.
3. Enter your custom prompt.

## How AI fields run

AI fields run per row — they must reference at least one other field in the same row. When a referenced field changes, the AI field re-runs.

When many AI fields run at once, they queue up. **Free** users share a common queue; **Enterprise** and **Ultimate** users use a dedicated fast lane — wait time is much shorter, throughput much higher.

Plan details: [https://table.dingtalk.io/pricing](https://table.dingtalk.io/pricing)

### AI field run states

If an AI field references no other fields, it shows **Required field empty** — you must reference at least one non-empty field for the AI field to run.

When an AI field fails, the cell shows an icon — hover to see the error, copy it, or contact support:

To rerun all failed AI fields in bulk, use the field menu:

# FAQ

* **Q: How do I revert an AI field to a regular field?**

  A: Double-click the field title, click the icon in the upper-right of the configuration dialog, and pick **Convert to regular field**.

  **Note**: after conversion, the field adopts the chosen type's format and keeps only the AI-generated output.