Skip to main content
云端版本所有方案可用；私有部署版本需要商业版及以上方案。
AI 对话用于分析当前表格数据、解释记录内容、生成图表和报告，也可以协助创建或更新表格、视图、应用和自动化。 AI 会优先参考当前页面。需要跨表格、视图、应用、自动化或文件夹时，可以在输入框中输入 @ 选择相关节点。

​
打开方式

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

​
AI 会参考哪些内容

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

​
输入框控制项

  • 语音输入：点击输入框中的麦克风按钮，允许使用麦克风后开始录音。录制时可以选择 结束语音输入 或 丢弃本次语音输入。选择结束后，Teable 会把录音内容转写到输入框中。
  • 模型：在模型菜单中选择本次对话使用的模型档位。菜单按能力从高到低列出 Ultra、Smart、Standard、Lite，每档标出背后实际使用的模型；管理员可以随时更换某一档背后的模型，也可以只开放其中几档，你不需要重新选择。简单查询、整理、改写选择较低的档位；复杂规划、跨表分析和应用构建选择更高的档位。
  • 智能：在模型菜单中单独选择 智能 级别，用于控制 AI 的思考强度；级别越高，推理越深入。
  • 我的 Secret：打开 + → 更多 → 我的 Secret，在 设置 → 集成 中保存 API Key 或其他凭证。这些值属于你个人，AI 对话运行时可通过环境变量读取，也可以按需授权给某个应用或自动化使用，详见 凭据与集成。
  • 授权卡片：当 AI 需要访问第三方账号或某个 Secret 时，会在对话中固定一张卡片，等你处理后再继续这一轮。Cuppy 需要使用这个账号完成任务时，点击 连接 走一次 OAuth；应用或自动化运行时要用这份凭据时，可以 连接我的账号，或直接授权你已有的凭据。点击 跳过 则不提供这份凭据，AI 会在不使用它的情况下继续处理可完成的部分，详见 凭据与集成。
  • 网页抓取：打开 + 菜单，选择 网页抓取，按平台和数据类型挑一项。条目分两类：一类贴链接就抓，比如 LinkedIn 的 个人资料、Amazon 的 商品评论；一类按关键词、话题或姓名去搜，比如 TikTok 的 视频搜索、Reddit 的 板块的帖子。挑好之后 Teable 会把抓取指令预填到输入框，末尾留出需要你补充的部分。也可以选 任意网页，直接粘贴链接抓取。
  • 技能：打开 + 菜单，选择 技能，可以在当前对话中导入、启用、停用或试用技能。导入时需要选择谁能用这个技能：选 个人 只有自己能用，选 项目 则当前项目的协作者都能用，选 空间 则当前空间的所有成员都能用。在输入框中输入 /，可以选择已启用的技能。需要连接或迁移外部系统时，请参阅 Connect & Migrate Everything。
  • 上下文用量：输入框旁的圆环显示当前对话占用了多少模型上下文窗口，点击可查看百分比和 token 数量。上下文接近用满时，Teable 会压缩对话内容；如果希望从干净的上下文开始，可以新建对话。
  • 文件管理：打开 + → 更多 → 文件管理，可以查看当前对话沙箱中的文件。可以预览支持的文件类型、下载文件，也可以删除不再需要的文件或文件夹。需要先开始一段对话，才会有对应文件可管理。
  • 消息队列：AI 还在工作时继续发消息不会打断它，消息会排进输入框上方的队列，等这一轮结束后一起发出。排队项和输入框一样保留表格、视图、附件和选区标签，可以 移除，也可以用 … → 编辑消息 放回输入框；纯文本消息还能点 调整方向，不等这一轮结束就把这段话交给它。如果这一轮正停在一张等你处理的卡片上（例如授权卡片、AI 的提问），纯文本消息不进队列：卡片会关闭并记为 已跳过，你这条消息立即作为下一条指令交给这一轮，不必先处理卡片。带附件的消息仍然进入队列。

