langgraph4j

环境要求

• JDK 17 或更高版本（1.9.x、1.8.x 的 Java baseline 均为 17+）
• Maven 项目（README 只提供 Maven 依赖方式）
• 如需运行 Agent 示例，需本地可用的 Ollama 服务，示例默认地址 http://localhost:11434
• 可选：与 LangChain4j 或 Spring AI 集成时，需要对应的依赖模块

安装与启动步骤

1. 1确认 Java 版本

   安装 JDK 17 或以上版本，并确保 MAVEN 编译使用的也是该版本，否则无法使用 1.9.x / 1.8.x 任何版本。

2. 2引入 BOM 管理版本

   在 pom.xml 的 properties 中定义 langgraph4j.version，并通过 dependencyManagement 导入 langgraph4j-bom，统一管理各模块版本。

   
       1.9.3 
   
   
   
   
     
       
         org.bsc.langgraph4j
         langgraph4j-bom
         ${langgraph4j.version}
         pom
         import
       
     
   

   复制

3. 3添加核心依赖

   在 pom.xml 的 dependencies 中加入 langgraph4j-core（BOM 已管理版本，无需再写 version）；按需再添加 langgraph4j-langchain4j 等模块。

   
       
           org.bsc.langgraph4j
           langgraph4j-core
       
       
   

   复制

4. 4改用快照版本

   想用最新未发布特性时使用 snapshot 版本，并需在 pom.xml 或 settings.xml 中配置 Sonatype OSS 快照仓库。

   
       
           sonatype-oss-snapshots
           https://central.sonatype.com/repository/maven-snapshots
           
               true
           
       
   

   复制

5. 5选择运行方式

   编译好的图有两种执行方法：stream 返回 AsyncGenerator，每个元素是某节点执行完后的状态；invoke 返回 CompletableFuture，完成时给出到达 END 的最终状态。

   stream(S initialState, RunnableConfig config)
   
   invoke(S initialState, RunnableConfig config)

   复制

6. 6运行你的第一个图

   调用 compile() 得到可执行图，再用 stream 或 invoke 传入初始状态 Map 与 RunnableConfig；示例用 forEachAsync 打印每一步状态。

   agent.stream( Map.of( "messages", "perform test twice and return number of current active threads" ) )
                   .forEachAsync( item -> System.out.println( item ));

   复制

7. 7接入 Ollama 模型

   README 的 Agent 示例使用 OllamaChatModel 构建 chatModel，默认 baseUrl 为 http://localhost:11434，再通过 AgentExecutor 绑定工具并 compile。

   var model = OllamaChatModel.builder()
                   .modelName(  )
                   .baseUrl("http://localhost:11434")
                   .supportedCapabilities(Capability.RESPONSE_FORMAT_JSON_SCHEMA)
                   .logRequests(true)
                   .logResponses(true)
                   .maxRetries(2)
                   .temperature(0.0)
                   .build();
   
   var agent = AgentExecutor.builder()
               .chatModel(model)
               .toolsFromObject(new TestTool())
               .build()
               .compile();

   复制

8. 8可视化调试

   README 提供可嵌入的 Web 应用 Langgraph4j Studio，用于可视化与实验图结构，需访问官网 studio 页面获取入口。

关键配置

如何确认成功

调用 invoke() 后 CompletableFuture 正常完成并返回最终状态，或 stream() 能逐个打印节点完成后的状态且无异常，即表示配置成功。

常见问题

注意事项

• README 只给出 Maven 依赖方式，未提供 Gradle 或命令行脚手架，请勿臆造其他安装命令。
• 版本号请以 Maven Central（central.sonatype.com 搜索 g:org.bsc.langgraph4j）实际最新版本为准，示例中的 1.9.3 需自行核对。
• 1.9.x 包含实验性新特性以准备迁移到 2.0，生产环境建议评估后再升级，或用 1.8.x LTS。
• 示例中的 Ollama 模型名、工具类与运行地址需按你本地实际环境替换。