快速开始

NOTE

如果你使用的是 Quarkus，请参阅 Quarkus 集成。

如果你使用的是 Spring Boot，请参阅 Spring Boot 集成。

如果你使用的是 Helidon，请参阅 Helidon 集成

LangChain4j 提供了与众多 LLM 提供者、 嵌入/向量存储 等的集成。 每个集成都有各自的 maven 依赖。

最低支持的 JDK 版本为 17。

作为一个例子，我们来导入 OpenAI 依赖：

• 在 pom.xml 中的 Maven 写法：

<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-open-ai</artifactId>
    <version>1.22.0</version>
</dependency>

如果你希望使用高层的 AI 服务 API，还需要添加 以下依赖：

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

• 在 build.gradle 中的 Gradle 写法：

implementation 'dev.langchain4j:langchain4j-open-ai:1.22.0'
implementation 'dev.langchain4j:langchain4j:1.22.0'

物料清单（Bill of Materials，BOM）

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>dev.langchain4j</groupId>
            <artifactId>langchain4j-bom</artifactId>
            <version>1.22.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

NOTE

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

NOTE

请注意，虽然 langchain4j-bom 的版本为 1.22.0， 但许多模块的版本仍是 1.22.0-beta32， 因此这些模块未来可能会有些破坏性变更。

SNAPSHOT 依赖（最新特性）

如果你想在正式发布前体验最新特性， 可以使用最新的 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.22.0-SNAPSHOT</version>
    </dependency>
</dependencies>

然后，导入你的 OpenAI API key。 建议将 API key 存放在环境变量中，以降低被公开泄露的风险。

String apiKey = System.getenv("OPENAI_API_KEY");

设好 key 之后，我们来创建一个 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