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
2 changes: 1 addition & 1 deletion en/basic/admin-panel/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ After logging in as an administrator, click the "Admin Panel" button in the uppe
- **[Spaces](/en/basic/admin-panel/spaces)** - Manage spaces and auto-join settings
- **[Self-hosted license](/en/deploy/activate)** - Register, update, and view the current instance license
- **[Template admin](/en/basic/admin-panel/template-admin)** - Configure template center and custom templates
- **[Instance settings](/en/basic/admin-panel/settings)** - Configure system-wide settings and permissions
- **[Instance settings](/en/basic/admin-panel/settings)** - Configure system-wide settings, permissions, email, and system limits
- **[AI settings](/en/basic/admin-panel/ai-setting)** - Configure AI features and models
- **[Automation management](/en/basic/admin-panel/automation-management)** - View automation run status and run history
- **[Sandbox Agent](/en/basic/admin-panel/sandbox-agent)** - Configure Sandbox Agent runtime limits and base snapshots
Expand Down
9 changes: 9 additions & 0 deletions en/basic/admin-panel/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,22 @@ This page mainly covers instance-level basics. The main settings are grouped as
|------|------|
| **General Settings** | Includes **Allow creating new accounts**, **Allow sending space invitations**, **Allow everyone to create new spaces**, and **Enable email verification** |
| **Email** | Includes **Notification Email** and **Automation Email** for password reset, email verification, notification emails, and invitation emails |
| **System limits** | Shows the effective table data, field, view, and text limits for the instance |

To enable system emails, complete the setup in **Email**.

<Tip>
If email is not fully configured, the **Email** item in the **Pending configuration** panel will not turn green.
</Tip>

## System limits

**System limits** shows the current instance-level limits for table data and related configuration. If you need to adjust a limit, use the environment variable shown on that page.

<Note>
After changing an environment variable, restart the service for the new value to take effect.
</Note>

## Pending configuration

The **Pending configuration** panel on the right is a system checklist. It shows which important settings are still missing for the instance.
Expand Down
4 changes: 3 additions & 1 deletion en/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Open a table or view, then click the **Cuppy** icon in the top right corner to o
AI prioritizes information from the current page:

- **Current table and view**: The current table, current view, and the filtered or sorted results in that view.
- **Selected records**: If records are selected, AI uses them as key context.
- **Selected rows, columns, and cells**: If rows, columns, or a rectangular cell range are selected in Grid view, AI uses that selection as key context.
- **Uploaded files**: Add PDFs, Excel files, Word documents, images, and other files to the conversation.
- **More nodes with `@`**: Type `@` in the input box to add tables, views, apps, automations, or folders from the tree.

Expand Down Expand Up @@ -91,6 +91,8 @@ Ask questions about data in the current table, for example:

If the question involves multiple tables, use `@` to add the related tables or views to the conversation.

In Grid view, you can also select rows, columns, or a rectangular cell range, then use **Add to Chat** from the context menu. The selection appears as a chip in the input box, and clicking the chip highlights the related grid area again.

### Generate Temporary Charts or Report Previews

AI can generate one-time HTML previews from queried data, useful for checking charts or reports quickly:
Expand Down
4 changes: 2 additions & 2 deletions en/basic/space/billing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -202,15 +202,15 @@ After cancellation:

**Credits were used on a failed action. Can I get them back?**

Credits are consumed when your prompt is processed, even if the result isn't what you expected. If the failure was caused by a system error on our end, we may restore credits after review.
Credits are consumed once your prompt is processed, even if the result is not what you expected. If the AI Agent is unexpectedly interrupted, Teable restores the credits used by the final failed step. If you believe the failure was caused by a Teable-side issue, contact support and we can review it.

**I lost credits to repeated errors that didn't fix the problem.**

We understand the frustration. For App Builder, follow the [App Builder Practical Guide](/en/basic/ai/app-builder-practical-guide) before sending repeated fix prompts.

**The AI made changes I didn't ask for and used my credits.**

If the AI agent made unwanted changes in App Builder, you can roll back to a previous version. Credits for processed prompts can't be automatically refunded, but if the behavior seems like a product bug, we can review it.
If the AI agent made unwanted changes in App Builder, you can roll back to a previous version. Credits for processed prompts are not automatically refunded unless the AI Agent was unexpectedly interrupted, but if the behavior seems like a product bug, we can review it.

