alibaba/spring-ai-alibaba · error · UnsupportedOperationException

A2aRemoteAgent has not support schedule.

Error message

A2aRemoteAgent has not support schedule.

What it means

A2aRemoteAgent represents a remote A2A agent proxied over the network; it does not own a local StateGraph that can be scheduled, so its schedule(ScheduleConfig) override is intentionally unimplemented and throws UnsupportedOperationException. Scheduling is only supported by agents backed by a local graph (e.g. scheduled subgraphs). Calling schedule() on a remote agent is a design-time mistake, not a transient failure.

Source

Thrown at spring-ai-alibaba-agent-framework/src/main/java/com/alibaba/cloud/ai/graph/agent/a2a/A2aRemoteAgent.java:86

			this.keyStrategyFactory = () -> {
				HashMap<String, KeyStrategy> keyStrategyHashMap = new HashMap<>();
				keyStrategyHashMap.put("messages", new AppendStrategy());
				return keyStrategyHashMap;
			};
		}

		StateGraph graph = new StateGraph(name, this.keyStrategyFactory);
		graph.addNode("A2aNode", AsyncNodeActionWithConfig.node_async(
				new A2aNodeActionWithConfig(agentCard, name, includeContents, outputKey, instruction, streaming,
						this.shareState, this.compileConfig)));
		graph.addEdge(StateGraph.START, "A2aNode");
		graph.addEdge("A2aNode", StateGraph.END);
		return graph;
	}

	@Override
	public ScheduledAgentTask schedule(ScheduleConfig scheduleConfig) {
		throw new UnsupportedOperationException("A2aRemoteAgent has not support schedule.");
	}

	public static Builder builder() {
		return new Builder();
	}

	@Override
	public Node asNode(boolean includeContents, boolean returnReasoningContents) {
		return new A2aRemoteAgentNode(this.name, includeContents, returnReasoningContents, this.instruction, this.agentCard, this.streaming, this.shareState, this.getAndCompileGraph());
	}

	/**
	 * Internal class that adapts an A2aRemoteAgent to be used as a Node.
	 * Similar to AgentSubGraphNode but uses A2aNodeActionWithConfig internally.
	 * Implements SubGraphNode interface to provide subgraph functionality.
	 */
	private class A2aRemoteAgentNode extends Node implements SubGraphNode {

View on GitHub (pinned to f82da0b50f)

Solutions

1. Remove the schedule() call for A2aRemoteAgent instances; schedule the local orchestrating agent/graph instead.
2. Guard with `if (agent instanceof ScheduledAgentTask && !(agent instanceof A2aRemoteAgent))` before calling schedule().
3. Wrap the call in try-catch for UnsupportedOperationException if mixed agent lists are unavoidable.
4. Track A2A remote agents separately from local agents so scheduling logic only targets the local ones.

Example fix

// before
agent.schedule(scheduleConfig); // throws for A2aRemoteAgent

// after
if (!(agent instanceof A2aRemoteAgent)) {
    agent.schedule(scheduleConfig);
}

if (agent instanceof A2aRemoteAgent) {
    throw new IllegalStateException("Remote A2A agents do not support scheduling");
}

boolean isSchedulable(Object agent) {
    return agent instanceof ScheduledAgentTask && !(agent instanceof A2aRemoteAgent);
}

try {
    agent.schedule(config);
} catch (UnsupportedOperationException e) {
    log.warn("{} does not support scheduling", agent.getClass().getSimpleName(), e);
}

When it happens

Trigger: Calling schedule(config) on an A2aRemoteAgent instance built via A2aRemoteAgent.builder().build(), or invoking it generically on an Agent reference that is actually a remote A2A agent.

Common situations: Developers porting scheduling code written for local graph agents to remote A2A agents, or iterating over a mixed collection of agents and applying schedule() uniformly without checking the agent type.

Understand the failure class

Background: UnsupportedOperationException and "is not supported" errors: when a library deliberately refuses a call — this error's family across 30 libraries.

Related errors

• Currently Spring AI ToolResponseMessage only supports text t
• Failed to parse any valid result from streaming response
• Result is null, cannot extract response text
• No valid text content found in result:
• Failed to build JSON-RPC payload

AI-assisted analysis of alibaba/spring-ai-alibaba@f82da0b50f (2026-09-09). Data as JSON: /api/errors/08c484c674f008bc. Report an issue: GitHub.