SuperAPI AI 工具集

exa-performance-tuning

测试与质量

查看项目

更新于 10-15 23:25

技能介绍

用途:针对实测延迟与检索质量,调优 Exa 的搜索类型、内容模式、时效性、结果数量与并发。适用于运维或评审 Exa 检索链路的场景。

主要能力:搜索类型在延迟与综合深度之间取舍;内容抽取、outputSchema、强制 livecrawl、摘要与子页面都会增加工作量;Highlights 通常比全文更省 token。官方公布的延迟值仅为参考,不是特定服务的 SLO。

使用方式:正常 REST 调用时,从获批的服务端密钥管理器注入 EXA_API_KEY,仅以 Authorization: Bearer 发送到配置的第一方 Exa API 主机。团队管理服务密钥、托管 MCP OAuth 或企业托管授权、支付协议调用属于不同信任模型。凭据不得打印、提交、放入 URL 或暴露给不可信客户端。

调优步骤:建立带明确相关性与时效性判断的基准集;端到端测量现有适配器(含队列与下游处理);每次只变一个维度(类型、结果数、内容模式、时效性或子页面);同时跟踪 p50、p95、错误、内容大小、相关性、时效性与成本;为交互、后台与深度研究路径分别选择配置;对胜出配置做金丝雀发布并保留回滚阈值。

工具纪律:用 Read、Glob、Grep 检查仓库代码、配置、夹具与证据;仅在获批的实现或文档变更中使用 Write 与 Edit。不得仅因调用本技能就调用 Exa、运行付费研究,或创建/更改 Monitor、Webset、Agent run、Batch、团队、成员、API 密钥、预算、webhook 或部署。

审批边界:涉及敏感意图的实时查询、生产凭据、花费或速率限制变更、强制 livecrawl、生成摘要、外部投递、部署、成员或密钥变更、创建计划,以及破坏性取消、停止、删除或吊销,均需有责任负责人批准。只读仓库检查与合成离线验证不授权实时厂商操作。

失败模式:更快的结果可能相关性更低或更陈旧;强制 livecrawl 与深度综合会叠加而非替代延迟;仅看厂商请求延迟会忽略队列、解析、重排与模型消耗。

输出:返回操作范围、环境、团队与产品面、授权类别、契约与策略决策、确定性验证结果、无内容标识符、状态与成本计数、风险、清理或回滚状态,以及简明的通过或失败回执。除非另行批准,排除凭据、原始查询、提示、预签名 URL、检索内容、生成输出与客户衍生数据。

验证:重跑最小相关确定性测试,将实际行为与请求结果及当前第一方契约对比,确认证据中不含敏感字段,并在报告成功前确认截止时间、终态、下游保留与回滚。

限制:资料未提供具体延迟数值、价格、限额、平台支持范围与合规细节;依赖前应先查阅带日期的第一方证据地图。