LangChain4j从入门到精通-2-langchain快速上手

0 阅读2分钟

LangChain4j从入门到精通-2-langchain快速上手

想快速掌握LangChain4j这一强大的Java AI开发库吗?本文是《LangChain4j从入门到精通》系列的第二篇,聚焦实战快速上手。内容涵盖:依赖配置(Maven/Gradle详解)、BOM管理、快照版本尝鲜技巧、OpenAI API密钥安全设置(附免费demo密钥),并通过“Hello World”聊天示例直观演示开发流程。无论你是Quarkus、Spring Boot还是Helidon用户,文内均提供了对应集成指引。跟着步骤操作,10分钟内即可完成环境搭建与第一个AI对话,助力开发者高效整合大语言模型到Java应用!

#AI开发 #Java #LangChain4j #教程 #快速上手

::: 注意 如果您正在使用 Quarkus, 请参考 Quarkus Integration.

如果您正在使用 Spring Boot, 请参考 Spring Boot Integration.

如果您正在使用 Helidon, 请参考 Helidon Integration

:::

LangChain4j 提供与众多 LLM 提供商、 嵌入/向量存储等的集成。 每个集成都有其独立的 Maven 依赖项。 最低支持的 JDK 版本为 17。

下面我们导入OpenAI依赖项:

  • Maven pom.xml:
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-open-ai</artifactId>
    <version>1.10.0</version>
</dependency>

如果你想使用高级AI服务API,还需要添加以下依赖项:

<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j</artifactId>
    <version>1.10.0</version>
</dependency>

对于build.gradle中的Gradle:

implementation 'dev.langchain4j:langchain4j-open-ai:1.10.0'
implementation 'dev.langchain4j:langchain4j:1.10.0'
BOM添加
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>dev.langchain4j</groupId>
            <artifactId>langchain4j-bom</artifactId>
            <version>1.10.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

:::注意 请注意,langchain4j-bom始终包含所有 LangChain4j 模块的最新版本。 :::

:::注意 虽然 langchain4j-bom的版本是1.10.0,但许多模块的版本仍为 1.10.0-beta18,因此这些模块未来可能会出现一些破坏性变更。 :::

快照依赖项(最新功能)

如果你想在正式发布前测试最新功能,可以使用最新的 SNAPSHOT依赖项:

<repositories>
  <repository>
    <name>Central Portal Snapshots</name>
    <id>central-portal-snapshots</id>
    <url>https://central.sonatype.com/repository/maven-snapshots/</url>
    <releases>
      <enabled>false</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>dev.langchain4j</groupId>
        <artifactId>langchain4j</artifactId>
        <version>1.10.0-SNAPSHOT</version>
    </dependency>
</dependencies>
然后,导入您的OpenAI API密钥。建议将API密钥存储在环境变量中,以降低公开暴露的风险。
String apiKey = System.getenv("OPENAI_API_KEY");
如果没有API密钥怎么办?

如果你没有自己的OpenAI API密钥,别担心。 你可以暂时使用我们免费提供的demo密钥进行演示。 请注意,使用demo密钥时,所有对OpenAI API的请求都需要经过我们的代理服务器,代理会在转发请求前注入真实密钥。 我们不会以任何方式收集或使用你的数据。 demo密钥有使用限额,仅限gpt-4o-mini模型,且仅供演示用途。

OpenAiChatModel model = OpenAiChatModel.builder()
    .baseUrl("http://langchain4j.dev/demo/openai/v1")
    .apiKey("demo")
    .modelName("gpt-4o-mini")
    .build();

设置好密钥后,我们来创建一个OpenAiChatModel的实例:

OpenAiChatModel model = OpenAiChatModel.builder()
    .apiKey(apiKey)
    .modelName("gpt-4o-mini")
    .build();

现在,是时候聊天了!

String answer = model.chat("Say 'Hello World'");
System.out.println(answer); // Hello World