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
9 changes: 7 additions & 2 deletions en/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,8 @@ When you paste a long block of plain text, Teable converts it to a Markdown atta
- **Model**: Use the model menu to choose the model for the conversation. Use a lighter model for simple queries, cleanup, or rewriting, and a stronger model for complex planning, cross-table analysis, and app building.
- **Intelligence**: Choose the **Intelligence** level separately in the model menu. It controls thinking depth; higher levels produce more thorough reasoning.
- **Secrets**: Open the **+** menu and choose **Secrets** to store API keys or other credentials for AI Chat. AI Chat can read these values as environment variables. Saved values are write-only; enter a new value to update a secret.
- **Queued messages**: If you send another message while AI is still working, the message is queued. Queued items show the same table, view, attachment, and selection chips as the chat input. Use **Edit** to move a queued item back into the input, **Stop & send now** to interrupt the current run and send that item, or **Remove** to delete it from the queue.
- **Skills**: Open the **+** menu and choose **Skills** to import, enable, disable, or try skills in the current chat context. Personal skills are only available to you. Base skills are shared with collaborators in the current base. In the input box, type `/` to choose an enabled skill.
- **Queued messages**: If you send another message while AI is still working, the message is queued. Queued items show the same table, view, attachment, and selection chips as the chat input. Use **Edit** to move a queued item back into the input, **Send follow-up without interrupting** to add a text follow-up to the current run when that action is available, or **Remove** to delete it from the queue. Items that cannot be sent as follow-ups stay queued until the current run finishes.

## Common Uses

Expand Down Expand Up @@ -204,7 +205,11 @@ Teable is improving the experience and runtime capability for long-running tasks
</Accordion>

<Accordion title="What happens if I send another message while AI is working?">
The new message is queued. You can edit the queued message, remove it, or use **Stop & send now** to interrupt the current run and send the queued message.
The new message is queued. You can edit the queued message, remove it, or, when the action is available, use **Send follow-up without interrupting** to add a text follow-up to the current run.
</Accordion>

<Accordion title="How do I use Skills in AI Chat?">
Open the **+** menu and choose **Skills** to import or manage skills, or type `/` in the input box to choose an enabled skill. Use personal skills for your own chats, and Base skills when collaborators in the same base should be able to use the skill. Users who can manage the base can add Base skills. If AI Chat presents a `.skill` file, use **Install** on the file card to add it.
</Accordion>

<Accordion title="What happens when I copy a message with chips?">
Expand Down
1 change: 1 addition & 0 deletions en/basic/ai/app-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ The App Builder provides a dual-interface for both non-technical users and devel
The command center for your app.
- **Natural Language Editing**: Describe changes like *"Make the header blue"* or *"Add a submission form for new records"*.
- **Auto-Routing**: The AI understands which component or page you are referring to and modifies it directly.
- **Skills**: Open the **+** menu and choose **Skills** to manage skills for this app conversation. App skills are only available to the current app.
- **Clear Conversation**: If the current conversation has drifted, click **Clear Chat** in the bottom-right corner of the panel to start a new session. This clears the chat history for the current conversation but does not delete the app itself. The first use shows a confirmation, and you can choose not to show it again next time.

### 2. Live Preview Panel
Expand Down
5 changes: 5 additions & 0 deletions en/basic/record/record-history.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ Click the **...** button in the top-right corner of the table, then choose **His

In the table history dialog, click **View Record** next to a history entry to jump to the corresponding record.

Use the filters at the top of the dialog to narrow history by field, user, and time range. After filtering, use **Clear filters** to return to the full list.

<Info>When the **Authority Matrix** is not enabled, users with table editing permission can view table record history. When it is enabled, only administrators can view it.</Info>

## Individual Record History
Expand All @@ -47,10 +49,13 @@ Open the record detail card, then click the record history icon in the top-right

You can also right-click a record in the table view and select **Show record history**.

In individual record history, you can use the same filters to focus on a field, modifier, or time range for that record.

Users only need editing permission for a specific record to view that record's history.

## Notes

