DuckDuckGoSearch 组件概览
DuckDuckGoSearch 组件让您的 AI 工作流能够使用 DuckDuckGo 搜索引擎进行实时网页搜索。它接受用户自定义的搜索查询，并返回相关网页结果，包括 URL 和其内容，是知识检索、研究任务或为大语言模型（LLM）补充最新互联网信息的强大工具。
该组件的功能
- 根据提供的关键词（查询）在 DuckDuckGo 上执行搜索。
- 检索可配置数量的结果（默认：3）。
- 支持按地区、安全搜索等级和时间段筛选结果。
- 结果可作为结构化 URL 记录和纯文本输出，适合后续自动处理或展示。
- 可作为独立工具使用，也可集成到基于 agent 的工作流中。
输入项
| Name | Description | Type | Required | Default | Advanced |
|---|---|---|---|---|---|
| Input Keywords | 要搜索的关键词或查询字符串。 | String | Yes | (empty) | No |
| Max Results | 返回结果的数量。 | Integer | Yes | 3 | No |
| Region | 用于本地化结果的地区/语言代码（如 us-en, uk-en, ru-ru）。 | String | Yes | us-en | Yes |
| SafeSearch | 设置安全搜索过滤级别：strict、moderate 或 off。 | String | Yes | moderate | Yes |
| Time Limit | 按时间限制结果：d（天）、w（周）、m（月）、y（年）。 | String | Yes | y | Yes |
| Tool Description | （可选）供 agent 理解如何使用该工具的描述。 | String | No | (empty) | Yes |
| Tool Name | （可选）在 agent 框架中引用该工具的别名。 | String | No | (empty) | Yes |
| Verbose | 执行时是否打印详细/调试输出。 | Boolean | No | false | Yes |
输出项
该组件提供三种输出格式：
URL 记录 (
UrlRecord)- 搜索结果的结构化列表，每项包含 URL 及其相关内容。适用于编程处理或与其他组件串联。
文本格式的 URL (
Message)- 将搜索结果以可读文本格式输出，适合直接展示或集成到消息驱动型流程中。
DuckDuckGo 搜索作为工具 (
Tool)- 整个搜索操作封装为工具对象，便于在 agent 或使用工具的 AI 系统中使用。
为什么要用这个组件？
- 获取最新信息： 让您的 AI 工作流查询最新网页信息，特别适合 LLM 或 AI agent 需要获取其训练集之外的最新数据时使用。
- 灵活配置： 支持地区、安全搜索、时间等多维度过滤，满足个性化需求。
- 多格式输出： 可根据下游任务选择最合适的输出格式，无论是自动化处理还是面向终端用户的展示。
- Agent 集成： 易于被 agent 框架引用和描述，适用于复杂的 AI 编排场景。
示例应用场景
- 答案增强： 用实时网页搜索结果丰富 LLM 的回答。
- 知识提取： 获取最新网页内容用于总结或分析。
- 研究自动化： 针对特定主题、领域或时间段自动收集信息。
该组件是需要外部知识和最新网页数据的工作流中，灵活且必不可少的基础模块。