1.1.0
VeADK 1.1.0 发布于 2026 年 8 月 7 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio 云服务商 | veadk studio、veadk frontend、veadk studio deploy 和 veadk studio update 新增 --provider 选项，可选择 volcengine（默认）或 byteplus；选择 BytePlus 时使用 BYTEPLUS_ACCESS_KEY、BYTEPLUS_SECRET_KEY 和可选的 BYTEPLUS_SESSION_TOKEN 提供凭证，Runtime 列表默认地域为 BYTEPLUS_REGION 或 ap-southeast-1。veadk studio deploy 和 veadk studio update 新增 --byteplus-access-key、--byteplus-secret-key 和 --byteplus-session-token 选项。 | Studio 智能体工作台 · VeADK Frontend |
| Studio 部署 | veadk studio deploy 新增 --vefaas-application-template-id 选项覆盖内置 VeFaaS Application Center 模板 ID，以及 --keep-failed-deploy 标志在部署失败时保留已创建资源便于排查；--region 新增 ap-southeast-1。veadk studio update 新增 --volcengine-session-token 选项，--region 同样新增 ap-southeast-1。 | Studio 智能体工作台 |
| Studio 品牌 | veadk studio 和 veadk frontend 的默认系统名称由 VeADK Studio 改为 AgentKit Studio，默认 Logo 更新为 AgentKit 品牌 Logo；未通过 --site-title、--site-logo 或对应环境变量自定义时使用新默认值。 | Studio 智能体工作台 |
| Studio 部署 | 更新已有 Runtime 时保留其当前网络配置（网络模式、VPC、子网和共享公网），不再丢失。 | Studio 智能体工作台 |
| Studio 草稿 | 自定义创建的未发布智能体草稿保存在当前浏览器并按登录用户隔离；草稿在管理列表显示草稿与部署中标识，支持编辑和删除；草稿将 MCP 鉴权 Token 转换为环境变量引用保存，Token 值保留在部署环境变量中，YAML 导出与浏览器草稿均保留对应值。 | Studio 智能体工作台 |
| Studio MCP 鉴权 | MCP 工具的鉴权 Token 转换为环境变量引用：生成源码仅保留 ${ENV_NAME} 引用并通过 os.environ 读取，Token 值写入部署环境变量；更新已部署 Runtime 时重新加载已有环境变量值，在部署表单中输入新 Token 覆盖原有值。 | Studio 智能体工作台 |
| Studio Runtime 环境变量 | 更新已部署 Runtime 时保留已有环境变量值；选择 Runtime 目标进行调试测试时，将该 Runtime 的环境变量注入测试进程。 | Studio 智能体工作台 |
| Studio MCP Endpoint | MCP 工具的 HTTP Endpoint 不再自动补充 /mcp 路径；Studio 保留输入地址原样使用，地址不以 /mcp 结尾时显示提示。 | Studio 智能体工作台 |
| Studio 问题反馈 | 对话页面每条助手回复新增「问题反馈」入口，可针对单轮回复选择问题类型（执行速度慢、运行崩溃、结果不准确、工具调用失败或其他）并补充描述后上报，提交时携带该轮输入、输出、工具调用记录和链路信息并做凭据脱敏；侧边栏底部新增「问题反馈」入口（Beta），用于按所属模块反馈 Studio 整体使用问题。 | Studio 智能体工作台 |
| Studio 调用链路 | 对话页面助手回复旁的调用链路观测面板支持查看云端 Runtime 的链路：Studio 服务端使用自身火山引擎凭证向 APMPlus 查询会话链路，浏览器不接触凭证；通过 Studio 部署的 Runtime 默认启用 APMPlus 链路观测，未开启链路观测时打开面板会提示先在控制台开启。 | Studio 智能体工作台 |
| Studio 应用内更新 | Studio 固定从维护在北京地域的 veadk-studio TOS 发布源读取新版本，不再随部署地域变化；veadk studio deploy 移除 --studio-update-region 选项与 VEADK_STUDIO_UPDATE_REGION 环境变量，--studio-update-bucket 与 --studio-update-prefix 仍可覆盖发布源。 | Studio 智能体工作台 |
| Studio 自动化 | 侧边栏「自动化」页面新增「配置 Coding Agents」本地集成：检测本机已安装的 Trae、Claude Code 和 Codex 客户端，并将内置的 VeADK 开发与 AgentKit 平台操作 Skills 全局安装到对应客户端的 Skills 目录；浏览器只能选择固定标识，不接受任意命令或 Skill 内容。 | Studio 智能体工作台 |
| Studio 埋点 | veadk studio deploy 新增 --apmplus-aid、--apmplus-token、--apmplus-domain 与 --apmplus-env 选项（及对应环境变量）配置 APMPlus 前端埋点；同时提供 aid 与 token 后启用，默认关闭，上报失败不影响 Studio 使用；埋点仅采集使用统计维度，不采集对话内容、提示词、代码或密钥。 | Studio 智能体工作台 |
| Studio 埋点 | 扩展前端埋点覆盖范围：在实例加载、登录、智能体部署和沙箱创建之外，新增智能体连接、对话发送、调试测试和源码下载的成功与失败事件，并记录创建方式和是否使用智能生成；失败事件的错误摘要会自动脱敏密钥、令牌和密码后截取上报。 | Studio 智能体工作台 |
| Studio 创建 | 「添加智能体」菜单新增「从存量迁移」入口，用于将 LangChain、Dify 等存量项目迁移至 AgentKit Runtime，当前标记为「敬请期待」并禁用，暂不可用。 | Studio 智能体工作台 |
| Studio 自动化 | 侧边栏「自动化」页面新增模板项目导入、AgentKit Runtime 持续交付和 PR 自动评审三种 GitHub 自动化集成：通过浏览器直接调用 GitHub API 创建分支、文件和 Pull Request，为仓库添加持续交付工作流或自动评审工作流；GitHub Token 仅用于当前请求，不持久化。 | Studio 智能体工作台 |
| Studio 自动化 | 侧边栏「自动化」页面新增飞书机器人自动化（Beta）：填写飞书应用凭据后，Studio 生成基础智能体并直接部署到 AgentKit Runtime，启用飞书消息长连接；App Secret 仅用于本次部署，不写入生成源码或浏览器存储。 | Studio 智能体工作台 |
| Studio 记忆 | 自定义创建智能体时，长期记忆新增 OpenViking 后端，可在创建页配置服务地址、API Key、记忆归属 ID 和记忆策略，并写入生成项目的环境变量。 | Studio 智能体工作台 · 使用 OpenViking 存储 |
| 长期记忆 | OpenViking 长期记忆未配置 memory_policy 时不再使用 VeADK 内置默认策略，改为不向 OpenViking 发送策略，由服务端应用其官方默认策略。 | 使用 OpenViking 存储 |
| Studio 评测 | 部署智能体时新增「自动创建评测集」开关（默认开启），部署成功后自动为该智能体创建 Good Case 和 Bad Case 评测集；创建失败时在部署结果中显示警告，不影响已部署的 Runtime。 | Studio 智能体工作台 |
| Studio 评测 | 会话结束后自动评估每轮对话质量，调用模型从任务完成度、事实可靠性等维度评分（0–1），按评分归入 Good Case 或 Bad Case 评测集；自动评测案例标记为「自动回流」并展示评分与评分理由，可与手动反馈案例一起筛选和删除。 | Studio 智能体工作台 |
| Studio 评测 | 智能体工作台新增「优化项」标签，基于累计评测案例自动生成优化建议，按优先级和模块分组展示；评测模型可通过 VEADK_STUDIO_EVALUATION_MODEL 环境变量覆盖。 | Studio 智能体工作台 |
| Studio 部署 | 创建新 Runtime 时支持选择访问鉴权方式：默认使用 API Key，也可改用 VeIdentity 用户池；Studio 服务端加载当前账号可见的用户池并标记当前登录所用用户池，选择该用户池时由 Studio 转发登录 JWT，选择其他用户池时调用方需使用该用户池签发的 JWT；更新已有 Runtime 时保留其当前鉴权方式。 | Studio 智能体工作台 |
| Studio 沙箱 | veadk studio deploy 和 veadk studio update 新增 --sandbox-dev-tool-id 选项（及 SANDBOX_DEV 环境变量），用于指定或自动创建开发沙箱使用的 AgentKit DevEnv Tool；仅支持火山引擎部署，BytePlus 部署中传入会报错。 | Studio 智能体工作台 |
| Studio 沙箱 | 沙箱 Tool 的模型、接入地址和候选地域改为按云服务商区分：火山引擎使用 doubao-seed-2-1-pro-260628 模型与 https://ark.cn-beijing.volces.com/api/v3、候选地域 cn-beijing 与 cn-shanghai；BytePlus 使用 seed-2-0-lite-260228 模型与 https://ark.ap-southeast.bytepluses.com/api/v3、候选地域 ap-southeast-1。BytePlus 部署不再跳过沙箱 Tool 自动创建，改为与火山引擎一致地按服务商自动配置。 | Studio 智能体工作台 |
| Studio Codex 会话 | Codex 智能体对话中上传的图片附件现在会在对话中正确渲染预览，点击后通过共享图片查看器打开，不再出现重复预览。 | Studio 智能体工作台 |
| Studio 创建 | 使用 BytePlus 作为云服务商时，web_search 和 parallel_web_search 不出现在自定义创建和智能生成的内置工具列表中；火山引擎模式下不受影响。 | Studio 智能体工作台 |
| 网页搜索 | web_search 和 parallel_web_search 在 CLOUD_PROVIDER 设为 byteplus 时改用 BytePlus SearchInfinity API，通过 BYTEPLUS_WEB_SEARCH_API_KEY 提供凭证，可选 BYTEPLUS_WEB_SEARCH_URL 覆盖搜索端点。 | 网页搜索 |
| 长期记忆 | VikingDB 记忆后端 BytePlus 模式下区域固定为 cn-hongkong，不再受 DATABASE_VIKING_REGION 环境变量或显式传入值影响；凭证解析依次检查 AGENTKIT_CLOUD_PROVIDER 与 CLOUD_PROVIDER，设为 byteplus 时从 BYTEPLUS_ACCESS_KEY、BYTEPLUS_SECRET_KEY 和 BYTEPLUS_SESSION_TOKEN 读取。 | 使用 VikingDB 存储 |
| 知识库 | VikingDB 知识库后端 BytePlus 模式下区域改为按映射规则确定：未设置或中国大陆地域（cn-beijing、cn-shanghai、cn-guangzhou）自动映射为 cn-hongkong，其他地域保持原样；凭证解析依次检查 AGENTKIT_CLOUD_PROVIDER 与 CLOUD_PROVIDER，设为 byteplus 时从 BYTEPLUS_ACCESS_KEY、BYTEPLUS_SECRET_KEY 和 BYTEPLUS_SESSION_TOKEN 读取；新增 resource_id 构造参数与 DATABASE_VIKING_RESOURCE_ID 环境变量用于多资源场景请求路由。 | 使用 VikingDB 知识库存储 |
| 代码沙箱 | run_code 执行代码或 Shell 命令时，调用 AgentKit 的请求超时随 timeout 与 hard_timeout 自动延长，避免长耗时任务在固定超时下被提前中断。 | 代码沙箱 |
| 代码沙箱 | execute_skills 新增 invocation_mode 参数与环境变量 AGENTKIT_SKILL_INVOCATION_MODE，支持在 execute（默认）、run_sse、a2a 和 python_agent 四种调用模式之间切换技能沙箱后端；原 prefer_stream 参数已移除。 | 代码沙箱 |
| 模型 | CLOUD_PROVIDER 设为 byteplus 时，默认推理模型由 dola-seed-2-1-turbo-260628 改为 seed-2-0-lite-260228。 | 模型 |
| 模型 | CLOUD_PROVIDER 设为 byteplus 时，默认向量模型由 doubao-embedding-vision-250615 改为 skylark-embedding-vision-250615，接入地址改为 BytePlus 方舟。 | 模型 |
1.0.10
VeADK 1.0.10 发布于 2026 年 8 月 4 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio 智能体目录 | 智能体目录改为按类型标签切换并支持按名称搜索，跨全部地域加载当前用户的 Runtime 并在滚动时自动加载下一页；智能体卡片简化为名称与创建时间，已连接的智能体置顶显示，加载失败时可重新加载。 | Studio 智能体工作台 |
| Studio 部署 | 部署构建阶段在部署进度卡片中实时展示构建日志，支持展开、收起和复制；日志在服务端完成凭据脱敏与篇幅截断，构建失败时追加失败原因。 | Studio 智能体工作台 |
| Studio 沙箱会话 | 创建内置智能体或 Skill 的 Session、查找对应 Tool 时，优先使用 AGENTKIT_SANDBOX_REGION 指定的地域（默认 cn-beijing）；当该地域返回资源不存在时，自动回退到另一个支持地域（北京 ↔ 上海）继续操作，其他错误不触发回退。 | Studio 智能体工作台 |
| Studio 部署 | 部署到 AgentKit 时，根智能体描述会自动整理为符合 Runtime 规范的单行描述（至多 255 字节，去除换行、控制字符与不安全符号），完整描述保留在项目中；若整理后的描述被 Runtime 拒绝，会去掉描述后重试创建。 | Studio 智能体工作台 |
| Studio 部署与调试 | 构建或部署阶段失败时，工作台展示服务端返回的完整错误信息并默认展开，可复制；构建错误改用与部署错误一致的可展开错误面板呈现。 | Studio 智能体工作台 |
| Studio 角色权限 | 「管理智能体」页面与智能体选择器统一按登录账号的角色限制 Runtime 可见范围；管理员可见全部 Runtime，开发者与普通用户仅可见自己创建的。管理员浏览全部 Runtime 时，自己创建的 Runtime 标注「我创建的」。 | Studio 智能体工作台 |
| Studio 测试运行 MCP 端点 | 测试运行时自动规范化生成智能体中 HTTP MCP 工具的端点：URL 未以 /mcp 结尾时自动补全，并通过 Streamable HTTP 验证工具发现；连接失败时返回错误提示确认 URL 与 Token，画布中保存的原始 URL 不受影响。 | Studio 智能体工作台 |
| Studio 接入方式 | 智能体详情页新增「接入方法」标签，探测 Runtime 暴露的 API Server 与 A2A 协议端点，显示鉴权方式与 API Key（默认掩码，按需显式显示），并提供对应的 Python 调用示例。 | Studio 智能体工作台 |
| Studio 草稿 | 自定义创建的未发布智能体草稿保存在当前浏览器并按登录用户隔离；草稿在管理列表显示草稿与部署中标识，支持编辑和删除；草稿不保存 MCP 鉴权 Token 与部署环境变量值，刷新后需重新填写。 | Studio 智能体工作台 |
| Studio 部署 | veadk studio deploy 支持通过 --volcengine-session-token 传入 STS 临时凭证的 Session Token，部署凭据解析依次读取命令参数、VOLCENGINE_SESSION_TOKEN / VOLC_SESSIONTOKEN 环境变量和 ~/.volc/credentials 中 [default] 配置的 session_token 字段。 | Studio 智能体工作台 |
| 知识库 | OpenViking 知识库默认资源目录改为 viking://user/<openviking_user_id>/resources/<index>/，新增 openviking_user_id 构造参数与 DATABASE_OPENVIKING_USER_ID 环境变量用于隔离不同应用的资源；KnowledgeBase 新增 close() 方法用于释放后端客户端。 | 使用 OpenViking 存储 |
| 长期记忆 | OpenViking 长期记忆新增 openviking_user_id 作为 owner/context 标识并区分于 Runner.user_id（peer ID），新增 memory_policy 构造参数与 DATABASE_OPENVIKING_MEMORY_POLICY 环境变量用于覆盖默认记忆提取策略。 | 使用 OpenViking 存储 |
| Studio Codex 会话 | 内置 Codex 智能体对话新增专用会话控件：快捷命令、模型切换、Skill 调用、工作空间选择、Codex 权限设置、操作审批、终端与浏览器工具，以及每轮 Token 用量和历史会话恢复。 | Studio 智能体工作台 |
| Studio 部署 | 创建新 Runtime 时支持配置最小和最大实例数；使用 in-memory 短期记忆时默认为 1～1 并提示改用持久化存储。实例范围非默认值时在部署进度中增加「更新实例配置」阶段。 | Studio 智能体工作台 |
| Studio 会话 | 列举会话时跳过已不存在的会话，不再导致整个列表加载失败。 | Studio 智能体工作台 |
| Studio 沙箱会话 | 沙箱会话列表的「创建者」改为显示创建者的显示名称（OAuth 邮箱或本地用户名），不再显示内部用户标识；未获取到显示名称时回退为内部标识。 | Studio 智能体工作台 |
| Studio 错误提示 | run_sse 失败时区分会话不存在和 Runtime 版本不兼容，分别给出改用持久化存储或检查 Runtime 版本的排查建议。 | Studio 智能体工作台 |
| Studio 云服务商 | veadk studio 和 veadk frontend 新增 --provider 选项，可选择 volcengine（默认）或 byteplus；选择 BytePlus 时使用 BYTEPLUS_ACCESS_KEY、BYTEPLUS_SECRET_KEY 和可选的 BYTEPLUS_SESSION_TOKEN 提供凭证，Runtime 列表默认地域为 BYTEPLUS_REGION 或 ap-southeast-1。 | Studio 智能体工作台 · VeADK Frontend |
| Studio 智能生成 | 智能生成的草稿不再配置记忆、知识库与链路观测，这些能力始终关闭并使用默认后端，生成后可在画布中手动启用；生成可选内置工具移除 web_scraper、text_to_speech、vesearch。 | Studio 智能体工作台 |
| Studio 智能生成 | 智能生成优先使用 LLM 智能体作为根智能体，不再始终使用顺序编排型根智能体；仅在需要严格控制执行流程时才使用编排型作为根。 | Studio 智能体工作台 |
| Studio 智能体选择 | 云端模式下不再自动选择第一个可用智能体；开始新会话前需手动连接 Runtime，未选择时提示先选择智能体并打开管理页。 | Studio 智能体工作台 |
| Studio 智能体删除 | 删除前弹出确认对话框并列出待删除项；删除过程中从列表暂时隐藏；若当前对话使用被删除的智能体则清除选择并返回管理页。 | Studio 智能体工作台 |
| Studio 消息反馈 | 反馈按 Runtime 实际 app 名称关联评测集，首选地域查询失败时自动回退另一地域；赞/踩旁新增「查看评测案例」入口，可预览当前消息对应的评测样本。 | VeADK Frontend |
| AgentKit 集成 | 动态 A2A 运行接口在会话不存在时自动创建会话，不再返回 404。 | 部署到 AgentKit |
| AgentKit 集成 | create_agentkit_app 新增可选 identity 参数，传入后 AgentKit 在 VeADK 智能体或工具代码执行前验证并绑定入站用户身份；/ping 健康检查端点排除在身份绑定之外。使用该参数需要 agentkit-sdk-python>=0.8.2。 | 部署到 AgentKit |
| Studio 新会话体验 | 新会话模式选择器对所有用户可见；智能体选择器移至页面顶部；原「临时会话」更名为「内置智能体」，可选择 Codex 智能体；空输入时显示快捷提示。 | Studio 智能体工作台 |
| 开发服务器 | veadk studio 和 veadk frontend 的 --vite 模式允许 http://localhost:5174 作为端口 5173 的回退来源。 | Studio 智能体工作台 · VeADK Frontend |
| Studio 代码包部署 | 新增「从代码包添加和部署」创建方式，可上传、检查并编辑包含根目录 app.py 的 ZIP 项目后部署到 AgentKit；压缩包最大 50 MB、800 个文件，并执行路径安全校验。 | Studio 智能体工作台 |
| VeADK Frontend | SSO 登录态在使用过程中过期时，可在独立窗口重新登录，保留当前编辑内容并自动重试原操作。 | VeADK Frontend |
| Studio 对话 | 根智能体向子智能体移交任务时，子智能体回复显示在独立的「智能体移交」卡片中。 | Studio 智能体工作台 |
| Studio 技能 | SkillSpace 浏览改由 Studio 服务端凭证完成；本地技能在导入阶段只做轻量安全校验；云端提供完整技能包时会下载脚本、参考文档和资源，并移除单个智能体的固定技能数量上限。 | Studio 智能体工作台 |
| Codex 运行时 | 新增 codex 可选依赖组和 CodexRuntimeConfig 安全配置；默认采用会话隔离工作区、workspace_write 沙箱、禁用网络并拒绝提权操作，同时将工具、状态、鉴权和 Token 用量转换为标准 ADK Event。 | 运行时 |
| Studio 部署 | VeFaaS Application 与 Function、API Gateway 和 AgentKit 资源统一使用所选部署地域。 | Studio 智能体工作台 |
| Studio 智能体工作台 | 新增画布式多智能体工作台，集中展示 Runtime 版本和部署状态；已部署智能体可在同一 Runtime 上编辑并发布递增版本，取消更新不影响已有 Runtime。 | Studio 智能体工作台 |
| Studio 智能生成 | 可根据自然语言目标生成经过校验的递归智能体配置草稿，并列出需要用户补充的资源；生成会替换当前画布并消耗 Token。 | Studio 智能体工作台 |
| Studio Runtime | Runtime 启动期间会重试只读就绪探测；私网 Runtime 不可达时提供 VPC 排查建议；部署完成后自动连接，暂时不可达时保留任务并允许重试。 | Studio 智能体工作台 |
| Studio 调试 | Runtime 创建或更新后立即刷新智能体详情和版本；生成智能体测试进程按用户限制为最多 3 个，并自动清理刷新页面后遗留的进程。 | Studio 智能体工作台 |
| Studio 测试运行 | 单次临时测试运行最多接受 300 个项目文件。 | Studio 智能体工作台 |
| 模型 | 启用 Responses API 所需的 google-adk 最低版本提升至 1.34.0。 | 模型 |
| APMPlus 追踪 | 模型输出中的推理内容以 reasoning 类型标注，与普通文本内容区分，便于在 APMPlus 中单独查看推理过程。 | APMPlus |
| APMPlus 追踪 | OpentelemetryTracer 初始化时若检测到已存在的全局 TracerProvider，将复用该 provider 而不再覆盖，并自动移除 APMPlusExporter；新增只读属性 apmplus_managed_externally 用于查询此状态。 | 可观测概述 · APMPlus |
1.0.9
VeADK 1.0.9 发布于 2026 年 7 月 26 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| 长期记忆 | 新增 TOS ContextBucket 后端，由托管服务完成记忆推理与检索，并按 user_id 隔离记忆。 | 使用 TOS ContextBucket 存储 |
| Studio 知识库 | 创建智能体时默认使用 VikingDB Knowledge，不再提供本地向量库选项，并可选择北京地域 default 项目中当前账号可见的已有知识库集合。 | Studio 智能体工作台 |
| Studio 远程智能体 | 远程智能体配置支持按地域选择并刷新 AgentKit 智能体中心，远程智能体仍只能作为子智能体使用。 | Studio 智能体工作台 |
| Studio 消息反馈 | 连接 AgentKit Runtime 后可使用赞/踩评分，反馈幂等写入按智能体区分的评测集；标准名称被占用但不可见时使用稳定的备用名称。 | VeADK Frontend |
| Studio 发布与自更新 | veadk studio deploy 默认使用部署地域的 veadk-studio TOS Bucket 作为发布渠道，管理员可在 Studio 内更新前后端；账号菜单可查看当前系统版本。 | Studio 智能体工作台 |
| 会话能力叠加 | AgentKit 应用支持为单个会话增减内置工具和远程技能，无需修改已部署智能体。 | 部署到 AgentKit · Studio 智能体工作台 |
| Studio 智能体信息 | 对话页面新增智能体信息栏，展示当前智能体的描述、模型、工具、技能和协作拓扑。 | VeADK Frontend |
| Studio 创建工作台 | 自定义创建新增代码执行工具配置和资源选择器搜索，支持设置 AGENTKIT_TOOL_ID 与 AGENTKIT_TOOL_REGION。 | Studio 智能体工作台 · 代码沙箱 |
1.0.8
VeADK 1.0.8 发布于 2026 年 7 月 23 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio 远程智能体 | 自定义创建支持远程智能体子节点；通过 AgentKit 智能体中心 ID、召回数量、地域和 OpenAPI 地址配置，每轮任务按需发现匹配能力。远程智能体不能作为根智能体。 | Studio 智能体工作台 |
| Studio Runtime | Runtime 连接失败时区分权限不足、Agent Server 不可连接和鉴权失败，并给出对应排查建议。 | Studio 智能体工作台 |
| Studio 会话 | 修复后续消息发送时历史上下文丢失的问题；临时会话和 Skill 创建在 Tool、地域或模型凭据准备失败时显示不包含凭据的错误信息。 | Studio 智能体工作台 |
| Studio 部署凭据 | veadk studio deploy 依次从命令参数、VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY 环境变量和 ~/.volc/credentials 的 [default] 配置解析部署凭据。 | Studio 智能体工作台 |
| Studio 部署资源 | 上海部署时，Function、API Gateway、AgentKit CodeEnv Tool 和 Session 使用一致的地域；临时会话与 Skill 创建的模型凭据配置在各自 Tool 中，VeFaaS Function 只接收 Tool ID。 | Studio 智能体工作台 |
1.0.7
VeADK 1.0.7 发布于 2026 年 7 月 23 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| 代码沙箱 | run_code 新增 bash 语言支持，可在 AgentKit 沙箱中执行 Shell 脚本，并提供 exec_dir、env、hard_timeout 与 max_output_length 参数，分别控制工作目录、环境变量、硬超时与输出长度上限。 | 代码沙箱 |
| Studio 创建模式 | 新增 Skill 创建模式：在两个独立的 AgentKit CodeEnv Session 中并行生成候选技能方案，完成后可对比、下载 ZIP 或发布到 AgentKit；该模式仅限 developer 与 admin 使用。同时新增临时会话模式，退出后自动清理 Session，且不写入普通历史会话。 | Studio 智能体工作台 |
| Studio 智能搜索 | 新增基于当前智能体的智能搜索：可在会话历史中做全文检索，或通过智能体挂载的联网搜索工具、知识库与长期记忆实时检索；智能体元数据声明已挂载的检索源，Studio 据此提前置灰不可用的来源。 | Studio 智能体工作台 |
| Studio 角色与访问 | 新增基于角色的访问控制：veadk studio、veadk frontend 与 veadk studio deploy 支持 --admin 与 --developer；登录后显示用户邮箱与角色徽标，并展示 OAuth 头像。 | Studio 智能体工作台 |
| Studio 更新命令 | 新增 veadk studio update --vefaas-app-name <name>，从本地 VeADK 源码重新构建前端并更新已有的 VeFaaS Application 与 Function，保留原 URL、SSO、IAM、网关、环境变量、标题与 Logo；未指定 --region 与 --project 时跨北京、上海及全部可见项目查找。 | Studio 智能体工作台 |
| Studio 部署 | veadk studio deploy 自动创建临时会话与 Skill 创建专用的两个 AgentKit CodeEnv Tool，也可通过 --sandbox-chat-codex-tool-id 与 --sandbox-skill-creator-tool-id 指定已有 Tool；部署后客户端登录时跳过重复的 OAuth 授权确认。 | Studio 智能体工作台 |
| 飞书渠道 | FeishuChannelExtension 支持通过飞书 OpenAPI 拉取话题历史与引用消息，新增 include_parent_message、include_thread_history 与 thread_history_limit 配置，并将引用或话题内容拼接到入站消息之前。 | 飞书渠道 |
| Studio 工作台 | 改进自定义创建工作台：本地技能支持拖入文件夹或 ZIP 并自动识别格式，可按地域和项目浏览 AgentKit Skill Space 及其中技能；部署页展示智能体拓扑、支持导出配置与下载源码；并改进运行时管理与响应式布局、新会话启动、智能体运行时选择器、视频消息渲染与工具调用状态展示。 | Studio 智能体工作台 |
| 依赖 | 放宽 psycopg2-binary 版本约束为 >=2.9.10；要求 AgentKit SDK 提供默认 CORS 配置。 | 安装 |
1.0.6
VeADK 1.0.6 发布于 2026 年 7 月 20 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio 品牌 | veadk studio 和 veadk frontend 新增 --site-title（至多 6 个字符）和 --site-logo（本地图片或 HTTP(S) URL，至多 5 MB，支持 PNG、JPEG、GIF、WebP、AVIF、ICO），分别设置系统名称与 Logo。Logo 同时用于侧边栏、登录页和浏览器 favicon，系统名称也作为浏览器页面标题；不传 --site-title 时保留默认 VeADK Studio。对应环境变量为 VEADK_SITE_TITLE 与 VEADK_SITE_LOGO。云上部署使用相同参数，网络图片在部署时下载并打包进 VeFaaS。 | Studio 智能体工作台 |
| Studio 部署 | veadk studio deploy 支持 --region 选择部署地域（cn-beijing 默认，cn-shanghai），VeFaaS、API Gateway 等资源创建在所选地域；新增 --project 指定 VeFaaS 函数所属项目，默认为 default。部署时自动跨北京、上海查找 VeIdentity 用户池与客户端，跨地域命中时输出 warning 并继续。 | Studio 智能体工作台 |
| Studio 部署 IAM | veadk studio deploy 部署前自动检查 ServerlessApplicationRole，缺失时创建该 Role 并绑定 vefaas_full_access 自定义策略及所需系统策略；该检查即使指定 --iam-role 也会执行。 | Studio 智能体工作台 |
| Studio 创建与调试 | 系统提示词支持所见即所得的 Markdown 编辑，提供标题、列表等快捷输入；初始化、会话或对话失败时展示经过凭据脱敏的错误详情和 Runner 日志，可展开与复制。新增智能体名称校验，须符合 Google ADK 规则：以英文字母或下划线开头，仅含英文字母、数字和下划线，不能使用保留名 user，且在智能体结构中唯一。 | Studio 智能体工作台 |
| AgentKit 部署 | 飞书、知识库、短期/长期记忆和观测配置显示在各自配置区域，填写的值仅在部署时转换为运行时环境变量；选择观测 exporter 后对应 ENABLE_* 开关自动启用，这些值不写入生成源码或导出的 YAML，部署页同步显示便于核对。多实例部署应使用数据库持久化短期记忆；run_sse 返回 404 时界面提示检查会话是否落在不同实例。通过内置 Web UI 部署时，云端镜像构建失败会显示经过凭据脱敏的构建日志片段，便于定位依赖或 Dockerfile 错误。 | 部署到 AgentKit |
| Studio 运行时管理 | 改进运行时管理视图与响应式布局。 | Studio 智能体工作台 |
| 飞书渠道 | 在部署页打开或关闭飞书渠道时，Studio 自动重新生成项目，确保 app.py、extensions 依赖和运行时环境变量在部署前保持一致。 | Studio 智能体工作台 |
1.0.5
VeADK 1.0.5 发布于 2026 年 7 月 19 日。下表列出该版本的公开用户能力变化；完整提交记录见 GitHub Release。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio 与 Frontend | Studio 启用与 Frontend 相同的完整界面并默认进入对话页面；新增云端 Runtime 选择、Skill Hub/本地上传/AgentKit SkillSpace、多模态会话、结构化技能与子智能体调用；重构自定义创建流程，智能模式、模板和工作流入口当前显示为「敬请期待」；并完善部署区域、环境变量、任务状态、失败重试和 OAuth Token 转发。 | VeADK Frontend · Studio 智能体工作台 |
| 模型 | 默认推理模型更新为 doubao-seed-2-1-pro-260628；Responses API 支持回退模型与方舟上下文管理。 | 模型 |
| 运行时 | Agent.runtime 新增 piagent，支持通过 PiAgent 执行智能体并桥接函数工具、MCP 工具与技能；安装包不再内置 PiAgent 二进制文件。 | 运行时 |
| Studio 测试 | 生成的智能体项目可在服务端受限临时进程中测试；测试进程默认保留 1800 秒，可通过命令参数调整。 | Studio 智能体工作台 |
| Studio 部署 | 使用默认 IAM Role 部署 Studio 时，自动补充访问模型、日志、追踪、知识库、记忆与身份资源所需的系统策略；显式指定的自定义 Role 不会被修改。 | Studio 智能体工作台 |
| AgentKit 集成 | Studio 生成的智能体应用统一通过公开函数 create_agentkit_app 构建，集中提供 AgentKit 接口、健康检查、拓扑、Web UI 和短期记忆配置。 | 部署到 AgentKit |
| 飞书渠道 | 改进文本、卡片和合并转发消息的内容提取，并兼容飞书 Channel SDK 的同步生命周期。 | 飞书渠道 |
1.0.4
VeADK 1.0.4 发布于 2026 年 7 月 14 日。下表列出该版本的公开用户能力变化。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Studio | 新增 veadk studio，提供专注于创建和管理智能体的工作台；支持智能生成、自定义和模板创建，工作流入口显示为「敬请期待」；并分阶段展示 AgentKit 部署进度。 | Studio 智能体工作台 |
| 智能体管理 | Frontend 与 Studio 新增 AgentKit Runtime 管理视图，按当前用户列出由工作台部署的 Runtime，可查看 Runtime 详情与主智能体信息，并删除 Runtime。 | Studio 智能体工作台 |
| VeFaaS 部署 | 新增 veadk studio deploy，可将 Studio 部署到 VeFaaS，接入 VeIdentity 登录，并创建或复用 Serverless API Gateway 与 IAM Role。 | Studio 部署说明 |
| VeADK Frontend | 新增智能体拓扑和转移路径展示；项目部署按构建镜像、部署、发布三个阶段展示实时进度。 | VeADK Frontend |
| Harness 技能 | Harness 的 skills 支持 space:<技能空间 ID>，可以加载 AgentKit 技能中心的整个技能空间，并继续与 Skill Hub 名称或 slug 混用。 | 技能 |
| 前端安全 | 移除直接执行浏览器提交代码的测试入口；限制 AgentKit 代理的协议、域名与凭证要求；限制部署文件和静态文件的可访问路径。 | VeADK Frontend |
| 日志 | 日志实现迁移到 Python 标准库 logging，保留追踪 ID 关联；非交互式输出不再包含颜色转义序列，流式思考内容不再逐 token 记录。 | 应用日志 |
| 存储配置 | 完善 Milvus 与 OpenViking 的环境变量和配置示例；1.0.4 继续提供 1.0.3 已加入的 Milvus 知识库、OpenViking 知识库与 OpenViking 长期记忆后端。 | Milvus · OpenViking 知识库 · OpenViking 长期记忆 |
1.0.3
VeADK 1.0.3 包含以下公开用户能力变化。| 模块 | 变更细节 | 链接 |
|---|---|---|
| 知识库 | 新增 milvus 后端，支持 Milvus 服务和 Milvus Lite URI、Token 或用户名密码鉴权、数据库名称、初始化覆盖、超时和额外返回字段。 | 使用 Milvus 存储 |
| 知识库 | 新增 openviking 后端，支持向 OpenViking 导入文件、目录和文本，并按资源 URI 检索与读取结果。 | 使用 OpenViking 存储 |
| 长期记忆 | 新增 openviking 后端，按用户保存实体、事件与偏好记忆，并在跨会话检索时保持用户隔离。 | 使用 OpenViking 存储 |
| A2A | 调用 AgentKit A2A Registry 中的下游智能体时，可传递入站 X-Ve-TIP-Token 和 Bearer JWT；下游使用入站 JWT 返回 401 时，可回退到 M2M OAuth2 并重试一次。 | 入站认证 |
| 依赖 | 合并重复的项目依赖声明，并把 OpenViking SDK 加入基础依赖、把 Milvus 集成加入 extensions。 | 安装 |
1.0.2
VeADK 1.0.2 包含以下公开用户能力变化。| 模块 | 变更细节 | 链接 |
|---|---|---|
| 模型 | 新增 MODEL_AGENT_API_KEY_NAME 和 Agent.model_api_key_name，可按火山方舟 API Key 名称解析密钥；显式 Key 值仍具有更高优先级。 | 模型配置 |
| 短期记忆 | PostgreSQL 新增 schema 配置，可在一个数据库内为不同部署隔离会话表；VeADK 会创建不存在的 schema 并固定连接的 search_path。 | 使用 PostgreSQL 存储 |
| MCP | MCP Server 会话过期、服务重启或连接中断后，自动清理失效会话、重连并重试工具加载或调用一次。 | 自定义 MCP Server |
| 前端 | VeADK Frontend 新增工具 OAuth 授权卡片：打开身份提供方授权页，接收回调后提交凭证并继续原工具调用；同时优化账号入口、登录页、会话列表、空回复提示与默认智能体选择。 | VeADK Frontend |
| 网络请求 | VeSearch 与网页抓取请求使用 30 秒超时，避免无响应服务持续阻塞。 | 火山引擎搜索 · 网页抓取 |
| 安全 | 网页抓取会校验 TLS 证书；内容安全护栏的调试日志不会记录 API Key 值。 | 网页抓取 · 内容安全护栏 |
1.0.1
VeADK 1.0.1 发布于 2026 年 7 月 7 日，主要新增 Harness、A2A 注册和 ADK 技能集成，并增强 Codex 运行时与 Frontend。| 模块 | 变更细节 | 链接 |
|---|---|---|
| Codex 运行时 | 随包提供沙箱、网络访问与操作审核的默认配置：允许完整主机与网络访问，且不要求交互式确认。 | 运行时安全 |
| Harness | 新增 VeADK Harness 扩展，可为每轮调用准备上下文、压缩大体积工具结果并验证最终回答；同时支持在初始化时应用智能体描述。 | Harness 插件 |
| A2A | 新增 Harness A2A 注册能力并修正注册行为。 | 远程智能体发现 |
| A2A | A2A 调用支持 OAuth 认证。 | A2A 鉴权 |
| Codex 运行时 | 对临时后端错误提供可配置重试，并恢复经 Responses 适配层使用网页搜索的能力。 | Codex 后端请求 |
| 技能 | 新增与 Google ADK SkillToolset 配合使用的 VeSkillRegistry，支持 SkillHub 与技能空间；本地技能推荐迁移到 ADK SkillToolset，旧的 Agent(skills=..., skills_mode="local") 入口保持兼容但已废弃。 | 云端技能 |
| VeADK Frontend | 新增网关认证模式，并在创建智能体时提示缺失的火山引擎访问凭证。 | Frontend 认证 |
| Codex 运行时 | 支持将智能体技能传递给 Codex 运行时。 | Codex 技能与工具 |
| Codex 运行时 | 支持在 Codex 运行时中调用智能体的 MCP 工具和函数工具。 | Codex 技能与工具 |
| 示例 | 新增同时使用本地技能和 MCP 工具的 Codex 运行时示例。 | Codex 技能与工具 |
1.0.0
VeADK 1.0.0 发布于 2026 年 6 月 22 日。下表依据公开 Release 整理；该版本相对 0.5.40 的公开变更集中在文档入口文案。| 模块 | 变更细节 | 链接 |
|---|---|---|
| 文档 | 对齐中英文快速开始入口文案，中文入口明确说明可构建并运行第一个智能体。 | 快速开始 |