SuperAPI AI 工具集

web-research

写作与研究

查看项目

更新于 10-15 22:14

技能介绍

用途:把一个问题拆成需要证据的事实主张或子问题,用 Exa 和 Tavily 作为互补的研究来源,最后自行撰写一份带链接引用的综合答案。不用于浏览器 QA(fieldtest)或网页抓取(firecrawl-*),Firecrawl 不属于本技能。

主要能力:并行调用 Exa 与 Tavily 做发现;检索支撑答案的原始页面;优先一手来源、去重 URL 与重复报道、核查两个来源之间的实质分歧;保留不确定性与来源分歧,而不是把两份报告并排粘贴。仅在普通搜索与提取无法回答时才使用深度或代理式研究,且服务商生成的研究报告只作为综合的输入,不是最终答案。

使用方式:EXA_API_KEY 与 TAVILY_API_KEY 从环境变量读取,若没有则从当前仓库根目录的 .env 读取;一次调用只需所选服务商的密钥。若两处都没有,说明缺少哪个变量并停止。通过 scripts/request 调用 API,避免在诊断信息或命令参数中暴露密钥。请求体以完整 JSON 经标准输入传入,例如:printf '%s' '{"query":"current timber reuse standards","type":"auto","numResults":5}' | scripts/request exa search。选择端点前先阅读 references/providers.md,使用能回答该问题的最廉价操作。

限制:绝不把密钥写入任何文件、打印出来,也不因认证失败而改用其他搜索服务商;应报告哪个服务商不可用及由此产生的覆盖缺口。凭据加载必须非交互并受宿主超时约束,不得把登录作为修复步骤。捆绑的辅助脚本需要 Python 3;scripts/read-credential.py 在任何请求前要求一个非空、单行的环境凭据,它从不读取凭据文件,也不发起认证。其他细节暂未提供。