钉钉互动表单操作指引

💡 什么是「工作流表单」功能？

在斑头雁 Agent 平台 ai.betteryeah.com 中，Agent 可以通过「工作流表单」功能向用户收集运行工作流的准确参数。现在，即便是将 Agent 发布到「钉钉机器人」后，Agent 仍可以通过「钉钉动态卡片」功能，创建出可以在钉钉内使用的表单，完成信息的收集。

接下来，我们以一份简单的 “维修工单” 表单为示例，演示 Agent 如何通过「钉钉卡片」功能，向用户发送工单。

1、在斑头雁平台搭建「维修工单」工作流

第一步，需要在斑头雁 ai.betteryeah.com 平台完成「维修工单」工作流的搭建。工单内共包含 3 个字段，分别为：

报修人，必填字段，字段类型为「单行文本」，变量名为「name」
报修部门，必填字段，字段类型为「单选项」，变量名为「department」，对应的下拉选项顺序依次为「IT、人事、财务」
问题类型，必填字段，字段类型为「多选项」，变量名为「questions」。对应的下拉选项顺序依次为「打印机不工作、电脑不开机、设备无法连接网络」。工作流搭建完成后，需要将其添加到对应的 Agent 内。注意，「输入展示展示」必须选择为「表单形式」。

2、将 Agent 发布到钉钉机器人

在「发布页」将 Agent 发布到钉钉机器人，注意，消息接收模式必须选择「流式输出（stream模式）」。发布成功后，即可在钉钉内与对应的机器人发起对话。

3、使用「钉钉动态卡片」搭建表单

第一步，前往「钉钉卡片平台」，创建卡片模板。

「模版名称」可自定义
「卡片模版场景」选择普通卡片
「关联应用」选择第二步操作中发布的钉钉机器人

第二步，向模板内添加字段

添加「报修人」字段

添加「报修人」字段的标题
首先添加「文本」组件，并在内容中输入“报修人”三字，作为字段的标题。注意，钉钉卡片不支持直接设置必填字段，因此建议在字段名称前添加 (必填) 提示。

添加「报修人」字段的输入框
继续添加「文本输入」组件。其中，表示「组件唯一ID」和「当前输入内容」的变量，必须与斑头雁平台的变量保持一致。均需要填写为「name」

添加「报修部门」字段

添加「报修部门」字段的标题
添加「报修部门」字段的下拉框
- 添加「下拉框」组件。注意：
  - 表示「组件唯一ID」的变量，必须与斑头雁平台保持一致，填写为「department」；
  - 表示「当前选中项的下标」的变量，必须为「组件唯一ID」的变量加「_index」后缀。即「department_index」;
  - 「选项列表」处的下拉选项内容顺序，也必须和斑头雁平台保持一致。

添加「问题类型」字段

添加「问题类型」字段的标题
添加「问题类型」字段的多选下拉框
- 添加「多选下拉框」组件。注意：
  - 表示「组件唯一ID」的变量，必须与斑头雁平台保持一致，需要填写为「questions」；
  - 表示「选中项下标」的变量，必须为「组件唯一ID」的变量加「_index」后缀。即「questions_index」；
  - 「选项列表」处的下拉选项内容顺序，也必须和斑头雁平台保持一致。

添加「提交表单」按钮

添加「单个按钮」组件，将按钮文案更改为「提交」，并必须绑定名为「is_submit」的普通变量。
将按钮组件的「点击事件」设置为「回传请求」

第三步，发布模版

检查并确认模版内字段无误后，点击「发布」按钮。并返回到模版列表。
复制模版ID后，前往斑头雁平台的 Agent 发布页，在「钉钉机器人」的发布成功页填入模版ID，即可在钉钉机器人内使用表单功能。

4、在钉钉机器人中使用表单功能

当 Agent 判断用户需要报修时，会自动弹出表单信息，引导用户填写。