XML文档搜索组件是一款多功能工具，旨在便捷地对XML文档进行搜索。它既支持简单文本搜索，也支持类似pandas的高级查询，非常适合在AI工作流中从结构化数据资源中提取特定信息。
该组件的功能
此组件允许用户在XML文件中进行搜索，可以上传内部文档或提供XML文件的URL。它可用于定位特定元素或数值、根据多种条件筛选内容，并为AI流程中的进一步处理提取相关数据。
主要特点与能力
- 文本与查询搜索： 使用基础文本匹配或类似pandas的查询表达式在XML文档中检索更复杂的数据。
- 灵活的数据源选择： 支持内部文档（通过ID）和外部XML文件（通过URL）的选择。
- 元素过滤： 可通过指定XML元素路径，选择性地限制搜索范围。
- 区分大小写： 可选择是否区分大小写进行搜索。
- 结果数量限制： 支持设定返回结果的最大数量，避免输出过多数据。
- 缓存机制： 可定义缓存XML文件内容的时长，提升性能并减少重复处理。
- 详细输出： 可开启详细模式，在执行过程中获得更详细的日志。
输入
此组件没有输入句柄。
设置参数
以下为可配置输入参数概要：
| 输入名称 | 描述 | 必填 | 默认值 | 高级 |
|---|---|---|---|---|
| XML文档ID | 通过ID选择内部XML文档。 | 否 | (空) | 是 |
| XML文件URL | 如未使用内部文档，可提供外部XML文件的URL。 | 否 | (空) | 是 |
| 元素路径 | 以逗号分隔的XML元素路径列表，用于限制搜索范围（如product,category）。 | 否 | (空) | 是 |
| 区分大小写 | 搜索时是否区分大小写。 | 否 | False | 是 |
| 最大结果数 | 返回结果的最大数量。 | 是 | 50 | 否 |
| 缓存时长 | XML内容缓存的持续时间（如不缓存、5分钟、2周等）。 | 否 | 2周 | 是 |
| 详细输出 | 启用详细输出，用于调试或查看详细日志。 | 否 | False | 是 |
| 工具名称 | 工具的自定义名称，便于在基于Agent的工作流中引用。 | 否 | (空) | 是 |
| 工具描述 | 用于帮助Agent理解该工具目的和用途的描述。 | 否 | (空) | 是 |
**注意：**应提供 XML文档ID 或 XML文件URL 之一，以指定源XML文件。
输出
- 工具：该组件的输出是一个工具实例，可集成进更大的AI工作流中。它会根据配置的输入返回搜索结果。
用例与优势
- 数据提取： 快速从XML文件中查找并提取结构化数据，用于机器学习模型或数据分析任务。
- 内容过滤： 通过指定元素路径，提取大型XML文档中特定区块或元素。
- 工作流自动化： 将XML数据搜索集成到自动化流程中，实现数据无缝采集与转换。
- 性能优化： 利用缓存机制，避免重复下载或处理大型XML文件，提升工作流效率。
适用场景
当您的AI流程需要处理以XML格式存储的信息（如产品目录、配置文件或结构化报告）时，该组件尤其有用。通过灵活配置，它既可实现简单查找，也支持复杂查询，适用于多种数据提取和转换场景。
集成XML文档搜索组件，可以简化在AI工作流中与XML数据源交互和提取价值的过程。