If you believe credits were unfairly consumed because of a Teable-side issue, submit a [Credit Issue Report](https://app.teable.ai/share/shrmBIyArdkWm999klP/view) with the related usage details.
</Accordion>
Expand Down
26 changes: 26 additions & 0 deletions en/deploy/env.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,13 +70,39 @@ Also ensure the public bucket is configured with **public-read + CORS**. See: [O
| **Session/JWT Configuration** | | | | |
| BACKEND_SESSION_EXPIRES_IN | Session expiration time | 7d | - | 7d |
| BACKEND_SESSION_COOKIE_SECURE | Whether to secure session cookie | false | - | true |
| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | Enable Origin and Fetch Metadata checks for unsafe browser session-cookie API requests. Enable only when your reverse proxy or CDN preserves these headers | false | - | false |
| BACKEND_JWT_EXPIRES_IN | JWT expiration time | 20d | - | 20d |
| BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | Reset password email expiration time | 30m | - | 30m |
| **Resource Limits** | | | | |
| MAX_COPY_CELLS | Maximum number of cells to copy in a single request | - | - | 50000 |
| MAX_READ_ROWS | Maximum number of rows to read in a single request | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | Maximum attachment upload size (bytes) | - | - | 2147483648 |
| MAX_SPACE_OWNER_COUNT | Maximum number of spaces a user can own | 10 | - | 10 |
| TASK_MAX_FIELDS_PER_BATCH | Maximum number of AI fields sent to the model in one batch request. Values are clamped from 1 to 20 | 5 | - | 5 |
| TASK_MAX_CONCURRENCY | Maximum pending AI field task runs dispatched in one scheduling cycle. Values are clamped from 1 to 20 | 5 | - | 5 |
| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | Maximum serialized field option bytes | 262144 | - | 262144 |
| TABLE_LIMIT_SELECT_CHOICES_MAX | Maximum select choices per select field | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | Maximum select choice name length | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | Maximum select default values | 100 | - | 100 |
| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | Maximum cell value bytes | 262144 | - | 262144 |
| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | Maximum serialized record fields bytes | 1048576 | - | 1048576 |
| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | Maximum records per mutation | 20000 | - | 20000 |
| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | Maximum computed cell value bytes | 262144 | - | 262144 |
| TABLE_LIMIT_FORMULA_MAX_LENGTH | Maximum formula length | 8192 | - | 8192 |
| TABLE_LIMIT_TABLES_PER_BASE_MAX | Maximum tables per base | 1000 | - | 1000 |
| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | Maximum fields per table | 500 | - | 500 |
| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | Maximum views per table | 100 | - | 100 |
| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | Maximum fields accepted when creating a table | 1000 | - | 1000 |
| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | Maximum views accepted when creating a table | 20 | - | 20 |
| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | Maximum records accepted when creating a table | 20000 | - | 20000 |
| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | Maximum rows per table. Empty means no instance-level row limit | - | - | 1000000 |
| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | Maximum filter items in a view | 100 | - | 100 |
| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | Maximum nested filter depth in a view | 5 | - | 5 |
| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | Maximum sort items in a view | 20 | - | 20 |
| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | Maximum group items in a view | 3 | - | 3 |
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | Maximum serialized view option bytes | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | Maximum display name length for supported table objects | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | Maximum description length for supported table objects | 2000 | - | 2000 |
| **Feature Toggles** | | | | |
| RECORD_HISTORY_DISABLED | Whether to disable record history, defaults to false | false | - | true |
| PASSWORD_LOGIN_DISABLED | Whether to disable password login (OAuth and OIDC still available) | false | - | true |
Expand Down
2 changes: 1 addition & 1 deletion zh/basic/admin-panel/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ description: "Teable 私有化部署的管理员后台,用于管理实例的
- **[空间管理](/zh/basic/admin-panel/spaces)** - 管理空间和自动加入设置
- **[自托管许可证](/zh/deploy/activate)** - 注册、更新和查看当前实例许可证
- **[模板管理](/zh/basic/admin-panel/template-admin)** - 配置模板中心和自定义模板
- **[实例设置](/zh/basic/admin-panel/settings)** - 配置系统级设置和权限
- **[实例设置](/zh/basic/admin-panel/settings)** - 配置系统级设置、权限、邮箱和系统限制
- **[AI 配置](/zh/basic/admin-panel/ai-setting)** - 配置 AI 功能和模型
- **[自动化管理](/zh/basic/admin-panel/automation-management)** - 查看自动化运行状态和历史记录
- **[沙箱 Agent](/zh/basic/admin-panel/sandbox-agent)** - 配置沙箱 Agent 运行限制和基础快照
Expand Down
9 changes: 9 additions & 0 deletions zh/basic/admin-panel/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,18 @@ description: "管理实例级开关、邮件配置和系统待配置项。"
|------|------|
| **通用配置** | 包括 **允许新用户注册**、**允许发送空间邀请**、**允许所有人创建新的空间**、**启用邮箱验证** |
| **邮箱** | 包括 **通知邮箱** 和 **自动化邮箱**,用于密码找回、邮箱验证、通知邮件和邀请邮件 |
| **系统限制** | 查看当前实例生效的表数据、字段、视图和文本限制 |

如果需要启用系统邮件,请在 **邮箱** 中完成配置。

## 系统限制

**系统限制** 用于查看当前实例生效的数据与配置上限。如果需要调整某个限制,请以页面中显示的环境变量为准。

<Note>
修改环境变量后,需要重启服务才会生效。
</Note>

## 待配置项

右侧 **待配置项** 可以理解为一份系统检查清单。它不是普通说明卡片,而是在告诉你:当前实例还缺少哪些关键配置。
Expand Down
4 changes: 3 additions & 1 deletion zh/basic/ai/ai-chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ AI 会优先参考当前页面。需要跨表格、视图、应用、自动化
AI 会优先参考你当前页面中的信息:

- **当前表格和视图**:包括当前表格、当前视图,以及视图中的筛选和排序结果。
- **选中的记录**:如果你选中了记录,AI 会把这些记录作为重点参考
- **选中的行、列和单元格区域**:如果你在网格视图中选中了行、列或矩形单元格区域,AI 会把这些选区作为重点参考
- **上传的文件**:可以把 PDF、Excel、Word、图片等文件加入对话。
- **`@` 让 AI 参考更多节点**:在输入框中输入 `@`,可以把目录树里的表格、视图、应用、自动化或文件夹加入对话。

Expand Down Expand Up @@ -91,6 +91,8 @@ AI 不只回答问题,也可以协助创建、更新或整理数据。对于

如果问题涉及多个表格,建议用 `@` 把相关表格或视图加入对话。

在网格视图中,你也可以选中行、列或矩形单元格区域,然后从右键菜单选择 **添加到 AI 对话**。选区会以标签形式进入输入框;点击标签时,会重新高亮对应的网格区域。

### 生成临时图表或报告预览

AI 可以根据已经查询到的数据生成一次性的 HTML 预览,适合临时查看图表或报告:
Expand Down
4 changes: 2 additions & 2 deletions zh/basic/space/billing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -202,15 +202,15 @@ Teable 遵循"物有所值"的取消政策。当您取消订阅时,您并非

**一次失败的操作消耗了算力,可以恢复吗?**

只要提示词被处理,就会消耗算力,即使结果并不是您预期的。如果失败是由 Teable 侧的系统问题导致,我们会在审核后酌情恢复算力
只要提示词被处理,就会消耗算力,即使结果并不是您预期的。如果 AI Agent 被意外中断,Teable 会返还最后一步失败时消耗的算力。如果您认为失败是由 Teable 侧问题导致,我们可以进一步审核处理

**我连续尝试修复问题,但一直失败并消耗了算力。**

我们理解这种情况会让人沮丧。对于应用构建器,建议先参考[应用构建器最佳实践](/zh/basic/ai/app-builder-practical-guide),避免连续发送重复的修复提示词。

**AI 做了我没有要求的改动,并消耗了算力。**

如果应用构建器做出了不需要的改动,您可以回退到之前的版本。已处理提示词的算力不会自动退回,但如果该行为看起来像产品 bug,我们可以进行审核。
如果应用构建器做出了不需要的改动,您可以回退到之前的版本。已处理提示词的算力不会自动退回,除非 AI Agent 被意外中断;如果该行为看起来像产品 bug,我们可以进行审核。

如果您认为算力是因为 Teable 侧问题被不公平消耗,请提交 [Credit Issue Report](https://app.teable.ai/share/shrmBIyArdkWm999klP/view),并附上相关用量明细。
</Accordion>
Expand Down
Loading