Java SDK 概览

Java SDK（agent-cli-sdk）让 Java 程序直接驱动 dcl：在自己的服务里发起任务、读取流式结果、审批工具调用，并把 JVM 里的方法作为工具提供给 Agent。

SDK 通过子进程启动 CLI，在标准输入输出上使用 stream-json 控制协议通信，因此：

零依赖：不依赖任何第三方库，支持 Java 8 及以上版本，可以放进任何现有工程。
行为一致：工具、权限、Hook、MCP 和会话都由 dcl 执行，与命令行使用时相同。
不绑定具体 CLI：任何实现了 stream-json 控制协议的可执行文件都可以使用。

能做什么

一次性查询和长连接会话（多轮对话、排队消息、中断）
类型化消息：SystemMessage、AssistantMessage、UserMessage、ResultMessage、StreamEvent
工具权限回调，可以改写工具输入、附带权限规则
Hook 回调，例如 PreToolUse、PostToolUse、UserPromptSubmit
进程内 MCP 服务器：在 JVM 里实现工具
子 Agent 定义、结构化输出和部分消息流
会话控制：切换模型和权限模式、查询上下文用量、回退文件等

安装

xml

<dependency>
  <groupId>nexus.io</groupId>
  <artifactId>agent-cli-sdk</artifactId>
  <version>使用最新发布的版本</version>
</dependency>

也可以从源码安装到本地 Maven 仓库：

bash

mvn clean install -DskipTests -Dgpg.skip

运行前先安装 dcl 并配置模型提供商。

第一个程序

java

import java.io.File;

import nexus.io.agent.sdk.Agent;
import nexus.io.agent.sdk.AgentOptions;
import nexus.io.agent.sdk.PermissionMode;
import nexus.io.agent.sdk.message.AssistantMessage;
import nexus.io.agent.sdk.message.ResultMessage;

public class QuickStart {
  public static void main(String[] args) {
    AgentOptions options = new AgentOptions()
        .cliPath("dcl")
        .cwd(new File("."))
        .permissionMode(PermissionMode.ACCEPT_EDITS)
        .allowedTools("Read", "Grep", "Glob");

    ResultMessage result = Agent.query("总结 README.md 的内容", options, message -> {
      if (message instanceof AssistantMessage) {
        System.out.print(((AssistantMessage) message).getText());
      }
    });
    System.out.println();
    System.out.println("结果: " + result.getResult());
    System.out.println("轮次: " + result.getNumTurns());
  }
}

cliPath 也可以省略，改用环境变量 AGENT_CLI_PATH 指定 CLI 路径。

Java SDK 概览 ​

能做什么 ​

安装 ​

第一个程序 ​

接下来 ​

Java SDK 概览

能做什么

安装

第一个程序

接下来