---
uuid: "5f7eb720-5e60-45f6-a103-1bfa309bdc3c"
type: "tutorial"
title: "在流程中调用 AI 识别能力"
sidebar_position: 4
description: "在腾讯轻联流程中插入 AI 识别节点，将草料表单上传的图片自动转成结构化数据，支持身份证、银行卡、发票、表格图片等识别类型，识别结果可写入腾讯文档或推送到企业微信群。包含完整搭建步骤。"
keywords:
  - 腾讯轻联AI识别
  - 草料二维码AI处理
  - 表单图片OCR识别
  - 身份证银行卡识别
  - 轻联自动化流程
cl_old_blog_id: "78997"
cl_old_blog_url: "https://cli.im/help/78997"
last_update:
  date: "2025-09-04"
---

本文介绍如何在**腾讯轻联**的流程中插入 AI 识别节点，把草料表单上传的图片自动识别成结构化数据，再写入腾讯文档或推送到群。

**可对接的 AI 能力**：身份证 OCR、银行卡识别、发票识别、行程卡识别、健康码识别、表格图片解析、语音转文字等。

**适用场景**：

- 劳务人员上报：扫码上传身份证和银行卡照片，自动提取姓名、身份证号、卡号
- 新员工登记：上传证件照片，自动填入登记表
- 费用报销：扫码上传发票图片，自动识别金额、税号

如果还不了解腾讯轻联，先看 [腾讯轻联×草料总览](/help/integration-and-connection/third-party-integration/tencent-hiflow/connection)。

