volcengine · yaozheng-fang · Jan 6, 2026 · Jan 4, 2026 · Jan 5, 2026 · Jan 5, 2026
diff --git a/docs/docs/agent/agent-to-agent.md b/docs/docs/agent/agent-to-agent.md
@@ -32,8 +32,8 @@ title: A2A Agent
 
 | 场景名称 | 说明 |
 | - | - |
-| **内部代码组织** | 您在单个 Agent 内将复杂任务拆分为更小、可管理的函数或模块，这类场景出于性能与简洁考虑，更适合作为本地子 |
-| **性能关键的内部操作** | 某个 Sub Agent 负责与主 Agent 执行紧密耦合的高频、低延迟操作，这类场景由于需要低延迟响应，更适合作为本地Local Sub-Agents |
+| **内部代码组织** | 您在单个 Agent 内将复杂任务拆分为更小、可管理的函数或模块，这类场景出于性能与简洁考虑，更适合作为本地 Local Sub-Agents |
+| **性能关键的内部操作** | 某个 Sub Agent 负责与主 Agent 执行紧密耦合的高频、低延迟操作，这类场景由于需要低延迟响应，更适合作为本地 Local Sub-Agents |
 | **共享内存或上下文** | 当 Sub Agent 需要直接访问主 Agent 的内部状态或共享内存以提高效率时，A2A 的网络开销与序列化/反序列化会适得其反 |
 | **简单的辅助函数** | 对于无需独立部署或复杂状态管理的小型复用逻辑，直接在同一 Agent 中编写函数或类，通常比拆分为独立的 A2A Agent 更合适 |
 

diff --git a/docs/docs/configuration.md b/docs/docs/configuration.md
@@ -142,9 +142,13 @@ veidentity:
 | 名称 | 值 | 释义 |
 |------|----|------|
 | DEFAULT_AGENT_NAME | `veAgent` | Agent 的缺省名称 |
-| DEFAULT_MODEL_AGENT_NAME | `doubao-seed-1-6-250615` | Agent 的推理模型名称 |
-| DEFAULT_MODEL_AGENT_PROVIDER | `openai` | Agent 的推理模型提供商 |
+| DEFAULT_MODEL_AGENT_NAME | `doubao-seed-1-6-251015` | Agent 的推理模型名称 |
+| DEFAULT_MODEL_AGENT_PROVIDER | `openai` | Agent 的推理模型提供商，方舟平台兼容 openai 规范，因此使用方舟默认是 openai 即可 |
 | DEFAULT_MODEL_AGENT_API_BASE | `https://ark.cn-beijing.volces.com/api/v1/` | 模型 API 基础地址 |
+| DEFAULT_IMAGE_GENERATE_MODEL_NAME | `doubao-seedream-4-5-251128` | image_generate 工具默认使用的方舟生图模型 |
+| DEFAULT_IMAGE_GENERATE_MODEL_API_BASE | `https://ark.cn-beijing.volces.com/api/v3/` | image_generate 工具默认使用的方舟生图模型 API 基础地址 |
+| DEFAULT_VIDEO_MODEL_NAME | `doubao-seedance-1-5-pro-251215` | video_generate 工具默认使用的方舟视频生成模型 |
+| DEFAULT_VIDEO_MODEL_API_BASE | `https://ark.cn-beijing.volces.com/api/v3/` | video_generate 工具默认使用的方舟视频生成模型 API 基础地址 |
 | DEFAULT_APMPLUS_OTEL_EXPORTER_ENDPOINT | `http://apmplus-cn-beijing.volces.com:4317` | APMPlus OpenTelemetry Trace 导出地址 |
 | DEFAULT_APMPLUS_OTEL_EXPORTER_SERVICE_NAME | `veadk_tracing` | APMPlus 服务名 |
 | DEFAULT_COZELOOP_OTEL_EXPORTER_ENDPOINT | `https://api.coze.cn/v1/loop/opentelemetry/v1/traces` | CozeLoop OTEL Trace 上报地址 |
@@ -155,5 +159,5 @@ veidentity:
 | DEFAULT_CR_REPO_NAME | `veadk-user-repo` | 容器镜像仓库名称 |
 | DEFAULT_TLS_LOG_PROJECT_NAME | `veadk-logs` | TLS 日志项目名称 |
 | DEFAULT_TLS_TRACING_INSTANCE_NAME | `veadk-tracing` | TLS Tracing 实例名称 |
-| DEFAULT_TOS_BUCKET_NAME | `veadk-default-bucket` | 默认 TOS 存储桶名称 |
+| DEFAULT_TOS_BUCKET_NAME | `veadk-default-bucket` | 默认 TOS 存储桶名称，由于 TOS 存储桶全球唯一，因此强烈建议用户自定义存储桶名称，避免与其他用户冲突导致运行失败 |
 | DEFAULT_COZELOOP_SPACE_NAME | `VeADK Space` | CozeLoop 空间名称 |
diff --git a/docs/docs/index.md b/docs/docs/index.md
@@ -116,7 +116,7 @@ hide:
 
     ---
 
