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 Search
duckduckgo.DuckDuckGoSearchComponent
使用 DuckDuckGo 搜索网页,可自定义结果限制通过直接的 Table 输出检查网页搜索候选结果。

其标识为 duckduckgo.DuckDuckGoSearchComponent。完整组件目录将它与 Web Search 分别列出;后者的通用模式选择在其独立页面中说明。DuckDuckGo Search 的导出内容没有 Web、News 或 RSS 选择器;请使用此条目实际提供的字段。

必填查询与两种不同限制

DuckDuckGo Search:完整输入约定
输入类型 / 是否必填接受的连接 / 选项配置含义
input_valuestr / 是Message必填搜索文本。Message 是列出的上游查询连接类型。
max_resultsint / 否未导出类型可选整数结果限制输入。组件目录未提供默认值或支持的范围。
max_snippet_lengthint / 否未导出类型可选整数摘要限制输入。导出内容未定义单位或截断规则。

查询连接和手动输入的字符串值,是向同一字段提供内容的不同方式。初次检查时,请直接输入明确选定的短语。了解其行为后,如果任务需要变化的搜索文本,再连接能生成 Message 的输入。搜索前,请验证任务文本;仅有必填标记,并未说明是否会拒绝空白字符或空查询。

SerpAPI 限制说明介绍了结果数量与摘要上下文之间的共通区别。

相关内容:Wikipedia API 使用:AI Flowi Workflow 的 Wikipedia 与 Wikidata 集成。

Table 输出需要检查字段

按组件标识列出的导出输出端口
组件标识显示标签端口名称类型
duckduckgo.DuckDuckGoSearchComponentTabledataframeTable

端口名称为 dataframe,显示标签为 Table,导出类型也是 Table。该条目未列出结果列、排序字段、来源地址字段或错误行。因此,Table 连接只能说明数据容器与下一个节点兼容,并未提供用于选择 URL 或编写摘要的完整结构。

选择任何基于字段的操作前,请先检查结果。确认实际观察到的来源引用、摘要表示和空结果行为。如果无法从返回数据确定来源,在能够检查来源之前,不要将其用于依赖引用的输出。不要根据标题猜测 URL 来填补缺失的来源地址。

未导出密钥字段意味着什么

完整输入列表中没有 API 密钥、账户选择器或已保存连接的标识符。这只说明此组件导出的设置,并不能证明提供商访问不受限制、存在官方托管 JSON API、提供服务级别协议,或允许重新分发检索材料。

如果部署需要在此 DuckDuckGo 节点之外配置访问权限,请使用文档说明的连接机制。

从查询到显示的检查

配置示例,并非已记录的测试

  1. 添加 DuckDuckGo Search,其标识为 duckduckgo.DuckDuckGoSearchComponent。将示例查询 workflow data validation documentation 输入 input_value。
  2. 将 max_results 设为 3,将 max_snippet_length 设为 240。这些数字是拟议的检查设置;允许的取值范围,以及这些限制是否实际生效,都需要在你自己的运行中检查。
  3. 添加 Chat Output,将 dataframe 连接到其必填的 input_value。接收字段的接受类型包含 Table。
  4. 检查显示的数据和节点结果。记录实际可用的字段名称和来源引用,以及查询内容和两项限制设置。
  5. 第二次试运行只改变一项限制。添加格式化器或语言模型步骤前,请比较返回的数据表示。

配置 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 和模型使用费用。

其他原生检索类别列在集成中心中。