在整合生成器中，请求参数允许您从人工智能专员对话中提取数据（对话参数），并将其传递到外部端点。在某些情况下，您可能需要转换或重新格式化这些数据，然后才能在 API 请求中将其作为 URL 查询或请求正文发送。为此，您可以使用 JSONdata，它是一种功能强大的查询和转换语言。
本文章包含以下主题：
相关文章：
重新格式化请求参数的值
您可以使用 JSONdata 重新格式化请求参数的值。
重新格式化请求参数的值
- 在人工智能专员工作区中，使用右上角的人工智能专员下拉字段选择您的人工智能专员。
- 在左侧主菜单中，单击API 整合。
- 选择或创建一个整合。
- 在请求参数页面上，选择或创建您要重新设置值格式的请求参数。
- 在测试值字段中，选择重新格式化值图标 (
）。
- 在重新格式化值对话框中的重新格式化 JSONdata字段中，使用 JSONdata 转换或重新格式化与选定请求参数密钥关联的值。
在您的 JSONdata 查询中，使用“$”代表您要重新格式化其值的键。
通过测试值预览字段，您可以实时检查查询结果。
- 单击完成。
- （可选）如果您将 请求参数添加到 API 请求的正文：
- 在左侧环境标题下，选择适当的环境。
- 选择正文标签。
- 添加您的 JSON 对象，使用请求参数作为双花括号中的值。
重新设置值格式的常见用例
在整合生成器中，您可以通过将请求参数分配给特定的键来定义这些参数。这些值可以直接使用，但在某些情况下需要对其进行转换或重新格式化，以满足外部系统的要求。
例如，您可能想要：
- 重新格式化日期：将日期格式从 MM/DD/YYYY 更改为 YYYY-MM-DD 或 ISO 8601，以满足 API 要求。
- 进行字符串运算：操作字符串，例如添加或移除字符、合并多个字段，或转换字符串以包含 HTML。
- 应用条件逻辑：应用条件，例如检查字段是否为空或根据需要分配默认值。
本部分包含以下示例：
场景：重新格式化日期
在这种情况下，端点需要检查 YYYY-MM-DD 或 ISO 8601 格式的日期。但是，对于您的对话，您希望日期以更友好的格式显示，即 DD/MM/YYYY。
以下是在此场景中将使用的 JSONdata 查询：
$substring($, 6, 10) & "-" & $substring($, 3, 2) & "-" & $substring($, 0, 2)
场景：重新格式化 URL 以使链接可单击
在这种情况下，您希望搜索以 http:// 或 https:// 开头，后跟多个非空白字符的文本（子字符串），以便将 URL 转换为可单击链接。然后，您要使用 JSONdata $replace 函数将该子字符串替换为一个将匹配的 URL 包装在 HTML 中的字符串。< a>标签，创建一个可点击的链接。
以下是在此场景中将使用的 JSONdata 查询：
(
$text := "Chat transcript unavailable. Here is a link:https://www.zendesk.com. Here is another link: https://www.w3schools.com.";
$replace($text, /(https?:\/\/[^\s]+)/, '<a href="$1">$1</a>'
)
场景：重新格式化在线交谈记录副本以使其更具可读性
在这种情况下，您想要添加在线交谈记录副本到工单。但是，在默认形式下，在线交谈记录副本的可读性不是很好：
- 在线交谈记录副本 - 2024-10-12 (13:04:10)人工智能专员：欢迎使用客户工程人工智能专员！(13:04:10)人工智能专员：选择要测试的整合：(13:04:10) 访问者：test c.id：d501304d-da09-4485-a4c7-1c708ec0005d 所有时间（UTC 时间）
您希望通过每条消息换行将其转换为一种更加用户友好的格式。由于每条新消息都以左括号（ () 开头，因此您可以使用 JSONdata 将每个 ( 替换为换行符后跟 (。
重新格式化的对话将如下所示：
- 在线交谈记录副本 - 2024-10-12
(13:04:10)人工智能专员：欢迎使用整合生成器人工智能专员！
(13:04:10)人工智能专员：选择要测试的整合：
(13:04:10) 访问者：test c.id：d501304d-da09-4485-a4c7-1c708ec0005d 所有时间（UTC 时间）
以下是在此场景中将使用的 JSONdata 查询：
$replace($, “(“, “\n(“)
此外，您需要将此参数添加到您环境中的正文部分，以便与请求一起发送：
{
"chatTranscript": "{{chatTranscript}}"
}
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。