此版本仍在开发中，尚未被视为稳定版。为了获取最新的快照版本，请使用Spring AI 1.1.3！spring-doc.cadn.net.cn

亚马逊Bedrock

根据 Bedrock 的建议，Spring AI 已过渡到使用 Amazon Bedrock 的 Converse API 来实现 Spring AI 中的所有聊天对话功能。 Bedrock Converse API 具有以下主要优势：spring-doc.cadn.net.cn

converse 平台不支持嵌入操作，因此这些功能将继续存在于现有版本中，并继续维护模型功能spring-doc.cadn.net.cn

Amazon Bedrock 是一项托管服务，通过统一的 API 提供来自各种人工智能提供商的基础模型。spring-doc.cadn.net.cn

Spring AI 通过实现 Spring EmbeddingModel 接口，支持可通过 Amazon Bedrock 使用的嵌入式 AI 模型。spring-doc.cadn.net.cn

此外，Spring AI 为所有客户端提供了 Spring 自动配置和 Boot Starters，使其能够轻松地引导和配置 Bedrock 模型。spring-doc.cadn.net.cn

入门指南

开始之前有几个步骤spring-doc.cadn.net.cn

项目依赖

然后将 Spring Boot Starter 依赖项添加到项目的 Maven pom.xml 构建文件中：spring-doc.cadn.net.cn

<dependency>
 <artifactId>spring-ai-starter-model-bedrock</artifactId>
 <groupId>org.springframework.ai</groupId>
</dependency>

或者添加到您的Gradle 构建脚本文件中。spring-doc.cadn.net.cn

dependencies {
    implementation 'org.springframework.ai:spring-ai-starter-model-bedrock'
}
参考以下依赖管理部分，添加Spring AI BOM到你的构建文件中。

连接到 AWS Bedrock

使用 BedrockAwsConnectionProperties 来配置 AWS 凭证和区域：spring-doc.cadn.net.cn

spring.ai.bedrock.aws.region=us-east-1

spring.ai.bedrock.aws.access-key=YOUR_ACCESS_KEY
spring.ai.bedrock.aws.secret-key=YOUR_SECRET_KEY

spring.ai.bedrock.aws.profile.name=YOUR_PROFILE_NAME
spring.ai.bedrock.aws.profile.credentials-path=YOUR_CREDENTIALS_PATH
spring.ai.bedrock.aws.profile.configuration-path=YOUR_CONFIGURATION_PATH

spring.ai.bedrock.aws.timeout=10m

region 属性是必需的。spring-doc.cadn.net.cn

AWS 凭证的解析顺序如下：spring-doc.cadn.net.cn

  1. Spring-AI Bedrock spring.ai.bedrock.aws.access-key 和 spring.ai.bedrock.aws.secret-key 属性。spring-doc.cadn.net.cn

  2. Spring-AI Bedrock spring.ai.bedrock.aws.profile.name，如果未指定 spring.ai.bedrock.aws.profile.credentials-path 和 spring.ai.bedrock.aws.profile.configuration-path，Spring AI 将使用标准的 AWS 共享文件：~/.aws/credentials 用于凭据，~/.aws/config 用于配置。spring-doc.cadn.net.cn

  3. Java 系统属性 - aws.accessKeyId 和 aws.secretAccessKey。spring-doc.cadn.net.cn

  4. 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。spring-doc.cadn.net.cn

  5. 来自系统属性或环境变量的 Web Identity Token 凭据。spring-doc.cadn.net.cn

  6. 凭证配置文件位于默认位置 (~/.aws/credentials)，由所有 AWS SDK 和 AWS CLI 共享。spring-doc.cadn.net.cn

  7. 如果设置了 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 环境变量且安全管理器具有访问该变量的权限，则通过 Amazon EC2 容器服务传递凭据。spring-doc.cadn.net.cn

  8. 通过 Amazon EC2 元数据服务传递的实例配置文件凭证，或设置 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量。spring-doc.cadn.net.cn

AWS 区域按以下顺序解析：spring-doc.cadn.net.cn

  1. Spring-AI Bedrock spring.ai.bedrock.aws.region 属性。spring-doc.cadn.net.cn

  2. Java 系统属性 - aws.region。spring-doc.cadn.net.cn

  3. 环境变量 - AWS_REGION。spring-doc.cadn.net.cn

  4. 凭证配置文件位于默认位置 (~/.aws/credentials)，由所有 AWS SDK 和 AWS CLI 共享。spring-doc.cadn.net.cn

  5. 通过 Amazon EC2 元数据服务传递的实例配置文件区域。spring-doc.cadn.net.cn

除了标准的 Spring-AI Bedrock 凭据和区域属性配置外，Spring-AI 还支持自定义 AwsCredentialsProvider 和 AwsRegionProvider Bean。spring-doc.cadn.net.cn

例如，同时使用 Spring-AI 和 Spring Cloud for Amazon Web Services。Spring-AI 与 Spring Cloud for Amazon Web Services 的凭证配置兼容。

启用选定的 Bedrock 模型

默认情况下，所有模型均被禁用。您必须使用 spring.ai.bedrock.<model>.embedding.enabled=true 属性显式启用所选的 Bedrock 模型。

以下是支持的 `<model>`：spring-doc.cadn.net.cn

模型spring-doc.cadn.net.cn

凝聚spring-doc.cadn.net.cn

titan（暂不支持批量操作）spring-doc.cadn.net.cn

例如，要启用 Bedrock Cohere 嵌入模型，您需要设置 spring.ai.bedrock.cohere.embedding.enabled=true。spring-doc.cadn.net.cn

接下来，您可以使用spring.ai.bedrock.<model>.embedding.*属性来配置每个模型，如所提供的那样。spring-doc.cadn.net.cn

如需了解更多信息，请参阅下方针对每种支持模型的文档。spring-doc.cadn.net.cn