跳转到主要内容

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 会优先参考当前页面。需要跨表格、视图、应用、自动化或文件夹时，可以在输入框中输入 @ 选择相关节点。

​
打开方式

打开表格或视图后，点击右上角的 Cuppy 图标，即可打开 AI 对话。在输入框中描述问题或任务；如果任务会修改数据或创建节点，建议先让 AI 列出计划，再确认执行。

​
AI 会参考哪些内容

AI 会优先参考你当前页面中的信息：
  • 当前表格和视图：包括当前表格、当前视图，以及视图中的筛选和排序结果。
  • 选中的行、列和单元格区域：如果你在网格视图中选中了行、列或矩形单元格区域，AI 会把这些选区作为重点参考。
  • 上传的文件：可以把 PDF、Excel、Word、图片等文件加入对话。
  • @ 让 AI 参考更多节点：在输入框中输入 @，可以把目录树里的表格、视图、应用、自动化或文件夹加入对话。
你也可以直接把文件粘贴或拖拽到输入框中。文件会先显示为附件标签，发送后再交给 AI 参考。 较长的纯文本粘贴会转成 Markdown 附件，避免输入框被大段文本占满。文本和 Markdown 附件可从附件标签中打开预览。

​
输入框控制项

  • 语音输入：点击输入框中的麦克风按钮，允许使用麦克风后开始实时转写，再选择结束或丢弃本次语音输入。
  • 模型：在模型菜单中选择本次对话使用的模型。简单查询、整理、改写可以选择较轻量的模型；复杂规划、跨表分析和应用构建适合选择更强的模型。
  • 智能：在模型菜单中单独选择 智能 级别，用于控制 AI 的思考强度；级别越高，推理越深入。
  • 排队消息：如果 AI 仍在工作时继续发送消息，新消息会进入队列。排队项会像输入框一样显示表格、视图、附件和选区标签。可以点击 编辑 把排队项移回输入框，点击 中断并立即发送 停止当前任务并发送该项，或点击 移除 从队列删除。

​
常见用法

创建表格和自动化

规划业务数据库，创建表格、视图、应用、自动化，或更新已有记录。

分析数据

统计当前表格或视图中的数据，也可以结合多个相关节点分析。

临时图表和报告

基于已查询的数据生成一次性的图表或报告预览。

阅读文件

结合 PDF、Excel、Word、图片等附件回答问题。

​
创建表格和自动化

AI 不只回答问题，也可以协助创建、更新或整理数据。对于新的业务场景，可以先和 AI 讨论数据结构，再让它继续创建表格、视图、应用和自动化。 适合这样使用：
  • 先帮我规划一个客户跟进系统，需要哪些表和字段？
  • 按刚才的规划，帮我创建这些表格、视图和字段。
  • 给任务表添加优先级、负责人、截止时间和状态字段，并创建常用视图。
  • 把选中的记录状态改成已完成。
  • 根据这个 Excel 创建一张新表，并检查字段类型是否合适。
  • 基于这个客户表创建一个 CRM 应用，包含客户列表、客户详情和跟进记录页面。
  • 当新订单创建时，自动通知负责人，并包含订单号、客户名称和金额。
如果你要搭建完整业务数据库，可以先让 AI 规划表结构，再继续让它根据计划创建表格、视图、应用和自动化。
1

先梳理

说明业务目标，例如我要搭一个客户跟进系统，让 AI 先整理需要哪些表格、字段、视图和自动化。
2

确认结构

检查 AI 给出的表格、字段、字段类型和关联关系，补充缺少的规则或流程。
3

再创建

让 AI 根据确认后的计划创建表格和视图，再继续补充应用或自动化。
更多应用创建说明，请参考 应用构建器。更多自动化说明，请参考 自动化。

​
分析数据

你可以直接问当前表格里的数据问题，例如：
  • 按负责人统计本月完成的任务数量。
  • 找出过去 30 天销售额最高的客户。
  • 帮我分析这个视图里的异常记录。
如果问题涉及多个表格，建议用 @ 把相关表格或视图加入对话。 在网格视图中，你也可以选中行、列或矩形单元格区域，然后从右键菜单选择 添加到 AI 对话。选区会以标签形式进入输入框；点击标签时，会重新高亮对应的网格区域。

​
生成临时图表或报告预览

AI 可以根据已经查询到的数据生成一次性的 HTML 预览，适合临时查看图表或报告：
  • 按周生成销售趋势图。
  • 把这个查询结果做成饼图。
  • 基于这些记录生成一份汇总报告。
这种预览不会作为长期应用保存，也不会自动刷新数据。如果你需要长期使用的仪表盘、业务页面或交互式应用，请用 应用构建器 创建应用。

