SuperAPI AI 工具集

search

通用与其它

查看项目

更新于 10-15 17:06

技能介绍

用途

该技能定位为“深度研究编排器”,适用于线索挖掘(lead generation)、文献综述(literature reviews)、深度调研(deep dives)、竞品分析(competitive analysis),以及任何单一搜索无法满足的查询。

主要能力

技能本身并不直接提供搜索能力,而是作为一个编排层,围绕 Exa 搜索服务组织研究工作。核心能力包括:

  • 复杂度评估:将查询划分为极端简单、中等、进阶、复杂四个层级,并据此决定是自行处理还是派发子智能体。
  • 日期计算:当查询涉及时间(如“上周”“最近”“过去 6 个月”)时,先基于当前环境日期明确计算具体日期范围,不凭感觉估计或复用示例日期。
  • 任务分解:识别查询涉及的工作类型,包括种子实体扩展、合格标准定义、字段结构定义、广度搜索、结构化数据抽取、过滤、合并去重、评分排序与叙述综合。
  • 子智能体派发:通过 Agent 工具派发子智能体,保持原始搜索结果不进入主上下文;通常每个子智能体执行 3-5 次搜索,独立工作流并行启动。
  • 参考资料指引:将子智能体指向 references/searching.md(查询撰写指导),并按任务类型附加 references/extraction.md、references/filtering.md、references/synthesis.md、references/source-quality.md。
  • 结果汇总:去重(同一 URL 丢弃、同一实体合并字段)、校验覆盖缺口并做针对性补充搜索、按表格或列表格式化输出。
  • 多轮查询:支持实体链式(多跳)、先探索后定向、先发现标准再搜索候选等顺序多轮模式。
  • 来源质量评估:区分实践者与评论者,关注多个独立高信号来源的收敛结论,并通过“排除法”先剔除噪声来源。

使用方式

服务端为 https://mcp.exa.ai/mcp。认证方式有三种:

  • OAuth(推荐):客户端打开 auth.exa.ai,用户通过 Google / SSO / 邮箱登录,JWT 自动附加,无需复制密钥。
  • API Key:若 OAuth 不可用,可在 https://dashboard.exa.ai/api-keys 获取密钥,通过 Authorization: Bearer …、?exaApiKey=… 或 EXA_API_KEY(本地 npm)传入。
  • 匿名:无需配置即可使用,但受速率限制。

遇到认证或速率限制错误时,应提示修复方式(优先 OAuth),而不是退回到通用网页搜索。

派发子智能体时使用 model: "haiku",并在提示中说明需阅读的参考文件绝对路径、要执行的具体搜索、验证标准与返回格式。每个子智能体需以 sources_reviewed: N 结尾,N 为其所有 web_search_exa 调用 numResults 之和(含重试)。

适用场景

  • 需要跨实体类型交叉引用、多跳链条或穷尽覆盖的复杂研究。
  • 竞品与线索挖掘。
  • 文献综述与深度主题调研。
  • 需要明确评分标准并排序的“最佳”类问题。
  • 需要专家发现与最佳实践收敛结论的查询。

限制

  • 匿名模式受速率限制。
  • 子智能体返回空结果时,应换角度改写查询而非替换同义词;若仍为空,可能说明该主题网络覆盖有限,需如实报告。
  • Exa 返回的是相似度结果,并非已验证结果,出现于搜索结果不代表满足用户标准,必须进行验证。
  • 简单查询不应过度执行(派发子智能体),复杂查询(4 个以上约束、时间连接或语义过滤)不应只做一次搜索。
  • 需避免同义词查询造成的 token 浪费,应按角度而非同义词做多样化。
  • 日期必须基于当前环境日期计算,不得复用说明文档或历史查询中的日期。