Initial Support for the Anthropic Java SDK by sobychacko · Pull Request #5366 · spring-projects/spring-ai

sobychacko · 2026-01-30T03:06:49Z

Initial support for the Anthropic Java SDK. Current support in the PR includes both sync and async chat model interactions with tool calling support in both cases.

ericbottard

Added some comments related to JSpecify and builder.
This does not constitue a thorough review of the anthropic aspects.

ericbottard · 2026-01-30T09:25:31Z

...anthropic-sdk/src/main/java/org/springframework/ai/anthropicsdk/AnthropicSdkChatOptions.java

+	/**
+	 * Maximum number of tokens to generate in the response.
+	 */
+	@Nullable private Integer maxTokens;


All of those JSpecify annotations are out of place.
Should be

Suggested change

@Nullable private Integer maxTokens;

private @Nullable Integer maxTokens;

ericbottard · 2026-01-30T09:27:46Z

...anthropic-sdk/src/main/java/org/springframework/ai/anthropicsdk/AnthropicSdkChatOptions.java

+	 */
+	public static final class Builder {
+
+		private final AnthropicSdkChatOptions options = new AnthropicSdkChatOptions();


Builders should be re-usable. Hence, they should not act on an pre-created instance of options, otherwise if you call build(), then mutate the builder, then build() again, you actually get the same instance and the result of the first call is mutated while the user may not realise.

ericbottard · 2026-01-30T09:28:25Z

...i-anthropic-sdk/src/main/java/org/springframework/ai/anthropicsdk/metadata/package-info.java

+@NullMarked
+package org.springframework.ai.anthropicsdk.metadata;
+
+import org.jspecify.annotations.NullMarked;


This package is empty

ericbottard · 2026-01-30T09:29:08Z

...ropic-sdk/src/main/java/org/springframework/ai/anthropicsdk/AbstractAnthropicSdkOptions.java

+	 */
+	private Map<String, String> customHeaders = new HashMap<>();
+
+	@Nullable public String getBaseUrl() {


Similarly, all the method annotations are out of place.

Should be

Suggested change

@Nullable public String getBaseUrl() {

public @Nullable String getBaseUrl() {

ericbottard · 2026-01-30T09:35:52Z

...i-anthropic-sdk/src/main/java/org/springframework/ai/anthropicsdk/AnthropicSdkChatModel.java

+	/**
+	 * Creates a new AnthropicSdkChatModel with default options.
+	 */
+	public AnthropicSdkChatModel() {


There should be only ONE constructor, which should be private.
Users construct instance via the builder.

sobychacko · 2026-01-30T15:00:54Z

@ericbottard Thanks for the review. The initial focus was to get the basic functionality done and have feature parity with the regular anthropic module for sync and async calls. I will go through this review and address them soon. Thanks again!

sobychacko · 2026-01-30T23:02:24Z

@ericbottard Addressed most of the comments and issues you raised. Could you take a look again? Thanks!

sdeleuze · 2026-02-02T08:58:45Z

@sobychacko How should we proceed for this PR versus #5282 ? I guess we should decide which one is merged first.

Edit: #5282 has been merged so please let me know if you need my inputs for the rebase.

sobychacko · 2026-02-02T15:21:14Z

@sdeleuze I used jackson2 in this PR. I think I will make it jackson 3 based.

sobychacko · 2026-02-02T20:41:00Z

@sdeleuze I think it might be better to wait for the jackson 3 changes with the broader upgrade in the framework. What do you think?

ericbottard · 2026-03-12T09:17:51Z

.../springframework/ai/model/anthropic/legacy/autoconfigure/AnthropicChatAutoConfiguration.java

+ * @author Yanming Zhou
+ * @since 1.0.0
+ */
+@AutoConfiguration(after = { RestClientAutoConfiguration.class, WebClientAutoConfiguration.class,


This configuration only defines 2 beans, one of type AnthropicApi and one of type AnthropicChatModel (ChatModel).

None of those are defined in the configurations cited in after, so that attribute should be removed

ericbottard · 2026-03-12T09:19:29Z

...ava/org/springframework/ai/model/anthropic/autoconfigure/AnthropicChatAutoConfiguration.java

-		ToolCallingAutoConfiguration.class, SpringAiRetryAutoConfiguration.class })
-@EnableConfigurationProperties({ AnthropicChatProperties.class, AnthropicConnectionProperties.class })
-@ConditionalOnClass(AnthropicApi.class)
+@AutoConfiguration(after = { ToolCallingAutoConfiguration.class })


See my comment above about after

The anthropicChatModel bean directly injects ToolCallingManager, which is provided by ToolCallingAutoConfiguration. Removing the after attribute breaks various auto-config tests since SpringAiTestAutoConfigurations.of() rely on it to include dependency configs in the test context. OpenAiSdkChatAutoConfiguration also follows the same pattern. Therefore I am keeping the after as is, unless you see further issues with that.

This is not correct. SpringAiTestAutoConfigurations is wrong too (it adding any config that is in after to the list of configs to load is wrong and does not reflect what happens at runtime). Please remove the afters from this PR and I'll also create a PR to get rid of SpringAiTestAutoConfigurations for M3

@ericbottard Based on our discussion on this matter, we are good here, right?

yes, let's postpone

ericbottard · 2026-03-12T09:20:12Z

.../springframework/ai/model/anthropic/legacy/autoconfigure/AnthropicChatAutoConfiguration.java

@@ -0,0 +1,108 @@
+/*


What's with that "legacy" module?

ericbottard · 2026-03-12T09:24:59Z

...spring-ai-anthropic/src/main/java/org/springframework/ai/anthropic/AnthropicChatOptions.java

+	/**
+	 * Builder for creating {@link AnthropicChatOptions} instances.
+	 */
+	public static final class Builder {


Please use the builder pattern found eg in 88fbe6b

ericbottard · 2026-03-12T09:26:41Z

...g-ai-anthropic/src/test/java/org/springframework/ai/anthropic/AnthropicChatOptionsTests.java

 */
-class AnthropicChatOptionsTests<B extends AnthropicChatOptions.Builder<B>>
-		extends AbstractChatOptionsTests<AnthropicChatOptions, B> {
+class AnthropicChatOptionsTests {


See 88fbe6b for added builder tests

Rewrite the Anthropic integration from the ground up on the official Anthropic Java SDK (v2.16.1), replacing the hand-rolled RestClient implementation. Core capabilities: - Sync and streaming chat with typed SDK response objects - Tool calling with JsonValue visitor pattern for schema conversion - Streaming tool calling with partial JSON accumulation and recursive multi-turn execution - Multi-modal inputs (base64 images, HTTPS URLs, PDF documents) - Extended thinking (ThinkingBlock, RedactedThinkingBlock) with budget control and adaptive mode - Citations across plain text, PDF, and custom content documents with three location types (char, page, content block) - Citation consistency validation on build to reject mixed settings - Prompt caching with 5 strategies, configurable TTL, content length thresholds, and multi-block system message support - Structured output via OutputConfig with JSON schema enforcement and effort control (LOW/MEDIUM/HIGH/MAX) - Per-request HTTP headers for beta features and request tracking - Claude Skills (XLSX, PPTX, DOCX, PDF) with Files API for downloading generated documents - disableParallelToolUse wiring into ToolChoice subtypes - Expose underlying SDK clients via getAnthropicClient() and getAnthropicClientAsync() for direct access to SDK features Infrastructure: - Builder aligned with DefaultToolCallingChatOptions.Builder using self-type generics, mutate()/combineWith() pattern - SDK-native retry (no Spring RetryTemplate), matching spring-ai-openai-sdk - Raw SDK Message stored in metadata under "anthropic-response" key - Observation/tracing support with Micrometer for both sync and streaming paths - Default model: claude-haiku-4-5, default max tokens: 4096 - Auto-configuration and starter modules - Comprehensive unit tests (55+) and integration tests (35+) - Reference documentation with configuration properties Signed-off-by: Soby Chacko <soby.chacko@broadcom.com>

tzolov · 2026-03-13T18:55:38Z

Great contribution. Thanks @sobychacko
Rebased and merged at b0ce25a

sobychacko changed the title ~~Initial Support for Anthropic Java SDK~~ Initial Support for the Anthropic Java SDK Jan 30, 2026

ericbottard reviewed Jan 30, 2026

View reviewed changes

ilayaperumalg added the anthropic label Jan 30, 2026

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch from 6f7950e to c7ee377 Compare February 3, 2026 23:29

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch 2 times, most recently from 40cb8ca to f729e83 Compare February 23, 2026 23:42

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch 2 times, most recently from fa7601c to a81f788 Compare March 4, 2026 00:39

sdeleuze mentioned this pull request Mar 9, 2026

Add User-Agent header for Anthropic API calls #5566

Open

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch from a81f788 to 32c2346 Compare March 11, 2026 01:50

ericbottard requested changes Mar 12, 2026

View reviewed changes

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch 2 times, most recently from 32dc776 to 8462ca6 Compare March 12, 2026 15:46

sobychacko added this to the 2.0.0-M3 milestone Mar 12, 2026

sobychacko marked this pull request as ready for review March 12, 2026 16:01

sobychacko force-pushed the feature/spring-ai-anthropic-sdk branch from 8d429ed to 8952059 Compare March 13, 2026 15:41

tzolov self-assigned this Mar 13, 2026

tzolov closed this Mar 13, 2026

	@Nullable private Integer maxTokens;
	private @Nullable Integer maxTokens;

	@Nullable public String getBaseUrl() {
	public @Nullable String getBaseUrl() {

Conversation

sobychacko commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ericbottard left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sobychacko commented Jan 30, 2026

Uh oh!

sobychacko commented Jan 30, 2026

Uh oh!

sdeleuze commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sobychacko commented Feb 2, 2026

Uh oh!

sobychacko commented Feb 2, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tzolov commented Mar 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

sobychacko commented Jan 30, 2026 •

edited

Loading

sdeleuze commented Feb 2, 2026 •

edited

Loading