- Record history stores changes at the cell level.
- Bulk import, bulk paste, and bulk update operations can generate many history entries.
- Button field actions appear as **Clicked button** entries.
- If you cannot see the history entry point, first confirm whether you have editing permission for the corresponding record or table.
1 change: 1 addition & 0 deletions en/basic/table.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ In a base, click the `+` button in the directory and choose to:
1. Create a new blank table
2. Import from a CSV file
3. Import from an Excel file
4. Import from Airtable, if Airtable integration is configured

See the [Import section](/en/basic/table/import) for details.

Expand Down
32 changes: 28 additions & 4 deletions en/basic/table/import.mdx
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
---
title: "Import"
description: "Import CSV or Excel files to create a new table or append data to an existing table."
description: "Import CSV, Excel, or Airtable data into Teable."
---

{/* mintlify-resync: 2026-05-14 */}
Use import to initialize a new table or append new data to an existing table.
Use import to initialize a new table, append new data to an existing table, or bring tables from Airtable into a Teable base.

<Info>
Excel files are limited to **5MB**. If you need to import a larger dataset, save it as **CSV** first and then import it.
</Info>

<Steps>
<Step title="Choose an import method">
To create a new table, click `+` at the top of the left directory and choose `From CSV` or `From Excel`. To append data to an existing table, choose `Import data` from the target table menu.
To create a new table, click `+` at the top of the left directory and choose **CSV file** or **Excel file** under **Add from other sources**. To append data to an existing table, choose **Import data** from the target table menu.
</Step>
<Step title="Upload the file">
Select the CSV or Excel file you want to import. Excel files must be **5MB** or smaller.
Expand All @@ -31,7 +31,7 @@ Before the completion notification arrives, do not delete the table being genera

## Import Flow

Click `+` at the top of the left directory and select CSV or Excel according to your file type.
Click `+` at the top of the left directory and select **CSV file** or **Excel file** according to your file type.

<img
src="/images/docs/base/2026-05-22-table-create-menu.png"
Expand All @@ -57,6 +57,30 @@ To append data to an existing table, open the table menu, select **Import data**

After upload, map file columns to fields in the target table, then click **Import**. Teable processes the data in the background and notifies you when the import succeeds or fails.

## Import from Airtable

If Airtable integration is configured for your instance, you can import an Airtable base into the Teable base you are viewing.

1. Open the target Teable base.
2. Click `+` at the top of the left directory.
3. Under **Add from other sources**, choose **Airtable**.

<img
src="/images/docs/base/2026-06-24-table-import-airtable-menu.png"
alt="Airtable import entry in the base menu"
className="docs-screenshot"
/>

4. Connect your Airtable account if needed, then choose the Airtable base to import.
5. Choose whether to import records, download and import attachments, and import view filters, sorts, and grouping.
6. Click **Start import**.

<Info>
When **Import view filters, sorts and grouping** is enabled, Teable asks for a read-only Airtable shared-base link because the Airtable API does not expose view settings. In Airtable, open the base's **Share** menu, use **Share to web** with full base access, paste that shared-base link into Teable, then turn the shared link off after the import completes.
</Info>

During import, Teable shows progress by table. If some fields, views, or values need to be adjusted, the import log lists the changes before showing **Import completed**.

## Notes

