用途:将 Exa.ai 搜索 API 集成到应用中,实现神经与关键词网页搜索并检索内容,适用于构建网页搜索功能或接入 Exa SDK(exa_py、exa-js)。
主要能力:提供 auto、neural、keyword 三种搜索模式。auto 为大多数查询的默认模式,由 Exa 自动在神经与关键词之间优化;neural 适合自然语言、概念性问题(如“什么是…”“如何…”);keyword 适合精确匹配、技术术语、专有名词和错误码。支持域名、日期、文本和分类过滤,可对结果做正文提取、高亮、摘要和 livecrawl。另提供查找相似链接的能力。
使用方式:Python 使用 exa_py,先创建 Exa(api_key="your-api-key"),或设置 EXA_API_KEY 环境变量;TypeScript 使用 exa-js,new Exa(process.env.EXA_API_KEY)。核心调用为 search_and_contents,可传 type、num_results、text、highlights 等参数;过滤示例包括 include_domains、start_published_date、summary。相似链接使用 find_similar_and_contents,可配 exclude_source_domain。
限制与常见错误:搜索默认只返回 URL,需显式设置 text=True 才会获取内容;可用 highlights=True 获取相关片段、summary=True 获得精简摘要(适合 RAG 场景)。相关度评分仅在 type="neural" 时返回,auto 模式不包含。概念性查询不宜用 keyword。建议先宽泛搜索,再逐步添加域名或日期过滤。需正确设置 API 密钥,否则调用失败。