JSONata查询

解决深层 JSON 取数的痛点

在处理复杂的客户资料或业务数据时，我们经常遇到嵌套极深的 JSON 结构。如果需要从中提取特定的联系人、跟进列表或进行聚合统计，传统的 JavaScript 处理方式往往需要编写冗长且脆弱的可选链代码（如 data?.customer?.contacts?.phone）。这种方式不仅代码量大，而且在数据结构稍有变动时极易引发报错。此外，当取数规则需要由业务方动态配置时，硬编码的路径提取方式显然无法满足灵活性的需求。

核心能力与工作流

本技能基于 jsonata 库，将复杂的 JSON 遍历与过滤逻辑转化为单条声明式查询表达式。它的核心工作流分为三个关键步骤：

• 输入与解析：接收用户提供的 JSON 数据以及配置好的 JSONata 表达式。
• 安全求值：在隔离的环境中执行表达式，通过路径匹配和数组过滤直接生成目标结果，整个过程默认只读。
• 结果预览：将查询后的数据结构化展示，支持在报表导出前进行快速核对。

为了降低上手门槛，技能内部预置了 3 到 5 条针对客户域的示例表达式，开发者可以直接参考或修改这些样例来适配自己的业务场景。

适用边界与安全注意点

尽管 JSONata 表达式非常强大，但在集成到生产环境时必须严格遵守以下边界：

• 拒绝任意代码执行：对于来自用户输入的不可信表达式，必须设置超时和复杂度限制，切勿将其等同于 eval 使用。
• 禁止副作用操作：本技能仅用于数据查询与提取，严禁利用表达式执行写盘、发请求等副作用操作。
• 数据隐私保护：在提供示例数据或测试时，必须确保不包含真实的敏感信息（如手机号明文），建议使用脱敏样例，且不要将用户的完整数据库默认上传至第三方服务。