用途:该技能面向需要语义网页搜索、相似页面发现、结果内容提取、研究论文查找、GitHub 发现或结构化研究的场景,根据用户意图选择 Exa 端点。
主要能力与端点选择:search 用于语义搜索、查找网页或研究主题,默认 type 为 auto;深度搜索或结构化研究使用 search 端点并设 type 为 deep 或 deep-reasoning,可选 outputSchema;contents 在已有结果 ID 时提取完整内容;findsimilar 在给定 URL 时查找相似页面;answer 用于直接回答问题。注意 /research 与 /research/v1 已弃用并于 2026-05-01 硬移除,新调用应迁移到 /search 并设 type 为 deep-reasoning。
使用方式:采用主技能加子技能两阶段架构,主技能理解问题、选择端点并组装 JSON,子技能仅执行 HTTP 调用。通过 Task 工具调用 exa-fetcher 子技能,参数为 subagent_type: Bash、description: "Call Exa API",prompt 使用 cat <<'JSON' | node scripts/exa-api.cjs <search|contents|findsimilar|answer> 传入 JSON。脚本仍接受旧 research 命令以兼容,但会规范化负载并发送到 /search 且 type 为 deep-reasoning。
搜索类型包括 auto、fast、instant、deep-lite、deep、deep-reasoning;类别包括 company、people、research paper、news、personal site、financial report 等。使用 outputSchema 时,/search 在 output.content 返回合成内容,在 output.grounding 返回字段级引用与置信度,不要向 schema 添加引用或置信度字段。
API Key 配置优先级为环境变量 EXA_API_KEY 高于 .env 文件,可从 .env.example 复制。所有端点返回 JSON,包含 requestId、results、searchType、context 与 costDollars。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;使用前需自行配置 API Key,并注意弃用端点的迁移要求。