​
管理对话

点击对话面板右上角的 历史记录，可以查看你在当前项目中的对话，也可以按名称搜索。 对话名称旁的圆点用于标出哪些对话需要你回去处理。等待你回复 表示这一轮停在需要你参与的环节，例如 AI 的提问、一次连接授权、选择表格或凭据请求，在你回复之前它不会继续。回复失败 表示上一次回复没有正常结束，可以进去重新提问。生成中… 和未读圆点只说明进度和有新回复，不需要你操作。 在对话的 … 菜单中可以 置顶、重命名、归档 或删除这个对话。删除会一并删除它的全部消息，无法恢复。 历史记录默认展示最近 100 个对话。常用的对话建议 置顶：置顶的对话排在最前，且不受这个数量限制，不会随着新对话增多被挤出列表。也可以拖动对话调整位置。 应用构建器的对话以对应应用命名，不能归档。

​
已归档对话

归档会把对话移出历史记录列表，但不会删除内容。打开左下角头像 → 设置 → 已归档对话，可以看到你在各个项目中归档的对话。点击 恢复 后，对话会重新出现在所属项目的历史记录中；确认不再需要时也可以在这里删除。

​
常见用法

创建表格和自动化

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

分析数据

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

图表和报告

把查询结果做成图表、报告或小型交互页面，随时可以重新打开和分享。

阅读文件

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

​
创建表格和自动化

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

先梳理

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

确认结构

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

再创建

让 AI 根据确认后的计划创建表格和视图，再继续补充应用或自动化。
每次回答下方的 本次更改 会按资源列出这一轮的改动，包括字段、视图、记录的增删改数量和应用、自动化的发布与启停。点击其中一项可跳转到对应资源核对。 更多应用创建说明，请参考 应用构建器。更多自动化说明，请参考 自动化。

​
分析数据

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

​
生成图表和报告

让 AI 把查询到的数据做成图表、书面报告或小型交互页面：
  • 按周生成销售趋势图。
  • 把这个查询结果做成饼图。
  • 基于这些记录生成一份汇总报告。
这些结果会以 Artifact 的形式生成：在对话中显示为一张卡片，在独立的查看器中打开，对话结束后仍然可以再次访问。具体用法见 Artifact。
Artifact 保存的是 AI 生成它时写入的数据，不会自动刷新。如果需要持续读取表格最新数据，或者需要收集输入、保存状态的页面，请用 应用构建器 创建应用。

​
生成图片

让 AI 直接出图，用于产品概念图、文章配图、海报草稿等：
  • 画一张这个产品的使用场景图。
  • 根据这条记录的描述生成一张封面图。
  • 参考这张图，换成冬季配色再出三张。
把已有图片加入对话即可作为参考图，前提是所选模型支持图生图。 对话中会出现一张生图卡片，显示正在用哪个模型生成、还剩几张，完成后以图库形式展示，点击可查看大图。生成的图片保存在当前对话沙箱中，可在 文件管理 中下载。停止这一轮时，尚未完成的图片会一并取消。
AI 对话、应用构建器 和例行任务都可以生成图片；在 IM 中与 Cuppy 对话时不支持。

​
阅读文件

上传文件后，可以让 AI 结合文件和表格数据回答问题：
  • 总结这个 PDF，并和当前客户记录关联起来。
  • 读取这个 Excel，帮我找出需要导入的字段。
  • 根据这张图片生成产品描述。
上传到对话中的文件，以及对话中生成的文件，会保存在当前对话沙箱中，之后可通过 文件管理 查看。 当一条回复同时生成多个文件时，可以点击文件卡片下方的 下载全部，把它们打包成一个压缩包下载。

​
记忆

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

​
处理长任务

AI 对话的单次对话环境最长可运行约 24 小时，足以完成大多数数据分析、文件处理和应用构建任务。执行长任务时，请保留当前对话，以便查看进度，并在需要时补充信息。
1

