用途:把 Exa 的 Search 与 Contents 作为显式的两阶段检索流程来操作或审查,在受限上下文、时效要求和成本上限下工作。
主要能力:POST /search 可返回排序结果及嵌套内容;POST /contents 用于检索已知 URL 或文档 ID,且必须逐条检查每个 URL 的状态。内容模式中,highlights 更省 token,text 支持更深分析,summary 为生成式摘要。maxAgeHours 省略时使用缓存并以 livecrawl 兜底,设为 0 强制 livecrawl,设为 -1 仅用缓存。
使用方式:先对查询、允许域名、审核需求与时效要求分类;除非有实测延迟或深度综合需求,type 选 auto;以有界结果数和最小内容模式搜索;仅在需要更多上下文时,把已批准的 URL 或 ID 提升为 Contents 请求;检查每个 Contents 状态并隔离部分抓取失败;记录请求 ID、数量、时效策略与成本,但不复制内容。凭证方面,常规 REST 调用从服务端密钥管理器注入 EXA_API_KEY,仅以 Authorization: Bearer 发往配置的 Exa 官方 API 主机,不得打印、提交、放入 URL 或暴露给不可信客户端。
适用场景:需要可审计、成本可控的检索流程,或对既有 Exa 检索实现做评审。
限制:旧版 neural 不推荐用于新代码;强制 livecrawl 会增加延迟且仍可能逐 URL 失败;批次级 Contents 成功响应中仍可能包含失败的 URL 状态。涉及敏感意图、生产凭证、支出或限流变更、强制实时抓取、生成摘要、外部交付、部署、成员或密钥变更、计划创建及破坏性取消删除等操作,需有责任负责人批准。仅调用本技能不授权实际调用 Exa 或产生付费研究。输出应包含操作范围、环境、授权类别、策略决策、验证结果、无内容标识符、状态与成本计数、风险及回滚状态,并排除凭证、原始查询、提示词、预签名 URL、检索内容与生成输出。