此版本仍在开发中，尚未被视为稳定版。为了获取最新的快照版本，请使用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

统一接口：编写一次代码，即可将其用于任何受支持的 Amazon Bedrock 模型spring-doc.cadn.net.cn
模型灵活性：无需更改代码即可无缝切换不同的对话模型spring-doc.cadn.net.cn
扩展功能：通过专用结构支持模型特定参数spring-doc.cadn.net.cn
工具支持：原生集成函数调用和工具使用功能spring-doc.cadn.net.cn
多模态能力：内置对视觉及其他多模态功能的支持spring-doc.cadn.net.cn
面向未来：符合 Amazon Bedrock 推荐的最佳实践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

将 Bedrock 的 Spring Boot Starter 添加到您的项目中。spring-doc.cadn.net.cn
获取AWS凭证：如果你还没有AWS账户或尚未配置AWS CLI和SDK，这部教学视频指南可以帮助你完成配置：AWS CLI和SDK快速配置指南！。你应该能够获得你的访问凭证和安全凭证。spring-doc.cadn.net.cn
启用的模型：前往亚马逊 Bedrock，并在左侧的“模型访问”菜单中从模型访问菜单中配置要使用的模型的访问权限。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.timeout=10m

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

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

Spring-AI Bedrock spring.ai.bedrock.aws.access-key 和 spring.ai.bedrock.aws.secret-key 属性。spring-doc.cadn.net.cn
Java 系统属性 - aws.accessKeyId 和 aws.secretAccessKey。spring-doc.cadn.net.cn
环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。spring-doc.cadn.net.cn
来自系统属性或环境变量的 Web Identity Token 凭据。spring-doc.cadn.net.cn
凭证配置文件位于默认位置 (~/.aws/credentials)，由所有 AWS SDK 和 AWS CLI 共享。spring-doc.cadn.net.cn
如果设置了 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 环境变量且安全管理器具有访问该变量的权限，则通过 Amazon EC2 容器服务传递凭据。spring-doc.cadn.net.cn
通过 Amazon EC2 元数据服务传递的实例配置文件凭证，或设置 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量。spring-doc.cadn.net.cn

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

Spring-AI Bedrock spring.ai.bedrock.aws.region 属性。spring-doc.cadn.net.cn
Java 系统属性 - aws.region。spring-doc.cadn.net.cn
环境变量 - AWS_REGION。spring-doc.cadn.net.cn
凭证配置文件位于默认位置 (~/.aws/credentials)，由所有 AWS SDK 和 AWS CLI 共享。spring-doc.cadn.net.cn
通过 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

Spring AI Bedrock Cohere Embeddings: spring.ai.bedrock.cohere.embedding.enabled=truespring-doc.cadn.net.cn
Spring AI Bedrock Titan Embeddings: spring.ai.bedrock.titan.embedding.enabled=truespring-doc.cadn.net.cn