跳转到主要内容
本教程介绍如何创建一个最小 VeADK Java 智能体,并通过 Runner 执行一次对话。

前置条件

  • 已完成安装,并在项目中添加 com.volcengine.veadk:veadk-java
  • 已准备火山方舟或 OpenAI 兼容模型服务的 API Key,并拥有所选模型的调用权限
  • 以下命令使用 Bash 或 zsh;配置与运行命令应在同一终端执行

配置模型凭证

在当前终端导出模型 API Key:
如果不显式配置 provider,VeADK Java 默认使用 OpenAI-compatible 路径。默认 base URL 是火山方舟 OpenAI-compatible endpoint;需要使用 OpenAI 官方、LiteLLM Proxy 或内部兼容网关时,可以通过 modelApiBase(...) 或 modelBaseUrl(...) 覆盖。

编写最小智能体

在你的 Maven 项目中创建 Main.java:
Agent.builder() 是 VeADK Java 的主要入口。new Runner(agent).run(...) 会创建默认用户与会话,执行一次阻塞式调用,并返回最终文本。

使用 Ark 专用适配器

只有需要 Ark 专用 ArkLlm 适配器时,才显式指定 modelProvider("ark"):
如果使用 OpenAI 官方、LiteLLM Proxy 或内部 OpenAI-compatible 网关,则把 base URL 指向对应 endpoint:

运行仓库示例

在 veadk-java 源码仓根目录运行基础 Agent 示例:
该示例会创建一个 Ark 模型驱动的 Agent,注册 Java 函数工具,并调用 Runner.run(...)。 启动 ADK Web 示例:
默认访问地址是 http://localhost:8000。

使用会话继续对话

需要在多轮对话中延续上下文时,复用相同的 userId 和 sessionId:
默认情况下,Runner.run(String) 使用默认用户并自动创建会话;显式传入 userId 和 sessionId 可以控制会话归属和复用。

排查首次运行问题

最后修改于 2026年10月20日