Exa 搜索 API:AI Flowi Workflow 集成

Exa 搜索 API 在 AI Flowi Workflow 中通过 Exa Search 搜索与内容检索工具包提供,其返回的是 Tool,而非直接的搜索结果行。请先配置提供商密钥和工具包控制项,再检查工具定义,之后才将输出连接到 Agent。导出的 Exa Search 节点没有查询字段。

此工具包在组件目录中已有说明;Ai Flowi 尚未进行生产环境测试。本页采用 2026 年 10 月 9 日导出的 AI Flowi Workflow 1.9.2 组件目录,并区分准备工具、实际调用工具和审查检索材料。

作者:Ai Flowi · 发布于

工具包约定:输出并非直接结果

Exa 工具包表格支持横向滚动,便于在小屏幕上阅读凭据和输出名称。

组件清单与范围
组件 / 标识组件目录说明原文的译文此接口的用途
Exa Search
exa.ExaSearch
用于搜索和内容检索的 Exa Search 工具包为能调用工具的兼容组件准备提供商工具包。

请用 exa.ExaSearch 在组件目录中确认目标条目。现有的 Web Search 参考介绍直接查询的 Table 接口。将该接口照搬到 Exa,会凭空增加此工具包并不具备的查询输入和 Table 输出。

密钥、搜索限制、相似内容限制与自动提示词

Exa Search:完整输入约定
输入类型 / 是否必填接受的连接 / 选项配置含义
metaphor_api_keystr / 否明确为空列表提供商凭据字段使用此准确名称。导出内容将其标为可选,但未说明匿名访问或自动查找密钥。
search_num_resultsint / 否未导出类型以搜索结果数量命名的整数控制。未提供范围、默认值或各工具的限制执行规则。
similar_num_resultsint / 否未导出类型以相似结果数量命名的独立整数控制。导出内容未列出相似内容工具的参数。
use_autopromptbool / 否未导出类型布尔选项。组件目录列出了开关名称,但未说明改写行为或默认值。

请严格保留导出的凭据名称:metaphor_api_key。为匹配提供商显示名称而重命名字段,会创建此快照中不存在的配置。必填标记也需要仔细解读:元数据将该字段标为可选,但未说明缺少凭据时从哪里获取,也不能证明不提供凭据就能调用提供商。

两项结果数量控制应分别记录。搜索结果设置不能确定相似内容操作的结果数量,这两个整数也都不设定 Agent 的迭代预算。测试 use_autoprompt 时,请保持其他设置和任务文本不变,避免在比较中混入多项配置变化。

tools 端口是交接点

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

唯一输出名为 tools,显示为 Tools,类型为 Tool。此条目没有 JSON、Message 或 Table 结果端口。Agent 可以使用工具包,并不能证明 Agent 已选择它、使用了合适的参数或收到有用的来源内容。

使用生成的工具前,请在工作区检查工具名称、说明和接受的参数。组件目录条目未提供单个工具清单或查询结构。因此,仅凭工具包说明就承诺特定搜索方法、相似度参数、内容键或响应封装结构,为时过早。

分别准备提供商与模型访问权限

配置访问提供商的连接时,你需要自己的 Exa 账户和 API 密钥,提供商用量另行付费。通过导出的 metaphor_api_key 字段填写该凭据。凭据机制可参阅连接指南;请核实该字段是否支持变量加载,以及支持的加载方式,不要根据其接受类型列表为空就作出假定。

为接收端 Agent 配置连接时,请遵循 Agent 连线参考及其链接中的模型访问说明。

检查一个设有限制的 Agent 配置

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

  1. 添加 Exa Search,通过 metaphor_api_key 输入你自己的提供商密钥。明确选择试运行设置:将 search_num_results 设为 3,将 similar_num_results 设为 2,将 use_autoprompt 设为 false。
  2. 检查生成的工具包定义。找出适合计划任务的工具,并检查其预期参数;本页不提供猜测的参数名称。
  3. 添加 Language Model,配置其必填的 model 和提供商访问权限,然后将其 model_output 连接到 Agent 必填的 model。
  4. 将 Exa Search 的 tools 连接到 Agent.tools。将 Agent 的 input_value 设为 Find source material explaining workflow input validation and retain the source references.
  5. 设置 system_prompt,要求提供观察到的工具证据、保留来源引用,并在检索失败时明确标记为未解决。将 max_iterations 设为 2,作为试运行上限;这不承诺任务完成或确切调用次数。
  6. 将 Agent.response 连接到 Chat Output 的 input_value,该字段接受 Message。接受任何检索所得的说法之前,请先检查实际工具活动和响应。

