Guide · 使用教程
Exa 网页研究 Agent 教程：搜索、来源核验、预算上限与人工验收
从 20 个真实问题出发，用 Exa Search 取候选网页、核对原文和日期，再让 Agent 生成带证据清单的草稿；重点控制来源质量和整条任务链费用。
这篇教程会完成什么
搭建一个“先找网页、再核查原文、最后写结论”的轻量研究流程。产物是一张每个断言都能追到 URL 的证据表和一份待人工审核的摘要。示例用于公开网页资料，不上传客户名单、内部日志或未授权文档。Exa 负责搜索与内容获取；真实性判断和最终发布仍由人负责。
开始前准备
注册 Exa 账户并在控制台创建 API key，设置 EXA_API_KEY 环境变量。先选 20 个真实问题，其中至少 5 个涉及容易过时的价格或版本，5 个有多个相互矛盾的来源。为每题写下允许的官网域名、预期需要的发布日期和“不知道就不回答”的条件。设置每天和单任务预算、并发与结果数上限。官网 Starter 有每月 $10 免费额度及一次性奖励，实际调用按端点扣费。
第一步：用 Search 建候选清单
下面的请求使用官方 Search API 的 auto 模式，并返回 highlights。把问题替换成需要核实的具体事项；API key 放在环境变量，不写入代码库或日志。
curl -X POST https://api.exa.ai/search \
-H "x-api-key: $EXA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"产品 X 的最新官方价格与生效日期","type":"auto","numResults":8,"contents":{"highlights":true}}'
保存请求时间、requestId、每条结果的 title、url、publishedDate 和 highlights。URL 去除明显追踪参数后再去重；同一站点的多个转载不当作多个独立来源。遇到空结果先检查问题与域名约束，不要无限自动重试。
第二步：读取原文并核查日期
选出与问题最相关的 3–5 个 URL，必要时使用 Contents API 获取正文。优先产品官网、官方文档或一手公告；价格、政策和产品版本要检查网页正文里的生效日期与当前状态。只有 highlights 而拿不到原文时，把证据标记为“不足”，不要写确定性结论。若页面有登录、付费或禁止抓取限制，遵守其访问规则，不绕过权限。
证据表至少包含：断言、原文 URL、页面标题、发布日期、抓取时间、支持它的原文句段、是否独立来源、审核人。页面的 publishedDate 可能缺失或不等于内容更新日，不能只靠它判断新旧。对相互矛盾的来源保留差异，不要让模型强行合并成一个数字。
第三步：让 Agent 写待审草稿
给模型的任务是“只依据证据表写草稿，每条可核查陈述后附来源 URL；证据不足时明确写未知；不得补造日期或价格”。先让模型输出结构化的断言列表，再写自然语言摘要。对于价格表、软件版本或法律政策，要求人工打开原网页复核。若调用 Exa Agent API 做深度研究，限制 effort 与运行次数，并仍保留最终人工验收环节；不要把 Agent 生成的引用视为自动通过。
第四步：验收质量与费用
对 20 题逐条打分：相关页面命中、原文可读、引文支持程度、日期正确、是否有独立第二来源、最终是否需要改写。记录 Exa Search、Contents、Agent、模型 token 和人工审查时间。用“通过验收的答案数”计算单题成本，比每千次搜索单价更接近真实预算。失败题按照“搜不到、抓不到、原文不支持、模型误读”分类，分别修复。
常见错误
- 把搜索摘要当作完整原文：重要结论需要打开页面上下文。
- 只看 URL 数量：十个同源转载仍可能只有一条证据。
- 自动重试没有上限：429 和网络错误要指数退避并有总预算。
- 混入内部敏感信息：先脱敏或改用获批准的内部检索渠道。
- 未记录抓取时间：半年后无法解释为什么旧价格曾被引用。
什么时候换工具
需要快速给一般聊天 Agent 加联网能力，可以同时测 Tavily；要把固定网站长期同步为知识库，应评估 Firecrawl。Exa、Tavily、Firecrawl 都不是事实核验人员。不要用单次演示替代长期的错误率、更新率和费用监控。
官方资料
常见问题
- Exa 免费额度能完成多少次研究？
- 取决于 Search、Contents、Agent 等端点和实际参数，不能换算成固定次数。用小样本记录账单后估算。
- 有 URL 就代表答案可引用吗？
- 不代表。要核对 URL 原文、日期、上下文，以及该段文字是否真正支持对应断言。
- 如何避免引用同一条新闻的多个转载？
- 在证据表中记录最早发布者与转载关系，优先原始公告，并按独立来源计数。
- Exa Agent API 可以替代人工核查吗？
- 不能。多步研究可节省查找时间，价格、法律、医疗和其他高风险结论仍须人工打开原文复核。
- API key 应放在哪里？
- 放在受控环境变量或密钥管理系统；不要放在前端页面、公开仓库或日志中。
- 如何防止费用失控？
- 限制结果数、Contents 页面数、Agent effort、并发和重试次数，设置单任务与日预算，按通过验收的答案计算费用。