> ## 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 对话用于分析当前表格数据、解释记录内容、生成临时图表，也可以协助创建或更新表格、视图、应用和自动化。
AI 会优先参考当前页面。需要跨表格、视图、应用、自动化或文件夹时，可以在输入框中输入 `@` 选择相关节点。
## 打开方式
打开表格或视图后，点击右上角的 
，即可打开 AI 对话。在输入框中描述问题或任务；如果任务会修改数据或创建节点，建议先让 AI 列出计划，再确认执行。
## AI 会参考哪些内容
AI 会优先参考你当前页面中的信息：
* **当前表格和视图**：包括当前表格、当前视图，以及视图中的筛选和排序结果。
* **选中的行、列和单元格**：如果你在表格视图中选中了行、列、单个单元格或单元格区域，AI 会把这些选区作为重点参考。
* **上传的文件**：可以把 PDF、Excel、Word、图片等文件加入对话。
* **`@` 让 AI 参考更多节点**：在输入框中输入 `@`，可以把目录树里的表格、视图、应用、自动化或文件夹加入对话。
你也可以直接把文件粘贴或拖拽到输入框中。文件会先显示为附件标签，发送后再交给 AI 参考。
较长的纯文本粘贴会转成 Markdown 附件，避免输入框被大段文本占满。文本和 Markdown 附件可从附件标签中打开预览。
## 输入框控制项
* **语音输入**：点击输入框中的麦克风按钮，允许使用麦克风后开始实时转写，再选择结束或丢弃本次语音输入。
* **模型**：在模型菜单中选择本次对话使用的模型。简单查询、整理、改写可以选择较轻量的模型；复杂规划、跨表分析和应用构建适合选择更强的模型。
* **智能**：在模型菜单中单独选择 **智能** 级别，用于控制 AI 的思考强度；级别越高，推理越深入。
* **密钥管理**：打开 **+** 菜单，选择 **密钥管理**，保存 API Key 或其他凭证。AI 对话运行时可通过环境变量读取这些值。已保存的值不会明文展示；需要修改时，输入新值覆盖即可。
* **技能**：打开 **+** 菜单，选择 **技能**，可以在当前对话上下文中导入、启用、停用或试用技能。个人技能仅自己可用；Base 技能会与当前 Base 内协作者共用。在输入框中输入 `/`，可以选择已启用的技能。
* **排队消息**：如果 AI 仍在工作时继续发送消息，新消息会进入队列。排队项会像输入框一样显示表格、视图、附件和选区标签。可以点击 **编辑** 把排队项移回输入框；当 **发送补充，不中断模型运行** 可用时，可将纯文本补充发送给当前任务；也可以点击 **移除** 从队列删除。无法作为补充发送的排队项，会等当前任务结束后再继续发送。
## 常见用法
规划业务数据库，创建表格、视图、应用、自动化，或更新已有记录。
统计当前表格或视图中的数据，也可以结合多个相关节点分析。
基于已查询的数据生成一次性的图表或报告预览。
结合 PDF、Excel、Word、图片等附件回答问题。
### 创建表格和自动化
AI 不只回答问题，也可以协助创建、更新或整理数据。对于新的业务场景，可以先和 AI 讨论数据结构，再让它继续创建表格、视图、应用和自动化。
适合这样使用：
* 先帮我规划一个客户跟进系统，需要哪些表和字段？
* 按刚才的规划，帮我创建这些表格、视图和字段。
* 给任务表添加优先级、负责人、截止时间和状态字段，并创建常用视图。
* 把选中的记录状态改成已完成。
* 根据这个 Excel 创建一张新表，并检查字段类型是否合适。
* 基于这个客户表创建一个 CRM 应用，包含客户列表、客户详情和跟进记录页面。
* 当新订单创建时，自动通知负责人，并包含订单号、客户名称和金额。
如果你要搭建完整业务数据库，可以先让 AI 规划表结构，再继续让它根据计划创建表格、视图、应用和自动化。
说明业务目标，例如我要搭一个客户跟进系统，让 AI 先整理需要哪些表格、字段、视图和自动化。
检查 AI 给出的表格、字段、字段类型和关联关系，补充缺少的规则或流程。
让 AI 根据确认后的计划创建表格和视图，再继续补充应用或自动化。
更多应用创建说明，请参考 [应用构建器](/zh/basic/ai/app-builder)。更多自动化说明，请参考 [自动化](/zh/basic/automation)。
### 分析数据
你可以直接问当前表格里的数据问题，例如：
* 按负责人统计本月完成的任务数量。
* 找出过去 30 天销售额最高的客户。
* 帮我分析这个视图里的异常记录。
如果问题涉及多个表格，建议用 `@` 把相关表格或视图加入对话。
在表格视图中，你也可以选中行、列、单个单元格或单元格区域，然后从右键菜单选择 **添加到 AI 对话**。选区会以标签形式进入输入框；点击标签时，会重新高亮对应的表格区域。
### 生成临时图表或报告预览
AI 可以根据已经查询到的数据生成一次性的 HTML 预览，适合临时查看图表或报告：
* 按周生成销售趋势图。
* 把这个查询结果做成饼图。
* 基于这些记录生成一份汇总报告。
这种预览不会作为长期应用保存，也不会自动刷新数据。如果你需要长期使用的仪表盘、业务页面或交互式应用，请用 [应用构建器](/zh/basic/ai/app-builder) 创建应用。
### 阅读文件
上传文件后，可以让 AI 结合文件和表格数据回答问题：
* 总结这个 PDF，并和当前客户记录关联起来。
* 读取这个 Excel，帮我找出需要导入的字段。
* 根据这张图片生成产品描述。
### 记忆
记忆用于保存你明确要求 Cuppy 记住的信息。记忆会按用户和数据库隔离：每个用户在每个数据库中都有独立的记忆，保存在其他数据库中的记忆不会自动出现在当前数据库。
* 记住当前数据库的信息
在对话中直接说明要记住的内容：
```text theme={null}
请记住 xxx。
```
* 复用其他数据库的记忆
让 Cuppy 读取指定数据库，并把相关内容保存到当前数据库：
```text theme={null}
Cuppy，请读取数据库 ID bsexxxxxxxxxxxx 的记忆，并把相关记忆保存到当前数据库。
```
### 处理长任务
AI Chat 更适合在当前可见对话中执行前台交互式任务。不要依赖对话中的后台任务或静默运行来处理长时间工作。
如果界面仍显示 `Thinking`，或仍在持续返回进度，说明前台执行仍在进行。如果任务显示 `Completed`，说明本次前台执行已经结束。
AI 运行环境被重启后，只有记忆文件可以被读取；后台任务、临时文件和中间结果都不会被保存。
在当前环境下，对话环境存在闲置释放和最长生命周期限制：前台执行结束后，闲置环境大约会在 30 分钟后被释放；单次对话环境也有大约 5 小时的最长生命周期。长时间任务应拆成较小批次处理。每开始一批前，建议先和 AI 约定本批的可见产出，例如写回 Teable、导出结果，或生成可下载文件；确认产出完成后，再继续下一批。
对于长时间或重复性任务，建议根据处理方式选择更合适的功能：
适合逐条记录处理，例如大型表格处理、批量分类、内容处理或填充字段。
适合在记录创建或更新后重复执行、发送通知，或按计划处理数据。
Teable 正在改进长时间任务的体验和运行能力。在当前阶段，请按以上限制规划长时间任务。
## 提问建议
* **先说明目标**：第一条消息尽量写清楚你想做什么、有哪些条件、希望输出成什么样，例如分析过去 3 个月每周销售趋势，按地区分组，并输出一张趋势表和简短结论。
* **写清字段名**：比如按 `创建时间` 排序，方便 AI 理解你要操作哪一列数据。
* **提供多样本示例**：需要固定格式输出时，可以提供 3-5 组输入 -> 期望输出示例。
* **用 `@` 选择节点**：需要参考表格、视图、应用、自动化或文件夹时，直接输入 `@` 选择节点。
* **先确认再执行**：会修改数据、创建表格、创建应用或启用自动化时，建议先让 AI 说明将要做哪些改动。
* **按任务选择模型**：如果你的空间支持选择模型，简单查询、整理、改写可以使用较轻量的模型；复杂规划、跨表分析、应用构建再使用更强模型。
* **调整智能级别**：**智能** 级别会影响 AI 的思考强度；级别越高，推理越深入。
* **换主题时新开对话**：话题变化、对话太长，或想减少上下文消耗时，建议新开一个对话。
## 常见问题
在输入框中输入 `@`，选择需要参考的节点。如果是在表格视图中，也可以先选中行、列、单个单元格或单元格区域，再从右键菜单选择 **添加到 AI 对话**。
不会。临时图表和报告预览是一次性的 HTML 预览，不会保存为应用，也不会自动刷新数据。如果需要长期使用的仪表盘或交互式页面，请用 [应用构建器](/zh/basic/ai/app-builder) 创建应用。
不会。记忆会按用户和数据库隔离。如果你想复用其他数据库的记忆，需要让 Cuppy 读取那个数据库的记忆，并把相关内容保存到当前数据库。
不建议把 AI 对话当作后台任务使用。请在当前可见对话中继续协作，并让 Cuppy 把结果写回 Teable、导出结果，或生成可下载文件。
每个用户最多可同时运行 3 个 Agent，包括 AI 对话和应用构建器。如果看到 `Cuppy 正在另一个对话中执行，请稍候`，说明已有任务正在运行，请等待 Cuppy 完成上一个任务后再继续。
一次 AI 对话可能包含多个处理步骤，对话里和账单里都会汇总展示同一轮对话的算力消耗。已经完成并保存的工作可以继续使用；如果最后一步意外中断，会自动返还中断那一步消耗的算力。你可以继续在同一段对话里推进后续工作。
新消息会进入队列。你可以编辑或移除排队消息；当 **发送补充，不中断模型运行** 可用时，也可以把纯文本补充发送给当前任务。
打开 **+** 菜单并选择 **技能**，可以导入或管理技能；也可以在输入框中输入 `/` 选择已启用的技能。个人技能适合自己使用；需要让同一个 Base 中的协作者也能使用时，可以使用 Base 技能。拥有 Base 管理权限的用户可以添加 Base 技能。如果 AI 对话生成了 `.skill` 文件，可以在文件卡片上点击 **安装** 来添加。
复制用户消息时，表格、视图、应用、自动化、文件夹、选区和附件会保留为标记文本。再次粘贴到 AI 对话时，Teable 会把可识别的标记恢复成标签。
在输入框的 **+** 菜单中选择 **密钥管理**。AI 对话可以在运行时使用这些值，不需要把明文密钥写进提示词。