前提条件
你需要一个有效的 Oracle Cloud Infrastructure (OCI) 帐户才能使用 OCI GenAI Cohere 聊天客户端。该客户端提供四种不同的连接方式,包括使用用户和私钥的简单身份验证、工作负载身份、实例主体或 OCI 配置文件身份验证。添加仓库和 BOM
Spring AI 的构件发布在 Maven Central 和 Spring Snapshot 仓库中。 请参阅构件仓库部分,将这些仓库添加到你的构建系统中。 为了帮助进行依赖管理,Spring AI 提供了一个 BOM (bill of materials),以确保在整个项目中使用一致版本的 Spring AI。请参阅依赖管理部分,将 Spring AI BOM 添加到你的构建系统中。自动配置
Spring AI 自动配置、启动器模块的构件名称发生了重大变化。
有关更多信息,请参阅升级说明。
- Maven
- Gradle
聊天属性
连接属性
前缀spring.ai.oci.genai 是用于配置与 OCI GenAI 连接的属性前缀。
配置属性
聊天自动配置的启用和禁用现在通过前缀为
spring.ai.model.chat 的顶级属性进行配置。
要启用,spring.ai.model.chat=oci-genai (默认启用)
要禁用,spring.ai.model.chat=none (或任何与 oci-genai 不匹配的值)
此更改是为了允许配置多个模型。spring.ai.oci.genai.chat.cohere 是配置 OCI GenAI Cohere Chat 的 ChatModel 实现的属性前缀。
运行时选项
OCICohereChatOptions.java 提供模型配置,例如要使用的模型、温度、频率惩罚等。 在启动时,可以使用OCICohereChatModel(api, options) 构造函数或 spring.ai.oci.genai.chat.cohere.options.* 属性配置默认选项。
在运行时,你可以通过向 Prompt 调用添加新的、特定于请求的选项来覆盖默认选项。
例如,要为特定请求覆盖默认模型和温度:
示例控制器
创建一个新的 Spring Boot 项目,并将spring-ai-starter-model-oci-genai 添加到你的 pom (或 gradle) 依赖项中。
在 src/main/resources 目录下添加一个 application.properties 文件,以启用和配置 OCI GenAI Cohere 聊天模型:
OCICohereChatModel 实现,你可以将其注入到你的类中。
以下是一个简单的 @Controller 类的示例,该类使用聊天模型进行文本生成。
手动配置
OCICohereChatModel 实现了ChatModel 并使用 OCI Java SDK 连接到 OCI GenAI 服务。
将 spring-ai-oci-genai 依赖项添加到项目的构建文件中:
- Maven
- Gradle
OCICohereChatModel 并将其用于文本生成:
OCICohereChatOptions 为聊天请求提供配置信息。
OCICohereChatOptions.Builder 是流畅的选项构建器。
文档有误?请协助编辑
发现文档问题?点击此处直接在 GitHub 上编辑并提交 PR,帮助我们改进文档!