Skip to main content
OCI GenAI 服务 提供按需模型或专用 AI 集群的生成式 AI 聊天功能。 OCI 聊天模型页面OCI 生成式 AI 试验场提供了有关在 OCI 上使用和托管聊天模型的详细信息。

前提条件

你需要一个有效的 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 自动配置、启动器模块的构件名称发生了重大变化。 有关更多信息,请参阅升级说明
Spring AI 为 OCI GenAI Cohere 聊天客户端提供 Spring Boot 自动配置。 要启用它,请将以下依赖项添加到项目的构建文件中:
请参阅依赖管理部分,将 Spring AI BOM 添加到你的构建文件中。

聊天属性

连接属性

前缀 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 实现的属性前缀。
所有以 spring.ai.oci.genai.chat.cohere.options 为前缀的属性都可以在运行时通过向 Prompt 调用添加特定于请求的聊天选项来覆盖。

运行时选项

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 聊天模型:
filecompartmentmodel 替换为你的 OCI 帐户中的值。
这将创建一个 OCICohereChatModel 实现,你可以将其注入到你的类中。 以下是一个简单的 @Controller 类的示例,该类使用聊天模型进行文本生成。

手动配置

OCICohereChatModel 实现了 ChatModel 并使用 OCI Java SDK 连接到 OCI GenAI 服务。 spring-ai-oci-genai 依赖项添加到项目的构建文件中:
请参阅依赖管理部分,将 Spring AI BOM 添加到你的构建文件中。
接下来,创建一个 OCICohereChatModel 并将其用于文本生成:
OCICohereChatOptions 为聊天请求提供配置信息。 OCICohereChatOptions.Builder 是流畅的选项构建器。

文档有误?请协助编辑

发现文档问题?点击此处直接在 GitHub 上编辑并提交 PR,帮助我们改进文档!