云端版本所有方案可用；私有部署版本需要商业版及以上方案。
@ 选择相关节点。
打开方式
打开表格或视图后，点击右上角的
，即可打开 AI 对话。在输入框中描述问题或任务；如果任务会修改数据或创建节点，建议先让 AI 列出计划，再确认执行。
AI 会参考哪些内容
AI 会优先参考你当前页面中的信息：- 当前表格和视图：包括当前表格、当前视图，以及视图中的筛选和排序结果。
- 选中的行、列和单元格：如果你在表格视图中选中了行、列、单个单元格或单元格区域，AI 会把这些选区作为重点参考。
- 上传的文件：可以把 PDF、Excel、Word、图片等文件加入对话。
@让 AI 参考更多节点：在输入框中输入@，可以把目录树里的表格、视图、应用、自动化或文件夹加入对话。
输入框控制项
- 语音输入：点击输入框中的麦克风按钮，允许使用麦克风后开始录音。录制时可以选择 结束语音输入 或 丢弃本次语音输入。选择结束后，Teable 会把录音内容转写到输入框中。
- 模型：在模型菜单中选择本次对话使用的模型。简单查询、整理、改写可以选择较轻量的模型；复杂规划、跨表分析和应用构建适合选择更强的模型。
- 智能：在模型菜单中单独选择 智能 级别，用于控制 AI 的思考强度；级别越高，推理越深入。
- 密钥管理：打开 + 菜单，选择 密钥管理，保存 API Key 或其他凭证。AI 对话运行时可通过环境变量读取这些值。已保存的值不会明文展示；需要修改时，输入新值覆盖即可。
- 集成连接：当 AI 需要访问第三方账号时，会在对话中显示类似 连接 Slack 的卡片。点击 连接 可通过 OAuth 授权；点击 跳过 会取消本次授权，AI 会在不使用该连接的情况下继续处理可完成的部分。
- 技能：打开 + 菜单，选择 技能，可以在当前对话中导入、启用、停用或试用技能。导入时需要选择谁能用这个技能：选 个人 只有自己能用，选 数据库 则当前数据库的协作者都能用，选 空间 则当前空间的所有成员都能用。在输入框中输入
/，可以选择已启用的技能。需要连接或迁移外部系统时，请参阅 Connect & Migrate Everything。 - 上下文用量：输入框旁的圆环显示当前对话占用了多少模型上下文窗口，点击可查看百分比和 token 数量。上下文接近用满时，Teable 会压缩对话内容；如果希望从干净的上下文开始，可以新建对话。
- 文件管理：打开 + → 更多 → 文件管理，可以查看当前对话沙箱中的文件。可以预览支持的文件类型、下载文件，也可以删除不再需要的文件或文件夹。需要先开始一段对话，才会有对应文件可管理。
- 消息队列：AI 还在工作时继续发消息不会打断它，消息会排进输入框上方的队列，等这一轮结束后一起发出。排队项和输入框一样保留表格、视图、附件和选区标签，可以 移除，也可以用 … → 编辑消息 放回输入框；纯文本消息还能点 调整方向，不等这一轮结束就把这段话交给它。
常见用法
创建表格和自动化
规划业务数据库，创建表格、视图、应用、自动化，或更新已有记录。
分析数据
统计当前表格或视图中的数据，也可以结合多个相关节点分析。
图表和报告
把查询结果做成图表、报告或小型交互页面，随时可以重新打开和分享。
阅读文件
结合 PDF、Excel、Word、图片等附件回答问题。
创建表格和自动化
AI 不只回答问题，也可以协助创建、更新或整理数据。对于新的业务场景，可以先和 AI 讨论数据结构，再让它继续创建表格、视图、应用和自动化。 适合这样使用：- 先帮我规划一个客户跟进系统，需要哪些表和字段？
- 按刚才的规划，帮我创建这些表格、视图和字段。
- 给任务表添加优先级、负责人、截止时间和状态字段，并创建常用视图。
- 把选中的记录状态改成已完成。
- 根据这个 Excel 创建一张新表，并检查字段类型是否合适。
- 基于这个客户表创建一个 CRM 应用，包含客户列表、客户详情和跟进记录页面。
- 当新订单创建时，自动通知负责人，并包含订单号、客户名称和金额。
1
先梳理
说明业务目标，例如我要搭一个客户跟进系统，让 AI 先整理需要哪些表格、字段、视图和自动化。
2
确认结构
检查 AI 给出的表格、字段、字段类型和关联关系，补充缺少的规则或流程。
3
再创建
让 AI 根据确认后的计划创建表格和视图，再继续补充应用或自动化。
分析数据
你可以直接问当前表格里的数据问题，例如：- 按负责人统计本月完成的任务数量。
- 找出过去 30 天销售额最高的客户。
- 帮我分析这个视图里的异常记录。
@ 把相关表格或视图加入对话。
在表格视图中，你也可以选中行、列、单个单元格或单元格区域，然后从右键菜单选择 添加到 AI 对话。选区会以标签形式进入输入框；点击标签时，会重新高亮对应的表格区域。列选区标签会优先显示字段名；列数较多时，只显示前几个字段名和剩余数量。
生成图表和报告
让 AI 把查询到的数据做成图表、书面报告或小型交互页面：- 按周生成销售趋势图。
- 把这个查询结果做成饼图。
- 基于这些记录生成一份汇总报告。
Artifact 保存的是 AI 生成它时写入的数据，不会自动刷新。如果需要持续读取表格最新数据，或者需要收集输入、保存状态的页面，请用 应用构建器 创建应用。
阅读文件
上传文件后，可以让 AI 结合文件和表格数据回答问题：- 总结这个 PDF，并和当前客户记录关联起来。
- 读取这个 Excel，帮我找出需要导入的字段。
- 根据这张图片生成产品描述。
记忆
记忆用于保存你明确要求 Cuppy 记住的信息。记忆会按用户和数据库隔离：每个用户在每个数据库中都有独立的记忆，保存在其他数据库中的记忆不会自动出现在当前数据库。- 记住当前数据库的信息
- 复用其他数据库的记忆
处理长任务
AI 对话的单次对话环境最长可运行约 24 小时，足以完成大多数数据分析、文件处理和应用构建任务。执行长任务时，请保留当前对话，以便查看进度，并在需要时补充信息。1
在当前对话中查看进度
如果界面显示
Thinking，或仍在持续返回进度，说明任务仍在运行。如果显示 Completed，说明本次运行已结束。2
在关键节点保存结果
对于包含多个阶段的任务，可以让 Cuppy 在关键节点把结果写回 Teable、导出结果，或生成可下载文件。即使对话环境之后被释放，已保存的工作仍可继续使用。
3
了解环境何时释放
单次对话环境的最长生命周期约为 24 小时。前台执行结束后，闲置环境大约会在 30 分钟后被释放。如果 AI 运行环境重启，临时文件和未保存的中间结果不会被保留。
AI 字段
适合逐条记录处理，例如大型表格处理、批量分类、内容处理或填充字段。
自动化
适合在记录创建或更新后重复执行、发送通知，或按计划处理数据。
Artifact
AI 生成图表、报告、看板式页面或小型交互工具时，会把结果保存为 Artifact：一个独立成页、在对话之外渲染的页面。Artifact 在对话中显示为卡片，之后一直可用，形式是可交互的 HTML 页面或 Markdown 报告。 点击卡片即可打开 Artifact。在查看器中可以：- 用 全屏 或 在新页面打开 获得更大的显示区域。
- 下载 当前版本的文件。
- 展开版本列表查看历史版本，用 恢复此版本 把它设为当前版本。
- 删除 该 Artifact。删除后对话里的卡片会显示为已删除，因此确认不再需要这个结果时再删。
分享 Artifact
Artifact 默认只有创建者本人能打开，要让别人查看，需要开启分享链接。1
开启分享
在查看器中点击 分享，打开 开启分享，Teable 会生成链接。
2
设置可见范围
把 可见范围 设为 任何拥有链接的人，或设为 空间成员，只允许已登录的空间成员打开。
3
设置密码（可选）
在高级设置中开启 密码保护 并设置密码，访问者需要先输入密码才能看到内容。
4
发送链接
点击 复制链接 复制。如果链接扩散范围超出预期，用 重置链接 换一条新链接，原链接随即失效。
找回之前的 Artifact
打开 + → 更多 → Artifact 管理，可以浏览你在各个对话中创建的全部 Artifact。按名称搜索后打开，即可查看或重新分享。提问建议
- 先说明目标：第一条消息尽量写清楚你想做什么、有哪些条件、希望输出成什么样，例如分析过去 3 个月每周销售趋势，按地区分组，并输出一张趋势表和简短结论。
- 写清字段名：比如按
创建时间排序，方便 AI 理解你要操作哪一列数据。 - 提供多样本示例：需要固定格式输出时，可以提供 3-5 组输入 -> 期望输出示例。
- 用
@选择节点：需要参考表格、视图、应用、自动化或文件夹时，直接输入@选择节点。 - 先确认再执行：会修改数据、创建表格、创建应用或启用自动化时，建议先让 AI 说明将要做哪些改动。
- 按任务选择模型：如果你的空间支持选择模型，简单查询、整理、改写可以使用较轻量的模型；复杂规划、跨表分析、应用构建再使用更强模型。
- 调整智能级别：智能 级别会影响 AI 的思考强度；级别越高，推理越深入。
- 换主题时新开对话：话题变化、对话太长，或想减少上下文消耗时，建议新开一个对话。
常见问题
如何让 AI 对话参考其他表格、视图、应用或自动化？
如何让 AI 对话参考其他表格、视图、应用或自动化？
在输入框中输入
@，选择需要参考的节点。如果是在表格视图中，也可以先选中行、列、单个单元格或单元格区域，再从右键菜单选择 添加到 AI 对话。AI 生成的图表和报告会保存吗？
AI 生成的图表和报告会保存吗？
会。它们会保存为 Artifact，带有版本历史，也可以生成分享链接，随时能从 + → 更多 → Artifact 管理 重新打开。Artifact 保存的是生成时的数据，不会自动刷新；需要读取表格最新数据的页面，请用 应用构建器 创建应用。
同事能打开我创建的 Artifact 吗？
同事能打开我创建的 Artifact 吗？
默认不能，Artifact 只有创建者本人可以打开。在查看器中开启 开启分享 并把链接发给对方即可；如果内容不应流出空间，把可见范围设为 空间成员。
记忆会跨数据库生效吗？
记忆会跨数据库生效吗？
不会。记忆会按用户和数据库隔离。如果你想复用其他数据库的记忆，需要让 Cuppy 读取那个数据库的记忆，并把相关内容保存到当前数据库。
AI 对话可以作为后台任务运行吗？
AI 对话可以作为后台任务运行吗？
不建议把 AI 对话当作后台任务使用。请在当前可见对话中继续协作，并让 Cuppy 把结果写回 Teable、导出结果，或生成可下载文件。
为什么提示 Cuppy 正在另一个对话中执行？
为什么提示 Cuppy 正在另一个对话中执行？
每个用户最多可同时运行 3 个 Agent，包括 AI 对话和应用构建器。如果看到
Cuppy 正在另一个对话中执行，请稍候，说明已有任务正在运行，请等待 Cuppy 完成上一个任务后再继续。AI 运行失败时如何返还算力？
AI 运行失败时如何返还算力？
一次 AI 对话可能包含多个处理步骤，对话里和账单里都会汇总展示同一轮对话的算力消耗。已经完成并保存的工作可以继续使用；如果最后一步意外中断，会自动返还中断那一步消耗的算力。你可以继续在同一段对话里推进后续工作。
AI 正在工作时继续发消息，会发生什么？
AI 正在工作时继续发消息，会发生什么？
新消息会排进输入框上方的发送队列，不会打断当前运行；这一轮结束后，Teable 会把整个队列合并成一条发出。队列保存在服务端，刷新页面不会丢失，同一段对话在不同标签页和设备上看到的队列也一致。排队期间，可以用 移除 删除它，或用 编辑消息 放回输入框。纯文本消息还可以点 调整方向 立刻送进正在运行的这一轮，送进去之后会在对话中标记为 已引导对话。一段对话最多排队 30 条消息。超出后这条消息不会进入队列，Teable 会提示
发送队列已满，请等 Cuppy 处理完再发。队列为什么显示已暂停？
队列为什么显示已暂停？
停止当前运行时，队列会一起暂停，这样你为当前回答按下的停止就不会把排队消息也发出去。此时队列标题会显示
由于你中断了当前响应，队列已暂停。点击 继续 即可放行；直接发下一条消息也可以，新一轮开始同样会解除暂停。如何在 AI 对话中使用技能？
如何在 AI 对话中使用技能？
打开 + 菜单并选择 技能，可以导入或管理技能；也可以在输入框中输入
/ 选择已启用的技能。导入时按使用范围选择：只有自己用，选个人；同一个数据库的协作者都要用，选数据库；整个空间都要用，选空间。拥有数据库管理权限的用户可以添加数据库技能，空间的所有者和创建者可以添加空间技能。如果 AI 对话生成了 .skill 文件，可以在文件卡片上点击 安装 来添加。有同名技能时，实际生效的是哪一个？
有同名技能时，实际生效的是哪一个？
同名技能只会生效一个，团队共用的版本优先于个人版本：数据库技能优先于空间技能，空间技能优先于个人技能；在 App 或 Bot 的对话中，为它单独添加的技能最优先。想让所有人换用新版本，就更新数据库或空间中的那一份。
哪些文件会保留在文件管理里？
哪些文件会保留在文件管理里？
文件管理 里只有两个目录：
uploads 存放你上传的文件，outputs 存放对话中生成的文件。这两个目录使用独立存储，沙箱释放或重建后内容仍然在，可以随时回来预览、下载或删除。Cuppy 在这两个目录之外写的文件属于临时文件，例如脚本运行时的中间产物。它们不会出现在 文件管理 中，沙箱重启后也不再保留。需要长期留存的结果，请让 Cuppy 写入 outputs、写回 Teable，或者及时下载（一条回复生成多个文件时可以用 下载全部）。复制带标签的消息时会保留什么？
复制带标签的消息时会保留什么？
复制用户消息时，表格、视图、应用、自动化、文件夹、选区和附件会保留为标记文本。再次粘贴到 AI 对话时，Teable 会把可识别的标记恢复成标签。
AI 对话需要 API Key 时，应该放在哪里？
AI 对话需要 API Key 时，应该放在哪里？
在输入框的 + 菜单中选择 密钥管理。AI 对话可以在运行时使用这些值，不需要把明文密钥写进提示词。