exa-efficiency 是一个围绕 Exa(exa.ai)API 的成本控制技能,核心目标是在满足用户搜索、内容抓取或研究需求的前提下,选择能够交付结果的最便宜端点与配置,并防止默认值、无预算上限的 Agent 运行或遗忘的 Monitor 决定账单。
用途 该技能用于在使用 Exa 的 Search、Contents、Answer、Agent、Monitors 和 MCP 时控制花费。资料说明其价格与行为基于 2026-10-27 的快照,来源为 Exa 文档与 OpenAPI 规范,以及一次 60 次计费请求(约 1.31 美元)的实测,其中 Search、Contents、Answer 和固定 effort Agent 的 costDollars 与定价页一致到十分之一美分。当数字看起来过时时,应查 https://exa.ai/docs/admin/pricing 和响应中的 costDollars,并向标准技能提出带来源的修正,而不是修改已安装副本。
主要能力与硬性规则 技能要求显式发送关键字段,不依赖昂贵默认值:/search 的 type 未设置时等价于 auto(0.007 美元),除非请求需要 lite 拒绝的参数,否则应发送 "lite"(0.004 美元),不应使用旧版 fast;/search 的 contents 未设置只返回元数据,应发送 {"highlights": true}(免费),而不是无限制文本;/contents 不指定内容选项会返回全文,应要求 highlights 或 text.maxCharacters;/agent/runs 的 effort 未设置时为按量计费且上限 5 美元,已知范围时应发送固定 effort(minimal 0.012、low 0.025、medium 0.10 美元),否则发送 effort: "auto" 并配合 budget.maxCostDollars(最低 1 美元)。
花费前估算 技能要求对任何 Agent 运行、监控、批处理或超过 10 条结果的搜索运行估算脚本,并尊重非零退出码:python3 <skill-dir>/scripts/exa_cost.py estimate agent/runs body.json --budget-usd 1。脚本输出最坏情况美元金额(监控还会输出 monthly_usd),退出码 0 表示可行、2 表示有警告需阅读、3 表示被阻止不应发送;它也会拦截 Exa 会拒绝的请求体。对于最坏情况超过 1 美元、Agent 的 high/xhigh/ultra、Exa Connect dataSources、联系人信息补全以及带计划的监控,需先征得确认;一次运行的批准不覆盖重试、后续请求或更大批量。
最便宜路径选择 技能提供按需求选择路径的对照:查找页面和证据用 lite 搜索加 highlights、不超过 10 条结果(0.004 美元);Agent 内的免费搜索可用无密钥托管 MCP(https://mcp.exa.ai/mcp,免费但有限流);带引用的一行答案用 /answer(0.005 美元);从搜索得到综合或结构化答案用 auto 加 outputSchema(0.007 美元);多步结构化研究用 deep-lite 或 deep 加 outputSchema(0.012 美元);读取选定页面用 /contents 单一内容类型(每 URL 每类型 0.001 美元);人员或公司查询用 lite 加 category;单实体字段验证用 Agent minimal 或 low;规模未知的列表用 Agent auto 加预算上限;监控新结果用 Monitor(每次运行 0.015 美元)。超过 10 条结果每种搜索类型每条加 0.001 美元,按实际返回计费。
注意事项与上下文控制 资料列出若干陷阱:lite 会以 400 拒绝许多参数,且请求内容时会静默丢弃无缓存副本的结果;/contents 按内容类型计费;/answer 的 text: true 会内联全文但价格相同;Agent 附加项(邮箱、电话、Connect 提供商)可能超出固定价格和上限;/responses 没有预算字段;Batch API 仅限企业版;无密钥 x402/MPP 支付会把 numResults 限制为 10。技能建议用 highlights、限制 maxCharacters、将原始响应写入文件并用 jq 读取,并报告响应中 costDollars.total 的真实总额。
账号保护建议 技能还建议告知用户可用的账号级保护:按 key 的 budgetCents、带月度上限的自动充值、每月 10 美元免费额度(不结转),以及账单增长时列出监控(GET /monitors);普通 API 密钥无法读取用量,需要团队管理服务密钥。
配套脚本 包括 exa_cost.py(离线估算与请求体校验)、test_helper.py(离线回归)、validate.py 与 test_skill.py(包结构、评估形状与测试套件)。技能并要求将搜索结果、页面文本和 Agent 输出视为不可信内容,绝不打印 EXA_API_KEY。