aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/09-/345/272/224/347/224/250/346/250/241/345/274/217//350/247/206/345/233/276/347/273/204/344/273/266.md

@@ -0,0 +1,125 @@
+---
+title: "视图组件"
+source: "https://wolai.dingtalk.com/oRWstzJRuEkAdvsoDt7M9L"
+source_type: wolai
+ingested: "2026-07-19T14:18:58.749Z"
+---
+# 视图组件
+
+## 功能简介
+
+视图组件是仪表盘数据呈现的专业化工具，通过在仪表盘中配置不同类型的专业视图，实现**针对特定业务场景构建专业可视化的界面**。
+
+**典型的仪表盘视图应用场景包括：**
+
+- **专业化业务视图构建**：根据不同业务需求选择专业视图类型，创建符合实际数据可视化需求的界面。
+  - **画册视图**：适用于产品展示、案例库、知识库等图文并茂的内容展示。
+  - **看板视图**：用于敏捷开发、任务管理、工作流推进等拖拽式流程管理。
+  - **甘特视图**：专为项目管理、进度跟踪、资源排期等时间线管理设计。
+  - **日历视图**：适合日程安排、会议管理、活动策划等时间维度组织。
+  - **表格视图**：提供传统的数据查看、编辑、筛选、排序等数据处理能力。
+
+## 操作流程
+
+### **添加视图组件**
+
+1. 进入AI表格应用模块。
+2. 在左侧导航栏选择需要添加组件的目标页面。
+3. 在弹出组件的分类中找到 **视图**，然后按需选择 **表格、看板、日历、甘特图 或 画册** 视图。
+
+![](https://img.alicdn.com/imgextra/i4/O1CN01mefDeu1x7smreSmVx_!!6000000006397-2-tps-754-94.png)
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01AtVKbZ1cKbrVIrQnc_!!6000000003582-2-tps-2936-1406.png)
+
+### 基础配置
+
+添加视图组件后，右侧弹出配置面板。您可进行如下配置：
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01dLSnMY1pEHOPiXvx1_!!6000000005328-2-tps-2936-1406.png)
+
+- **标题名称**
+  - 默认名称为“视图”，支持用户自定义修改。
+- **数据选择**
+  - **数据表与范围**：支持选择具体数据表及数据范围。
+    - 选择 **全部数据** 时，可进一步设置筛选条件。
+- **字段管理**
+  - **可见字段：** 控制视图中显示的字段及其顺序。
+
+    ![](https://img.alicdn.com/imgextra/i3/O1CN0125Vhob1KkZDy62U0B_!!6000000001202-2-tps-2936-1408.png)
+    - 点击字段右侧的  图标，可隐藏或显示该字段。
+    - 拖拽字段左侧的  图标，可调整字段的显示顺序。
+    - *注意：此处仅控制字段的显示与排序，不支持新增、修改或删除字段本身。*
+- **视图类型专属配置**  
+
+  根据所选视图类型，提供不同的详细配置项：
+  - **表格视图**：可配置分组设置、排序规则、行高密度等。
+  - **看板视图**：可配置分组依据字段、卡片封面字段（需有附件类型字段）、展示模式（常规/紧凑）、是否显示字段名、排序规则等。
+  - **甘特图视图**：可配置开始日期字段、结束日期字段、标题显示字段、颜色标记字段、是否仅显示工作日、排序规则等。
+  - **画册视图**：可配置卡片封面字段（需有附件类型字段）、是否显示字段标题、排序规则等。
+  - **日历视图**：可配置排序规则、开始日期字段、结束日期字段、标题显示字段、颜色标记字段等。
+
+### 自定义配置
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01FeNR5Z1faaWjf9rLS_!!6000000004023-2-tps-2936-1406.png)
+
+- **工具栏显示设置**
+
+  ![](https://img.alicdn.com/imgextra/i2/O1CN01IbpO2f1LjwIYVa9Sg_!!6000000001336-2-tps-2936-1408.png)
+
+  可勾选需在视图组件顶部工具栏中显示的交互按钮，支持的按钮类型包括：
+  - **筛选**：显示筛选按钮，支持快捷设置筛选条件。
+  - **排序**：显示排序按钮，支持按字段排序。
+  - **查找**：显示搜索框，支持关键词搜索。
+  - **分组：** 显示分组按钮，支持配置分组条件。
+- **自定义样式**
+  - **背景颜色**  
+
+    可通过色盘选择，自定义设置组件的整体背景颜色。
+  - **边框样式**
+    - **边框颜色**：从系统预设配色板或自定义颜色中选择边框颜色。
+    - **边框粗细**：从下拉列表中选择 `1px`、`2px` 等选项，以精确控制边框的宽度。
+  - **标题颜色**  
+
+    可单独设置组件标题文字的颜色，使其与背景形成对比，提高可读性。
+- **权限设置**
+  - **记录操作权限**
+    - **允许添加记录**：勾选后，视图左上角将显示 \*\*添加记录 \*\*按钮，点击可新增数据行。
+
+      ![](https://img.alicdn.com/imgextra/i2/O1CN01BoAiNW230S3VNpEHL_!!6000000007193-2-tps-2936-1404.png)
+  - **按钮文字自定义**  
+
+    支持修改上述操作按钮的显示文字，如将“添加记录”改为“新建项目”、“新增客户”等业务术语。
+- **自定义按钮**
+  - 支持启用/停用自定义按钮，开启此开关后，可在视图中添加用户自定义的功能按钮。类似按钮组件，支持配置按钮点击后触发的动作。
+
+    ![](https://img.alicdn.com/imgextra/i1/O1CN01Picq0f1zY6hGDe6Rf_!!6000000006725-2-tps-2936-1406.png)
+  - 可对手动添加的自定义按钮进行复制、删除的操作，当按钮列表中有多个自定义按钮时，支持上下拖拽修改按钮顺序。
+
+    ![](https://img.alicdn.com/imgextra/i2/O1CN01xTyxmE1lYeY3YpVNQ_!!6000000004831-2-tps-2936-1406.png)
+
+### **管理视图组件**
+
+- **操作菜单**  
+
+  选中组件后，点击其右上角的  图标，将展开操作菜单，您可以在此进行以下操作：
+
+  ![](https://img.alicdn.com/imgextra/i3/O1CN01gHxc0T1H0MQ6qikYt_!!6000000000695-2-tps-2936-1406.png)
+  - **配置**：快速打开该组件的属性配置面板。
+  - **复制**：在当前页面内复制一个相同的组件。
+  - **复制到**：将组件复制到本应用内的其他指定页面。
+  - **删除**：将组件从当前页面中移除。
+- **调整大小与位置**
+
+  ![](https://img.alicdn.com/imgextra/i4/O1CN01DgGIqq24Ndiw4rD8K_!!6000000007379-1-tps-2938-1492.gif)
+  - **调整大小**：将鼠标悬停在组件右下边角通，并拖动拖拽手柄，即可自由调整组件的宽度和高度。
+  - **移动位置**：将鼠标移至组件上方，浮现  图标，按住鼠标左键并拖动，可在页面内拖拽组件调整位置。
+
+## 常见问题
+
+#### 问：单个页面最多可以添加多少个视图组件（包含表格、卡片、画册、甘特和日历）？
+
+答：10个。
+
+#### 问：最多可添加多少个自定义按钮？
+
+答：10个。

package/templates/support-qa/profiles/aitable/wiki/faq-support/09-/345/272/224/347/224/250/346/250/241/345/274/217//350/277/207/346/273/244/345/231/250.md

@@ -0,0 +1,110 @@
+---
+title: "过滤器"
+source: "https://wolai.dingtalk.com/aDmBNUvNTQXaKbe7LRDyRg"
+source_type: wolai
+ingested: "2026-07-19T14:19:37.814Z"
+---
+# 过滤器
+
+## 功能简介
+
+过滤器组件是数据可视化分析的核心交互工具，用于**动态筛选和过滤仪表盘应用中的数据内容**。通过添加一个或多个过滤器，用户能够快速聚焦于特定数据子集，实现交互式数据分析与探索。
+
+**典型的适用场景包括**：
+
+- **全局数据筛选**：在仪表盘设置关键维度（如时间、地区、产品线）的过滤器，控制页面中所有关联组件的数据范围。
+- **多组件联动筛选**：为仪表盘中不同组件设置专属的过滤器，实现分层筛选逻辑（例如：先用"时间"过滤器全局筛选，再用"产品线"过滤器仅作用于销售明细表）。
+
+## 操作流程
+
+### **添加过滤器组件**
+
+1. 进入AI表格应用模块。
+2. 在左侧导航栏选择需要添加组件的目标页面。
+3. 点击页面左下角的  **+ 添加组件** ，然后选择\*\* 过滤器\*\* 。
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01jjNZAf29AslpFMuXl_!!6000000008028-2-tps-754-94.png)
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01ttB7JU1xyYKoLUJua_!!6000000006512-2-tps-2936-1411.png)
+
+### **基础配置**
+
+在添加组件后，通过右侧面板的 **基础配置** 进行以下设置：
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01Vu4oD81RStFW5fkl4_!!6000000002111-2-tps-2936-1406.png)
+
+- **标题名称**
+  - 默认名称为“过滤器”，支持用户自定义修改。
+- **数据选择**
+  - **数据表与范围**：支持选择具体数据表及数据范围。
+    - 选择 **全部数据** 时，可进一步设置筛选条件。
+  - **展示字段**：支持从下拉列表中选择一个字段作为过滤器的显示内容。
+    - 提供模糊搜索功能，便于快速定位字段。
+- **过滤器样式**
+  - **样式类型**：支持根据字段类型选择不同展示样式。
+
+    ![](https://img.alicdn.com/imgextra/i2/O1CN01kNqNtc1xs8n1oTaSx_!!6000000006498-2-tps-2936-1408.png)
+    - 日期型字段：支持下拉、平铺、日期三种样式。
+    - 数值型字段：支持下拉、平铺、数字三种样式。
+    - 枚举型字段：支持下拉、平铺两种样式。
+  - **内容排序**：支持正序或倒序排列选项。
+
+    ![](https://img.alicdn.com/imgextra/i1/O1CN01jlvw0v23g866apkqT_!!6000000007284-2-tps-2936-1404.png)
+  - **选择模式**：可设置支持单选或多选。
+
+    ![](https://img.alicdn.com/imgextra/i1/O1CN01Lrazb51FskDaORM6R_!!6000000000543-2-tps-2936-1406.png)
+- **生效范围**
+  - **生效图表**
+    - **自动模式**：默认控制当前页面中所有同数据源的图表。
+    - **自定义范围**：手动选择需要关联的图表范围。
+
+      ![](https://img.alicdn.com/imgextra/i3/O1CN01bhGV1t1qmuxkW53LG_!!6000000005539-2-tps-2936-1406.png)
+
+      ![](https://img.alicdn.com/imgextra/i2/O1CN01i8Fc5m1rQlQ80DA1E_!!6000000005626-2-tps-2936-1406.png)
+  - **关联过滤器**
+    - **自动模式**：默认关联页面中所有同数据源的过滤器。
+    - **自定义范围**：手动选择要关联的同数据源过滤器。
+
+      ![](https://img.alicdn.com/imgextra/i1/O1CN01hIAurr1bMbyeuDZFK_!!6000000003451-2-tps-2936-1404.png)**关联说明**：多个过滤器同时作用于图表时，各条件之间为“且”关系，即同时满足所有过滤条件。
+
+### **自定义配置**
+
+在右侧面板 **自定义配置** 中，进一步调整组件的视觉与交互效果：
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01w0bn0E1cKbrVVc0BY_!!6000000003582-2-tps-2931-1411.png)
+
+- **背景颜色**  
+
+  自定义设置组件的整体背景颜色。
+- **边框样式**
+  - **边框颜色：** 通过下拉配色板选择边框颜色。
+  - **边框粗细：** 下拉选择设置边框粗细。
+- **选中颜色**  
+
+  在平铺样式下，可通过色板设置过滤器选项被选中时的突出显示颜色。
+- **垂直对齐**  
+
+  提供两种对齐方式选项，用于设置内容项在组件内的垂直位置（上部对齐或居中对齐）。
+
+### **组件管理**
+
+- **操作菜单**  
+
+  选中组件后，点击其右上角的  图标，将展开操作菜单，您可以在此进行以下操作：
+
+  ![](https://img.alicdn.com/imgextra/i4/O1CN01c8vTwK1c5Un9Rgvdo_!!6000000003549-2-tps-2936-1408.png)
+  - **配置**：快速打开该组件的属性配置面板。
+  - **复制**：在当前页面内复制一个相同的组件。
+  - **复制到**：将组件复制到本应用内的其他指定页面。
+  - **删除**：将组件从当前页面中移除。
+- **调整大小与位置**
+
+  ![](https://img.alicdn.com/imgextra/i1/O1CN01WtTpr12A15vEP3Un7_!!6000000008142-1-tps-2938-1494.gif)
+  - **调整大小**：将鼠标悬停在组件右下边角通，并拖动拖拽手柄，即可自由调整组件的宽度和高度。
+  - **移动位置**：将鼠标移至组件上方，浮现  图标，按住鼠标左键并拖动，可在页面内拖拽组件调整位置。
+
+## 常见问题
+
+#### 问：单个页面最多可以添加多少个过滤器？
+
+答：20个。

package/templates/support-qa/profiles/aitable/wiki/faq-support/09-/345/272/224/347/224/250/346/250/241/345/274/217//351/200/217/350/247/206/350/241/250/347/273/204/344/273/266.md

@@ -0,0 +1,142 @@
+---
+title: "透视表组件"
+source: "https://wolai.dingtalk.com/mYP52qtoum1PaGRaXbKtY6"
+source_type: wolai
+ingested: "2026-07-19T14:20:17.394Z"
+---
+# 透视表组件
+
+## 功能简介
+
+透视表组件主要用于对数据进行多维度、动态的分析和汇总，通过灵活的拖拽字段配置，快速实现数据的分组、统计与交叉分析。它能够将复杂的数据集转化为清晰的结构化表格，支持用户从不同视角挖掘数据价值。
+
+- **多维数据分析：** 对同一数据集按多个维度（如时间、地区、产品类别）进行交叉汇总，快速生成统计报表。
+- **动态数据透视：** 通过拖拽调整行列字段、指标和筛选条件，实时查看不同组合下的数据聚合结果。
+- **业务报表制作：** 用于生成销售报表、库存分析、业绩统计等需要分组、求和、计数、平均值等聚合计算的业务场景。
+
+## 操作流程
+
+### **添加透视表组件**
+
+您可以通过以下两种方式添加透视表：
+
+**方式一：从 AI表格应用模块添加**
+
+1. 进入 **AI表格应用** 模块。
+2. 在左侧导航栏，选择目标页面。
+3. 点击页面左下角的  **+ 添加组件** ，并选择\*\* 透视表\*\* 。
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01d7FjNG1X2gHMYRcRh_!!6000000002866-2-tps-754-94.png)
+
+![](https://img.alicdn.com/imgextra/i4/O1CN01gLVLSC1YwO4H6Z3vD_!!6000000003123-2-tps-2940-1494.png)
+
+**方式二：从AI表格数据模块添加**
+
+1. 进入 **AI表格数据** 模块。
+2. 在左侧导航栏，选择目标仪表盘。
+3. 点击页面中的  **+ 添加图表** ，并选择\*\* 透视表\*\* 。
+
+![](https://img.alicdn.com/imgextra/i4/O1CN017nmpW41ePJ9lAvlpO_!!6000000003863-2-tps-782-90.png)
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01WgJf9Z1h8lhVbqBWx_!!6000000004233-2-tps-2940-1520.png)
+
+### **基础配置**
+
+在添加组件后，通过右侧面板进行以下设置：
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01aXIVkM1oniQBuCySD_!!6000000005270-2-tps-2940-1494.png)
+
+- **数据源选择**
+  - 选择需要进行分析的数据表和数据范围。
+- **透视配置**
+
+  透视配置是透视表的核心功能区域，通过简单的拖拽操作即可完成多维度数据分析。
+  - **字段管理**
+
+    ![](https://img.alicdn.com/imgextra/i1/O1CN01VViiOn23qCoGm58Pk_!!6000000007306-1-tps-2938-1492.gif)
+    - 移入/移除字段：从左侧字段列表中将目标字段拖入配置区域，或从配置区域将字段拖出，即可完成字段的添加与移除。
+    - 搜索字段：支持通过字段名称进行模糊搜索，当数据表字段较多时，可快速定位目标字段。
+  - **行维度**
+
+    用于设置数据行的分组依据，将字段拖拽至此区域后，数据将按该字段值进行纵向分组展示。
+
+    ![](https://img.alicdn.com/imgextra/i2/O1CN01qrstdN1Ly8ZimAK1t_!!6000000001367-1-tps-2938-1496.gif)
+    - **操作**：
+      - 拖拽字段至行区域，即可添加行分组维度。
+      - 上下拖拽已添加的字段，可调整分组层级顺序。
+      - 将字段拖出行区域，即可移除该分组维度。
+    - **显示**：默认显示行总计数据。
+  - **列维度**
+
+    用于设置数据列的分组依据，将字段拖拽至此区域后，数据将按该字段值进行横向分组展示。
+
+    ![](https://img.alicdn.com/imgextra/i3/O1CN01Usjx3x1KxOJbkzxnW_!!6000000001230-1-tps-2938-1494.gif)
+    - **操作**：
+      - 拖拽字段至列区域，即可添加列分组维度。
+      - 上下拖拽已添加的字段，可调整分组层级顺序。
+      - 将字段拖出列区域，即可移除该分组维度。
+    - **显示**：默认显示列总计数据，可在样式设置中调整。
+  - **值（度量）**
+
+    用于设置需要统计计算的指标，支持多种聚合计算方式和数值格式。
+
+    ![](https://img.alicdn.com/imgextra/i2/O1CN01xSDr2b1GXVT4fOeP4_!!6000000000632-1-tps-2938-1492.gif)
+    - **操作**：
+      - 将字段拖拽至值区域，即可添加统计指标。
+      - 点击字段右侧  图标，可配置聚合方式和数值格式。
+      - 将字段拖出值区域，即可移除该统计指标。
+    - **聚合方式**：支持求和、计数、去重计数、平均值、最大值、最小值等13种计算方式。
+    - **数值格式**：支持保留小数位、百分比、千位分隔符、货币符号等多种显示格式。
+    - **设置别名：** 设置值字段在图表中的展示名称。
+    - **清除别名：** 清除设置好的字段别名，恢复原名称。
+    - **移除字段：** 在值区域移除该字段。
+
+### **自定义配置**
+
+在右侧面板 **自定义配置** 中，进一步调整组件的视觉与交互效果：
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01yrNbEU1SNDxqCf9ee_!!6000000002234-2-tps-2940-1494.png)
+
+- **背景颜色：** 支持设置组件背景颜色。
+- **边框颜色：** 下拉配色板选择边框颜色。
+- **边框粗细：** 下拉选择边框粗细。
+- **列总计：**通常位于透视表 **最右侧** ，对**每一列**的数据进行 **纵向求和** ，显示该列所有行的汇总值。
+- **行总计：**通常位于透视表 **最底部** ，对**每一行**的数据进行 **横向求和** ，显示该行所有列的汇总值。
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01OjAfj71TGdtCW3MQ6_!!6000000002355-2-tps-2288-1254.png)
+
+在仪表盘配置界面中，还可以配置以下内容：
+
+- **主色调：** 用于设置透视表的整体主题颜色。
+- **垂直对齐：** 用于设置透视表在组件卡片内的垂直对齐方式。
+
+### **组件管理**
+
+- **操作菜单**  
+
+  选中组件后，点击其右上角的  图标，将展开操作菜单，您可以在此进行以下操作：
+
+  ![](https://img.alicdn.com/imgextra/i1/O1CN01ySzoMF21HjlwHGvPc_!!6000000006960-2-tps-2936-1492.png)
+  - **配置**：快速打开该组件的属性配置面板。
+  - **复制**：在当前页面内复制一个相同的组件。
+  - **复制到**：将组件复制到本应用内的其他指定页面。
+  - **删除**：将组件从当前页面中移除。
+- **调整大小与位置**
+
+  ![](https://img.alicdn.com/imgextra/i1/O1CN01usSwOp24QO6IRFBkf_!!6000000007385-1-tps-2938-1494.gif)
+  - **调整大小**：将鼠标悬停在组件右下边角通，并拖动拖拽手柄，即可自由调整组件的宽度和高度。
+  - **移动位置**：将鼠标移至组件上方，浮现  图标，按住鼠标左键并拖动，可在页面内拖拽组件调整位置。
+
+## 常见问题
+
+#### 问：如何更新透视表的数据？
+
+答：透视表的数据依赖于其选择的数据源。当底层数据表的数据更新后，通常透视表组件会自动刷新以显示最新数据。您也可以检查组件配置，确认其关联的数据源是否正确。
+
+#### 问：透视表的行列字段可以放置多个吗？
+
+答：可以。您可以在“行”或“列”区域拖入多个字段，透视表会形成多级分组，实现更细粒度的数据钻取和分析。字段的上下顺序决定了分组的层级关系。
+
+#### **问：透视表**结果限制？
+
+答：目前透视结果最多支持20,000个单元格。如有超出，请先调整数据筛选条件或者透视配置。

package/templates/support-qa/profiles/aitable/wiki/faq-support/10-/350/207/252/345/212/250/345/214/226/345/267/245/344/275/234/346/265/201/Webhook/345/217/202/346/225/260/347/232/204/350/257/246/347/273/206/350/257/264/346/230/216.md

@@ -0,0 +1,76 @@
+---
+title: "Webhook 参数的详细说明"
+source: "https://wolai.dingtalk.com/scxpuu3y38w4RvKdZyvqFw"
+source_type: wolai
+ingested: "2026-07-19T14:20:34.174Z"
+---
+# Webhook 参数的详细说明
+
+## 目录
+
+- [1 请求头（Header）及示例](#1-请求头Header及示例)
+- [2 请求体](#2-请求体)
+- [3 响应体及示例](#3-响应体及示例)
+- [4 错误码](#4-错误码)
+
+## 1 请求头（Header）及示例
+
+| **名称**​       | **类型**​ | **必填**​ | **描述**​                                                                                                                                                                                                                                                                                |
+| ------------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Authorization | string  | 否       | 凭证校验（Bearer token）需通过请求头（Header）的方式传给AI表格自动化，Header 格式（区分大小写）如下：  \\--header 'Authorization: Bearer \\\[真实的 Bearer token]'  单引号在实际 Header 中必须输入。中括号\\\[]仅表示变量，在实际 Header 中无需输入。  此处 Header 的 Key（键）固定为 Authorization，Value（值）有固定前缀 Bearer。  请注意，Bearer 前缀和真实的 Bearer token 中间，必须加一个空格。 |
+| Client-Token  | string  | 否       | 幂等的 Header 中，Key（键）固定为 Client-Token，Value（值）由用户生成，通常使用 uuid。  若此值为空，表示将发起一次新的请求。若此值非空，表示幂等的进行更新操作，相同的值 3 小时内只会触发一次。                                                                                                                                                                    |
+
+Bearer token 的示例代码如下（中括号表示需替换的变量，无需在实际代码中写入）：
+
+```bash 
+curl --location --request POST '[真实 webhook 地址]' \
+--header 'Authorization: Bearer [真实 Bearer token]' \
+--header 'Content-Type: application/json' \
+--data-raw '{[真实请求体内容]}'
+```
+
+
+## 2 请求体
+
+按需设置即可，格式需符合 JSON 规范。
+
+## 3 响应体及示例
+
+响应体中的 code 非 0 时表示失败。
+
+当 code 不是 0 时，你可以对照下文“相关报错”表格中的错误码和文案来排查问题。
+
+当 webhook 接收正常时，响应体示例如下：
+
+```json 
+{
+"msg": "",
+"data": { },
+"code": 0
+}
+```
+
+
+当 webhook 出现报错时，响应体示例如下：
+
+```json 
+{
+"data": { },
+"code": 800004509,
+"msg": "webhook trigger workflow is disabled"
+}
+```
+
+
+## 4 错误码
+
+若 webhook 触发出现报错，你需要在发出请求方查看报错情况，根据下表的错误码和报错文案来排查问题。
+
+| **错误码**​  | **报错文案**​                             | **报错原因**​                                                                                                                                                            | **解决方法**​                              |
+| --------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
+| 800005649 | 未通过凭证校验                               | 开启了凭证校验，但HTTP 请求中携带的凭证与自动化流程中所需的凭证不符，导致流程无法运行。                                                                                                                       | 重新检查和输入凭证。                             |
+| 800005650 | IP 地址不在白名单中，请检查                       | 开启了 IP 白名单，且发送请求的 IP 不在白名单内。                                                                                                                                         | 将对应 IP 加入白名单，或更换 IP 地址重新发送。            |
+| 800005647 | 请求内容大小超出上限，请减少内容                      | webhook 接收 HTTP 请求的大小超出了 4 MB。                                                                                                                                       | 请减少内容。                                 |
+| 800005646 | 存在调用自身的 HTTP 节点，造成死循环，请修改 HTTP 节点请求地址 | 自动化流程的触发条件为“webhook 触发时”，执行操作为“发送 HTTP 请求”，且 HTTP 的请求 URL 和当前流程的 webhook 地址一致，导致流程进入了循环触发。                                                                           | 修改“发送 HTTP 请求”中的 URL，不可与 webhook 地址一致。 |
+| 800005652 | 请求过于频繁，请稍后再试                          | webhook 接收 HTTP 请求的频率超出了限制，被限流。  \\-   整个AI表格的 webhook 触发频率上限为 50 次/秒。  \\-   单个自动化流程的 webhook 触发频率上限为 5 次/秒。  \\-   针对不开启凭证校验（Bearer token）的自动化流程，每个流程的频率上限为 1 次/秒。 | 稍后再试。                                  |
+| 800006003 | 请求体不符合 JSON 格式规范，请修改后重新请求             | 通常发生在使用“通过发送请求设置”的方法设置输出的时候，指接收到的请求体的 JSON 格式有误。                                                                                                                     | 请重新检查请求体的 JSON，修改后重试。                  |

package/templates/support-qa/profiles/aitable/wiki/faq-support/10-/350/207/252/345/212/250/345/214/226/345/267/245/344/275/234/346/265/201//344/270/200/350/241/250/344/270/200/345/217/267Agent/346/224/257/346/214/201/347/276/244/346/224/266/351/233/206.md

@@ -0,0 +1,150 @@
+---
+title: "一表一号Agent支持群收集"
+source: "https://wolai.dingtalk.com/cBvxR69ufEszwMkJm2gJPg"
+source_type: wolai
+ingested: "2026-07-19T14:21:11.858Z"
+---
+# 一表一号Agent支持群收集
+
+## 使用场景
+
+1. **采集内部群发言，识别问题反馈、咨询、事件上报、发送图片，就帮我自动收集到表**
+
+> 🍤**门店上报群**
+> 将通过拍照+文字的方式上报质检收集到表，AI打标
+
+> 🍤**客户问题反馈群**
+> 自己获取每日问题到表，通过AI表格仪表盘等能力进行Ai总结
+
+> 🍤**巡检群**
+> 每日通过拍照+文字的方式巡检，将巡检数据自动汇总到表
+
+## 使用效果预览
+
+1. @助理时将对话内容进行收集（免费）
+2. 可静默收集：无需@ 助理，即可感知群内指定消息并收集（限免）
+
+[新ui2.mp4](video/新ui2_S310TTse2u.mp4)
+
+## 功能使用咨询
+
+扫码加入群聊进行使用咨询
+
+![](https://img.alicdn.com/imgextra/i2/O1CN018wkBTE1OQeSyBP2QB_!!6000000001700-2-tps-690-606.png)
+
+## 使用步骤
+
+### 入口1: 打开顶部自动化标签页，点击新建工作流后在页面右上角可见群消息收集按钮
+
+![](https://img.alicdn.com/imgextra/i4/O1CN01cxWhgJ20gdgtg6cw2_!!6000000006879-2-tps-2674-1848.png)
+
+#### 入口2：或打开AI助理侧边栏，点击右上角「添加到群聊」展开设置面板，选择AI问题收集技能，设置触发条件，点击确认添加
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01EnYYmW1aDcaStvTjV_!!6000000003296-2-tps-1534-272.png)
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01kJxlWk1INY5XB5ZRR_!!6000000000881-2-tps-788-990.png)
+
+![](https://img.alicdn.com/imgextra/i3/O1CN014aCh6O210n7MSC2le_!!6000000006923-2-tps-1252-1372.png)
+
+1. 默认勾选AI助理被@ 时执行问题收集操作
+2. 可以选择是否要感知群消息（限免中，限免期限请关注官方说明），目前提供以下3类消息触发条件选择：
+   - 官方推荐的问题收集
+   > \#️⃣.*\[？?].*|. \*\[请问|如何|怎么|能否|能不能|可以|有.*吗|为什么|是不是|是否|求|帮忙|指导|咨询|麻烦|图片].*
+   > 💡该正则表达式旨在识别中文语境下的问题或请求。它由两个核心规则构成，通过“或”（`|`）连接，满足任一规则即可匹配。
+   > **规则一`.*[？?].*`**：通过标点判断。它匹配任何包含全角（？）或半角（?）问号的字符串，这是一种直接识别疑问句的方法。
+   > **规则二`.*[请问|如何|...|图片].*`**：通过关键词判断。其**意图**是匹配包含“请问”、“如何”、“帮忙”、“有...吗”等疑问或请求类词语的句子，以及带图片的反馈
+   - 图片：带图片的对话，图片将被自动添加到附件列
+   - 关键词：
+     - 关键词触发：对话中又指定单词时触发
+     - 正则表达式触发：满足正则表达式则触发。例：
+     ```java 
+     .*（任何对话都能触发则）
+     ```
+
+3. 可设置静默收集群消息后，是否要回复被收集的用户「我已将您的问题收集」
+
+   ![](https://img.alicdn.com/imgextra/i4/O1CN01ZzlKOz1T66mPvA363_!!6000000002332-2-tps-780-366.png)
+
+#### Step2. 进入群聊，发送问题测试一下
+
+发送符合实际场景的图文问题，等待1分钟后进入AI表格查看是否在AI表格中自动创建「问题收集」Sheet，并将刚才群内问题按问题原文、反馈人、分类、群来源、附件、时间等维度收集到行列中
+
+![](https://img.alicdn.com/imgextra/i4/O1CN01LMm5jd1cV8yIwr79M_!!6000000003605-2-tps-1826-1262.png)
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01VcgTes29aWwyIz4mH_!!6000000008084-2-tps-2426-1502.png)
+
+#### Step3. 优化助理设置，调优可触发内容类型和关键词
+
+1\. 点击「更多设置」进入助理能力调整
+
+![](https://img.alicdn.com/imgextra/i2/O1CN01RcZMIV1JrbhJrSRtZ_!!6000000001082-2-tps-1160-1378.png)
+
+2\. 在「人设」中修改助理需要处理的任务描述，如果用户希望修改收集到AI表格中的数据表名称和字段，您需要在人设中修改以下内容
+
+录入指定sheet字段为蓝色线条所画指令限制
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01Heb13m1opY0Jp72AO_!!6000000005274-2-tps-2554-1456.png)
+
+你需要改成黄色线条所示指令，指定你要收集到的数据表名称，匹配字段名称
+
+![](https://img.alicdn.com/imgextra/i3/O1CN01qHf5sq1raq8Mg8cDC_!!6000000005648-2-tps-1942-916.png)
+
+1. 如果您需要修改为自己的助理收集内容到指定的AI表格，你需要进入deap平台，并将人设参考上方案例进行修改，其中表格dentryUuid 将作为你写入指定表的唯一标识，为AI表格链接的蓝色下划线区域编码
+
+![](https://img.alicdn.com/imgextra/i1/O1CN010QUqIu1ZwfvtK7zx6_!!6000000003259-2-tps-1958-126.png)
+
+1. 更多deap智能体平台的操作请详见说明书：[查看详情](https://alidocs.dingtalk.com/i/p/Y7kmbokZp3pgGLq2/docs/YMyQA2dXW793K7oYukG54ykvJzlwrZgb?dontjump=true\&spm=a1zb9.8233112.0.0.14643a88CP7reV "查看详情")
+
+## 常见问题
+
+- **为什么显示创建助理时失败？**
+
+  您所在的组织可能在AI助理功能管理中禁用AI助理，请至[OA后台](https://oa.dingtalk.com "OA后台")-AI助理功能管理中查看
+
+  ![](https://img.alicdn.com/imgextra/i2/O1CN01EutoNk208HzC0w7g9_!!6000000006804-2-tps-1108-788.png)
+
+  如您不具备OA后台管理权限，可通过下图企业AI助理入口点击创建助理，查看是否被企业禁用
+
+  ![](https://img.alicdn.com/imgextra/i2/O1CN01Qk28Lv1Zs5yGCsKK0_!!6000000003249-2-tps-2684-1902.png)
+
+  如果您命中了新版钉钉，请访问[https://deap.dingtalk.com/](https://deap.dingtalk.com/ "https://deap.dingtalk.com/") 新建智能体看是否支持发布，如不可发布说明您企业禁用AI助理，需要联系管理员开通
+- **为什么我无法找到我企业的群聊？**
+
+  你需要是群主或管理员
+- **在群里按说明文档操作，什么都收集不上来？**
+
+  请将测试问题「为什么自动化没有触发？」发到群内，如果还是无法触发请检查是否群加密，如有开启三房密盾加密则只能关掉后再尝试收集
+
+  ![](https://img.alicdn.com/imgextra/i1/O1CN01n6rjg31DJomcUkvNZ_!!6000000000196-2-tps-974-562.png)
+- **助理设置修改后，在群内没有生效怎么办？**
+
+  请将助理移出群聊后再添加，清楚他在群内的缓存
+- **从deap平台删除助理后，在AI表格中能再次添加么？**
+
+  使用原操作链路可再次添加，之前删除的助理所在群需要重新添加新助理
+- **AI表格标题修改后支持同步么？**
+
+  暂不支持同步
+- **支持外部群收集么？**
+
+  暂不支持
+- **表格助理在表格中的收集表名称不能改是吗？不能增删字段么？**
+  1. 在「人设」中修改助理需要处理的任务描述，如果用户希望修改收集到AI表格中的数据表名称和字段，您需要在人设中修改以下内容
+     录入指定sheet字段为蓝色线条所画指令限制
+  ![](https://img.alicdn.com/imgextra/i1/O1CN01Heb13m1opY0Jp72AO_!!6000000005274-2-tps-2554-1456.png)
+
+  你需要改成黄色线条所示指令，指定你要收集到的数据表名称，匹配字段名称
+
+  ![](https://img.alicdn.com/imgextra/i3/O1CN01qHf5sq1raq8Mg8cDC_!!6000000005648-2-tps-1942-916.png)
+- **为什么有的问题没有收集到？**
+
+  [参考上文](/cBvxR69ufEszwMkJm2gJPg "参考上文")调整技能-技能触发规则「感知群消息」中的「正则表达式」，进行调优设置
+- **限免到什么时候？**
+
+  目前还没有明确的商业化付费策略，后续可能通过token调用次数计费
+- **支持收集附件么？**
+
+  目前暂不支持
+- **如何停止收集？**
+
+  到群里手动把助理移出群