- **First row detection**: Teable treats the first row as the header row by default. Make sure the first row contains clear column names, not data.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 7 additions & 2 deletions zh/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,8 @@ AI 会优先参考你当前页面中的信息:
- **模型**:在模型菜单中选择本次对话使用的模型。简单查询、整理、改写可以选择较轻量的模型;复杂规划、跨表分析和应用构建适合选择更强的模型。
- **智能**:在模型菜单中单独选择 **智能** 级别,用于控制 AI 的思考强度;级别越高,推理越深入。
- **密钥管理**:打开 **+** 菜单,选择 **密钥管理**,保存 API Key 或其他凭证。AI 对话运行时可通过环境变量读取这些值。已保存的值不会明文展示;需要修改时,输入新值覆盖即可。
- **排队消息**:如果 AI 仍在工作时继续发送消息,新消息会进入队列。排队项会像输入框一样显示表格、视图、附件和选区标签。可以点击 **编辑** 把排队项移回输入框,点击 **中断并立即发送** 停止当前任务并发送该项,或点击 **移除** 从队列删除。
- **技能**:打开 **+** 菜单,选择 **技能**,可以在当前对话上下文中导入、启用、停用或试用技能。个人技能仅自己可用;Base 技能会与当前 Base 内协作者共用。在输入框中输入 `/`,可以选择已启用的技能。
- **排队消息**:如果 AI 仍在工作时继续发送消息,新消息会进入队列。排队项会像输入框一样显示表格、视图、附件和选区标签。可以点击 **编辑** 把排队项移回输入框;当 **发送补充,不中断模型运行** 可用时,可将纯文本补充发送给当前任务;也可以点击 **移除** 从队列删除。无法作为补充发送的排队项,会等当前任务结束后再继续发送。

## 常见用法

Expand Down Expand Up @@ -204,7 +205,11 @@ Teable 正在改进长时间任务的体验和运行能力。在当前阶段,
</Accordion>

<Accordion title="AI 正在工作时继续发消息,会发生什么?">
新消息会进入队列。你可以编辑排队消息、移除排队消息,或点击 **中断并立即发送** 停止当前任务并发送这条消息。
新消息会进入队列。你可以编辑或移除排队消息;当 **发送补充,不中断模型运行** 可用时,也可以把纯文本补充发送给当前任务。
</Accordion>

<Accordion title="如何在 AI 对话中使用技能?">
打开 **+** 菜单并选择 **技能**,可以导入或管理技能;也可以在输入框中输入 `/` 选择已启用的技能。个人技能适合自己使用;需要让同一个 Base 中的协作者也能使用时,可以使用 Base 技能。拥有 Base 管理权限的用户可以添加 Base 技能。如果 AI 对话生成了 `.skill` 文件,可以在文件卡片上点击 **安装** 来添加。
</Accordion>

<Accordion title="复制带标签的消息时会保留什么?">
Expand Down
1 change: 1 addition & 0 deletions zh/basic/ai/app-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ Teable 应用构建器 (App Builder) 允许您在不编写代码的情况下,
这是您的应用控制中心。
- **自然语言编辑**:描述您想做的更改,如 *"把标题改成蓝色"* 或 *"添加一个新记录提交表单"*。
- **智能路由**:AI 能够理解您指的是哪个组件或页面,并直接对其进行修改。
- **技能**:打开 **+** 菜单,选择 **技能**,可以管理当前应用对话可用的技能。App 技能仅在当前应用中可用。
- **清除对话历史**:如果当前对话已经跑偏,可点击面板右下角的 **清除对话**,重新开始一个新的会话。这样会丢失当前对话的历史上下文,但不会删除应用本身。首次使用会弹出确认,并可选择下次不再提示。

### 2. 实时预览面板
Expand Down
5 changes: 5 additions & 0 deletions zh/basic/record/record-history.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ description: "查看表格或单条记录的历史变更,追踪数据被谁在

在表格历史记录弹窗中,点击某条历史记录旁的 **查看记录**,可以跳转到对应记录。

使用弹窗顶部的筛选项,可以按字段、修改人和时间范围缩小历史记录范围;筛选后可用 **清除筛选** 恢复完整列表。

<Info>未开启 **权限矩阵** 时,拥有表格编辑权限的用户可以查看表格记录历史。开启后,只有管理员可以查看。</Info>

## 单条记录历史
Expand All @@ -48,10 +50,13 @@ description: "查看表格或单条记录的历史变更,追踪数据被谁在

你也可以在表格视图中右键点击某条记录,选择 **显示记录历史**。

在单条记录历史中,也可以使用同样的筛选项,只查看这条记录中特定字段、修改人或时间范围内的变化。

只要用户拥有某条记录的编辑权限,就可以查看这条记录的历史。

## 注意事项

