REST 已老，AI 时代的智能体需要怎样的 API？
💡
原文中文，约9200字，阅读约需22分钟。
📝
内容提要
在AI时代，传统的REST API面临挑战，无法满足智能体的需求。REST API设计导致意图丢失、编排复杂和权限过宽。为此，提出了Agentic API理念，强调任务驱动而非资源驱动，简化AI与系统的交互，通过明确的动词表达操作意图，后端负责复杂逻辑和状态管理，从而提高效率和安全性。
🎯
关键要点
- 传统的REST API设计导致意图丢失、编排复杂和权限过宽，无法满足AI智能体的需求。
- AI智能体在使用REST API时面临认知障碍，无法明确执行任务的操作。
- REST API强迫调用者猜测后端的业务逻辑，增加了错误的风险。
- Agentic API理念强调任务驱动而非资源驱动，简化AI与系统的交互。
- Agentic API通过明确的动词表达操作意图，后端负责复杂逻辑和状态管理，提高效率和安全性。
- 使用Agentic API，AI可以直接调用明确的任务，而不需要进行复杂的编排。
- 未来的API设计需要转向“任务与意图”，以适应AI时代的需求。
❓
延伸问答
为什么传统的REST API无法满足AI智能体的需求？
传统的REST API设计导致意图丢失、编排复杂和权限过宽，无法明确表达AI智能体的操作意图。
什么是Agentic API，它与REST API有什么不同？
Agentic API强调任务驱动而非资源驱动，通过明确的动词表达操作意图，简化AI与系统的交互。
使用Agentic API有什么优势？
使用Agentic API可以提高效率和安全性，后端负责复杂逻辑和状态管理，AI可以直接调用明确的任务。
AI智能体在使用REST API时面临哪些具体问题？
AI智能体面临意图丢失、编排复杂和权限过宽等问题，导致无法有效执行任务。
如何设计一个符合Agentic API理念的接口？
设计时应使用明确的动词驱动路由，定义清晰的任务和意图，避免使用模糊的资源名词。
未来的API设计应该朝哪个方向发展？
未来的API设计需要转向“任务与意图”，以适应AI时代的需求，强调操作意图的明确性。
➡️
