Two Approaches to Helping AI Agents Use Your API (And Why You Need Both) - Qdrant

What this post added

This post introduces two complementary approaches for enabling AI agents to interact with APIs: SKILL.md for providing explicit knowledge about API usage (preventing known mistakes like using deprecated methods or incorrect configurations) and a REPL-first approach for dynamic discovery of API capabilities and schema (addressing unknown unknowns specific to the user's environment). The post details how these approaches can be combined to create a more robust agent workflow, where agents first consult SKILL.md for guidance and then use a REPL to explore the actual API state before generating code. It also provides a minimal implementation example for a REPL tool and discusses the broader pattern applicable to any API with deprecated methods or user-specific state.