> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 概述

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 项目维护，主要接收兼容性、安全和关键修复。 |

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

## 核心模块

| 模块 | 作用 |
| - | - |
| `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 | [安装](/productions/veadk-go/preview/zh/get-started/installation) |
| 运行第一个智能体 | [快速开始](/productions/veadk-go/preview/zh/get-started/quickstart) |
| 查看主线变化 | [更新日志](/productions/veadk-go/preview/zh/changelog) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.