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

手动配置

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

文档有误?请协助编辑

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