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

# AI 字段

> AI 字段可以直接帮你整理文本、分类标签、生成评分，或者把内容变成图片。

<Note>云端版本所有方案可用；私有部署版本需要商业版及以上方案。</Note>

## 主要用途

AI 字段会根据同一行里的其他字段内容生成当前字段值。它适合把原始内容整理成摘要、翻译、提取结果、分类标签、评分、日期或图片。

<Columns cols={2}>
  <Card title="文本" icon="text">
    总结、翻译、提取信息、文案改写、自定义生成。适合把长文本整理成可直接使用的文字结果。
  </Card>

  <Card title="单选" icon="circle-dot">
    智能分类、自定义生成。适合把内容匹配到一个已有分类。
  </Card>

  <Card title="多选" icon="tags">
    智能标签、自定义生成。适合为内容匹配一个或多个已有标签。
  </Card>

  <Card title="评分 / 数字" icon="star">
    评分、自定义生成。适合根据内容生成分数或数值结果。
  </Card>

  <Card title="日期" icon="calendar">
    提取信息、自定义生成。适合从内容中提取日期或时间。
  </Card>

  <Card title="附件" icon="image">
    图像生成、自定义生成。适合根据文字或附件生成图片。
  </Card>
</Columns>

如果不确定该选哪种动作，可以先看下面的说明：

<AccordionGroup>
  <Accordion title="总结、翻译、提取信息">
    * **总结**：根据来源字段生成摘要。
    * **翻译**：将来源字段翻译成目标语言。
    * **提取信息**：从文本中提取指定信息，日期字段也可以用它提取日期或时间。
  </Accordion>

  <Accordion title="文案改写、智能分类、智能标签">
    * **文案改写**：根据附加要求调整表达方式。
    * **智能分类**：为单选字段匹配已有选项。
    * **智能标签**：为多选字段匹配已有选项。
  </Accordion>

  <Accordion title="评分、图像生成">
    * **评分**：根据来源内容生成评分或数值。
    * **图像生成**：会在附件字段中生成图片，部分模型支持选择附件字段作为参考图。
  </Accordion>

  <Accordion title="自定义生成">
    用自定义提示词控制输出，适合默认动作无法覆盖的场景。自定义提示可以引用同一行里的字段。
  </Accordion>
</AccordionGroup>

## 操作流程

<Steps>
  <Step title="新增字段">
    创建字段时，先选择字段类型，再展开 **AI 配置**。不同字段类型会显示不同的 AI 动作。
  </Step>

  <Step title="选择动作和模型">
    选择 **AI 动作类型** 和 **AI 模型**。动作决定要执行的任务，模型决定使用哪一个 AI 模型生成结果。
  </Step>

  <Step title="选择来源字段">
    选择 AI 要读取哪一列作为输入。AI 字段会根据同一行里的来源字段内容生成当前字段值。
  </Step>

  <Step title="补充生成要求">
    根据动作填写 **附加要求**、**目标语言** 或 **自定义提示**。附件字段生成图片时，可以使用 **高级设置** 调整图片尺寸、质量、数量、宽高比、分辨率或参考图，具体选项取决于所选模型。
  </Step>
</Steps>

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-create-config.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=2b31cccc55c714dc7830b46b044744a3" alt="新增 AI 字段" className="docs-screenshot" width="1600" height="1095" data-path="images/docs/base/2026-05-22-ai-field-create-config.png" />

编辑 AI 字段时，可以修改动作类型、模型、来源字段、附加要求、自定义提示和自动更新。保存后，新配置会用于之后的生成；如果已有结果不符合预期，可以重新生成。

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-edit-config.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=a99c8488f6e9758ef124a466d7ff19f2" alt="编辑 AI 字段" className="docs-screenshot" width="1600" height="1100" data-path="images/docs/base/2026-05-22-ai-field-edit-config.png" />

## 自动更新和批量生成

开启 **自动更新** 后，当来源字段内容或 AI 配置变化时，AI 字段会按当前配置同步更新。它适合需要持续保持结果一致的场景，比如根据反馈内容更新分类、摘要、评分或标签。

保存新增字段或修改后的 AI 配置时，可以选择是否立刻处理当前视图里的记录：

<Columns cols={3}>
  <Card title="仅填充空单元格" icon="circle">
    只为没有结果的单元格生成内容，不覆盖已有内容。
  </Card>

  <Card title="整列生成" icon="rotate">
    为当前视图里的记录重新生成结果，会覆盖已有内容。
  </Card>

  <Card title="仅保存配置" icon="floppy-disk">
    只保存字段配置，不立即写入单元格。
  </Card>
</Columns>

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-save-options.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=de791ff173535586627d012371c6523e" alt="AI 字段保存选项" className="docs-screenshot" width="1600" height="998" data-path="images/docs/base/2026-05-22-ai-field-save-options.png" />

选择生成方式后，Teable 会显示当前任务状态。

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-generation-status.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=0492c4a7e2080dea562f7d0782731ea1" alt="AI 字段生成状态" className="docs-screenshot" width="1600" height="760" data-path="images/docs/base/2026-05-22-ai-field-generation-status.png" />

如果之后还需要重新生成，可以直接从字段菜单操作，不需要再次保存配置。

右键菜单里的 **生成** 可以按当前视图批量生成。是否可用取决于当前视图和权限。

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/base/2026-05-22-ai-field-generate-menu.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=566378ec1e69e84f702e1df932d800ba" alt="AI 字段生成菜单" className="docs-screenshot" width="1600" height="911" data-path="images/docs/base/2026-05-22-ai-field-generate-menu.png" />

## 常见问题

<AccordionGroup>
  <Accordion title="AI 字段会自动处理已有记录吗？">
    创建字段或修改 AI 配置后，保存时可以选择 **仅填充空单元格**、**整列生成** 或 **仅保存配置**。如果之后再想批量生成，可以从字段右键菜单里点击 **生成**。
  </Accordion>

  <Accordion title="什么时候需要开启自动更新？">
    如果希望来源字段内容变化后，AI 字段也跟着更新，就开启 **自动更新**。如果只想手动控制生成时机，可以关闭它，之后需要时再使用 **生成**。
  </Accordion>

  <Accordion title="为什么不同字段类型看到的 AI 动作不一样？">
    AI 动作会根据字段类型显示。比如文本字段适合总结、翻译和提取信息；单选字段适合智能分类；多选字段适合智能标签；附件字段适合图像生成。
  </Accordion>

  <Accordion title="为什么没有看到想用的模型？">
    模型列表来自 Teable 提供的模型，或当前空间自己配置的 AI 模型。如果需要使用第三方模型，请先在空间设置中添加自定义 AI 模型。
  </Accordion>

  <Accordion title="为什么图像生成的选项会变化？">
    图像尺寸、质量、数量、宽高比、分辨率和参考图等选项，会根据所选模型变化。
  </Accordion>

  <Accordion title="为什么选择 4K 后，图片不一定有 3840 px 边长？">
    部分图像模型会限制总像素数。选择 **4K** 等高分辨率时，Teable 会按当前宽高比使用可生成的最大合规尺寸，因此最终宽高可能会有所不同。
  </Accordion>
</AccordionGroup>