-    提供短期记忆与长期记忆的完整解决方案：短期记忆可基于 MySQL 实现持久化存储；长期记忆则依托 Viking DB、云搜索服务构建。VeADK 以 LlamaINdex 作为知识库核心处理入口，同时支持 Viking 知识库后端无缝接入。
+    提供短期记忆与长期记忆的完整解决方案：短期记忆可基于 MySQL 实现持久化存储；长期记忆则依托 Viking DB、云搜索服务构建。VeADK 以 LlamaIndex 作为知识库核心处理入口，同时支持 Viking 知识库后端无缝接入。
 
 -   :material-toolbox:{ .lg .middle } __内置丰富工具和生态集成__
 

diff --git a/docs/docs/memory/long-term-memory.md b/docs/docs/memory/long-term-memory.md
@@ -17,13 +17,16 @@ title: 长期记忆
 
 ## 支持后端类型
 
-| 类别         | 说明                                                       |
+调试可以用 `local` 后端。生产更建议使用 `viking` 或 `mem0` 后端。
+
+| 类别         | 说明                                                        |
 | :----------- | :--------------------------------------------------------- |
-| `local`      | 内存跨 Session 记忆，程序结束后即清空                      |
-| `opensearch` | 使用 OpenSearch 作为长期记忆存储，可实现持久化和检索       |
-| `redis`      | 使用 Redis 作为长期记忆存储，Redis 需要支持 Rediseach 功能 |
-| `viking`     | 使用 VikingDB 记忆库产品作为长期记忆存储                   |
-| `viking_mem` | 已废弃，设置后将会自动转为 `viking`                        |
+| `local`      | 内存跨 Session 记忆，程序结束后即清空 (仅适用于本地调试)            |
+| `viking`     | 使用 VikingDB 记忆库产品作为长期记忆存储 (生产推荐)              |
+| `mem0`       | 使用 Mem0 记忆库产品作为长期记忆存储 (生产推荐)                  |
+| `viking_mem` | 已废弃，设置后将会自动转为 `viking`                            |
+| `opensearch` | 使用 OpenSearch 作为长期记忆存储，可实现持久化和检索             |
+| `redis`      | 使用 Redis 作为长期记忆存储，Redis 需要支持 Rediseach 功能      |
 
 ## 初始化方法
 

diff --git a/docs/docs/memory/short-term-memory.md b/docs/docs/memory/short-term-memory.md
@@ -211,15 +211,23 @@ VeADK 中，您可以使用如下短期记忆后端服务来初始化您的短
 ```python
 from google.adk.apps.app import App
 from google.adk.apps.app import EventsCompactionConfig
+from veadk.agent import Agent
+
+root_agent = Agent(
+    description="hello world agent",
+    instruction="""你是一个智能助手，擅长用中文礼貌回复用户的问题。""",
+)
 
 app = App(
-    name='my-agent',
+    name='my_agent',
     root_agent=root_agent,
     events_compaction_config=EventsCompactionConfig(
         compaction_interval=3,  # 每 3 次新调用触发一次压缩。
         overlap_size=1          # 包含前一个窗口的最后一次事件重叠。
     ),
 )
+
+root_agent = agent
 ```
 
 ### 定义压缩器

diff --git a/docs/docs/veadk.md b/docs/docs/veadk.md
@@ -41,7 +41,7 @@ graph LR
 
 ## VeADK 体系结构
 
-VeADK 基于模块化设计，主要组件包括：智能体运行时、工具、记忆系统、知识库、观测系统、评测系统等。各组件通过明确的接口进行解耦，以便在不同业务场景下替换或扩展。
+VeADK 基于模块化设计，主要组件包括：执行引擎、工具、记忆系统、知识库、观测系统、评测系统等。各组件通过明确的接口进行解耦，以便在不同业务场景下替换或扩展。
 
 ### 核心组件
 

diff --git a/veadk/consts.py b/veadk/consts.py
@@ -58,7 +58,7 @@
 DEFAULT_TLS_LOG_PROJECT_NAME = "veadk-logs"
 DEFAULT_TLS_TRACING_INSTANCE_NAME = "veadk-tracing"
 
-DEFAULT_TOS_BUCKET_NAME = "ark-tutorial"
+DEFAULT_TOS_BUCKET_NAME = "veadk-default-bucket"
 
 DEFAULT_COZELOOP_SPACE_NAME = "VeADK Space"
-Original file line number
+Diff line change
@@ Expand Up / @@ -116,7 +116,7 @@ hide: @@
         ---
-        提供短期记忆与长期记忆的完整解决方案：短期记忆可基于 MySQL 实现持久化存储；长期记忆则依托 Viking DB、云搜索服务构建。VeADK 以 LlamaINdex 作为知识库核心处理入口，同时支持 Viking 知识库后端无缝接入。
+        提供短期记忆与长期记忆的完整解决方案：短期记忆可基于 MySQL 实现持久化存储；长期记忆则依托 Viking DB、云搜索服务构建。VeADK 以 LlamaIndex 作为知识库核心处理入口，同时支持 Viking 知识库后端无缝接入。
     -   :material-toolbox:{ .lg .middle } __内置丰富工具和生态集成__
@@ Expand Down @@