SuperAPI AI 工具集

exa-reference-architecture

智能体与模型

查看项目

更新于 10-16 06:20

技能介绍

用途:设计一套 Exa 架构,把查询策略、检索、内容处理、异步状态、引用和证据拆分为独立边界,并将凭证、查询、检索内容、生成输出、花费与破坏性状态分别治理。适用于运营或构建基于 Exa 的检索与 RAG 类工作负载。

主要能力:按用户结果、延迟等级、数据敏感度、新鲜度和体量进行分类;选择满足需求的最窄 Exa 产品;在厂商适配器之前实施策略与凭证强制;将检索内容与无内容的运营元数据和引用分离;仅持久化必要的异步 ID 并定义终态对账;绘制失败、保留、删除、Webhook、成本和回滚边界。

产品契约:Search 用于排序发现,Contents 用于已知 URL,Answer 用于直接带引用回答,Agent 用于多步研究,Monitors 用于周期性发现,Websets 用于验证与丰富集合,Batch 用于已启用的企业离线批量。各产品有不同生命周期与信任边界。

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

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

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

失败模式:有界 Search 或 Contents 足够时不要用 Agent;不要将不可信检索文本直接送入特权工具执行;不要对交互式与离线产品共用同一队列和重试策略。

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

验证:重跑最小相关确定性测试,将实际行为与请求结果及当前第一方契约比较,确认证据中不含敏感字段,并在报告成功前确认截止时间、终态、下游保留和回滚。依赖任何端点、参数、搜索类型、价格、限制、测试版、合规、身份、重试或生命周期声明前,先查看带日期的第一方证据地图。