Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 7 additions & 11 deletions en/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -141,17 +141,17 @@ Cuppy, please read the memory for Base ID bsexxxxxxxxxxxx and save the relevant

### Handle Long Tasks

AI Chat is designed for foreground, interactive work in the visible conversation. Do not rely on background tasks or silent execution inside the chat for long-running work.
AI Chat can keep a single conversation environment available for about 24 hours, which is enough for most data analysis, file processing, and app-building tasks. Keep long-running work in the current conversation so you can follow its progress and provide input when needed.

<Steps>
<Step title="Check whether the task is still running in the foreground">
If the interface still shows `Thinking`, or progress updates are still being returned, foreground execution is still running. If the task shows `Completed`, the current foreground execution has ended.
<Step title="Follow progress in the current conversation">
If the interface shows `Thinking` or continues to return progress updates, the task is still running. If it shows `Completed`, the current run has finished.
</Step>
<Step title="Do not treat temporary content as persistent storage">
After the AI runtime is restarted, only memory files can be read. Background tasks, temporary files, and intermediate results are not preserved.
<Step title="Save results at useful checkpoints">
For work with multiple stages, ask Cuppy to write results back to Teable, export them, or generate a downloadable file at key checkpoints. Saved work remains available even if the conversation environment is released later.
</Step>
<Step title="Split work into batches and agree on visible outputs">
In the current environment, the conversation environment has idle cleanup and maximum lifetime limits: after foreground execution ends, an idle environment is released after about 30 minutes, and a single conversation environment has an approximate maximum lifetime of 5 hours. Split long-running tasks into smaller batches. Before starting each batch, agree with AI Chat on the visible output for that batch, such as writing results back to Teable, exporting results, or generating a downloadable file. After confirming that output is complete, continue with the next batch.
<Step title="Know when the environment is released">
A single conversation environment has an approximate maximum lifetime of 24 hours. After foreground execution ends, an idle environment is released after about 30 minutes. Temporary files and unsaved intermediate results are not preserved if the environment restarts.
</Step>
</Steps>

Expand All @@ -166,10 +166,6 @@ For long-running or repeatable work, use the feature that matches the workflow:
</Card>
</CardGroup>

<Note>
Teable is improving the experience and runtime capability for long-running tasks. At this stage, plan long-running tasks around the limits above.
</Note>

## Prompting Tips

- **State the goal first**: In the first message, describe what to do, the relevant conditions, and the expected output. For example, analyze weekly sales trends over the past 3 months, grouped by region, and return a trend table with a short conclusion.
Expand Down
18 changes: 7 additions & 11 deletions zh/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -141,17 +141,17 @@ Cuppy,请读取数据库 ID bsexxxxxxxxxxxx 的记忆,并把相关记忆保

### 处理长任务

AI Chat 更适合在当前可见对话中执行前台交互式任务。不要依赖对话中的后台任务或静默运行来处理长时间工作
AI 对话的单次对话环境最长可运行约 24 小时,足以完成大多数数据分析、文件处理和应用构建任务。执行长任务时,请保留当前对话,以便查看进度,并在需要时补充信息

<Steps>
<Step title="确认任务是否仍在前台执行">
如果界面仍显示 `Thinking`,或仍在持续返回进度,说明前台执行仍在进行。如果任务显示 `Completed`,说明本次前台执行已经结束
<Step title="在当前对话中查看进度">
如果界面显示 `Thinking`,或仍在持续返回进度,说明任务仍在运行。如果显示 `Completed`,说明本次运行已结束
</Step>
<Step title="不要把临时内容当作持久存储">
AI 运行环境被重启后,只有记忆文件可以被读取;后台任务、临时文件和中间结果都不会被保存
<Step title="在关键节点保存结果">
对于包含多个阶段的任务,可以让 Cuppy 在关键节点把结果写回 Teable、导出结果,或生成可下载文件。即使对话环境之后被释放,已保存的工作仍可继续使用
</Step>
<Step title="拆成批次,并约定可见产出">
在当前环境下,对话环境存在闲置释放和最长生命周期限制:前台执行结束后,闲置环境大约会在 30 分钟后被释放;单次对话环境也有大约 5 小时的最长生命周期。长时间任务应拆成较小批次处理。每开始一批前,建议先和 AI 约定本批的可见产出,例如写回 Teable、导出结果,或生成可下载文件;确认产出完成后,再继续下一批
<Step title="了解环境何时释放">
单次对话环境的最长生命周期约为 24 小时。前台执行结束后,闲置环境大约会在 30 分钟后被释放。如果 AI 运行环境重启,临时文件和未保存的中间结果不会被保留
</Step>
</Steps>

Expand All @@ -166,10 +166,6 @@ AI Chat 更适合在当前可见对话中执行前台交互式任务。不要依
</Card>
</CardGroup>

<Note>
Teable 正在改进长时间任务的体验和运行能力。在当前阶段,请按以上限制规划长时间任务。
</Note>

## 提问建议

- **先说明目标**:第一条消息尽量写清楚你想做什么、有哪些条件、希望输出成什么样,例如分析过去 3 个月每周销售趋势,按地区分组,并输出一张趋势表和简短结论。
Expand Down