# 飞书多维表格自动化和工作流

## 自动化概述

**自动化能力：**
- 🔄 自动触发任务（无需手动操作）
- 📊 数据流转和同步
- 🤖 AI辅助处理
- 🔗 外部系统集成
- 📢 智能通知和提醒

**执行限制：**
- **运行次数：** 200 - 500,000次/月（根据版本）
- **单次执行：** 最长30分钟
- **触发频率：** 1分钟 - 1小时（定时触发）

## 触发条件（5大类）

### 1. 数据表触发

**触发时机：**
- 新增记录
- 修改记录
- 删除记录
- 符合条件的记录变化

**配置要点：**
- 指定监听的数据表
- 设置触发条件（筛选规则）
- 指定监听的字段（修改触发）

**示例场景：**
```
场景：新增客户自动通知
触发条件：客户表 - 新增记录
执行操作：发送飞书消息给销售主管
```

### 2. 时间触发

**触发类型：**
- **定时触发：** 每小时/每天/每周
- **日期触发：** 达到记录中的某个日期字段
- **周期触发：** 自定义周期（每天9:00）

**配置要点：**
- 设置触发时间点
- 指定作用范围（全表/筛选记录）
- 设置执行时区

**示例场景：**
```
场景1：每日库存检查
触发条件：每天 9:00
执行操作：检查库存，低于安全线则预警

场景2：任务截止提醒
触发条件：任务的截止日期字段 = 今天+1天
执行操作：发送提醒给负责人
```

### 3. 表单触发

**触发时机：**
- 表单提交成功
- 表单数据写入数据表

**配置要点：**
- 选择关联的表单
- 设置触发条件（可选）
- 配置数据处理逻辑

**示例场景：**
```
场景：客户提交反馈表单
触发条件：反馈表单 - 新提交
执行操作：
1. 自动分配处理人
2. 发送通知给客服团队
3. 创建跟进任务
```

### 4. 消息触发

**触发时机：**
- 飞书群聊消息（@机器人或关键词）
- 私聊消息

**配置要点：**
- 设置触发关键词
- 指定监听的群聊
- 配置消息解析规则

**示例场景：**
```
场景：群聊创建任务
触发条件：群聊消息包含 "#任务"
执行操作：解析消息内容，创建任务记录
```

### 5. 其他触发

**触发类型：**
- **Webhook触发：** 外部系统调用
- **手动触发：** 用户点击按钮
- **流程触发：** 其他工作流调用

**Webhook配置：**
```bash
# Webhook URL
POST https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/workflows/{workflow_id}/trigger

# 请求体
{
  "event": {
    "trigger_type": "webhook",
    "data": {
      "field1": "value1",
      "field2": "value2"
    }
  }
}
```

## 执行操作（5大类）

### 1. 记录操作

**操作类型：**
- **新增记录** - 向数据表添加新记录
- **更新记录** - 修改现有记录字段
- **删除记录** - 删除符合条件的记录
- **查找记录** - 查询满足条件的记录

**配置要点：**
- 指定目标数据表
- 设置字段值（支持动态引用）
- 添加筛选条件

**示例：**
```
操作：新增跟进记录
目标表：跟进记录表
字段值：
  - 客户：{{触发.客户}}
  - 跟进内容：自动生成
  - 跟进时间：{{当前时间}}
  - 跟进人：{{当前用户}}
```

### 2. 消息操作

**消息类型：**
- **飞书消息** - 私聊/群聊通知
- **邮件通知** - 发送邮件
- **短信通知** - 发送短信（需配置）

**配置要点：**
- 指定接收人（用户字段/群组）
- 设置消息内容（支持变量）
- 选择消息卡片/文本格式

**示例：**
```
操作：发送飞书消息
接收人：{{触发.负责人}}
消息内容：
  "【任务提醒】您有新任务：
   任务名称：{{触发.任务名称}}
   截止日期：{{触发.截止日期}}
   请及时处理。"
```

### 3. 任务操作

**操作类型：**
- **创建任务** - 新建飞书任务
- **更新任务** - 修改任务状态
- **删除任务** - 删除任务

**配置要点：**
- 关联任务和记录
- 设置任务属性（截止日期、负责人等）
- 同步任务状态到记录

### 4. 日程操作

**操作类型：**
- **创建日程** - 新建飞书日历事件
- **更新日程** - 修改日程信息
- **删除日程** - 取消日程

**配置要点：**
- 指定日历（个人/团队）
- 设置时间（开始/结束）
- 添加参会人

### 5. 高级操作

#### HTTP请求

**功能：** 调用外部API、Webhook

**配置：**
- 请求方法：GET/POST/PUT/DELETE
- 请求URL
- 请求头（Headers）
- 请求体（Body）
- 超时设置

**示例场景：**
```
场景：同步数据到外部系统
操作：HTTP请求
方法：POST
URL：https://api.example.com/sync
请求体：
{
  "customer": "{{触发.客户名称}}",
  "amount": {{触发.订单金额}},
  "date": "{{触发.下单时间}}"
}
```

**常见用途：**
- 调用第三方API（支付、物流等）
- 发送Webhook通知
- 同步数据到外部系统
- 调用AI接口

#### 条件判断

**功能：** 根据条件执行不同分支

**配置：**
- 条件表达式（IF）
- THEN分支（条件成立）
- ELSE分支（条件不成立）

**示例：**
```
条件：{{触发.订单金额}} > 10000
THEN：通知销售总监审批
ELSE：自动通过
```

#### 循环

**功能：** 批量处理多条记录

**配置：**
- 循环对象（记录列表）
- 循环体操作
- 退出条件