预期结果是你自己的运行中产生的 Agent 响应,并附有可检查的检索证据。Agent 仅用一句话声称已搜索,并不足以证明搜索发生。如果未观察到工具调用,请记录这一缺失,不要将生成文本视为 Exa 输出。

先检查工具参数,再检查来源质量

首先检查所选工具是否适合任务,以及观察到的参数是否反映预期问题。随后审查返回的引用和内容。这一顺序有助于区分是候选来源质量不佳,还是 Agent 从未提出正确的检索问题。

在了解工具包实际接口之前,请将搜索与相似内容试运行分开。similar_num_results 字段没有解释相似内容操作使用哪个来源。检查真实调用时,请记录该来源或参数,不要将原因不明的结果集归因于已有文档说明的相似内容配置方法。

相关内容:arXiv API 使用:AI Flowi Workflow 集成。

相关内容:DuckDuckGo 搜索 API:AI Flowi Workflow 集成。

Exa 工具包配置何时不适用?

导出内容未提供查询文本框、日期过滤器、域名允许列表、内容大小限制、超时或重试字段,也未提供自动提示词改写规则。如果任务需要其中某项控制,请先检查工具定义和实际提供商约定,再说明此节点是否支持该需求。

如果工作流需要从查询输入到 Table 输出的确定性传递,而非由 Agent 选择工具,请使用直接返回结果的组件。不要将 Exa 输出当作已检索文本,也不要将它连接到仅接受 Table 的字段。兼容的 Tool 连接只是初始配置,工具执行、来源检查和错误处理仍需验证。

三种不同的工具包检查

比较之前,请先根据工具包定义确定哪些检查可行。记录已部署 Exa 条目提供的可调用项名称及其接受的参数。如果没有对应计划操作的可调用项,请在定义检查阶段停止该练习。search_num_results 和 similar_num_results 这两个名称提示了不同的配置关注点,却无法补全缺失的可调用项名称或参数结构。

搜索练习可从拟议 Agent 配置中的文档查找任务开始。观察选中了哪个可调用项,以及实际查询参数(如果可见)。检查该参数是在询问工作流输入验证,还是询问 Agent 引入的更宽泛主题。如果检索前任务被改变,请先审查该变化,再判断返回的候选结果。随后检查所选搜索控制与返回表示之间的关系;不要假定工具包中每个可调用项都以相同方式执行限制。

相似内容练习需要根据接受的参数约定确定种子。如果要求来源地址,请选择你能检查的地址,并说明该来源为何代表所需主题。如果要求其他形式,则使用文档说明的形式。检查 similar_num_results 时,请保持种子不变。与不合适种子相关的结果集,可能符合相似性逻辑,却无法完成最初的查找任务;同时更改种子和限制会掩盖这一区别。

自动提示词练习应保持任务、可调用项和相关限制不变,仅将 use_autoprompt 从 false 改为 true。检查所有可观察的请求变化。如果变化不可见,请报告开关已改变,但无法检查改写后的请求。仅凭候选结果不同,无法确定改写规则。同样,候选结果不变也不能证明开关没有作用:导出内容未提供可据以作出该结论的内部行为说明。

请分别记录可调用项不可用、未观察到调用、参数不匹配和检索内容不适用这几种结果。它们各自指出工具包交接中需要调查的不同环节。例如,降低 similar_num_results 无法修复携带错误问题的搜索调用。这些检查有助于判断工具包是否适合任务,但不能确立 Exa 性能基准,也不要求在仅需直接结果行的工作流中增加模型阶段。

工具包与 Agent 用量

套餐: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 和模型使用费用。

集成索引包含不同交接类型的检索条目。