概述 - AgentKit 文档

VeADK Go 是面向 Go 开发者的智能体开发框架。它在 ADK Go 的智能体、Runner、会话和事件流之上，补充火山方舟模型配置、工具、记忆、知识库、可观测和应用封装能力，让 Go 应用可以直接嵌入或对外提供智能体能力。 Preview 文档跟随 veadk-go 主线。当前主线模块路径为 github.com/volcengine/veadk-go/v2，面向新项目；github.com/volcengine/veadk-go V1 只作为维护线，适合暂时无法迁移的存量项目。

适用场景

使用 Go 构建能够调用模型、工具、知识库或记忆的智能体；
在服务端代码中通过 Runner 直接调用智能体，并控制用户、会话和事件流；
使用 Workflow Agent 编排顺序、并行或循环执行流程；
将智能体封装为 Simple App、A2A App 或 AgentKit Server App；
为智能体接入 OpenTelemetry、APMPlus、Cozeloop 等可观测能力。

版本线

版本线	模块路径	ADK 依赖	分支	适用场景
V2	`github.com/volcengine/veadk-go/v2`	`google.golang.org/adk/v2`	`main`	新项目默认选择。当前 Preview 文档以该版本线为准。
V1	`github.com/volcengine/veadk-go`	`google.golang.org/adk`	`release/v1`	存量 V1 项目维护，主要接收兼容性、安全和关键修复。

Preview 文档用于展示当前 V2 能力。生产项目应固定到已发布版本或经过确认的提交。

核心模块

模块	作用
`agent/llmagent`	创建默认 LLM 智能体，接入模型、提示词、工具、技能、知识库和长期记忆。
`runner`	在 Go 代码中直接运行智能体，管理应用名、用户、会话、事件流、短期会话和长期记忆。
`agent/workflowagents`	创建顺序、并行和循环工作流智能体。
`tool/builtin_tools`	提供 Web Search、Web Fetch、Link Reader、MCP、图像、视频、语音、代码执行等内置工具。
`memory`	提供短期会话和长期记忆封装，支持多种本地或外部存储后端。
`knowledgebase`	构建知识库并通过工具让智能体检索外部资料。
`observability`	接入 OpenTelemetry，并导出到 stdout、文件、APMPlus、Cozeloop、TLS 或 OTLP 端点。
`apps`	将智能体封装为 HTTP App、A2A App 或 AgentKit Server App。

使用路径

目标	文档
安装并配置 VeADK Go	安装
运行第一个智能体	快速开始
查看主线变化	更新日志

最后修改于 2026年10月20日