I built a multi-agent system on Amazon Bedrock AgentCore. An orchestrator agent takes each request and hands the work to specialist worker agents: one checks orders, one handles refunds, one writes the reply to the customer. Some workers also search knowledge bases, a few of them in parallel.
Every agent worked. But the first time I opened the X-Ray service map, it showed the orchestrator, a box for Bedrock, and nothing else. No workers. No knowledge bases. Just a map that made my system look far simpler than it was.
Getting a map that matched the real call chain took me much longer than building the agents. This post is everything I wish I'd known before I started.
In this post:
What a service map is, and how X-Ray decides what to draw
The basic setup
Why worker agents and knowledge bases go missing, and how to fix it
Why parallel calls break the trace
How to check it worked
First, some quick definitions
A trace is the story of one request.…