Slide 29
Slide 29 text
AI-ready APIs
• LLMs have limited context size (2k, 4k, 8k, 16k,
rarely 32k)
• Bloated API design ❌
• Number of APIs it can consider ❌
• The quality of API docs & specs
• Most agents don’t handle other styles but RESTful
superface.ai
• RESTful – HTTP JSON API
• Use-case focused design
• Bundle calls together
• Consider limiting functionality
• Concise data model
• return only what is absolutely needed
• Minimize OAS, YAML format
• De
fi
ned data model (JSON Schema)
• Skip examples :(
Current agent limitations API design practice for AI
API design for autonomous agents