We Mapped 115 Microservices for Our Coding Agents — Kamalakannan Nandagopal, Postman
The talk details how Postman built an API context graph to enable coding agents to function effectively within large, distributed microservices architectures. Since traditional coding agents excel in single-project contexts, the speaker argues that APIs must serve as the central 'context layer.' The graph maps every microservice, endpoint, implementation detail, and data flow (down to databases and caches), grounded in either production telemetry or source code. This approach significantly improves agent performance in tasks like API discovery, redesign analysis, and impact assessment, though maintaining the graph's freshness is critical.
Key takeaways
-
APIs as the Context Layer
6:41
In distributed microservices systems, APIs define the boundaries and responsibilities of each service. The API context graph is necessary to provide agents with the holistic context required to understand complex, cross-system workflows.
-
High API Dependency Rate
16:40
Analysis of Postman's top 10 repositories revealed that approximately 75% of all Pull Requests (PRs) affected APIs, highlighting the critical importance of API-centric tooling.
-
Graph Grounding Requirement
8:56
Every data point added to the context graph must be grounded in a 'hard truth': either a line of code from the codebase or an exact trace from production telemetry.
-
Graph Maintenance is Crucial
13:40
The system's failure to accurately assess impact was traced back to a gap in the context graph—specifically, new consumers were introduced between the time the evaluation was written and when it was run, demonstrating the need for continuous synchronization.