消息卡片配置
# 消息卡片配置
——通过这篇文章了解我们为您提供的消息卡片配置产品说明
# 消息卡片的作用
我们希望您在了解任务流程功能之前，了解它的场景及用途：
● 使用场景：当用户向座席咨询商品、物流信息时，座席可以通过发送消息卡片清晰地回复用户。
● 用途：在任务流程中，您可以通过接口节点查询用户名下的所有订单或物流信息，并将订单、物流信息以消息卡片列表的形式向客户发送，客户可以选择正确的订单或物流卡片，或点击卡片跳转到特定网站。
# 功能特点
1.配置简易：无需根据智齿开发者文档改造接口。企业通过后台配置填写jsonpath表达式，智齿能够根据jsonpath提取参数值并填充到卡片特定槽位。卡片槽位支持自定义开启或关闭，卡片上支持添加“发送卡片”或“跳转链接”按钮。
2.交互智能：用户除了点击“发送卡片”按钮来选择卡片，也支持回复阿拉伯数字1、2、3或输入“第一个”、”第二”的简单描述来选择卡片。
3.卡片消息在Android SDK 支持安卓系统 4.2 (API 17) 以上版本 iOS10 以上版本支持(鸿蒙系统暂不支持); 在微信公众号、微信客服、微信小程序渠道支持。
# 如何使用消息卡片
以下将给您介绍每个功能点的作用和效果：
- 如何使用消息卡片
1.在【流程画布-接口调用节点】创建大模型机器人要调用的接口，其中【输出参数】作为卡片字段中的内容数据源。
2.为接口的返回参数填写JSONpath表达式。
JSONPath基本语法：
a.基本选择器
| 表达式 | 作用 | 示例 JSONPath | 匹配结果 |
|---|---|---|---|
| $ | 根节点 | $ | 整个 JSON 文档 |
| . 或 [] | 子节点（属性访问） | $.key 或 $['key'] | 获取 key 的值 |
| * | 通配符（匹配所有元素或属性） | $.* | 所有第一层的属性值 |
| .. | 递归下降（搜索所有层级） | $..key | 所有层级的 key 值 |
b.数组索引
| 表达式 | 作用 | 示例 JSONPath | 匹配结果 |
|---|---|---|---|
| [n] | 选择数组的第 n 个元素（从 0 开始） | $.array[1] | 数组的第二个元素 |
| [start:end] | 切片（Python 风格，含头不含尾） | $.array[0:2] | 数组的第 1、2 个元素 |
| [?(expr)] | 过滤表达式（类似 SQL WHERE） | $[?(@.price > 10)] | 所有 price > 10 的对象 |
c.示例
假设有一个 JSON 数据：
{
"store": {
"book": [
{ "title": "Book1", "price": 10 },
{ "title": "Book2", "price": 20 },
{ "title": "Book3", "price": 30 }
],
"location": "Beijing"
}
}
2
3
4
5
6
7
8
9
10
示例查询：
| 需求 | JSONPath 表达式 | 结果 |
|---|---|---|
| 获取所有书名 | $.store.book[*].title | ["Book1", "Book2", "Book3"] |
| 获取第一本书的价格 | $.store.book[0].price | 10 |
| 查找价格大于 10 的书 | $.store.book[?(@.price > 10)] | [{"title": "Book2", "price": 20}, ...] |
| 递归搜索所有 price 字段 | $..price | [10, 20, 30] |
3.设置机器人动作执行以下步骤：
a.变量赋值：将接口返回的参数值，赋值给机器人变量，用于后续对话和分支判断。
b.设置引导语。最终引导语将由大模型润色后发出。
c.配置消息卡片字段。可以将接口出参绑定在卡片字段上，使卡片不同字段展现不同的数 据。同时，支持添加自定义字段。
d.设置卡片动作。支持发送卡片和跳转外部链接两个自定义动作。
4.请求超时时间:设置接口请求超时时间及超时后动作。
- 消息卡片效果
1.在【知识中心-流程管理-主流程-接口调用-机器人动作】设置接口输出参数后机器人执行的动作效果。
a. 发送卡片动作效果：在自有渠道发送卡片样式，在三方渠道发送纯文本模块卡片。
b.消息卡片跳转链接效果：卡片配置了发送按钮后，客户可以点击“发送卡片”，机器人会识别卡片信息并且变量赋值（例如客户要查询物流，机器人查询到三个订单，客户选择一个订单并且点击发送，机器人会收集用户发送卡片的订单id，并以这个订单id为入参去查询订单的物流，然后返回物流信息）。这个发送卡片的动作，c端用户除了执行点击动作外，也可以说“第一个”“第二个”或者回复数字“1”“2”“3”来实现。
c.点击“查看详情”可以查看商品详细信息。
