跳转到主要内容
github.com/volcengine/veadk-go/v2/runner 用于在 Go 代码中直接运行智能体。它封装 ADK Go Runner,并补充默认会话服务、长期记忆自动接线、保存会话到长期记忆、文本响应收集和多模态输入 helper。

最小调用

当你只需要把一段文本发给智能体并拿到最终文本响应时,使用 RunText:
runner.New 要求 Agent 必填;如果没有传 SessionService,会默认使用 session.InMemoryService()。多轮对话时,复用相同的 userID 和 sessionID。

消费事件流

需要流式 UI、工具调用观察、artifact 或底层 ADK 事件时,使用 Run。Run 返回事件序列;如果只想把事件流收集成最终文本,可以用 CollectFinalText。
多 part 或多模态输入可以用 helper 构造:

Runner 配置

context、userID 和 sessionID

context.Context 是 Go 标准取消、超时和请求作用域上下文,不是对话上下文。对话历史由 userID、sessionID 和 SessionService 决定。

直接 Runner 与 App

直接 runner.New 适合嵌入自己的 Go 流程,例如后端 handler、worker、CLI 或测试。apps/simple_app、apps/a2a_app、apps/agentkit_server_app 适合启动 VeADK 提供的 HTTP / A2A / AgentKit 服务面。
最后修改于 2026年10月20日