SuperAPI AI 工具集

agent-ready-apis

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:提供关于 API 是否适合 AI 智能体使用的知识,并在用户表达相关需求时建议运行 readiness-analyzer 智能体。触发场景包括询问“我的 API 是否 agent-ready”“AI 智能体能否使用我的 API”“扫描/分析我的 API 规范”“我的 API 对 AI 有什么问题”“如何让 API 更适配智能体”“为 AI 智能体改进我的 API”等。

主要能力:分析器从 8 个维度评估 48 项检查。元数据:operationIds、摘要、描述、标签。错误:错误模式、代码、消息、重试指引。内省:参数类型、必填字段、枚举、示例。命名:大小写一致性、RESTful 路径、HTTP 语义。可预测性:响应模式、分页、日期格式。文档:认证文档、速率限制、外部链接。性能:速率限制响应头、缓存、批量端点、异步模式。可发现性:OpenAPI 版本、服务器 URL、联系信息。

评分:关键检查权重 4 倍,完全阻断智能体使用;高权重 2 倍,导致频繁失败;中权重 1 倍,降低性能;低权重 0.5 倍,属于锦上添花。Agent Ready 的标准是得分不低于 70% 且零关键失败。

结果解读:90-100% 为优秀,智能体可可靠使用;70-89% 为 agent-ready,可小幅改进;50-69% 为尚未就绪,需修复关键问题;低于 50% 需大量工作,先处理关键失败。完整检查参考见该技能文件夹中的 pillars.md。

限制:资料仅给出上述评估维度、评分与解读,未说明具体安装命令、执行步骤、支持的 API 规范类型或收费信息,暂未提供。