Upgrading Notes

Upgrading to 0.8.1

之前的 spring-ai-vertex-ai 已重命名为 spring-ai-vertex-ai-palm2，spring-ai-vertex-ai-spring-boot-starter 已重命名为 spring-ai-vertex-ai-palm2-spring-boot-starter。

因此，您需要将依赖项从

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-vertex-ai</artifactId>
</dependency>

更改为

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-vertex-ai-palm2</artifactId>
</dependency>

Palm2 模型的关联 Boot starter 已从

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-vertex-ai-spring-boot-starter</artifactId>
</dependency>

更改为

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-vertex-ai-palm2-spring-boot-starter</artifactId>
</dependency>

  • Renamed Classes (01.03.2024)

    • VertexAiApi → VertexAiPalm2Api

    • VertexAiClientChat → VertexAiPalm2ChatClient

    • VertexAiEmbeddingClient → VertexAiPalm2EmbeddingClient

    • VertexAiChatOptions → VertexAiPalm2ChatOptions

Upgrading to 0.8.0

January 24, 2024 Update

  • 将 prompt 和 messages 和 metadata 包移至 org.sf.ai.chat 的子包

  • 新功能是 text to image 客户端。类是 OpenAiImageClient 和 StabilityAiImageClient。有关用法的信息，请参阅集成测试，文档即将推出。

  • 新的包 model，其中包含界面和基类以支持为任何输入/输出数据类型组合创建 AI 模型客户端。目前聊天和图像模型包实现了此功能。我们很快将嵌入包更新到此新模型。

  • 新的“可移植选项”设计模式。我们希望在基于聊天的不同 AI 模型中尽可能多地提供 ChatClient 的可移植性。有一组常见的生成功能，然后是特定于模型提供商的生成功能。使用了一种类似“鸭子类型”的方法。ModelOptions 中的模型包是标记接口，表示此类的实现将为模型提供选项。请参阅 ImageOptions，一个子接口，它定义所有文本→图像 ImageClient 实现的可移植选项。然后，StabilityAiImageOptions 和 OpenAiImageOptions 提供特定于每个模型提供商的选项。所有选项类均通过流畅的 API 构建器创建，所有选项均可传递到可移植 ImageClient API 中。这些选项数据类型用于 ImageClient 实现的自动配置/配置属性。

January 13, 2024 Update

以下 OpenAi Autoconfiguration 聊天属性已更改

  • from spring.ai.openai.model to spring.ai.openai.chat.options.model.

  • from spring.ai.openai.temperature to spring.ai.openai.chat.options.temperature.

查找有关 OpenAi 属性的最新文档：[role="bare"][role="bare"]https://docs.spring.io/spring-ai/reference/api/clients/openai-chat.html

December 27, 2023 Update

将 SimplePersistentVectorStore 和 InMemoryVectorStore 合并到 SimpleVectorStore* 中，用 SimpleVectorStore 替换 InMemoryVectorStore

December 20, 2023 Update

重构 Ollama 客户端和相关类及包名

  • 将 org.springframework.ai.ollama.client.OllamaClient 替换为 org.springframework.ai.ollama.OllamaChatClient。

  • OllamaChatClient 方法签名已更改。

  • 将 org.springframework.ai.autoconfigure.ollama.OllamaProperties 重命名为 org.springframework.ai.autoconfigure.ollama.OllamaChatProperties，并将后缀更改为: spring.ai.ollama.chat。其中某些属性也已更改。

December 19, 2023 Update

对 AiClient 及相关类和包名进行重命名

  • Rename AiClient to ChatClient

  • Rename AiResponse to ChatResponse

  • Rename AiStreamClient to StreamingChatClient

  • 将包 org.sf.ai.client 重命名为 org.sf.ai.chat。

重命名构件 ID

  • transformers-embedding to spring-ai-transformers

已将 Maven 模块从顶级目录和 embedding-clients 子目录移到单个 models 目录下。

December 1, 2023

我们正在转换该项目的 Group ID：

  • FROM: org.springframework.experimental.ai

  • TO: org.springframework.ai

构件仍将托管在快照存储库中，如下所示。

主分支将移动到版本 0.8.0-SNAPSHOT。它将在未来一两周内不稳定。如果您不想在 bleeding edge 上，请使用 0.7.1-SNAPSHOT。

您可以像以前一样访问 `0.7.1-SNAPSHOT`工件，还可以访问 0.7.1-SNAPSHOT Documentation。

0.7.1-SNAPSHOT Dependencies

  • Azure OpenAI[source, xml]

<dependency>
    <groupId>org.springframework.experimental.ai</groupId>
    <artifactId>spring-ai-azure-openai-spring-boot-starter</artifactId>
    <version>0.7.1-SNAPSHOT</version>
</dependency>

  • OpenAI[source, xml]

<dependency>
    <groupId>org.springframework.experimental.ai</groupId>
    <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
    <version>0.7.1-SNAPSHOT</version>
</dependency>