conductor-oss/conductor · error · IllegalArgumentException

Duplicate agent names in '{}'. Each sub-agent must have a un

Error message

Duplicate agent names in '{}'. Each sub-agent must have a unique name.

What it means

Error "Duplicate agent names in '{}'. Each sub-agent must have a unique name." thrown in conductor-oss/conductor.

Source

Thrown at agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/compiler/MultiAgentCompiler.java:215

            sb.append("\"").append(e.getKey()).append("\": ");
            String type = "string";
            if (e.getValue() instanceof Map<?, ?> m && m.get("type") instanceof String s) {
                type = s;
            }
            sb.append("<").append(type).append(">");
            first = false;
        }
        sb.append("}");
        return sb.toString();
    }

    public WorkflowDef compile(AgentConfig config) {
        // Validate uniqueness
        if (config.getAgents() != null) {
            List<String> names = config.getAgents().stream().map(AgentConfig::getName).toList();
            Set<String> unique = new HashSet<>(names);
            if (unique.size() != names.size()) {
                throw new IllegalArgumentException(
                        "Duplicate agent names in '"
                                + config.getName()
                                + "'. Each sub-agent must have a unique name.");
            }
        }

        WorkflowDef strategyWf = compileStrategy(config);

        // Wrap with guardrails if needed
        List<GuardrailConfig> outputGuardrails = agentCompiler.getOutputGuardrails(config);
        if (!outputGuardrails.isEmpty()) {
            return wrapWithGuardrails(config, strategyWf);
        }
        return strategyWf;
    }

    private WorkflowDef compileStrategy(AgentConfig config) {
        AgentConfig.Strategy strategy =

View on GitHub (pinned to cf7c3e4a8a)

Solutions

1. Rename duplicate sub-agents so every agent in the multi-agent config has a unique name.

When it happens

Trigger: Thrown at agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/compiler/MultiAgentCompiler.java:215 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of conductor-oss/conductor@cf7c3e4a8a (2026-08-14). Data as JSON: /api/errors/de589ed19e6d8c7e. Report an issue: GitHub.