​
阅读文件

上传文件后，可以让 AI 结合文件和表格数据回答问题：
  • 总结这个 PDF，并和当前客户记录关联起来。
  • 读取这个 Excel，帮我找出需要导入的字段。
  • 根据这张图片生成产品描述。

​
记忆

记忆用于保存你明确要求 Cuppy 记住的信息。记忆会按用户和数据库隔离：每个用户在每个数据库中都有独立的记忆，保存在其他数据库中的记忆不会自动出现在当前数据库。
  • 记住当前数据库的信息
在对话中直接说明要记住的内容： 
请记住 xxx。
  • 复用其他数据库的记忆
让 Cuppy 读取指定数据库，并把相关内容保存到当前数据库： 
Cuppy，请读取数据库 ID bsexxxxxxxxxxxx 的记忆，并把相关记忆保存到当前数据库。

​
处理长任务

AI Chat 更适合在当前可见对话中执行前台交互式任务。不要依赖对话中的后台任务或静默运行来处理长时间工作。
1

确认任务是否仍在前台执行

如果界面仍显示 Thinking，或仍在持续返回进度，说明前台执行仍在进行。如果任务显示 Completed，说明本次前台执行已经结束。
2

不要把临时内容当作持久存储

AI 运行环境被重启后，只有记忆文件可以被读取；后台任务、临时文件和中间结果都不会被保存。
3

拆成批次，并约定可见产出

在当前环境下，对话环境存在闲置释放和最长生命周期限制：前台执行结束后，闲置环境大约会在 30 分钟后被释放；单次对话环境也有大约 5 小时的最长生命周期。长时间任务应拆成较小批次处理。每开始一批前，建议先和 AI 约定本批的可见产出，例如写回 Teable、导出结果，或生成可下载文件；确认产出完成后，再继续下一批。
对于长时间或重复性任务，建议根据处理方式选择更合适的功能：

AI 字段

适合逐条记录处理，例如大型表格处理、批量分类、内容处理或填充字段。

自动化

适合在记录创建或更新后重复执行、发送通知，或按计划处理数据。
Teable 正在改进长时间任务的体验和运行能力。在当前阶段，请按以上限制规划长时间任务。

​
提问建议

  • 先说明目标：第一条消息尽量写清楚你想做什么、有哪些条件、希望输出成什么样，例如分析过去 3 个月每周销售趋势，按地区分组，并输出一张趋势表和简短结论。
  • 写清字段名：比如按 创建时间 排序，方便 AI 理解你要操作哪一列数据。
  • 提供多样本示例：需要固定格式输出时，可以提供 3-5 组输入 -> 期望输出示例。
  • 用 @ 选择节点：需要参考表格、视图、应用、自动化或文件夹时，直接输入 @ 选择节点。
  • 先确认再执行：会修改数据、创建表格、创建应用或启用自动化时，建议先让 AI 说明将要做哪些改动。
  • 按任务选择模型：如果你的空间支持选择模型，简单查询、整理、改写可以使用较轻量的模型；复杂规划、跨表分析、应用构建再使用更强模型。
  • 调整智能级别：智能 级别会影响 AI 的思考强度；级别越高，推理越深入。
  • 换主题时新开对话：话题变化、对话太长，或想减少上下文消耗时，建议新开一个对话。

​
常见问题

在输入框中输入 @，选择需要参考的节点。如果是在网格视图中，也可以先选中行、列或单元格区域，再从右键菜单选择 添加到 AI 对话。
不会。临时图表和报告预览是一次性的 HTML 预览，不会保存为应用，也不会自动刷新数据。如果需要长期使用的仪表盘或交互式页面，请用 应用构建器 创建应用。
不会。记忆会按用户和数据库隔离。如果你想复用其他数据库的记忆，需要让 Cuppy 读取那个数据库的记忆，并把相关内容保存到当前数据库。
不建议把 AI 对话当作后台任务使用。请在当前可见对话中继续协作，并让 Cuppy 把结果写回 Teable、导出结果，或生成可下载文件。
每个用户最多可同时运行 3 个 Agent，包括 AI 对话和应用构建器。如果看到 Cuppy 正在另一个对话中执行，请稍候，说明已有任务正在运行，请等待 Cuppy 完成上一个任务后再继续。
一次 AI 对话可能包含多个处理步骤，对话里和账单里都会汇总展示同一轮对话的算力消耗。已经完成并保存的工作可以继续使用；如果最后一步意外中断，会自动返还中断那一步消耗的算力。你可以继续在同一段对话里推进后续工作。
新消息会进入队列。你可以编辑排队消息、移除排队消息，或点击 中断并立即发送 停止当前任务并发送这条消息。
Last modified on May 20, 2026