veadk-java

一款集成火山引擎强大能力的开源智能体（Agent）开发工具包。

快速开始

环境要求

JDK 17 或以上版本

<dependency>
    <groupId>com.volcengine.veadk</groupId>
    <artifactId>veadk-java</artifactId>
    <version>0.0.1</version>
</dependency>

public class QuickstartAgentExample {
    public static void main(String[] args) {
        // Use an Ark model (replace with a model name available in your Ark Console)
        BaseAgent agent = LlmAgent.builder()
            .name("quickstart-agent")
            .instruction("You are a helpful assistant.")
            .model(new ArkLlm("doubao-seed-1-8-preview-251115"))
            .build();

        Runner runner = new Runner(agent);

        Session session = runner.sessionService()
            .createSession(runner.appName(), "userId", null, "sessionId")
            .blockingGet();

        // Build a simple conversation
        Content userMsg = Content.fromParts(Part.fromText("hello!"));
        RunConfig runConfig = RunConfig.builder().setStreamingMode(RunConfig.StreamingMode.NONE).build();
        Flowable<Event> events = runner.runAsync(session.userId(), session.id(), userMsg, runConfig);

        // Print the final reply
        events.blockingForEach(e -> {
            if (e.finalResponse()) System.out.println(e.stringifyContent());
        });
    }
}

必需环境变量

示例工程在运行前需要配置以下环境变量（缺失时会抛出明确错误）：

MODEL_AGENT_API_KEY：火山方舟服务的 API Key（ArkLlm 使用）

示例设置（macOS / Linux）：

export MODEL_AGENT_API_KEY="<your-ark-api-key>"

运行项目示例

构建项目

在仓库根目录执行：./mvnw clean -DskipTests package

构建完成后，example/target 会生成示例所需的编译产物。

运行示例（CLI）

示例入口：com.volcengine.veadk.example.AgentCliRunner。

运行方式（无需修改 POM，直接通过 Maven Exec 插件坐标）：

./mvnw -pl example -q compile exec:java -Dexec.mainClass=com.volcengine.veadk.example.AgentCliRunner

交互说明：

启动后按提示输入对话内容，与 ArkAgent 进行交互。
输入 quit 退出。

运行示例（Web UI）

启动命令：

./mvnw -pl example -q compile exec:java \
    -Dexec.mainClass="com.google.adk.web.AdkWebServer" \
    -Dexec.args="--adk.agents.source-dir=example/target --server.port=8000"

访问地址：http://localhost:8000

在 IDE 中运行

使用 IntelliJ IDEA 或 Eclipse 导入 Maven 多模块工程。
直接运行 AgentCliRunner 或 AdkWeb 的 main 方法即可。
确保在 IDE 的运行配置中注入必需环境变量（或使用 shell 启动 IDE）。
如果需要使用web search、viking memory、viking knowledgebase，需要配置环境变化：
- VOLCENGINE_ACCESS_KEY：火山引擎AccessKey
- VOLCENGINE_SECRET_KEY：火山引擎SecretKey
如果需要使用TLS Trace，除了AK/SK，还需要配置TLS Topic
- OBSERVABILITY_OPENTELEMETRY_TLS_SERVICE_NAME：TLS服务trace日志主题的id