DuckDuckGo 搜索 API:AI Flowi Workflow 集成
DuckDuckGo 搜索 API:本页介绍如何通过 AI Flowi Workflow 的原生 DuckDuckGo Search 组件进行查询。它通过必填的 input_value 接收搜索文本,提供两项可选限制控制,并返回 Table。组件目录未说明可在工作流之外调用的独立公共 JSON 端点。
此组件在组件目录中已有说明;Ai Flowi 尚未进行生产环境测试。字段参考来自 2026 年 10 月 9 日导出的 AI Flowi Workflow 1.9.2 目录。本页介绍如何检查少量搜索结果,不编造成功响应、访问保证或提供商配额。
作者:Ai Flowi · 发布于
一个面向特定提供商的搜索条目
在手机上,请将焦点移到 DuckDuckGo 表格区域,再左右滚动表格,以对照阅读查询约定与限制。
| 组件 / 标识 | 组件目录说明原文的译文 | 此接口的用途 |
|---|---|---|
DuckDuckGo Searchduckduckgo.DuckDuckGoSearchComponent | 使用 DuckDuckGo 搜索网页,可自定义结果限制 | 通过直接的 Table 输出检查网页搜索候选结果。 |
其标识为 duckduckgo.DuckDuckGoSearchComponent。完整组件目录将它与 Web Search 分别列出;后者的通用模式选择在其独立页面中说明。DuckDuckGo Search 的导出内容没有 Web、News 或 RSS 选择器;请使用此条目实际提供的字段。
必填查询与两种不同限制
| 输入 | 类型 / 是否必填 | 接受的连接 / 选项 | 配置含义 |
|---|---|---|---|
input_value | str / 是 | Message | 必填搜索文本。Message 是列出的上游查询连接类型。 |
max_results | int / 否 | 未导出类型 | 可选整数结果限制输入。组件目录未提供默认值或支持的范围。 |
max_snippet_length | int / 否 | 未导出类型 | 可选整数摘要限制输入。导出内容未定义单位或截断规则。 |
查询连接和手动输入的字符串值,是向同一字段提供内容的不同方式。初次检查时,请直接输入明确选定的短语。了解其行为后,如果任务需要变化的搜索文本,再连接能生成 Message 的输入。搜索前,请验证任务文本;仅有必填标记,并未说明是否会拒绝空白字符或空查询。
SerpAPI 限制说明介绍了结果数量与摘要上下文之间的共通区别。
相关内容:Wikipedia API 使用:AI Flowi Workflow 的 Wikipedia 与 Wikidata 集成。
Table 输出需要检查字段
| 组件标识 | 显示标签 | 端口名称 | 类型 |
|---|---|---|---|
duckduckgo.DuckDuckGoSearchComponent | Table | dataframe | Table |
端口名称为 dataframe,显示标签为 Table,导出类型也是 Table。该条目未列出结果列、排序字段、来源地址字段或错误行。因此,Table 连接只能说明数据容器与下一个节点兼容,并未提供用于选择 URL 或编写摘要的完整结构。
选择任何基于字段的操作前,请先检查结果。确认实际观察到的来源引用、摘要表示和空结果行为。如果无法从返回数据确定来源,在能够检查来源之前,不要将其用于依赖引用的输出。不要根据标题猜测 URL 来填补缺失的来源地址。
未导出密钥字段意味着什么
完整输入列表中没有 API 密钥、账户选择器或已保存连接的标识符。这只说明此组件导出的设置,并不能证明提供商访问不受限制、存在官方托管 JSON API、提供服务级别协议,或允许重新分发检索材料。
如果部署需要在此 DuckDuckGo 节点之外配置访问权限,请使用文档说明的连接机制。
从查询到显示的检查
配置示例,并非已记录的测试
- 添加 DuckDuckGo Search,其标识为
duckduckgo.DuckDuckGoSearchComponent。将示例查询workflow data validation documentation输入input_value。 - 将
max_results设为3,将max_snippet_length设为240。这些数字是拟议的检查设置;允许的取值范围,以及这些限制是否实际生效,都需要在你自己的运行中检查。 - 添加 Chat Output,将
dataframe连接到其必填的input_value。接收字段的接受类型包含 Table。 - 检查显示的数据和节点结果。记录实际可用的字段名称和来源引用,以及查询内容和两项限制设置。
- 第二次试运行只改变一项限制。添加格式化器或语言模型步骤前,请比较返回的数据表示。
配置 DuckDuckGo 候选结果集的显示方式时,请参阅 Chat Output 参考。
分别处理查找、来源审查与失败
查找文档时,请先确认组件标识,再接受参考资料。有关名称相似节点的页面可能看似相关,却描述了不兼容的输入约定。下方查询练习说明如何缩小组件标识问题的范围。
如果运行未返回可用候选结果,请将该情况记录为“本次试运行无可用结果”。如果节点报告访问错误或提供商错误,则应保留该错误。这些观察结果需要不同的后续步骤。组件目录没有为任一情况定义自动分支,因此设计无人值守处理前,请先核实其实际表示。
何时需要 DuckDuckGo 以外的检索接口?
此处未导出搜索引擎选项、页面偏移量、语言选择器、位置字段、超时或重试控制。组件说明明确了可自定义限制的网页搜索,但未说明专门的新闻检索、整页加载、排名保证或精确的时效窗口。
已知要检查的页面时,请选择文档说明的 URL 读取路径;如果需求是导出的模式控制,请使用通用 Web Search 参考。本页不会将 DuckDuckGo 组件变成面向普通用户的浏览器教程或通用 HTTP API 规范。在更大的工作流中依赖原生搜索约定之前,请先测试它。
相关内容:Exa 搜索 API:AI Flowi Workflow 集成。
文档查找查询练习
假设你需要某个具名工作流组件的验证说明。请准备一个包含组件名称和待理解行为的初始短语,而不是整段聊天记录。长对话可能包含多个无关请求,而此节点只有一个必填搜索文本字段。在将文本放入 input_value 之前,请确定哪个请求才是需要通过搜索解答的问题。这并不假定支持特定搜索运算符或查询语法。
在示例 workflow data validation documentation 试运行中,按用途将每个可检查的候选结果分类:组件参考、展示某种配置的教程、一般文章或无关匹配。教程可以帮助解释配置,却未必是每个输入的权威定义。参考资料可以定义输入,却不一定展示成功运行。这种分类比仅因标题包含全部查询词就接受页面,更能直接回答文档问题。
后续短语可以将宽泛的行为描述替换为你已知的准确组件名称。保持试运行限制不变。检查候选结果现在是否涉及促使你搜索的那个输入。如果它讨论的是标签相似的其他组件,请先修改实体表述,再扩大搜索范围。缩小短语范围是在明确所寻找的实体;这与上文链接中的结果数量与摘要上下文之间的权衡是不同问题。
将手动输入文本改为 Message 连接之前,请检查一条拟输入、包含两个问题的消息。确定哪个问题会发送到此搜索节点,以及工作流应如何处理另一个问题。组件目录未在此提供查询提取字段。连接对话消息本身,并不会从消息中选出需要通过搜索解答的问题,因此在依赖动态输入前,请先在上游确定预期文本。不要仅因凭据或私密工作区细节出现在对话中,就将其粘贴到查询里。
对于此文档任务,空结果意味着针对该组件的问题仍缺少候选参考。只有准确名称的短语过窄时才扩大表述;提供商错误则需要解决执行失败。不要将任何一种情况转化为编造的文档链接。如果同事已提供权威页面地址,再次搜索会增加不必要的查找步骤;请通过 URL 组件读取该已知地址。
搜索检查用量
套餐:Go 年付方案每月 USD8 起(月付 USD10),Plus 年付方案每月 USD16 起(月付 USD20),Pro 100 年付方案每月 USD80 起(月付 USD100),Pro 200 年付方案每月 USD160 起(月付 USD200),Pro 500 年付方案每月 USD400 起(月付 USD500),每月包含 5,000 至 250,000 个 Flowi Tokens,并支持充值;每次节点运行消耗 1 个 token;不包含第三方 API 和模型使用费用。
其他原生检索类别列在集成中心中。