用途:以异步方式运行 Exa Agent 研究,将已批准的研究问题转化为窄查询,并可选系统提示,适用于需要结构化输出、引用与成本控制的调研流程。
主要能力:创建一次运行并持久化不含内容的 run ID;通过轮询或服务器发送事件消费结果,并设置截止时间与终态处理;独立校验结构化字段、grounding、引用与成本;按证据策略停止、取消、保留或删除运行。固定 effort 提供可预测价格,auto 与 beta max 按用量计费。
使用方式:从已批准的服务器端密钥管理器注入 EXA_API_KEY,仅以 Authorization: Bearer 发送到配置的第一方 Exa API 主机。选择固定 effort 或显式计量上限,定义输出 schema,创建运行后轮询或消费 SSE,最后按策略清理。
限制与边界:运行创建不等于完成;schema 有效的结果仍可能 grounding 薄弱或超出范围;cancel、stop、delete 操作意图不同,不可混用。涉及敏感意图、生产凭据、花费或速率限制变更、强制实时爬取、生成摘要、外部交付、部署、成员或密钥变更、计划创建及破坏性操作时,需有责任负责人批准。只读仓库检查与离线合成验证不授权实时供应商操作。输出应排除凭据、原始查询、提示、预签名 URL、检索内容、生成输出与客户衍生数据,除非另行批准。
验证:重跑最小相关确定性测试,对照请求结果与当前第一方契约,确认敏感字段未出现在证据中,并核实截止时间、终态、下游保留与回滚后再报告成功。具体端点、参数、价格、限制与合规声明需查阅带日期的第一方证据地图。