Module 24: Spring Boot Client
Use the autoconfigured ACP client in a Spring Boot application. Connect to agents with just properties — no manual transport or client construction.Prerequisites
- Java 21+ (Spring Boot 4.x requirement)
- Module 23: Spring Boot Agent built and available
What You’ll Learn
- Injecting
AcpSyncClientfrom autoconfiguration - Configuring the client transport via
application.properties - Property-driven transport selection (stdio vs WebSocket)
Dependencies
Same starter as the agent side:The Client
The autoconfiguredAcpSyncClient is injected like any Spring bean:
Configuration
application.properties:stdio.command property and creates a StdioAcpClientTransport that launches the agent as a subprocess.
What the Autoconfiguration Does
- Detects transport properties —
stdio.commandtriggers stdio transport;websocket.uritriggers WebSocket - Creates
AcpSyncClientandAcpAsyncClient— configured with timeout and client capabilities - Manages shutdown —
DisposableBeancallscloseGracefully()on context close
Transport Selection
The autoconfiguration picks the transport based on which properties are set:Build & Run
Client Configuration Properties
View on GitHub