From 1c976d98990d30554a980d8db8db52774ce10959 Mon Sep 17 00:00:00 2001 From: warm-wm Date: Sun, 4 Jan 2026 20:36:53 +0800 Subject: [PATCH 1/4] fix: udpate some typo of docs --- docs/docs/agent/agent-to-agent.md | 4 ++-- docs/docs/index.md | 2 +- docs/docs/veadk.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/docs/agent/agent-to-agent.md b/docs/docs/agent/agent-to-agent.md index 3d3d4cc6..eef52c7c 100644 --- 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/index.md b/docs/docs/index.md index a87c04c9..3bb8acb2 100644 --- 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/veadk.md b/docs/docs/veadk.md index a391b59c..72470eba 100644 --- a/docs/docs/veadk.md +++ b/docs/docs/veadk.md @@ -41,7 +41,7 @@ graph LR ## VeADK 体系结构 -VeADK 基于模块化设计，主要组件包括：智能体运行时、工具、记忆系统、知识库、观测系统、评测系统等。各组件通过明确的接口进行解耦，以便在不同业务场景下替换或扩展。 +VeADK 基于模块化设计，主要组件包括：执行引擎、工具、记忆系统、知识库、观测系统、评测系统等。各组件通过明确的接口进行解耦，以便在不同业务场景下替换或扩展。 ### 核心组件 From b552d02b5feffffab3709a443b55decadba2c570 Mon Sep 17 00:00:00 2001 From: warm-wm Date: Mon, 5 Jan 2026 11:08:01 +0800 Subject: [PATCH 2/4] fix: udpate default config --- docs/docs/configuration.md | 10 +++++++--- veadk/consts.py | 2 +- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/docs/configuration.md b/docs/docs/configuration.md index 5428060d..efc03851 100644 --- 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/veadk/consts.py b/veadk/consts.py index 209c81e3..2d22bca4 100644 --- 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" From a826e201cc7d306364834cc5e591b3bc944f52fe Mon Sep 17 00:00:00 2001 From: warm-wm Date: Mon, 5 Jan 2026 17:51:28 +0800 Subject: [PATCH 3/4] fix: udpate short term memory sample --- docs/docs/memory/short-term-memory.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/docs/memory/short-term-memory.md b/docs/docs/memory/short-term-memory.md index f2d37ff7..6f3e1083 100644 --- 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 ``` ### 定义压缩器 From ff16e25438ca681ea29de9b50fa6759f08102e33 Mon Sep 17 00:00:00 2001 From: warm-wm Date: Mon, 5 Jan 2026 19:26:45 +0800 Subject: [PATCH 4/4] fix: udpate long term memory backend --- docs/docs/memory/long-term-memory.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/docs/memory/long-term-memory.md b/docs/docs/memory/long-term-memory.md index ea0aa82e..6e36d4c1 100644 --- 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 功能 | ## 初始化方法