**示例场景：**
```
场景：库存预警检查
循环对象：所有商品记录
循环体：
  - 判断：库存 < 安全库存
  - THEN：发送预警消息
```

## AI增强功能

### 1. AI生成文本

**功能：** 自动生成文本内容

**应用场景：**
- 自动生成周报/日报
- 生成客户沟通话术
- 生成任务描述
- 生成邮件内容

**配置：**
```
AI提示词：
"根据以下信息生成客户跟进记录：
客户名称：{{触发.客户名称}}
沟通内容：{{触发.沟通内容}}
要求：简明扼要，突出重点"

输出字段：跟进记录
```

### 2. AI分类

**功能：** 自动分类数据

**应用场景：**
- 客户分类（A/B/C类）
- 工单分类（技术/产品/服务）
- 情感分析（正面/负面/中性）

**配置：**
```
AI提示词：
"根据客户反馈内容，判断问题类型：
1. 产品功能问题
2. 服务体验问题
3. 价格问题
4. 其他"

输入字段：反馈内容
输出字段：问题分类（单选）
```

### 3. AI Agent

**功能：** 执行复杂AI任务

**能力：**
- 数据分析和洞察
- 文档生成和整理
- 决策支持
- 知识库问答

**配置：**
- 选择AI能力
- 提供上下文数据
- 设置输出格式

## 常见自动化场景

### 1. 新增任务通知

```
触发：任务表 - 新增记录
条件：负责人 不为空
操作：
  1. 发送飞书消息给负责人
  2. 消息内容："【新任务】{{任务名称}}，截止：{{截止日期}}"
```

### 2. 自动打标签

```
触发：客户表 - 修改记录
条件：累计消费金额 >= 100000
操作：
  1. 更新记录字段"客户级别" = "VIP"
  2. 发送通知给客户经理
```

### 3. 定时提醒

```
触发：每天 9:00
条件：任务状态 = "进行中" AND 截止日期 = 今天
操作：
  1. 查找所有符合条件的任务
  2. 循环发送提醒消息给负责人
```

### 4. 数据汇总（周报）

```
触发：每周五 18:00
操作：
  1. 查询本周新增任务
  2. 查询本周完成任务
  3. AI生成周报摘要
  4. 发送飞书消息给团队群
```

### 5. 库存预警

```
触发：每天 10:00
操作：
  1. 查询所有商品
  2. 循环：判断库存 < 安全库存
  3. THEN：发送预警消息给采购
  4. 创建补货任务
```

### 6. 客户跟进提醒

```
触发：客户表 - 修改记录
条件：上次跟进时间 + 7天 <= 今天
操作：
  1. 发送提醒消息给负责人
  2. 消息："客户{{客户名称}}已7天未跟进"
```

### 7. 订单状态流转

```
触发：订单表 - 修改记录
条件：订单状态 变更
操作：
  1. 根据状态分支：
     - "已支付" → 通知仓库发货
     - "已发货" → 通知客户物流信息
     - "已完成" → 发送满意度调查
```

### 8. 表单收集自动处理

```
触发：反馈表单 - 新提交
操作：
  1. 新增记录到"反馈表"
  2. AI分类问题类型
  3. 根据类型分配处理人
  4. 发送确认消息给提交人
```

## 工作流高级功能

### 1. 节点类型

**基础节点：**
- 触发节点
- 操作节点
- 条件节点
- 循环节点

**高级节点：**
- AI节点（生成文本、分类、Agent）
- HTTP节点
- 延迟节点（等待一段时间）
- 审批节点（人工审批）

### 2. 流程控制

**串行执行：**
```
触发 → 操作1 → 操作2 → 操作3 → 结束
```

**并行执行：**
```
触发 → 操作1
     → 操作2  → 合并 → 结束
     → 操作3
```

**分支执行：**
```
触发 → 条件判断 → 分支A → 操作A
                   → 分支B → 操作B
```

### 3. 变量引用

**系统变量：**
- `{{当前时间}}` - 当前时间戳
- `{{当前用户}}` - 当前操作用户
- `{{触发.字段名}}` - 触发记录的字段值

**记录变量：**
- `{{记录.字段名}}` - 当前记录的字段值
- `{{查找结果.字段名}}` - 查找结果的字段值

**循环变量：**
- `{{循环项.字段名}}` - 循环中当前项的字段值
- `{{循环索引}}` - 当前循环索引（0开始）

## 性能优化建议

### 1. 减少执行次数

**策略：**
- 合并相似自动化
- 使用条件筛选减少触发
- 避免不必要的循环

**示例：**
```
❌ 不好：每个客户变更都触发通知
✅ 好：仅关键状态变更才触发通知
```

### 2. 优化查询

**策略：**
- 添加筛选条件（减少查询结果）
- 使用索引字段（常用筛选字段）
- 限制返回字段数量

### 3. 避免长时间运行

**策略：**
- 减少HTTP请求超时时间
- 分批处理大量数据
- 使用异步处理

## 调试和监控

### 1. 执行日志

**查看路径：** 数据表 → 自动化 → 执行记录

**日志内容：**
- 触发时间和条件
- 执行的操作
- 成功/失败状态
- 错误信息（失败时）

### 2. 常见错误

**错误1：执行超时**
- 原因：操作过多、HTTP请求慢
- 解决：优化流程、减少操作

**错误2：权限不足**
- 原因：机器人无字段编辑权限
- 解决：检查权限配置

**错误3：变量引用错误**
- 原因：字段名错误、字段不存在
- 解决：检查变量名称

---

**参考文档版本：** 1.0
**最后更新：** 2026-03-12