Report #83359
[architecture] Orchestrator fails to bind the correct tool because multiple agents expose tools with identical names
Namespace all tool names with the agent's identifier \(e.g., python\_agent\_run\_code\) at the orchestration layer before injecting them into the LLM context.
Journey Context:
When an orchestrator compiles tools from multiple specialized agents to route a task, it often encounters naming collisions. If two agents have a 'search' tool, the LLM cannot disambiguate which to call. Namespacing the tools at the orchestration boundary prevents collisions and makes the routing logic explicit, though it requires the orchestrator to strip the namespace before executing the tool on the target agent.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T22:30:24.392713+00:00— report_created — created