Runner 执行一次对话。
前置条件
- 已完成安装,并在项目中添加
com.volcengine.veadk:veadk-java - 已准备火山方舟或 OpenAI 兼容模型服务的 API Key,并拥有所选模型的调用权限
- 以下命令使用 Bash 或 zsh;配置与运行命令应在同一终端执行
配置模型凭证
在当前终端导出模型 API Key:modelApiBase(...) 或 modelBaseUrl(...) 覆盖。
编写最小智能体
在你的 Maven 项目中创建Main.java:
Agent.builder() 是 VeADK Java 的主要入口。new Runner(agent).run(...) 会创建默认用户与会话,执行一次阻塞式调用,并返回最终文本。
使用 Ark 专用适配器
只有需要 Ark 专用ArkLlm 适配器时,才显式指定 modelProvider("ark"):
运行仓库示例
在veadk-java 源码仓根目录运行基础 Agent 示例:
Agent,注册 Java 函数工具,并调用 Runner.run(...)。
启动 ADK Web 示例:
http://localhost:8000。
使用会话继续对话
需要在多轮对话中延续上下文时,复用相同的userId 和 sessionId:
Runner.run(String) 使用默认用户并自动创建会话;显式传入 userId 和 sessionId 可以控制会话归属和复用。