From e004751842e71c996d72e31d14992f959740ce48 Mon Sep 17 00:00:00 2001 From: Ben Middleton Date: Thu, 7 Mar 2024 16:36:11 +0000 Subject: [PATCH] Add Bedrock Anthropic Claude 3 models support - Created low-leverl anthropic messages API for Claude 3. Use the new message API. - Add Chat Client with tests. - Add bedrok anthropic 3 docs. - Add multibudality support + tests. - Add auto-configuraiton & tests. - Rename Athropic to Athropic3 in class names to avoid confusion with previous Bedrock Anthropic 2 impl. --- .../api/AnthropicChatBedrockApi.java | 1 - .../anthropic3/Anthropic3ChatOptions.java | 166 +++++++ .../BedrockAnthropic3ChatClient.java | 190 ++++++++ .../api/Anthropic3ChatBedrockApi.java | 446 ++++++++++++++++++ .../ai/bedrock/aot/BedrockRuntimeHints.java | 7 + .../api/AnthropicChatBedrockApiIT.java | 4 +- .../BedrockAnthropic3ChatClientIT.java | 207 ++++++++ .../BedrockAnthropic3CreateRequestTests.java | 79 ++++ .../api/Anthropic3ChatBedrockApiIT.java | 142 ++++++ .../src/test/resources/test.png | Bin 0 -> 167772 bytes pom.xml | 2 +- spring-ai-core/pom.xml | 2 +- .../src/main/antora/modules/ROOT/nav.adoc | 5 +- .../ROOT/pages/api/chat/anthropic-chat.adoc | 2 +- .../api/chat/bedrock/bedrock-anthropic.adoc | 8 +- .../api/chat/bedrock/bedrock-anthropic3.adoc | 288 +++++++++++ ...edrockAnthropic3ChatAutoConfiguration.java | 61 +++ .../BedrockAnthropic3ChatProperties.java | 83 ++++ ...ot.autoconfigure.AutoConfiguration.imports | 1 + ...rockAnthropic3ChatAutoConfigurationIT.java | 153 ++++++ 20 files changed, 1839 insertions(+), 8 deletions(-) create mode 100644 models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java create mode 100644 models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java create mode 100644 models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java create mode 100644 models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClientIT.java create mode 100644 models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3CreateRequestTests.java create mode 100644 models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApiIT.java create mode 100644 models/spring-ai-bedrock/src/test/resources/test.png create mode 100644 spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic3.adoc create mode 100644 spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfiguration.java create mode 100644 spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatProperties.java create mode 100644 spring-ai-spring-boot-autoconfigure/src/test/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfigurationIT.java diff --git a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApi.java b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApi.java index 38fdd503059..324580a5fe9 100644 --- a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApi.java +++ b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApi.java @@ -115,7 +115,6 @@ public static class Builder { private Integer topK;// = 10; private Float topP; private List stopSequences; - // private String anthropicVersion = DEFAULT_ANTHROPIC_VERSION; private String anthropicVersion; private Builder(String prompt) { diff --git a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java new file mode 100644 index 00000000000..2862359fe9d --- /dev/null +++ b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java @@ -0,0 +1,166 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonInclude.Include; +import com.fasterxml.jackson.annotation.JsonProperty; +import org.springframework.ai.chat.prompt.ChatOptions; + +import java.util.List; + +/** + * @author Ben Middleton + * @since 1.0.0 + */ +@JsonInclude(Include.NON_NULL) +public class Anthropic3ChatOptions implements ChatOptions { + + // @formatter:off + /** + * Controls the randomness of the output. Values can range over [0.0,1.0], inclusive. A value closer to 1.0 will + * produce responses that are more varied, while a value closer to 0.0 will typically result in less surprising + * responses from the generative. This value specifies default to be used by the backend while making the call to + * the generative. + */ + private @JsonProperty("temperature") Float temperature; + + /** + * Specify the maximum number of tokens to use in the generated response. Note that the models may stop before + * reaching this maximum. This parameter only specifies the absolute maximum number of tokens to generate. We + * recommend a limit of 4,000 tokens for optimal performance. + */ + private @JsonProperty("max_tokens") Integer maxTokens; + + /** + * Specify the number of token choices the generative uses to generate the next token. + */ + private @JsonProperty("top_k") Integer topK; + + /** + * The maximum cumulative probability of tokens to consider when sampling. The generative uses combined Top-k and + * nucleus sampling. Nucleus sampling considers the smallest set of tokens whose probability sum is at least topP. + */ + private @JsonProperty("top_p") Float topP; + + /** + * Configure up to four sequences that the generative recognizes. After a stop sequence, the generative stops + * generating further tokens. The returned text doesn't contain the stop sequence. + */ + private @JsonProperty("stop_sequences") List stopSequences; + + /** + * The version of the generative to use. The default value is bedrock-2023-05-31. + */ + private @JsonProperty("anthropic_version") String anthropicVersion; + // @formatter:on + + public static Builder builder() { + return new Builder(); + } + + public static class Builder { + + private final Anthropic3ChatOptions options = new Anthropic3ChatOptions(); + + public Builder withTemperature(Float temperature) { + this.options.setTemperature(temperature); + return this; + } + + public Builder withMaxTokens(Integer maxTokens) { + this.options.setMaxTokens(maxTokens); + return this; + } + + public Builder withTopK(Integer topK) { + this.options.setTopK(topK); + return this; + } + + public Builder withTopP(Float topP) { + this.options.setTopP(topP); + return this; + } + + public Builder withStopSequences(List stopSequences) { + this.options.setStopSequences(stopSequences); + return this; + } + + public Builder withAnthropicVersion(String anthropicVersion) { + this.options.setAnthropicVersion(anthropicVersion); + return this; + } + + public Anthropic3ChatOptions build() { + return this.options; + } + + } + + @Override + public Float getTemperature() { + return this.temperature; + } + + public void setTemperature(Float temperature) { + this.temperature = temperature; + } + + public Integer getMaxTokens() { + return this.maxTokens; + } + + public void setMaxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + } + + @Override + public Integer getTopK() { + return this.topK; + } + + public void setTopK(Integer topK) { + this.topK = topK; + } + + @Override + public Float getTopP() { + return this.topP; + } + + public void setTopP(Float topP) { + this.topP = topP; + } + + public List getStopSequences() { + return this.stopSequences; + } + + public void setStopSequences(List stopSequences) { + this.stopSequences = stopSequences; + } + + public String getAnthropicVersion() { + return this.anthropicVersion; + } + + public void setAnthropicVersion(String anthropicVersion) { + this.anthropicVersion = anthropicVersion; + } + +} diff --git a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java new file mode 100644 index 00000000000..12dba850c41 --- /dev/null +++ b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java @@ -0,0 +1,190 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3; + +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatRequest; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatResponse; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatStreamingResponse.StreamingType; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.MediaContent; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.ChatCompletionMessage; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.ChatCompletionMessage.Role; +import org.springframework.ai.chat.ChatClient; +import org.springframework.ai.chat.ChatResponse; +import org.springframework.ai.chat.Generation; +import org.springframework.ai.chat.StreamingChatClient; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.MessageType; +import org.springframework.ai.chat.metadata.ChatGenerationMetadata; +import org.springframework.ai.chat.prompt.ChatOptions; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.model.ModelOptionsUtils; +import org.springframework.util.CollectionUtils; + +import reactor.core.publisher.Flux; + +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; +import java.util.concurrent.atomic.AtomicReference; +import java.util.stream.Collectors; + +/** + * Java {@link ChatClient} and {@link StreamingChatClient} for the Bedrock Anthropic chat + * generative. + * + * @author Ben Middleton + * @author Christian Tzolov + * @since 1.0.0 + */ +public class BedrockAnthropic3ChatClient implements ChatClient, StreamingChatClient { + + private final Anthropic3ChatBedrockApi anthropicChatApi; + + private final Anthropic3ChatOptions defaultOptions; + + public BedrockAnthropic3ChatClient(Anthropic3ChatBedrockApi chatApi) { + this(chatApi, + Anthropic3ChatOptions.builder() + .withTemperature(0.8f) + .withMaxTokens(500) + .withTopK(10) + .withAnthropicVersion(Anthropic3ChatBedrockApi.DEFAULT_ANTHROPIC_VERSION) + .build()); + } + + public BedrockAnthropic3ChatClient(Anthropic3ChatBedrockApi chatApi, Anthropic3ChatOptions options) { + this.anthropicChatApi = chatApi; + this.defaultOptions = options; + } + + @Override + public ChatResponse call(Prompt prompt) { + + AnthropicChatRequest request = createRequest(prompt); + + AnthropicChatResponse response = this.anthropicChatApi.chatCompletion(request); + + return new ChatResponse(List.of(new Generation(response.content().get(0).text()))); + } + + @Override + public Flux stream(Prompt prompt) { + + AnthropicChatRequest request = createRequest(prompt); + + Flux fluxResponse = this.anthropicChatApi + .chatCompletionStream(request); + + AtomicReference inputTokens = new AtomicReference<>(0); + return fluxResponse.map(response -> { + if (response.type() == StreamingType.MESSAGE_START) { + inputTokens.set(response.message().usage().inputTokens()); + } + String content = response.type() == StreamingType.CONTENT_BLOCK_DELTA ? response.delta().text() : ""; + + var generation = new Generation(content); + + if (response.type() == StreamingType.MESSAGE_DELTA) { + generation = generation.withGenerationMetadata(ChatGenerationMetadata + .from(response.delta().stopReason(), new Anthropic3ChatBedrockApi.AnthropicUsage(inputTokens.get(), + response.usage().outputTokens()))); + } + + return new ChatResponse(List.of(generation)); + }); + } + + /** + * Accessible for testing. + */ + AnthropicChatRequest createRequest(Prompt prompt) { + + AnthropicChatRequest request = AnthropicChatRequest.builder(toAnthropicMessages(prompt)) + .withSystem(toAnthropicSystemContext(prompt)) + .build(); + + if (this.defaultOptions != null) { + request = ModelOptionsUtils.merge(request, this.defaultOptions, AnthropicChatRequest.class); + } + + if (prompt.getOptions() != null) { + if (prompt.getOptions() instanceof ChatOptions runtimeOptions) { + Anthropic3ChatOptions updatedRuntimeOptions = ModelOptionsUtils.copyToTarget(runtimeOptions, + ChatOptions.class, Anthropic3ChatOptions.class); + request = ModelOptionsUtils.merge(updatedRuntimeOptions, request, AnthropicChatRequest.class); + } + else { + throw new IllegalArgumentException("Prompt options are not of type ChatOptions: " + + prompt.getOptions().getClass().getSimpleName()); + } + } + + return request; + } + + /** + * Extracts system context from prompt. + * @param prompt The prompt. + * @return The system context. + */ + private String toAnthropicSystemContext(Prompt prompt) { + + return prompt.getInstructions() + .stream() + .filter(m -> m.getMessageType() == MessageType.SYSTEM) + .map(Message::getContent) + .collect(Collectors.joining(System.lineSeparator())); + } + + /** + * Extracts list of messages from prompt. + * @param prompt The prompt. + * @return The list of {@link ChatCompletionMessage}. + */ + private List toAnthropicMessages(Prompt prompt) { + + return prompt.getInstructions() + .stream() + .filter(m -> m.getMessageType() == MessageType.USER || m.getMessageType() == MessageType.ASSISTANT) + .map(message -> { + List contents = new ArrayList<>(List.of(new MediaContent(message.getContent()))); + if (!CollectionUtils.isEmpty(message.getMedia())) { + List mediaContent = message.getMedia() + .stream() + .map(media -> new MediaContent(media.getMimeType().toString(), + this.fromMediaData(media.getData()))) + .toList(); + contents.addAll(mediaContent); + } + return new ChatCompletionMessage(contents, Role.valueOf(message.getMessageType().name())); + }) + .toList(); + } + + private String fromMediaData(Object mediaData) { + if (mediaData instanceof byte[] bytes) { + return Base64.getEncoder().encodeToString(bytes); + } + else if (mediaData instanceof String text) { + return text; + } + else { + throw new IllegalArgumentException("Unsupported media data type: " + mediaData.getClass().getSimpleName()); + } + } + +} diff --git a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java new file mode 100644 index 00000000000..28cbd25f2d2 --- /dev/null +++ b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java @@ -0,0 +1,446 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3.api; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonInclude.Include; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.ObjectMapper; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatRequest; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatResponse; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatStreamingResponse; +import org.springframework.ai.bedrock.api.AbstractBedrockApi; +import org.springframework.util.Assert; +import reactor.core.publisher.Flux; +import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; + +import java.util.List; + +/** + * Based on Bedrock's Anthropic + * Claude Messages API. + * + * It is meant to replace the previous Chat API, which is now deprecated. + * + * @author Ben Middleton + * @author Christian Tzolov + * @since 1.0.0 + */ +// @formatter:off +public class Anthropic3ChatBedrockApi extends + AbstractBedrockApi { + + /** + * Default version of the Anthropic chat model. + */ + public static final String DEFAULT_ANTHROPIC_VERSION = "bedrock-2023-05-31"; + + /** + * Create a new AnthropicChatBedrockApi instance using the default credentials provider chain, the default object. + * @param modelId The model id to use. See the {@link AnthropicChatModel} for the supported models. + * @param region The AWS region to use. + */ + public Anthropic3ChatBedrockApi(String modelId, String region) { + super(modelId, region); + } + + /** + * Create a new AnthropicChatBedrockApi instance using the provided credentials provider, region and object mapper. + * + * @param modelId The model id to use. See the {@link AnthropicChatModel} for the supported models. + * @param credentialsProvider The credentials provider to connect to AWS. + * @param region The AWS region to use. + * @param objectMapper The object mapper to use for JSON serialization and deserialization. + */ + public Anthropic3ChatBedrockApi(String modelId, AwsCredentialsProvider credentialsProvider, String region, + ObjectMapper objectMapper) { + super(modelId, credentialsProvider, region, objectMapper); + } + + // https://github.com/build-on-aws/amazon-bedrock-java-examples/blob/main/example_code/bedrock-runtime/src/main/java/aws/community/examples/InvokeBedrockStreamingAsync.java + + // https://docs.anthropic.com/claude/reference/complete_post + + // https://docs.aws.amazon.com/bedrock/latest/userguide/br-product-ids.html + + // Anthropic Claude models: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-claude.html + + /** + * AnthropicChatRequest encapsulates the request parameters for the Anthropic messages model. + * https://docs.anthropic.com/claude/reference/messages_post + * + * @param messages A list of messages comprising the conversation so far. + * @param system A system prompt, providing context and instructions to Claude, such as specifying a particular goal + * or role. + * @param temperature (default 0.5) The temperature to use for the chat. You should either alter temperature or + * top_p, but not both. + * @param maxTokens (default 200) Specify the maximum number of tokens to use in the generated response. + * Note that the models may stop before reaching this maximum. This parameter only specifies the absolute maximum + * number of tokens to generate. We recommend a limit of 4,000 tokens for optimal performance. + * @param topK (default 250) Specify the number of token choices the model uses to generate the next token. + * @param topP (default 1) Nucleus sampling to specify the cumulative probability of the next token in range [0,1]. + * In nucleus sampling, we compute the cumulative distribution over all the options for each subsequent token in + * decreasing probability order and cut it off once it reaches a particular probability specified by top_p. You + * should either alter temperature or top_p, but not both. + * @param stopSequences (defaults to "\n\nHuman:") Configure up to four sequences that the model recognizes. After a + * stop sequence, the model stops generating further tokens. The returned text doesn't contain the stop sequence. + * @param anthropicVersion The version of the model to use. The default value is bedrock-2023-05-31. + */ + @JsonInclude(Include.NON_NULL) + public record AnthropicChatRequest( + @JsonProperty("messages") List messages, + @JsonProperty("system") String system, + @JsonProperty("temperature") Float temperature, + @JsonProperty("max_tokens") Integer maxTokens, + @JsonProperty("top_k") Integer topK, + @JsonProperty("top_p") Float topP, + @JsonProperty("stop_sequences") List stopSequences, + @JsonProperty("anthropic_version") String anthropicVersion) { + + public static Builder builder(List messages) { + return new Builder(messages); + } + + public static class Builder { + private final List messages; + private String system; + private Float temperature;// = 0.7f; + private Integer maxTokens;// = 500; + private Integer topK;// = 10; + private Float topP; + private List stopSequences; + private String anthropicVersion; + + private Builder(List messages) { + this.messages = messages; + } + + public Builder withSystem(String system) { + this.system = system; + return this; + } + public Builder withTemperature(Float temperature) { + this.temperature = temperature; + return this; + } + + public Builder withMaxTokens(Integer maxTokens) { + this.maxTokens = maxTokens; + return this; + } + + public Builder withTopK(Integer topK) { + this.topK = topK; + return this; + } + + public Builder withTopP(Float tpoP) { + this.topP = tpoP; + return this; + } + + public Builder withStopSequences(List stopSequences) { + this.stopSequences = stopSequences; + return this; + } + + public Builder withAnthropicVersion(String anthropicVersion) { + this.anthropicVersion = anthropicVersion; + return this; + } + + public AnthropicChatRequest build() { + return new AnthropicChatRequest( + messages, + system, + temperature, + maxTokens, + topK, + topP, + stopSequences, + anthropicVersion + ); + } + } + } + + /** + * @param type the content type can be "text" or "image". + * @param source The source of the media content. Applicable for "image" types only. + * @param text The text of the message. Applicable for "text" types only. + * @param index The index of the content block. Applicable only for streaming + * responses. + */ + @JsonInclude(Include.NON_NULL) + public record MediaContent( // @formatter:off + @JsonProperty("type") Type type, + @JsonProperty("source") Source source, + @JsonProperty("text") String text, + @JsonProperty("index") Integer index // applicable only for streaming responses. + ) { + // @formatter:on + + public MediaContent(String mediaType, String data) { + this(new Source(mediaType, data)); + } + + public MediaContent(Source source) { + this(Type.IMAGE, source, null, null); + } + + public MediaContent(String text) { + this(Type.TEXT, null, text, null); + } + + /** + * The type of this message. + */ + public enum Type { + + /** + * Text message. + */ + @JsonProperty("text") + TEXT, + /** + * Image message. + */ + @JsonProperty("image") + IMAGE + + } + + /** + * The source of the media content. (Applicable for "image" types only) + * + * @param type The type of the media content. Only "base64" is supported at the + * moment. + * @param mediaType The media type of the content. For example, "image/png" or + * "image/jpeg". + * @param data The base64-encoded data of the content. + */ + @JsonInclude(Include.NON_NULL) + public record Source( // @formatter:off + @JsonProperty("type") String type, + @JsonProperty("media_type") String mediaType, + @JsonProperty("data") String data) { + // @formatter:on + + public Source(String mediaType, String data) { + this("base64", mediaType, data); + } + } + } + + /** + * Message comprising the conversation. + * + * @param content The contents of the message. + * @param role The role of the messages author. Could be one of the {@link Role} + * types. + */ + @JsonInclude(Include.NON_NULL) + public record ChatCompletionMessage(@JsonProperty("content") List content, + @JsonProperty("role") Role role) { + + /** + * The role of the author of this message. + */ + public enum Role { + + /** + * User message. + */ + @JsonProperty("user") + USER, + /** + * Assistant message. + */ + @JsonProperty("assistant") + ASSISTANT + + } + } + + /** + * Encapsulates the metrics about the model invocation. + * https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages.html#model-parameters-anthropic-claude-messages-request-response + * + * @param inputTokens The number of tokens in the input prompt. + * @param outputTokens The number of tokens in the generated text. + */ + @JsonInclude(Include.NON_NULL) + public record AnthropicUsage(@JsonProperty("input_tokens") Integer inputTokens, + @JsonProperty("output_tokens") Integer outputTokens) { + } + + /** + * AnthropicChatResponse encapsulates the response parameters for the Anthropic + * messages model. + * + * @param id The unique response identifier. + * @param model The ID for the Anthropic Claude model that made the request. + * @param type The type of the response. + * @param role The role of the response. + * @param content The list of generated text. + * @param stopReason The reason the model stopped generating text: end_turn – The + * model reached a natural stopping point. max_tokens – The generated text exceeded + * the value of the max_tokens input field or exceeded the maximum number of tokens + * that the model supports. stop_sequence – The model generated one of the stop + * sequences that you specified in the stop_sequences input field. + * @param stopSequence The stop sequence that caused the model to stop generating + * text. + * @param usage Metrics about the model invocation. + */ + @JsonInclude(Include.NON_NULL) + public record AnthropicChatResponse(@JsonProperty("id") String id, @JsonProperty("model") String model, + @JsonProperty("type") String type, @JsonProperty("role") String role, + @JsonProperty("content") List content, @JsonProperty("stop_reason") String stopReason, + @JsonProperty("stop_sequence") String stopSequence, @JsonProperty("usage") AnthropicUsage usage) { + } + + /** + * AnthropicChatStreamingResponse encapsulates the streaming response parameters for + * the Anthropic messages model. + * https://docs.anthropic.com/claude/reference/messages-streaming + * + * @param type The streaming type. + * @param message The message details that made the request. + * @param index The delta index. + * @param contentBlock The generated text. + * @param delta The delta. + * @param usage The usage data. + */ + @JsonInclude(Include.NON_NULL) + public record AnthropicChatStreamingResponse(@JsonProperty("type") StreamingType type, + @JsonProperty("message") AnthropicChatResponse message, @JsonProperty("index") Integer index, + @JsonProperty("content_block") MediaContent contentBlock, @JsonProperty("delta") Delta delta, + @JsonProperty("usage") AnthropicUsage usage) { + + /** + * The streaming type of this message. + */ + public enum StreamingType { + + /** + * Message start. + */ + @JsonProperty("message_start") + MESSAGE_START, + /** + * Content block start. + */ + @JsonProperty("content_block_start") + CONTENT_BLOCK_START, + /** + * Ping. + */ + @JsonProperty("ping") + PING, + /** + * Content block delta. + */ + @JsonProperty("content_block_delta") + CONTENT_BLOCK_DELTA, + /** + * Content block stop. + */ + @JsonProperty("content_block_stop") + CONTENT_BLOCK_STOP, + /** + * Message delta. + */ + @JsonProperty("message_delta") + MESSAGE_DELTA, + /** + * Message stop. + */ + @JsonProperty("message_stop") + MESSAGE_STOP + + } + + /** + * Encapsulates a delta. + * https://docs.anthropic.com/claude/reference/messages-streaming * + * + * @param type The type of the message. + * @param text The text message. + * @param stopReason The stop reason. + * @param stopSequence The stop sequence. + */ + @JsonInclude(Include.NON_NULL) + public record Delta(@JsonProperty("type") String type, @JsonProperty("text") String text, + @JsonProperty("stop_reason") String stopReason, @JsonProperty("stop_sequence") String stopSequence) { + } + } + + /** + * Anthropic models version. + */ + public enum AnthropicChatModel { + + /** + * anthropic.claude-instant-v1 + */ + CLAUDE_INSTANT_V1("anthropic.claude-instant-v1"), + /** + * anthropic.claude-v2 + */ + CLAUDE_V2("anthropic.claude-v2"), + /** + * anthropic.claude-v2:1 + */ + CLAUDE_V21("anthropic.claude-v2:1"), + /** + * anthropic.claude-3-sonnet-20240229-v1:0 + */ + CLAUDE_V3_SONNET("anthropic.claude-3-sonnet-20240229-v1:0"), + /** + * anthropic.claude-3-haiku-20240307-v1:0 + */ + CLAUDE_V3_HAIKU("anthropic.claude-3-haiku-20240307-v1:0"); + + private final String id; + + /** + * @return The model id. + */ + public String id() { + return id; + } + + AnthropicChatModel(String value) { + this.id = value; + } + + } + + @Override + public AnthropicChatResponse chatCompletion(AnthropicChatRequest anthropicRequest) { + Assert.notNull(anthropicRequest, "'anthropicRequest' must not be null"); + return this.internalInvocation(anthropicRequest, AnthropicChatResponse.class); + } + + @Override + public Flux chatCompletionStream(AnthropicChatRequest anthropicRequest) { + Assert.notNull(anthropicRequest, "'anthropicRequest' must not be null"); + return this.internalInvocationStream(anthropicRequest, AnthropicChatStreamingResponse.class); + } + +} +// @formatter:on diff --git a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/aot/BedrockRuntimeHints.java b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/aot/BedrockRuntimeHints.java index 3cca99876b3..8ed33139b7d 100644 --- a/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/aot/BedrockRuntimeHints.java +++ b/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/aot/BedrockRuntimeHints.java @@ -17,6 +17,8 @@ import org.springframework.ai.bedrock.anthropic.AnthropicChatOptions; import org.springframework.ai.bedrock.anthropic.api.AnthropicChatBedrockApi; +import org.springframework.ai.bedrock.anthropic3.Anthropic3ChatOptions; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; import org.springframework.ai.bedrock.api.AbstractBedrockApi; import org.springframework.ai.bedrock.cohere.BedrockCohereChatOptions; import org.springframework.ai.bedrock.cohere.BedrockCohereEmbeddingOptions; @@ -77,6 +79,11 @@ public void registerHints(RuntimeHints hints, ClassLoader classLoader) { hints.reflection().registerType(tr, mcs); for (var tr : findJsonAnnotatedClassesInPackage(AnthropicChatOptions.class)) hints.reflection().registerType(tr, mcs); + + for (var tr : findJsonAnnotatedClassesInPackage(Anthropic3ChatBedrockApi.class)) + hints.reflection().registerType(tr, mcs); + for (var tr : findJsonAnnotatedClassesInPackage(Anthropic3ChatOptions.class)) + hints.reflection().registerType(tr, mcs); } } diff --git a/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApiIT.java b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApiIT.java index 09c2d9ff3e4..11084c8879b 100644 --- a/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApiIT.java +++ b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic/api/AnthropicChatBedrockApiIT.java @@ -18,11 +18,13 @@ import java.util.List; import java.util.stream.Collectors; +import com.fasterxml.jackson.databind.ObjectMapper; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import reactor.core.publisher.Flux; +import software.amazon.awssdk.auth.credentials.EnvironmentVariableCredentialsProvider; import software.amazon.awssdk.regions.Region; import org.springframework.ai.bedrock.anthropic.api.AnthropicChatBedrockApi.AnthropicChatRequest; @@ -41,7 +43,7 @@ public class AnthropicChatBedrockApiIT { private final Logger logger = LoggerFactory.getLogger(AnthropicChatBedrockApiIT.class); private AnthropicChatBedrockApi anthropicChatApi = new AnthropicChatBedrockApi(AnthropicChatModel.CLAUDE_V2.id(), - Region.EU_CENTRAL_1.id()); + EnvironmentVariableCredentialsProvider.create(), Region.US_WEST_2.id(), new ObjectMapper()); @Test public void chatCompletion() { diff --git a/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClientIT.java b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClientIT.java new file mode 100644 index 00000000000..8048d5288d7 --- /dev/null +++ b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClientIT.java @@ -0,0 +1,207 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3; + +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; +import org.springframework.ai.chat.ChatResponse; +import org.springframework.ai.chat.Generation; +import org.springframework.ai.chat.messages.AssistantMessage; +import org.springframework.ai.chat.messages.Media; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.chat.prompt.PromptTemplate; +import org.springframework.ai.chat.prompt.SystemPromptTemplate; +import org.springframework.ai.parser.BeanOutputParser; +import org.springframework.ai.parser.ListOutputParser; +import org.springframework.ai.parser.MapOutputParser; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.SpringBootConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Bean; +import org.springframework.core.convert.support.DefaultConversionService; +import org.springframework.core.io.ClassPathResource; +import org.springframework.core.io.Resource; +import org.springframework.util.MimeTypeUtils; + +import software.amazon.awssdk.auth.credentials.EnvironmentVariableCredentialsProvider; +import software.amazon.awssdk.regions.Region; + +import java.io.IOException; +import java.util.Arrays; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import static org.assertj.core.api.Assertions.assertThat; + +@SpringBootTest +@EnabledIfEnvironmentVariable(named = "AWS_ACCESS_KEY_ID", matches = ".*") +@EnabledIfEnvironmentVariable(named = "AWS_SECRET_ACCESS_KEY", matches = ".*") +class BedrockAnthropic3ChatClientIT { + + private static final Logger logger = LoggerFactory.getLogger(BedrockAnthropic3ChatClientIT.class); + + @Autowired + private BedrockAnthropic3ChatClient client; + + @Value("classpath:/prompts/system-message.st") + private Resource systemResource; + + @Test + void roleTest() { + UserMessage userMessage = new UserMessage( + "Tell me about 3 famous pirates from the Golden Age of Piracy and why they did."); + SystemPromptTemplate systemPromptTemplate = new SystemPromptTemplate(systemResource); + Message systemMessage = systemPromptTemplate.createMessage(Map.of("name", "Bob", "voice", "pirate")); + + Prompt prompt = new Prompt(List.of(userMessage, systemMessage)); + + ChatResponse response = client.call(prompt); + + assertThat(response.getResult().getOutput().getContent()).contains("Blackbeard"); + } + + @Test + void outputParser() { + DefaultConversionService conversionService = new DefaultConversionService(); + ListOutputParser outputParser = new ListOutputParser(conversionService); + + String format = outputParser.getFormat(); + String template = """ + List five {subject} + {format} + """; + PromptTemplate promptTemplate = new PromptTemplate(template, + Map.of("subject", "ice cream flavors.", "format", format)); + Prompt prompt = new Prompt(promptTemplate.createMessage()); + Generation generation = this.client.call(prompt).getResult(); + + List list = outputParser.parse(generation.getOutput().getContent()); + assertThat(list).hasSize(5); + } + + @Test + void mapOutputParser() { + MapOutputParser outputParser = new MapOutputParser(); + + String format = outputParser.getFormat(); + String template = """ + Provide me a List of {subject} + {format} + Remove the ```json code blocks from the output. + """; + PromptTemplate promptTemplate = new PromptTemplate(template, + Map.of("subject", "an array of numbers from 1 to 9 under they key name 'numbers'", "format", format)); + Prompt prompt = new Prompt(promptTemplate.createMessage()); + Generation generation = client.call(prompt).getResult(); + + Map result = outputParser.parse(generation.getOutput().getContent()); + assertThat(result.get("numbers")).isEqualTo(Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9)); + + } + + record ActorsFilmsRecord(String actor, List movies) { + } + + @Test + void beanOutputParserRecords() { + + BeanOutputParser outputParser = new BeanOutputParser<>(ActorsFilmsRecord.class); + + String format = outputParser.getFormat(); + String template = """ + Generate the filmography of 5 movies for Tom Hanks. + Remove non JSON tex blocks from the output. + {format} + Provide your answer in the JSON format with the feature names as the keys. + """; + PromptTemplate promptTemplate = new PromptTemplate(template, Map.of("format", format)); + Prompt prompt = new Prompt(promptTemplate.createMessage()); + Generation generation = client.call(prompt).getResult(); + + ActorsFilmsRecord actorsFilms = outputParser.parse(generation.getOutput().getContent()); + assertThat(actorsFilms.actor()).isEqualTo("Tom Hanks"); + assertThat(actorsFilms.movies()).hasSize(5); + } + + @Test + void beanStreamOutputParserRecords() { + + BeanOutputParser outputParser = new BeanOutputParser<>(ActorsFilmsRecord.class); + + String format = outputParser.getFormat(); + String template = """ + Generate the filmography of 5 movies for Tom Hanks. + {format} + Remove Markdown code blocks from the output. + """; + PromptTemplate promptTemplate = new PromptTemplate(template, Map.of("format", format)); + Prompt prompt = new Prompt(promptTemplate.createMessage()); + + String generationTextFromStream = client.stream(prompt) + .collectList() + .block() + .stream() + .map(ChatResponse::getResults) + .flatMap(List::stream) + .map(Generation::getOutput) + .map(AssistantMessage::getContent) + .collect(Collectors.joining()); + + ActorsFilmsRecord actorsFilms = outputParser.parse(generationTextFromStream); + logger.info("" + actorsFilms); + assertThat(actorsFilms.actor()).isEqualTo("Tom Hanks"); + assertThat(actorsFilms.movies()).hasSize(5); + } + + @Test + void multiModalityTest() throws IOException { + + byte[] imageData = new ClassPathResource("/test.png").getContentAsByteArray(); + + var userMessage = new UserMessage("Explain what do you see o this picture?", + List.of(new Media(MimeTypeUtils.IMAGE_PNG, imageData))); + + ChatResponse response = client.call(new Prompt(List.of(userMessage))); + + logger.info(response.getResult().getOutput().getContent()); + assertThat(response.getResult().getOutput().getContent()).contains("bananas", "apple", "basket"); + } + + @SpringBootConfiguration + public static class TestConfiguration { + + @Bean + public Anthropic3ChatBedrockApi anthropicApi() { + return new Anthropic3ChatBedrockApi(Anthropic3ChatBedrockApi.AnthropicChatModel.CLAUDE_V3_SONNET.id(), + EnvironmentVariableCredentialsProvider.create(), Region.US_EAST_1.id(), new ObjectMapper()); + } + + @Bean + public BedrockAnthropic3ChatClient anthropicChatClient(Anthropic3ChatBedrockApi anthropicApi) { + return new BedrockAnthropic3ChatClient(anthropicApi); + } + + } + +} diff --git a/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3CreateRequestTests.java b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3CreateRequestTests.java new file mode 100644 index 00000000000..340c7a496e5 --- /dev/null +++ b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3CreateRequestTests.java @@ -0,0 +1,79 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3; + +import org.junit.jupiter.api.Test; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatModel; +import org.springframework.ai.chat.prompt.Prompt; +import software.amazon.awssdk.regions.Region; + +import java.util.List; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * @author Christian Tzolov + */ +public class BedrockAnthropic3CreateRequestTests { + + private Anthropic3ChatBedrockApi anthropicChatApi = new Anthropic3ChatBedrockApi(AnthropicChatModel.CLAUDE_V2.id(), + Region.EU_CENTRAL_1.id()); + + @Test + public void createRequestWithChatOptions() { + + var client = new BedrockAnthropic3ChatClient(anthropicChatApi, + Anthropic3ChatOptions.builder() + .withTemperature(66.6f) + .withTopK(66) + .withTopP(0.66f) + .withMaxTokens(666) + .withAnthropicVersion("X.Y.Z") + .withStopSequences(List.of("stop1", "stop2")) + .build()); + + var request = client.createRequest(new Prompt("Test message content")); + + assertThat(request.messages()).isNotEmpty(); + assertThat(request.temperature()).isEqualTo(66.6f); + assertThat(request.topK()).isEqualTo(66); + assertThat(request.topP()).isEqualTo(0.66f); + assertThat(request.maxTokens()).isEqualTo(666); + assertThat(request.anthropicVersion()).isEqualTo("X.Y.Z"); + assertThat(request.stopSequences()).containsExactly("stop1", "stop2"); + + request = client.createRequest(new Prompt("Test message content", + Anthropic3ChatOptions.builder() + .withTemperature(99.9f) + .withTopP(0.99f) + .withMaxTokens(999) + .withAnthropicVersion("zzz") + .withStopSequences(List.of("stop3", "stop4")) + .build() + + )); + + assertThat(request.messages()).isNotEmpty(); + assertThat(request.temperature()).isEqualTo(99.9f); + assertThat(request.topK()).as("unchanged from the default options").isEqualTo(66); + assertThat(request.topP()).isEqualTo(0.99f); + assertThat(request.maxTokens()).isEqualTo(999); + assertThat(request.anthropicVersion()).isEqualTo("zzz"); + assertThat(request.stopSequences()).containsExactly("stop3", "stop4"); + } + +} diff --git a/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApiIT.java b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApiIT.java new file mode 100644 index 00000000000..dfd05da6458 --- /dev/null +++ b/models/spring-ai-bedrock/src/test/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApiIT.java @@ -0,0 +1,142 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.bedrock.anthropic3.api; + +import com.fasterxml.jackson.databind.ObjectMapper; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatModel; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatRequest; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatResponse; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatStreamingResponse.StreamingType; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.MediaContent; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.ChatCompletionMessage; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.ChatCompletionMessage.Role; +import reactor.core.publisher.Flux; +import software.amazon.awssdk.auth.credentials.EnvironmentVariableCredentialsProvider; +import software.amazon.awssdk.regions.Region; + +import java.util.List; +import java.util.stream.Collectors; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.DEFAULT_ANTHROPIC_VERSION; + +/** + * @author Ben Middleton + */ +@EnabledIfEnvironmentVariable(named = "AWS_ACCESS_KEY_ID", matches = ".*") +@EnabledIfEnvironmentVariable(named = "AWS_SECRET_ACCESS_KEY", matches = ".*") +public class Anthropic3ChatBedrockApiIT { + + private final Logger logger = LoggerFactory.getLogger(Anthropic3ChatBedrockApiIT.class); + + private Anthropic3ChatBedrockApi anthropicChatApi = new Anthropic3ChatBedrockApi( + AnthropicChatModel.CLAUDE_INSTANT_V1.id(), EnvironmentVariableCredentialsProvider.create(), + Region.US_EAST_1.id(), new ObjectMapper()); + + @Test + public void chatCompletion() { + + MediaContent anthropicMessage = new MediaContent("Name 3 famous pirates"); + ChatCompletionMessage chatCompletionMessage = new ChatCompletionMessage(List.of(anthropicMessage), Role.USER); + AnthropicChatRequest request = AnthropicChatRequest.builder(List.of(chatCompletionMessage)) + .withTemperature(0.8f) + .withMaxTokens(300) + .withTopK(10) + .withAnthropicVersion(DEFAULT_ANTHROPIC_VERSION) + .build(); + + AnthropicChatResponse response = anthropicChatApi.chatCompletion(request); + + System.out.println(response.content()); + assertThat(response).isNotNull(); + assertThat(response.content().get(0).text()).isNotEmpty(); + assertThat(response.content().get(0).text()).contains("Blackbeard"); + assertThat(response.stopReason()).isEqualTo("end_turn"); + assertThat(response.stopSequence()).isNull(); + assertThat(response.usage().inputTokens()).isGreaterThan(10); + assertThat(response.usage().outputTokens()).isGreaterThan(100); + + logger.info("" + response); + } + + @Test + public void chatMultiCompletion() { + + MediaContent anthropicInitialMessage = new MediaContent("Name 3 famous pirates"); + ChatCompletionMessage chatCompletionInitialMessage = new ChatCompletionMessage(List.of(anthropicInitialMessage), + Role.USER); + + MediaContent anthropicAssistantMessage = new MediaContent( + "Here are 3 famous pirates: Blackbeard, Calico Jack, Henry Morgan"); + ChatCompletionMessage chatCompletionAssistantMessage = new ChatCompletionMessage( + List.of(anthropicAssistantMessage), Role.ASSISTANT); + + MediaContent anthropicFollowupMessage = new MediaContent("Why are they famous?"); + ChatCompletionMessage chatCompletionFollowupMessage = new ChatCompletionMessage( + List.of(anthropicFollowupMessage), Role.USER); + + AnthropicChatRequest request = AnthropicChatRequest + .builder(List.of(chatCompletionInitialMessage, chatCompletionAssistantMessage, + chatCompletionFollowupMessage)) + .withTemperature(0.8f) + .withMaxTokens(400) + .withTopK(10) + .withAnthropicVersion(DEFAULT_ANTHROPIC_VERSION) + .build(); + + AnthropicChatResponse response = anthropicChatApi.chatCompletion(request); + + System.out.println(response.content()); + assertThat(response).isNotNull(); + assertThat(response.content().get(0).text()).isNotEmpty(); + assertThat(response.content().get(0).text()).contains("Blackbeard"); + assertThat(response.stopReason()).isEqualTo("end_turn"); + assertThat(response.stopSequence()).isNull(); + assertThat(response.usage().inputTokens()).isGreaterThan(30); + assertThat(response.usage().outputTokens()).isGreaterThan(200); + + logger.info("" + response); + } + + @Test + public void chatCompletionStream() { + MediaContent anthropicMessage = new MediaContent("Name 3 famous pirates"); + ChatCompletionMessage chatCompletionMessage = new ChatCompletionMessage(List.of(anthropicMessage), Role.USER); + + AnthropicChatRequest request = AnthropicChatRequest.builder(List.of(chatCompletionMessage)) + .withTemperature(0.8f) + .withMaxTokens(300) + .withTopK(10) + .withAnthropicVersion(DEFAULT_ANTHROPIC_VERSION) + .build(); + + Flux responseStream = anthropicChatApi + .chatCompletionStream(request); + + List responses = responseStream.collectList().block(); + assertThat(responses).isNotNull(); + assertThat(responses).hasSizeGreaterThan(10); + assertThat(responses.stream() + .filter(message -> message.type() == StreamingType.CONTENT_BLOCK_DELTA) + .map(message -> message.delta().text()) + .collect(Collectors.joining())).contains("Blackbeard"); + } + +} diff --git a/models/spring-ai-bedrock/src/test/resources/test.png b/models/spring-ai-bedrock/src/test/resources/test.png new file mode 100644 index 0000000000000000000000000000000000000000..8abb4c81aea34f9238ce5abeabfbcc8db7ff0cb3 GIT binary patch literal 167772 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

48FLmZ)xyub>{lu#+uX7FE)!_XE4D0pBKKwA>R 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 literal 0 HcmV?d00001 diff --git a/pom.xml b/pom.xml index edad7bcc44e..fca9a0f38ac 100644 --- a/pom.xml +++ b/pom.xml @@ -117,7 +117,7 @@ 1.0.0-beta.7 1.0.0 4.31.1 - 2.24.8 + 2.25.3 2.16.1 0.26.0 1.17.0 diff --git a/spring-ai-core/pom.xml b/spring-ai-core/pom.xml index ddd220b8b70..66c935834fa 100644 --- a/spring-ai-core/pom.xml +++ b/spring-ai-core/pom.xml @@ -112,7 +112,7 @@ test - + diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/nav.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/nav.adoc index b8af5752769..848e4fb8a3d 100644 --- a/spring-ai-docs/src/main/antora/modules/ROOT/nav.adoc +++ b/spring-ai-docs/src/main/antora/modules/ROOT/nav.adoc @@ -9,7 +9,8 @@ *** xref:api/chat/azure-openai-chat.adoc[Azure OpenAI] **** xref:api/chat/functions/azure-open-ai-chat-functions.adoc[Function Calling] *** xref:api/bedrock-chat.adoc[Amazon Bedrock] -**** xref:api/chat/bedrock/bedrock-anthropic.adoc[Anthropic] +**** xref:api/chat/bedrock/bedrock-anthropic3.adoc[Anthropic3] +**** xref:api/chat/bedrock/bedrock-anthropic.adoc[Anthropic2] **** xref:api/chat/bedrock/bedrock-llama2.adoc[Llama2] **** xref:api/chat/bedrock/bedrock-cohere.adoc[Cohere] **** xref:api/chat/bedrock/bedrock-titan.adoc[Titan] @@ -21,7 +22,7 @@ ***** xref:api/chat/functions/vertexai-gemini-chat-functions.adoc[Function Calling] *** xref:api/chat/mistralai-chat.adoc[Mistral AI] **** xref:api/chat/functions/mistralai-chat-functions.adoc[Function Calling] -*** xref:api/chat/anthropic-chat.adoc[Anthropic] +*** xref:api/chat/anthropic-chat.adoc[Anthropic 3] ** xref:api/embeddings.adoc[] *** xref:api/embeddings/openai-embeddings.adoc[OpenAI] *** xref:api/embeddings/ollama-embeddings.adoc[Ollama] diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/anthropic-chat.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/anthropic-chat.adoc index 341e57a7517..6a126313381 100644 --- a/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/anthropic-chat.adoc +++ b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/anthropic-chat.adoc @@ -1,4 +1,4 @@ -= Anthropic Chat += Anthropic 3 Chat link:https://www.anthropic.com/[Anthropic Claude] is a family of foundational AI models that can be used in a variety of applications. For developers and businesses, you can leverage the API access and build directly on top of link:https://www.anthropic.com/api[Anthropic's AI infrastructure]. diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic.adoc index 192eb5976c7..43b424d28a2 100644 --- a/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic.adoc +++ b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic.adoc @@ -1,4 +1,7 @@ -= Anthropic Chat += Bedrock Anthropic 2 Chat + +NOTE: The Anthropic 2 Chat API is deprecated and replaced by the new Anthropic Claude 3 Message API. +Please use the xref:api/chat/bedrock/bedrock-anthropic3.adoc[Anthropic Claude 3 Message API] for new projects. https://www.anthropic.com/product[Anthropic's Claude] is an AI assistant based on Anthropic’s research into training helpful, honest, and harmless AI systems. The Claude model has the following high level features @@ -9,6 +12,9 @@ The Claude model has the following high level features The https://aws.amazon.com/bedrock/claude[AWS Bedrock Anthropic Model Page] and https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html[Amazon Bedrock User Guide] contains detailed information on how to use the AWS hosted model. +TIP: Anthropic’s Claude 2 and 3 models are also available directly on the Anthropic's own cloud platform. +Spring AI provides dedicated xref:api/chat/anthropic-chat.adoc[Anthropic Claude] client to access it. + == Prerequisites Refer to the xref:api/bedrock.adoc[Spring AI documentation on Amazon Bedrock] for setting up API access. diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic3.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic3.adoc new file mode 100644 index 00000000000..58323278776 --- /dev/null +++ b/spring-ai-docs/src/main/antora/modules/ROOT/pages/api/chat/bedrock/bedrock-anthropic3.adoc @@ -0,0 +1,288 @@ += Bedrock Anthropic 3 + +link:https://www.anthropic.com/[Anthropic Claude] is a family of foundational AI models that can be used in a variety of applications. + +The Claude model has the following high level features + +* 200k Token Context Window: Claude boasts a generous token capacity of 200,000, making it ideal for handling extensive information in applications like technical documentation, codebase, and literary works. +* Supported Tasks: Claude's versatility spans tasks such as summarization, Q&A, trend forecasting, and document comparisons, enabling a wide range of applications from dialogues to content generation. +* AI Safety Features: Built on Anthropic's safety research, Claude prioritizes helpfulness, honesty, and harmlessness in its interactions, reducing brand risk and ensuring responsible AI behavior. + +The https://aws.amazon.com/bedrock/claude[AWS Bedrock Anthropic Model Page] and https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html[Amazon Bedrock User Guide] contains detailed information on how to use the AWS hosted model. + +TIP: Anthropic’s Claude 2 and 3 models are also available directly on the Anthropic's own cloud platform. +Spring AI provides dedicated xref:api/chat/anthropic-chat.adoc[Anthropic Claude] client to access it. + +== Prerequisites + +Refer to the xref:api/bedrock.adoc[Spring AI documentation on Amazon Bedrock] for setting up API access. + +=== Add Repositories and BOM + +Spring AI artifacts are published in Spring Milestone and Snapshot repositories. Refer to the xref:getting-started.adoc#repositories[Repositories] section to add these repositories to your build system. + +To help with dependency management, Spring AI provides a BOM (bill of materials) to ensure that a consistent version of Spring AI is used throughout the entire project. Refer to the xref:getting-started.adoc#dependency-management[Dependency Management] section to add the Spring AI BOM to your build system. + +== Auto-configuration + +Add the `spring-ai-bedrock-ai-spring-boot-starter` dependency to your project's Maven `pom.xml` file: + +[source,xml] +---- + + org.springframework.ai + spring-ai-bedrock-ai-spring-boot-starter + +---- + +or to your Gradle `build.gradle` build file. + +[source,gradle] +---- +dependencies { + implementation 'org.springframework.ai:spring-ai-bedrock-ai-spring-boot-starter' +} +---- + +TIP: Refer to the xref:getting-started.adoc#dependency-management[Dependency Management] section to add the Spring AI BOM to your build file. + +=== Enable Anthropic Chat + +By default the Anthropic model is disabled. +To enable it set the `spring.ai.bedrock.anthropic3.chat.enabled` property to `true`. +Exporting environment variable is one way to set this configuration property: + +[source,shell] +---- +export SPRING_AI_BEDROCK_ANTHROPIC3_CHAT_ENABLED=true +---- + +=== Chat Properties + +The prefix `spring.ai.bedrock.aws` is the property prefix to configure the connection to AWS Bedrock. + +[cols="3,3,1"] +|==== +| Property | Description | Default + +| spring.ai.bedrock.aws.region | AWS region to use. | us-east-1 +| spring.ai.bedrock.aws.access-key | AWS access key. | - +| spring.ai.bedrock.aws.secret-key | AWS secret key. | - +|==== + +The prefix `spring.ai.bedrock.anthropic3.chat` is the property prefix that configures the chat client implementation for Claude. + +[cols="2,5,1"] +|==== +| Property | Description | Default + +| spring.ai.bedrock.anthropic3.chat.enable | Enable Bedrock Anthropic chat client. Disabled by default | false +| spring.ai.bedrock.anthropic3.chat.model | The model id to use. Supports the `anthropic.claude-3-sonnet-20240229-v1:0`,`anthropic.claude-3-haiku-20240307-v1:0` and the legacy `anthropic.claude-v2`, `anthropic.claude-v2:1` and `anthropic.claude-instant-v1` models for both synchronous and streaming responses. | `anthropic.claude-3-sonnet-20240229-v1:0` +| spring.ai.bedrock.anthropic3.chat.options.temperature | Controls the randomness of the output. Values can range over [0.0,1.0] | 0.8 +| spring.ai.bedrock.anthropic3.chat.options.top-p | The maximum cumulative probability of tokens to consider when sampling. | AWS Bedrock default +| spring.ai.bedrock.anthropic3.chat.options.top-k | Specify the number of token choices the generative uses to generate the next token. | AWS Bedrock default +| spring.ai.bedrock.anthropic3.chat.options.stop-sequences | Configure up to four sequences that the generative recognizes. After a stop sequence, the generative stops generating further tokens. The returned text doesn't contain the stop sequence. | 10 +| spring.ai.bedrock.anthropic3.chat.options.anthropic-version | The version of the generative to use. | bedrock-2023-05-31 +| spring.ai.bedrock.anthropic3.chat.options.max-tokens | Specify the maximum number of tokens to use in the generated response. Note that the models may stop before reaching this maximum. This parameter only specifies the absolute maximum number of tokens to generate. We recommend a limit of 4,000 tokens for optimal performance. | 500 +|==== + +Look at the https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java[AnthropicChatModel] for other model IDs. +Supported values are: `anthropic.claude-instant-v1`, `anthropic.claude-v2` and `anthropic.claude-v2:1`. +Model ID values can also be found in the https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids-arns.html[AWS Bedrock documentation for base model IDs]. + +TIP: All properties prefixed with `spring.ai.bedrock.anthropic3.chat.options` can be overridden at runtime by adding a request specific <> to the `Prompt` call. + +== Runtime Options [[chat-options]] + +The https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java[Anthropic3ChatOptions.java] provides model configurations, such as temperature, topK, topP, etc. + +On start-up, the default options can be configured with the `BedrockAnthropicChatClient(api, options)` constructor or the `spring.ai.bedrock.anthropic3.chat.options.*` properties. + +At run-time you can override the default options by adding new, request specific, options to the `Prompt` call. +For example to override the default temperature for a specific request: + +[source,java] +---- +ChatResponse response = chatClient.call( + new Prompt( + "Generate the names of 5 famous pirates.", + Anthropic3ChatOptions.builder() + .withTemperature(0.4) + .build() + )); +---- + +TIP: In addition to the model specific https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/Anthropic3ChatOptions.java[AnthropicChatOptions] you can use a portable https://github.com/spring-projects/spring-ai/blob/main/spring-ai-core/src/main/java/org/springframework/ai/chat/ChatOptions.java[ChatOptions] instance, created with the https://github.com/spring-projects/spring-ai/blob/main/spring-ai-core/src/main/java/org/springframework/ai/chat/ChatOptionsBuilder.java[ChatOptionsBuilder#builder()]. + + +== Multimodal + +Multimodality refers to a model's ability to simultaneously understand and process information from various sources, including text, images, audio, and other data formats. This paradigm represents a significant advancement in AI models. + +Currently, Anthropic Claude 3 supports the `base64` source type for `images`, and the `image/jpeg`, `image/png`, `image/gif`, and `image/webp` media types. +Check the link:https://docs.anthropic.com/claude/docs/vision[Vision guide] for more information. + +Spring AI's `Message` interface supports multimodal AI models by introducing the Media type. +This type contains data and information about media attachments in messages, using Spring's `org.springframework.util.MimeType` and a `java.lang.Object` for the raw media data. + +Below is a simple code example extracted from https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-anthropic/src/test/java/org/springframework/ai/anthropic3/Anthropic3ChatClientIT.java[Anthropic3ChatClientIT.java], demonstrating the combination of user text with an image. + +[source,java] +---- + byte[] imageData = new ClassPathResource("/test.png").getContentAsByteArray(); + + var userMessage = new UserMessage("Explain what do you see o this picture?", + List.of(new Media(MimeTypeUtils.IMAGE_PNG, imageData))); + + ChatResponse response = chatClient.call(new Prompt(List.of(userMessage))); + + assertThat(response.getResult().getOutput().getContent()).contains("bananas", "apple", "basket"); +---- + +It takes as an input the `test.png` image: + +image::multimodal.test.png[Multimodal Test Image, 200, 200, align="left"] + +along with the text message "Explain what do you see on this picture?", and generates a response something like: + +---- +The image shows a close-up view of a wire fruit basket containing several pieces of fruit. +The basket appears to be made of thin metal wires formed into a round shape with an elevated handle. + +Inside the basket, there are a few yellow bananas and a couple of red apples or possibly tomatoes. +The vibrant colors of the fruit contrast nicely against the metallic tones of the wire basket. + +The shallow depth of field in the photograph puts the focus squarely on the fruit in the foreground, while the basket handle extending upwards is slightly blurred, creating a pleasing bokeh effect in the background. + +The composition and lighting give the image a clean, minimalist aesthetic that highlights the natural beauty and freshness of the fruit displayed in this elegant wire basket. +---- + + +== Sample Controller + +https://start.spring.io/[Create] a new Spring Boot project and add the `spring-ai-bedrock-ai-spring-boot-starter` to your pom (or gradle) dependencies. + +Add a `application.properties` file, under the `src/main/resources` directory, to enable and configure the Anthropic Chat client: + +[source] +---- +spring.ai.bedrock.aws.region=eu-central-1 +spring.ai.bedrock.aws.access-key=${AWS_ACCESS_KEY_ID} +spring.ai.bedrock.aws.secret-key=${AWS_SECRET_ACCESS_KEY} + +spring.ai.bedrock.anthropic3.chat.enabled=true +spring.ai.bedrock.anthropic3.chat.options.temperature=0.8 +spring.ai.bedrock.anthropic3.chat.options.top-k=15 +---- + +TIP: replace the `regions`, `access-key` and `secret-key` with your AWS credentials. + +This will create a `BedrockAnthropicChatClient` implementation that you can inject into your class. +Here is an example of a simple `@Controller` class that uses the chat client for text generations. + +[source,java] +---- +@RestController +public class ChatController { + + private final BedrockAnthropic3ChatClient chatClient; + + @Autowired + public ChatController(BedrockAnthropic3ChatClient chatClient) { + this.chatClient = chatClient; + } + + @GetMapping("/ai/generate") + public Map generate(@RequestParam(value = "message", defaultValue = "Tell me a joke") String message) { + return Map.of("generation", chatClient.call(message)); + } + + @GetMapping("/ai/generateStream") + public Flux generateStream(@RequestParam(value = "message", defaultValue = "Tell me a joke") String message) { + Prompt prompt = new Prompt(new UserMessage(message)); + return chatClient.stream(prompt); + } +} +---- + +== Manual Configuration + +The https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java[BedrockAnthropic3ChatClient] implements the `ChatClient` and `StreamingChatClient` and uses the <> to connect to the Bedrock Anthropic service. + +Add the `spring-ai-bedrock` dependency to your project's Maven `pom.xml` file: + +[source,xml] +---- + + org.springframework.ai + spring-ai-bedrock + +---- + +or to your Gradle `build.gradle` build file. + +[source,gradle] +---- +dependencies { + implementation 'org.springframework.ai:spring-ai-bedrock' +} +---- + +TIP: Refer to the xref:getting-started.adoc#dependency-management[Dependency Management] section to add the Spring AI BOM to your build file. + +Next, create an https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/BedrockAnthropic3ChatClient.java[BedrockAnthropic3ChatClient] and use it for text generations: + +[source,java] +---- +Anthropic3ChatBedrockApi anthropicApi = new Anthropic3ChatBedrockApi( + AnthropicChatBedrockApi.AnthropicModel.CLAUDE_V3_SONNET.id(), + EnvironmentVariableCredentialsProvider.create(), + Region.US_EAST_1.id(), + new ObjectMapper()); + +BedrockAnthropic3ChatClient chatClient = new BedrockAnthropic3ChatClient(anthropicApi, + AnthropicChatOptions.builder() + .withTemperature(0.6f) + .withTopK(10) + .withTopP(0.8f) + .withMaxTokensToSample(100) + .withAnthropicVersion(AnthropicChatBedrockApi.DEFAULT_ANTHROPIC_VERSION) + .build()); + +ChatResponse response = chatClient.call( + new Prompt("Generate the names of 5 famous pirates.")); + +// Or with streaming responses +Flux response = chatClient.stream( + new Prompt("Generate the names of 5 famous pirates.")); +---- + +=== Low-level Anthropic3ChatBedrockApi Client [[low-level-api]] + +The https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java[Anthropic3ChatBedrockApi] provides is lightweight Java client on top of AWS Bedrock link:https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-claude.html[Anthropic Claude models]. + +Client supports the `anthropic.claude-3-sonnet-20240229-v1:0`,`anthropic.claude-3-haiku-20240307-v1:0` and the legacy `anthropic.claude-v2`, `anthropic.claude-v2:1` and `anthropic.claude-instant-v1` models for both synchronous (e.g. `chatCompletion()`) and streaming (e.g. `chatCompletionStream()`) responses. + +Here is a simple snippet how to use the api programmatically: + +[source,java] +---- +Anthropic3ChatBedrockApi anthropicChatApi = new Anthropic3ChatBedrockApi( + AnthropicModel.CLAUDE_V2.id(), Region.EU_CENTRAL_1.id()); + +AnthropicChatRequest request = AnthropicChatRequest + .builder(String.format(Anthropic3ChatBedrockApi.PROMPT_TEMPLATE, "Name 3 famous pirates")) + .withTemperature(0.8f) + .withMaxTokensToSample(300) + .withTopK(10) + .build(); + +// Sync request +AnthropicChatResponse response = anthropicChatApi.chatCompletion(request); + +// Streaming request +Flux responseStream = anthropicChatApi.chatCompletionStream(request); +List responses = responseStream.collectList().block(); +---- + +Follow the https://github.com/spring-projects/spring-ai/blob/main/models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/anthropic3/api/Anthropic3ChatBedrockApi.java[Anthropic3ChatBedrockApi.java]'s JavaDoc for further information. diff --git a/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfiguration.java b/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfiguration.java new file mode 100644 index 00000000000..ae06251fa9a --- /dev/null +++ b/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfiguration.java @@ -0,0 +1,61 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.autoconfigure.bedrock.anthropic3; + +import com.fasterxml.jackson.databind.ObjectMapper; +import org.springframework.ai.autoconfigure.bedrock.BedrockAwsConnectionConfiguration; +import org.springframework.ai.autoconfigure.bedrock.BedrockAwsConnectionProperties; +import org.springframework.ai.bedrock.anthropic3.BedrockAnthropic3ChatClient; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnClass; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Import; +import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; + +/** + * {@link AutoConfiguration Auto-configuration} for Bedrock Anthropic Chat Client. + * + * Leverages the Spring Cloud AWS to resolve the {@link AwsCredentialsProvider}. + * + * @author Christian Tzolov + * @since 0.8.0 + */ +@AutoConfiguration +@ConditionalOnClass(Anthropic3ChatBedrockApi.class) +@EnableConfigurationProperties({ BedrockAnthropic3ChatProperties.class, BedrockAwsConnectionProperties.class }) +@ConditionalOnProperty(prefix = BedrockAnthropic3ChatProperties.CONFIG_PREFIX, name = "enabled", havingValue = "true") +@Import(BedrockAwsConnectionConfiguration.class) +public class BedrockAnthropic3ChatAutoConfiguration { + + @Bean + @ConditionalOnMissingBean + public Anthropic3ChatBedrockApi anthropicApi(AwsCredentialsProvider credentialsProvider, + BedrockAnthropic3ChatProperties properties, BedrockAwsConnectionProperties awsProperties) { + return new Anthropic3ChatBedrockApi(properties.getModel(), credentialsProvider, awsProperties.getRegion(), + new ObjectMapper()); + } + + @Bean + public BedrockAnthropic3ChatClient anthropicChatClient(Anthropic3ChatBedrockApi anthropicApi, + BedrockAnthropic3ChatProperties properties) { + return new BedrockAnthropic3ChatClient(anthropicApi, properties.getOptions()); + } + +} diff --git a/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatProperties.java b/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatProperties.java new file mode 100644 index 00000000000..54d516239b2 --- /dev/null +++ b/spring-ai-spring-boot-autoconfigure/src/main/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatProperties.java @@ -0,0 +1,83 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.autoconfigure.bedrock.anthropic3; + +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi; +import org.springframework.ai.bedrock.anthropic3.Anthropic3ChatOptions; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatModel; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.context.properties.NestedConfigurationProperty; +import org.springframework.util.Assert; + +/** + * Configuration properties for Bedrock Anthropic Claude 3. + * + * @author Christian Tzolov + * @since 1.0.0 + */ +@ConfigurationProperties(BedrockAnthropic3ChatProperties.CONFIG_PREFIX) +public class BedrockAnthropic3ChatProperties { + + public static final String CONFIG_PREFIX = "spring.ai.bedrock.anthropic3.chat"; + + /** + * Enable Bedrock Anthropic chat client. Disabled by default. + */ + private boolean enabled = false; + + /** + * The generative id to use. See the {@link AnthropicChatModel} for the supported + * models. + */ + private String model = AnthropicChatModel.CLAUDE_V3_SONNET.id(); + + @NestedConfigurationProperty + private Anthropic3ChatOptions options = Anthropic3ChatOptions.builder() + .withTemperature(0.7f) + .withMaxTokens(300) + .withTopK(10) + .withAnthropicVersion(Anthropic3ChatBedrockApi.DEFAULT_ANTHROPIC_VERSION) + // .withStopSequences(List.of("\n\nHuman:")) + .build(); + + public boolean isEnabled() { + return this.enabled; + } + + public void setEnabled(boolean enabled) { + this.enabled = enabled; + } + + public String getModel() { + return this.model; + } + + public void setModel(String model) { + this.model = model; + } + + public Anthropic3ChatOptions getOptions() { + return options; + } + + public void setOptions(Anthropic3ChatOptions options) { + Assert.notNull(options, "AnthropicChatOptions must not be null"); + Assert.notNull(options.getTemperature(), "AnthropicChatOptions.temperature must not be null"); + + this.options = options; + } + +} diff --git a/spring-ai-spring-boot-autoconfigure/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/spring-ai-spring-boot-autoconfigure/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports index 8afcf6f11bd..2a5e030adb4 100644 --- a/spring-ai-spring-boot-autoconfigure/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ b/spring-ai-spring-boot-autoconfigure/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -10,6 +10,7 @@ org.springframework.ai.autoconfigure.bedrock.llama2.BedrockLlama2ChatAutoConfigu org.springframework.ai.autoconfigure.bedrock.cohere.BedrockCohereChatAutoConfiguration org.springframework.ai.autoconfigure.bedrock.cohere.BedrockCohereEmbeddingAutoConfiguration org.springframework.ai.autoconfigure.bedrock.anthropic.BedrockAnthropicChatAutoConfiguration +org.springframework.ai.autoconfigure.bedrock.anthropic3.BedrockAnthropic3ChatAutoConfiguration org.springframework.ai.autoconfigure.bedrock.titan.BedrockTitanChatAutoConfiguration org.springframework.ai.autoconfigure.bedrock.titan.BedrockTitanEmbeddingAutoConfiguration org.springframework.ai.autoconfigure.ollama.OllamaAutoConfiguration diff --git a/spring-ai-spring-boot-autoconfigure/src/test/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfigurationIT.java b/spring-ai-spring-boot-autoconfigure/src/test/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfigurationIT.java new file mode 100644 index 00000000000..467fedc7eb5 --- /dev/null +++ b/spring-ai-spring-boot-autoconfigure/src/test/java/org/springframework/ai/autoconfigure/bedrock/anthropic3/BedrockAnthropic3ChatAutoConfigurationIT.java @@ -0,0 +1,153 @@ +/* + * Copyright 2023 - 2024 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.springframework.ai.autoconfigure.bedrock.anthropic3; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; +import org.springframework.ai.chat.messages.AssistantMessage; +import reactor.core.publisher.Flux; +import software.amazon.awssdk.regions.Region; + +import org.springframework.ai.autoconfigure.bedrock.BedrockAwsConnectionProperties; +import org.springframework.ai.bedrock.anthropic3.BedrockAnthropic3ChatClient; +import org.springframework.ai.bedrock.anthropic3.api.Anthropic3ChatBedrockApi.AnthropicChatModel; +import org.springframework.ai.chat.ChatResponse; +import org.springframework.ai.chat.Generation; +import org.springframework.ai.chat.prompt.Prompt; +import org.springframework.ai.chat.prompt.SystemPromptTemplate; +import org.springframework.ai.chat.messages.Message; +import org.springframework.ai.chat.messages.UserMessage; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; + +import static org.assertj.core.api.Assertions.assertThat; + +/** + * @author Christian Tzolov + * @since 1.0.0 + */ +@EnabledIfEnvironmentVariable(named = "AWS_ACCESS_KEY_ID", matches = ".*") +@EnabledIfEnvironmentVariable(named = "AWS_SECRET_ACCESS_KEY", matches = ".*") +public class BedrockAnthropic3ChatAutoConfigurationIT { + + private final ApplicationContextRunner contextRunner = new ApplicationContextRunner() + .withPropertyValues("spring.ai.bedrock.anthropic3.chat.enabled=true", + "spring.ai.bedrock.aws.access-key=" + System.getenv("AWS_ACCESS_KEY_ID"), + "spring.ai.bedrock.aws.secret-key=" + System.getenv("AWS_SECRET_ACCESS_KEY"), + "spring.ai.bedrock.aws.region=" + Region.US_EAST_1.id(), + "spring.ai.bedrock.anthropic3.chat.model=" + AnthropicChatModel.CLAUDE_V3_SONNET.id(), + "spring.ai.bedrock.anthropic3.chat.options.temperature=0.5") + .withConfiguration(AutoConfigurations.of(BedrockAnthropic3ChatAutoConfiguration.class)); + + private final Message systemMessage = new SystemPromptTemplate(""" + You are a helpful AI assistant. Your name is {name}. + You are an AI assistant that helps people find information. + Your name is {name} + You should reply to the user's request with your name and also in the style of a {voice}. + """).createMessage(Map.of("name", "Bob", "voice", "pirate")); + + private final UserMessage userMessage = new UserMessage( + "Tell me about 3 famous pirates from the Golden Age of Piracy and why they did."); + + @Test + public void chatCompletion() { + contextRunner.run(context -> { + BedrockAnthropic3ChatClient anthropicChatClient = context.getBean(BedrockAnthropic3ChatClient.class); + ChatResponse response = anthropicChatClient.call(new Prompt(List.of(userMessage, systemMessage))); + assertThat(response.getResult().getOutput().getContent()).contains("Blackbeard"); + }); + } + + @Test + public void chatCompletionStreaming() { + contextRunner.run(context -> { + + BedrockAnthropic3ChatClient anthropicChatClient = context.getBean(BedrockAnthropic3ChatClient.class); + + Flux response = anthropicChatClient.stream(new Prompt(List.of(userMessage, systemMessage))); + + List responses = response.collectList().block(); + assertThat(responses.size()).isGreaterThan(2); + + String stitchedResponseContent = responses.stream() + .map(ChatResponse::getResults) + .flatMap(List::stream) + .map(Generation::getOutput) + .map(AssistantMessage::getContent) + .collect(Collectors.joining()); + + assertThat(stitchedResponseContent).contains("Blackbeard"); + }); + } + + @Test + public void propertiesTest() { + + new ApplicationContextRunner() + .withPropertyValues("spring.ai.bedrock.anthropic3.chat.enabled=true", + "spring.ai.bedrock.aws.access-key=ACCESS_KEY", "spring.ai.bedrock.aws.secret-key=SECRET_KEY", + "spring.ai.bedrock.anthropic3.chat.model=MODEL_XYZ", + "spring.ai.bedrock.aws.region=" + Region.EU_CENTRAL_1.id(), + "spring.ai.bedrock.anthropic3.chat.options.temperature=0.55") + .withConfiguration(AutoConfigurations.of(BedrockAnthropic3ChatAutoConfiguration.class)) + .run(context -> { + var anthropicChatProperties = context.getBean(BedrockAnthropic3ChatProperties.class); + var awsProperties = context.getBean(BedrockAwsConnectionProperties.class); + + assertThat(anthropicChatProperties.isEnabled()).isTrue(); + assertThat(awsProperties.getRegion()).isEqualTo(Region.EU_CENTRAL_1.id()); + + assertThat(anthropicChatProperties.getOptions().getTemperature()).isEqualTo(0.55f); + assertThat(anthropicChatProperties.getModel()).isEqualTo("MODEL_XYZ"); + + assertThat(awsProperties.getAccessKey()).isEqualTo("ACCESS_KEY"); + assertThat(awsProperties.getSecretKey()).isEqualTo("SECRET_KEY"); + }); + } + + @Test + public void chatCompletionDisabled() { + + // It is disabled by default + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(BedrockAnthropic3ChatAutoConfiguration.class)) + .run(context -> { + assertThat(context.getBeansOfType(BedrockAnthropic3ChatProperties.class)).isEmpty(); + assertThat(context.getBeansOfType(BedrockAnthropic3ChatClient.class)).isEmpty(); + }); + + // Explicitly enable the chat auto-configuration. + new ApplicationContextRunner().withPropertyValues("spring.ai.bedrock.anthropic3.chat.enabled=true") + .withConfiguration(AutoConfigurations.of(BedrockAnthropic3ChatAutoConfiguration.class)) + .run(context -> { + assertThat(context.getBeansOfType(BedrockAnthropic3ChatProperties.class)).isNotEmpty(); + assertThat(context.getBeansOfType(BedrockAnthropic3ChatClient.class)).isNotEmpty(); + }); + + // Explicitly disable the chat auto-configuration. + new ApplicationContextRunner().withPropertyValues("spring.ai.bedrock.anthropic3.chat.enabled=false") + .withConfiguration(AutoConfigurations.of(BedrockAnthropic3ChatAutoConfiguration.class)) + .run(context -> { + assertThat(context.getBeansOfType(BedrockAnthropic3ChatProperties.class)).isEmpty(); + assertThat(context.getBeansOfType(BedrockAnthropic3ChatClient.class)).isEmpty(); + }); + } + +}