组件描述
JSON文档搜索组件的工作原理
JSON文档搜索组件是一款多功能工具，专为在AI工作流中搜索和提取JSON文档中的信息而设计。它支持传统的基于文本的搜索和高级pandas查询表达式，可高效查询以JSON格式存储的结构化数据。
该组件的功能是什么？
该组件使用户能够：
- 搜索JSON文档，无论数据来自内部仓库还是外部URL。
- 指定搜索条件，如是否区分大小写、目标字段、结果数量限制等。
- 将搜索操作直接集成到AI流程工作流中，便于实现数据驱动的自动化和分析。
当您需要在复杂的JSON结构中筛选、查询或定位特定数据点时，它尤为有用，是数据预处理、校验和信息检索任务的宝贵利器。
输入
此组件没有输入句柄。
输出
- 工具：该组件的输出是一个搜索工具，可供代理或下游工作流步骤根据已配置的搜索参数检索相关JSON数据。
设置
| 选项 | 描述 | 默认值/示例 |
|---|---|---|
| 缓存TTL | 决定JSON文件内容的缓存时长。可选“无缓存”到“1年”。 | 2周 |
| 区分大小写 | 搜索时是否区分大写和小写字符。 | False |
| JSON数组键 | 指定存放要搜索对象数组的键。如果根本身就是数组可留空。 | （空） |
| JSON文档ID | 使用的内部JSON文档ID（如适用）。 | （空） |
| JSON文件URL | 外部JSON文件的URL，如果未选择内部文档时使用。 | （空） |
| 最大结果数 | 返回搜索结果的最大数量。 | 5000 |
| 搜索字段 | 要搜索的列（字段）名，逗号分隔。留空时搜索全部字段。 | （空） |
| 工具名称 | 自定义工具名称，便于引用。 | （空） |
| 工具描述 | 用于帮助代理或用户理解该工具用途的描述。 | （空） |
| 详细输出 | 启用详细输出以便调试或获取详细日志。 | False |
如何使用此组件
- 选择数据源：选择从内部数据源（通过文档ID）或外部URL加载JSON文档。
- 配置搜索：根据需要定义是否区分大小写，并指定搜索字段。
- 设置结果上限：根据用例调整最大返回结果数量。
- 自定义工具：可选地为工具命名和添加描述，便于集成到代理工作流。
为什么要用这个组件？
- 自动化数据提取：可快速定位并提取大型或复杂JSON文件中的相关信息。
- 灵活集成：兼容内部和外部JSON数据源。
- 可定制搜索：可通过高级选项灵活调整搜索，如限制结果数、过滤字段、控制大小写。
- 高效工作流：缓存机制减少频繁访问文档时的加载时间和冗余网络请求。
无论是用于分析、数据丰富，还是作为更大决策流程的一部分，此组件都是任何需要对结构化JSON数据进行强大、灵活且高效访问的AI工作流的理想选择。
常见问题
- JSON文档搜索组件的功能是什么？
它可以使用纯文本或高级查询表达式在JSON文件中进行搜索，方便您在工作流中从结构化数据中提取相关信息。
- 我可以同时使用内部和外部JSON数据吗？
可以，您既可以连接内部JSON文档，也可以从外部URL获取数据，灵活适配多种数据源。
- 可以限制搜索结果的数量吗？
当然可以。您可以设置返回结果的最大数量，从而控制输出并优化性能。
- 可以指定搜索的字段吗？
可以，您可以定义要重点搜索的列或字段。如果留空，则搜索JSON数据中的所有字段。
- 支持区分大小写的搜索吗？
您可以选择是否区分大小写，灵活适配您的数据需求。