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 工具包表格支持横向滚动,便于在小屏幕上阅读凭据和输出名称。
| 组件 / 标识 | 组件目录说明原文的译文 | 此接口的用途 |
|---|---|---|
Exa Searchexa.ExaSearch | 用于搜索和内容检索的 Exa Search 工具包 | 为能调用工具的兼容组件准备提供商工具包。 |
请用 exa.ExaSearch 在组件目录中确认目标条目。现有的 Web Search 参考介绍直接查询的 Table 接口。将该接口照搬到 Exa,会凭空增加此工具包并不具备的查询输入和 Table 输出。
密钥、搜索限制、相似内容限制与自动提示词
| 输入 | 类型 / 是否必填 | 接受的连接 / 选项 | 配置含义 |
|---|---|---|---|
metaphor_api_key | str / 否 | 明确为空列表 | 提供商凭据字段使用此准确名称。导出内容将其标为可选,但未说明匿名访问或自动查找密钥。 |
search_num_results | int / 否 | 未导出类型 | 以搜索结果数量命名的整数控制。未提供范围、默认值或各工具的限制执行规则。 |
similar_num_results | int / 否 | 未导出类型 | 以相似结果数量命名的独立整数控制。导出内容未列出相似内容工具的参数。 |
use_autoprompt | bool / 否 | 未导出类型 | 布尔选项。组件目录列出了开关名称,但未说明改写行为或默认值。 |
请严格保留导出的凭据名称:metaphor_api_key。为匹配提供商显示名称而重命名字段,会创建此快照中不存在的配置。必填标记也需要仔细解读:元数据将该字段标为可选,但未说明缺少凭据时从哪里获取,也不能证明不提供凭据就能调用提供商。
两项结果数量控制应分别记录。搜索结果设置不能确定相似内容操作的结果数量,这两个整数也都不设定 Agent 的迭代预算。测试 use_autoprompt 时,请保持其他设置和任务文本不变,避免在比较中混入多项配置变化。
tools 端口是交接点
| 组件标识 | 显示标签 | 端口名称 | 类型 |
|---|---|---|---|
exa.ExaSearch | Tools | tools | Tool |
唯一输出名为 tools,显示为 Tools,类型为 Tool。此条目没有 JSON、Message 或 Table 结果端口。Agent 可以使用工具包,并不能证明 Agent 已选择它、使用了合适的参数或收到有用的来源内容。
使用生成的工具前,请在工作区检查工具名称、说明和接受的参数。组件目录条目未提供单个工具清单或查询结构。因此,仅凭工具包说明就承诺特定搜索方法、相似度参数、内容键或响应封装结构,为时过早。
分别准备提供商与模型访问权限
配置访问提供商的连接时,你需要自己的 Exa 账户和 API 密钥,提供商用量另行付费。通过导出的 metaphor_api_key 字段填写该凭据。凭据机制可参阅连接指南;请核实该字段是否支持变量加载,以及支持的加载方式,不要根据其接受类型列表为空就作出假定。
为接收端 Agent 配置连接时,请遵循 Agent 连线参考及其链接中的模型访问说明。
检查一个设有限制的 Agent 配置
配置示例,并非已记录的测试
- 添加 Exa Search,通过
metaphor_api_key输入你自己的提供商密钥。明确选择试运行设置:将search_num_results设为3,将similar_num_results设为2,将use_autoprompt设为false。 - 检查生成的工具包定义。找出适合计划任务的工具,并检查其预期参数;本页不提供猜测的参数名称。
- 添加 Language Model,配置其必填的
model和提供商访问权限,然后将其model_output连接到 Agent 必填的model。 - 将 Exa Search 的
tools连接到Agent.tools。将 Agent 的input_value设为Find source material explaining workflow input validation and retain the source references. - 设置
system_prompt,要求提供观察到的工具证据、保留来源引用,并在检索失败时明确标记为未解决。将max_iterations设为2,作为试运行上限;这不承诺任务完成或确切调用次数。 - 将
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 和模型使用费用。
集成索引包含不同交接类型的检索条目。