在当前对话中查看进度

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

在关键节点保存结果

对于包含多个阶段的任务，可以让 Cuppy 在关键节点把结果写回 Teable、导出结果，或生成可下载文件。即使对话环境之后被释放，已保存的工作仍可继续使用。
3

了解环境何时释放

单次对话环境的最长生命周期约为 24 小时。前台执行结束后，闲置环境大约会在 30 分钟后被释放。如果 AI 运行环境重启，临时文件和未保存的中间结果不会被保留。
对于长时间或重复性任务，建议根据处理方式选择更合适的功能：

AI 字段

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

自动化

适合在记录创建或更新后重复执行、发送通知，或按计划处理数据。

​
Artifact

AI 生成图表、报告、看板式页面或小型交互工具时，会把结果保存为 Artifact：一个独立成页、在对话之外渲染的页面。Artifact 在对话中显示为卡片，之后一直可用，形式是可交互的 HTML 页面或 Markdown 报告。 点击卡片即可打开 Artifact。在查看器中可以：
  • 用 全屏 或 在新页面打开 获得更大的显示区域。
  • 下载 当前版本的文件。
  • 展开版本列表查看历史版本，用 恢复此版本 把它设为当前版本。
  • 删除 该 Artifact。删除后对话里的卡片会显示为已删除，因此确认不再需要这个结果时再删。
要修改 Artifact，在同一段对话里告诉 AI 即可。每次修改是同一个 Artifact 的新版本，而不是新建一个，因此分享链接继续有效，也仍然可以回到旧版本。如果页面运行出错，查看器会显示报错，并提供 让 AI 修复，把错误信息带回对话继续修。

​
分享 Artifact

Artifact 默认只有创建者本人能打开，要让别人查看，需要开启分享链接。
1

开启分享

在查看器中点击 分享，打开 开启分享，Teable 会生成链接。
2

设置可见范围

把 可见范围 设为 任何拥有链接的人，或设为 空间成员，只允许已登录的空间成员打开。
3

设置密码（可选）

在高级设置中开启 密码保护 并设置密码，访问者需要先输入密码才能看到内容。
4

发送链接

点击 复制链接 复制。如果链接扩散范围超出预期，用 重置链接 换一条新链接，原链接随即失效。

​
找回之前的 Artifact

打开 + → 更多 → Artifact 管理，可以浏览你在各个对话中创建的全部 Artifact。按名称搜索后打开，即可查看或重新分享。

​
提问建议

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

​
常见问题