- 记录历史以单元格为最小单位保存变更。
- 批量导入、批量粘贴或批量更新会产生较多历史记录。
- 按钮字段的操作会显示为 **点击了按钮**。
- 如果你看不到历史记录入口,先确认自己是否拥有对应记录或表格的编辑权限。
1 change: 1 addition & 0 deletions zh/basic/table.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ description: "在数据库中创建、导入、分享和管理表格。"
1. 新建空白表格
2. 从 CSV 导入
3. 从 Excel 导入
4. 如果已配置 Airtable 集成,也可以从 Airtable 导入

具体操作参考 [导入](/zh/basic/table/import) 章节。

Expand Down
32 changes: 28 additions & 4 deletions zh/basic/table/import.mdx
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
---
title: "导入"
description: "将 CSV 或 Excel 文件导入 Teable,可创建新表格,也可追加到现有表格。"
description: "将 CSV、ExcelAirtable 数据导入 Teable。"
---

{/* mintlify-resync: 2026-05-14 */}
导入可用于快速初始化新表格,也可将新数据追加到已有表格
导入可用于快速初始化新表格,将新数据追加到已有表格,也可以把 Airtable 中的表导入到 Teable 数据库

<Info>
Excel 文件大小限制为 **5MB**。如果您需要导入更大规模的数据,先将其另存为 **CSV** 格式后再进行导入。
</Info>

<Steps>
<Step title="选择导入方式">
创建新表格时,在左侧目录栏顶部点击 `+`,选择 `从 CSV` 或 `从 Excel`。向已有表格追加数据时,在目标表格菜单中选择 `导入数据`
创建新表格时,在左侧目录栏顶部点击 `+`,在 **从第三方资源导入** 下选择 **CSV 文件** 或 **Excel 文件**。向已有表格追加数据时,在目标表格菜单中选择 **导入数据**
</Step>
<Step title="上传文件">
选择要导入的 CSV 或 Excel 文件。Excel 文件不要超过 **5MB**。
Expand All @@ -31,7 +31,7 @@ Excel 文件大小限制为 **5MB**。如果您需要导入更大规模的数据

## 导入流程

创建新表格时,在左侧目录栏顶部点击 `+`,根据文件格式选择 `从 CSV` 或 `从 Excel`
创建新表格时,在左侧目录栏顶部点击 `+`,根据文件格式选择 **CSV 文件** 或 **Excel 文件**

<img
src="/images/docs/base/2026-05-22-table-create-menu.png"
Expand All @@ -57,6 +57,30 @@ Excel 文件大小限制为 **5MB**。如果您需要导入更大规模的数据

上传文件后,将文件列映射到目标表格字段,确认后点击 **导入**。Teable 会在后台处理数据,并在成功或失败后发送通知。

## 从 Airtable 导入

如果当前实例已配置 Airtable 集成,你可以把 Airtable base 导入到正在查看的 Teable 数据库中。

1. 打开目标 Teable 数据库。
2. 点击左侧目录栏顶部的 `+`。
3. 在 **从第三方资源导入** 下选择 **Airtable**。

<img
src="/images/docs/base/2026-06-24-table-import-airtable-menu.png"
alt="数据库菜单中的 Airtable 导入入口"
className="docs-screenshot"
/>

4. 如有需要,先连接 Airtable 账号,再选择要导入的 Airtable base。
5. 选择是否导入记录数据、下载并导入附件,以及是否导入视图的筛选、排序和分组。
6. 点击 **开始导入**。

<Info>
开启 **导入视图的筛选、排序和分组** 时,Teable 会要求提供一个只读的 Airtable 共享 base 链接,因为 Airtable API 不提供视图配置。请在 Airtable 中打开该 base 的 **Share** 菜单,通过 **Share to web** 开启完整 base 访问,把生成的共享 base 链接粘贴到 Teable;导入完成后,可以回到 Airtable 关闭这个共享链接。
</Info>

导入过程中,Teable 会按表显示进度。如果字段、视图或值在导入时需要调整,导入日志会列出这些变化,然后显示 **导入完成**。

## 注意事项

- **首行识别**:系统默认将文件的 **第一行** 视为表头(字段名称)。请确保您的 CSV/Excel 文件第一行是清晰的列名,而非数据内容
Expand Down