用途:帮助开发者用 Exa API 构建应用与智能体,覆盖检索、内容提取、答案生成、异步研究与定时任务等场景。
主要能力:核心检索 API(/search、/contents、/answer);长时研究用 Agent API(/agent);定时循环搜索用 Monitors API;旧版 Websets API 仅供既有集成;历史内容用 Exa Snapshot(search 与 contents 的 snapshotAsOf);SDK 为 Python exa-py 与 TypeScript exa-js;另提供 OpenAI 兼容端点(/chat/completions、/responses)。
安装与认证:pip install exa-py;npm install exa-js。设置 export EXA_API_KEY="your_api_key_here",支持 x-api-key 头或 Authorization: Bearer。
用法要点:推荐请求仅为 query 加 contents.highlights: true,其余字段按需添加。type 默认 auto,numResults 默认 10,category、域名过滤、maxAgeHours、日期过滤等仅在任务明确要求时使用。需要特定字段或合成结果时用 outputSchema 与 systemPrompt;search 的 text/highlights/summary 放在 contents 内,contents 端点则为顶层字段,三者择一。
限制:/search、/answer、/agent 支持零数据保留(ZDR),Websets 与 Monitors 不支持。Agent 为异步高延迟,需显式设置 effort 并轮询或 SSE 等待终态。/findSimilar 已弃用,新集成优先用 /search。新集合构建应使用 Agent API 而非 Websets。