在输入框中输入 @，选择需要参考的节点。如果是在表格视图中，也可以先选中行、列、单个单元格或单元格区域，再从右键菜单选择 添加到 AI 对话。
可以。AI 不局限于当前对话所属的项目，能查找你有权限访问的其他项目并在其中操作。直接在需求里说出项目名称即可，例如「把这张表和销售项目里的订单表做个对比」。@ 只能选择当前项目中的节点；没有特别指明时，AI 仍在当前对话所属的项目中执行。
会。它们会保存为 Artifact，带有版本历史，也可以生成分享链接，随时能从 + → 更多 → Artifact 管理 重新打开。Artifact 保存的是生成时的数据，不会自动刷新；需要读取表格最新数据的页面，请用 应用构建器 创建应用。
默认不能，Artifact 只有创建者本人可以打开。在查看器中开启 开启分享 并把链接发给对方即可；如果内容不应流出空间，把可见范围设为 空间成员。
默认一次最多 5 张，需要更多时让 AI 分几次生成。同一空间同时进行的生图数量也有上限，超出的会排队等待。
可选用的生图模型来自当前项目的 AI 配置：空间自己配置的模型排在前面，其次是 Teable 提供的模型。项目中没有可用的生图模型时，AI 不会提供生图能力。
图片成功保存后才计入算力，生成失败或被取消的图片不计费；在计费页的 算力用量统计 中，这类消耗的类型为 AI 生图。空间配置了自己的模型（BYOK）时，用这些模型出图不受空间算力用尽的限制。
不会。记忆会按用户和项目隔离。如果你想复用其他项目的记忆，需要让 Cuppy 读取那个项目的记忆，并把相关内容保存到当前项目。
不建议把 AI 对话当作后台任务使用。请在当前可见对话中继续协作，并让 Cuppy 把结果写回 Teable、导出结果，或生成可下载文件。
每个用户最多可同时运行 3 个 Agent，包括 AI 对话和应用构建器。如果看到 Cuppy 正在另一个对话中执行，请稍候，说明已有任务正在运行，请等待 Cuppy 完成上一个任务后再继续。
一次 AI 对话可能包含多个处理步骤，对话里和账单里都会汇总展示同一轮对话的算力消耗。已经完成并保存的工作可以继续使用；如果最后一步意外中断，会自动返还中断那一步消耗的算力。你可以继续在同一段对话里推进后续工作。
新消息会排进输入框上方的发送队列，不会打断当前运行；这一轮结束后，Teable 会把整个队列合并成一条发出。队列保存在服务端，刷新页面不会丢失，同一段对话在不同标签页和设备上看到的队列也一致。排队期间，可以用 移除 删除它，或用 编辑消息 放回输入框。纯文本消息还可以点 调整方向 立刻送进正在运行的这一轮，送进去之后会在对话中标记为 已引导对话。一段对话最多排队 30 条消息。超出后这条消息不会进入队列，Teable 会提示 发送队列已满，请等 Cuppy 处理完再发。
停止当前运行时，队列会一起暂停，这样你为当前回答按下的停止就不会把排队消息也发出去。此时队列标题会显示 由于你中断了当前响应，队列已暂停。点击 继续 即可放行；直接发下一条消息也可以，新一轮开始同样会解除暂停。
打开 + 菜单并选择 技能，可以导入或管理技能；也可以在输入框中输入 / 选择已启用的技能。导入时按使用范围选择：只有自己用，选个人；同一个项目的协作者都要用，选项目；整个空间都要用，选空间。拥有项目管理权限的用户可以添加项目技能，空间的所有者和创建者可以添加空间技能。如果 AI 对话生成了 .skill 文件，可以在文件卡片上点击 安装 来添加。
同名技能只会生效一个，团队共用的版本优先于个人版本：项目技能优先于空间技能，空间技能优先于个人技能；在 App 或 Bot 的对话中，为它单独添加的技能最优先。想让所有人换用新版本，就更新项目或空间中的那一份。
文件管理 里只有两个目录：uploads 存放你上传的文件，outputs 存放对话中生成的文件。这两个目录使用独立存储，沙箱释放或重建后内容仍然在，可以随时回来预览、下载或删除。Cuppy 在这两个目录之外写的文件属于临时文件，例如脚本运行时的中间产物。它们不会出现在 文件管理 中，沙箱重启后也不再保留。需要长期留存的结果，请让 Cuppy 写入 outputs、写回 Teable，或者及时下载（一条回复生成多个文件时可以用 下载全部）。
复制用户消息时，表格、视图、应用、自动化、文件夹、选区和附件会保留为标记文本。再次粘贴到 AI 对话时，Teable 会把可识别的标记恢复成标签。
在输入框的 + → 更多 中选择 我的 Secret。AI 对话可以在运行时使用这些值，不需要把明文密钥写进提示词。
菜单收录的是常用平台，直接用自然语言说清楚要抓哪个网站的什么内容即可，AI 会去找对应的数据源。
抓搜索结果、动态、评论这类列表内容时，每个链接或关键词默认最多返回 10 条。需要更多可以在提问里写明数量，最多 50 条。抓单个页面得到的就是那一条，不受这个数量影响。
最后修改于 2026年9月19日