组件描述
CSV文档搜索组件的工作原理
CSV文档搜索组件是一款多功能工具，旨在便捷地在CSV文件中进行智能搜索，为您的AI工作流程提供支持。它可以让用户对CSV文档执行基于文本的搜索或pandas查询表达式，非常适用于需要对结构化数据进行动态查询和分析的场景。
这个组件有什么作用？
该组件可以帮助您：
- 在CSV文件内搜索，支持关键词搜索或更高级的pandas风格查询表达式。
- 按指定列筛选搜索结果，若未指定则默认搜索所有列。
- 控制返回结果的数量，可设置最大返回条数。
- 灵活选择数据来源，既可选择内部文档中的CSV文件，也可指定外部文件URL。
- 优化性能和效率，通过缓存选项减少重复加载和解析大型文件的需求。
这使其特别适合将结构化数据查询集成到更大的AI或数据处理流程中，在需要自动化、可复用地访问表格数据时非常有用。
输入项
该组件没有输入句柄。
设置
| 参数 | 描述 | 默认/示例值 | 是否必填 |
|---|---|---|---|
| CSV文档ID | 从内部存储中选择要搜索的CSV文件。 | 否 | |
| CSV文件URL | 如未使用内部文档，可提供外部CSV文件的URL。 | 否 | |
| 搜索列 | 指定要搜索的列（以逗号分隔）。如留空，则搜索所有列。 | 否 | |
| 区分大小写 | 设置搜索时是否区分大小写。 | False | 否 |
| 最大结果数 | 设置每次搜索返回的最大结果数。 | 5000 | 是 |
| 缓存TTL | 定义CSV内容的缓存时长（从“不缓存”到“1年”等多种时长可选）。 | 2周 | 否 |
| 详细模式 | 启用详细输出，便于调试或开发。 | False | 否 |
| 工具名称 | 为工具分配一个自定义名称，以便在Agent工作流中引用。 | 否 | |
| 工具描述 | 提供工具描述，帮助Agent理解其用途和使用方式。 | 否 |
输出
- 工具：主要输出是一个工具对象，可集成到您的工作流程中，或供Agent按需进行文档搜索。
典型用例
- 自动化数据提取：根据用户查询或参数，从大型CSV数据集中检索相关行。
- 数据预处理：作为进一步分析或机器学习的准备步骤，过滤和提取部分数据。
- AI代理的动态数据查找：让AI代理在更广泛的决策过程中，按需访问和搜索表格数据。
为什么要使用CSV文档搜索？
- 灵活性：兼容内部和外部CSV文件，适应不同的数据存储策略。
- 高性能：缓存选项提升速度，减少重复加载数据。
- 可定制性：搜索参数、结果数量、搜索范围（列、大小写）均可根据需求调整。
- 无缝集成：作为大型AI工作流中的模块化组件，便于下游任务访问结构化数据。
该组件非常适合需要在AI自动化或分析流程中，对表格数据进行可编程、可复用搜索的任何用户。
常见问题
- CSV文档搜索组件有什么作用？
它允许您在工作流程中搜索和提取CSV文档中的信息，可以使用简单的文本搜索或pandas查询表达式。
- 我可以使用自己的CSV文件吗？
可以，您既可以搜索内部CSV文档，也可以通过URL搜索外部CSV文件。
- 我如何控制搜索范围？
您可以指定要搜索的列，并设置是否区分大小写。如果未指定列，则搜索所有列。
- 我最多可以获得多少条结果？
您可以设置返回结果的最大数量，默认最多可达5000条。
- 内容会被缓存吗？
会，您可以配置CSV内容的缓存时长，从不缓存到缓存一年，以优化性能。
- 我可以使用什么类型的查询？
您可以执行简单的文本搜索，也可以使用更高级的pandas查询表达式进行灵活的数据检索。