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