What Does an AI Agent Actually Need to Understand an API?

An API can be perfectly documented for humans and still be nearly impossible for an AI agent to use. OpenAPI describes the interface — paths, methods, schemas. But an agent needs more: intent-level de