![AI 识别示意](https://blogcdnimg.clewm.net/2022/09/image-1662541984660_16625419862039.png)

## 概念预热：AI 节点在流程中的位置

一条带 AI 的流程通常有 3 个节点：

1. **触发应用**：草料二维码 · 新表单提交（提供原始图片 URL）
2. **中间节点**：AI 识别应用（输入图片 URL，输出结构化字段）
3. **执行应用**：腾讯文档、群机器人等（消费 AI 返回的结构化字段）

也就是说：AI 并不能单独跑，它是一条流程里的**加工步骤**，前面要有数据源，后面要有去向。

> **注**：当前轻联的 AI 组件处在升级中，**相同名字的 AI 应用会出现两个**，请选择带 **V2** 的版本，旧版可能无法使用。

---

## 实操体验

扫码下方示例二维码，填写信息后上传一张证件图片，提交后可在示例表格中看到 AI 识别出的字段结果。

![实操体验二维码](https://blogcdnimg.clewm.net/2023/03/image-1680057762745_16800577631522.png)

[查看示例表格](https://docs.qq.com/sheet/DU25QUENVem5IV0tl?tab=BB08J2)

> **注**：别忘了删掉你自己提交的那一行，其它行保留给其他体验者。

---

## 准备工作

开始前准备好：

1. **草料二维码应用**：表单里包含「图片上传」字段（用于上传证件图、发票等）。[参考示例模板](https://cli.im/share/7NpigkN)
2. **腾讯文档在线表格**：用于写入识别结果。[参考示例表格](https://docs.qq.com/sheet/DU25QUENVem5IV0tl?tab=BB08J2)

---

## 搭建步骤

以「扫码上传图片 → AI 识别 → 写入腾讯文档 → 异常时推送企业微信」为例。

### 第 1 步：新建流程

登录 [腾讯轻联后台](https://ipaas.cloud.tencent.com/login)，点击【新建流程】。

![新建流程](https://blogcdnimg.clewm.net/2023/12/image-1703229830275_17032298308771.png)

### 第 2 步：配置草料触发应用

在触发应用位置搜索并选择**「草料二维码」**。

**2.1 选择触发方式**：新表单提交

![选择触发方式](https://blogcdnimg.clewm.net/2023/12/image-1703229894502_17032298949209.png)

**2.2 授权配置**：按提示用草料账号完成授权。

![授权配置](https://blogcdnimg.clewm.net/2023/12/image-1703229907792_17032299082049.png)

**2.3 参数配置并生成监听地址**：点击【执行预览】，复制下方生成的监听地址。

![生成监听地址](https://blogcdnimg.clewm.net/2023/12/image-1703229995917_17032299966761.png)

**2.4 把监听地址配置回草料**：在【表单设置】>【设置】>【数据 API】粘贴地址，或在【高级功能】>【数据 API】中添加。

![配置草料数据 API](https://blogcdnimg.clewm.net/2023/12/image-1703230030503_17032300310309.png)

**2.5 添加一条样本数据**：扫码提交一次表单（带上图片），轻联会监听到这条样本数据，用于后续字段引用。

![监听样本数据](https://blogcdnimg.clewm.net/2023/12/image-1703230053355_17032300538076.png)

### 第 3 步：添加 AI 识别节点

在触发应用后面加一个节点，搜索你需要的 AI 应用（如「AI 身份证 OCR 识别-V2」「AI 防疫健康码识别-V2」）。

**关键配置：图片参数**

AI 识别的输入是图片 URL。草料表单的图片字段返回的是一个列表（图片组件支持多图上传），取第一张图用 `urls[0]` 引用。

![配置 AI 识别图片参数](https://blogcdnimg.clewm.net/2023/12/image-1703230509599_17032305100334.png)

> **注意**：**一定要选带 V2 的版本**，老版本的 AI 应用可能已停止服务。

### 第 4 步：追加第二个 AI 识别（可选）

如果表单收了**多种图片**（比如身份证 + 银行卡），按相同方式再加一个 AI 节点，输入参数指向另一个图片字段的 `urls[0]`。

![追加 AI 识别](https://blogcdnimg.clewm.net/2023/12/image-1703230527314_17032305277374.png)

### 第 5 步：配置腾讯文档执行应用

在 AI 节点后面加一个**腾讯文档**执行应用（个人版）。

- **选择推送的表格**：选中准备好的表格和工作表
- **字段匹配**：除了表单原始字段，还可以直接映射 AI 节点返回的结构化字段（如 `姓名`、`身份证号`、`银行卡号`）

![配置腾讯文档](https://blogcdnimg.clewm.net/2023/12/image-1703230543384_17032305438811.png)

### 第 6 步：发布流程

确认所有节点都显示**打勾**状态，点击右上角【发布】上线流程。

---

## 验证是否生效

扫码实际提交一条带图片的表单：

- ✅ **正常**：腾讯文档里看到新一行，既有原始表单字段，也有 AI 识别出的结构化字段
- ❌ **识别失败**：回到轻联流程【执行记录】查看失败原因，常见：
  - 图片参数没取到 `urls[0]`，只传了字段名
  - 选了老版本 AI 应用（没选 V2）
  - 上传的图片过于模糊或不是标准证件照

---

## 常见问题

### 1. AI 节点把一张图识别失败了，会影响整条流程吗？

默认会让该条任务停在失败节点。你可以在失败节点后接一个「条件判断」：识别成功才继续后续写入，失败则跳过或推送「识别失败」提醒。

### 2. 多张图片字段怎么处理？

草料的图片组件支持多图。如果要把每张图都识别一遍，需要在流程里用「循环」节点（轻联内置）遍历 `urls` 数组，对每个元素调用 AI。

### 3. 除了 OCR，还有什么 AI 能在流程里用？

轻联 AI 应用中心还有语音转文字、表格图片解析、发票识别、营业执照识别等。具体以[轻联应用中心](https://hiflow.tencent.com/appCenter)的实时列表为准。

### 4. AI 识别会额外计费吗？

腾讯轻联按**任务数**计费，每经过一个节点（包括 AI 节点）算 1 个任务。草料侧按**推送条数**计费，不受 AI 节点影响。详情见 [计费规则](/help/integration-and-connection/third-party-integration/tencent-hiflow/connection#计费规则)。

---

## 参考资料

- [腾讯轻联官网](https://qinglian.tencent.com/)
- [腾讯轻联新手教程](https://qinglian.tencent.com/help/docs/sHInHG/)
- [草料 Webhook 说明](/help/integration-and-connection/data-api/webhook-webhook-guide)
- [腾讯轻联×草料计费规则](/help/integration-and-connection/third-party-integration/tencent-hiflow/connection#计费规则)

## 更多应用场景

- [把表单数据同步到在线表格](/help/integration-and-connection/third-party-integration/tencent-hiflow/sync-to-online-spreadsheet)
- [把表单数据推送到工作群](/help/integration-and-connection/third-party-integration/tencent-hiflow/group-message-push)

## 草料社区

如果你对数据 API 功能有疑问或想分享使用经验，欢迎在社区发起讨论，产品和技术人员都会参与互动。[前往社区](https://cli.im/community/minihome/question/104)