Mastra core 1.75.0 发布：Span 查询 API 上线，trace 聚合可统计 token 与成本

Mastra 于 2026 年 10 月 7 日发布 @mastra/core 1.75.0，重点是可观测性：新增 Span 查询 API，可以不先找 trace 就直接跨 trace 查询已完成的 span，并返回模型成本；trace 聚合开始支持 token 与成本度量，已在 ClickHouse、DuckDB 与 Postgres 三种存储实现。同批把 @mastra/connect 推进到 1.0 稳定版。

这次发布的是什么

2026 年 10 月 7 日，Mastra 在 GitHub 发布 @mastra/core 1.75.0（release 的 published_at 为 2026-10-07T16:17:26Z，非预发布版本）。这次的重点是可观测性：新增 Span 查询 API，可以不先找 trace 就直接跨 trace 查询已完成的 span；同时 trace 聚合开始支持 token 与成本度量。同批还把 @mastra/connect 推进到 1.0 稳定版，并调整了会话的模型保持行为。

可用性与限制

• 获取方式：通过 npm 安装 @mastra/core，版本 1.75.0；Node 与其他依赖的版本要求以官方 release 与文档为准。
• 存储支持：官方写明 token 与成本聚合已在 ClickHouse、DuckDB 与 Postgres 三种可观测性存储中实现，其他存储是否支持以官方文档为准。
• 破坏性变更：@mastra/connect 1.0 重做了 provider API，旧写法 integrations 已改名为 providers，并移除了部分旧接口。
• 工具审批：官方写明自动发现的 MCP 工具默认不再需要审批，需要通过 requireApproval 显式开启。
• 渠道标识：官方写明 channels() 中的 Slack 渠道标识从 slack 改为 slack-channels，Slack 工具侧保持不变。
• 境内可用性：npm 与 GitHub 的可访问性取决于本地网络环境，以实际情况为准。

主要功能

• 用存储层或客户端的 querySpans() 查询已完成的 span
• 提供 HTTP 接口 POST /api/observability/spans/query
• 支持过滤、游标、预览与模型成本字段，可直接查「过去一小时内失败的 tool_call」
• aggregateTraces() 支持 token 与成本度量，含覆盖率与货币处理
• 语义回忆可以跑在自带嵌入能力的向量库上，无需配置客户端 embedder
• 会话跨模式切换保持单一当前模型，并支持创建不立即建 thread 的会话

技术原理

按官方 release 的说明，过去要定位一次失败的工具调用，通常得先找到对应的 trace 再往下钻；Span 查询 API 把 span 本身变成可查询对象，配合过滤、游标与预览字段，在存储层直接返回结果，也把模型成本一并带了进来。成本与 token 的聚合同样落在存储层实现，官方说明 ClickHouse、DuckDB 与 Postgres 三种存储都已支持，并带覆盖率与货币处理，用于回答「哪些会话花钱最多」这类问题。语义回忆一侧，官方引入了「向量库是否自带嵌入」的判断标记，MongoDB 向量库可通过 autoEmbed 自行生成嵌入，从而省掉客户端 embedder 的配置。

实际体验

可以按下面几步验证这次升级对你的项目是否可用：

1. 在测试环境把 @mastra/core 升到 1.75.0，先跑一遍既有流程，重点看 @mastra/connect 是否报改名错误——官方写明 integrations 已改名为 providers。
2. 用存储层的 querySpans() 写一条查询，过滤出过去一小时内状态为失败的 tool_call，确认返回里有预览与成本字段。
3. 在你使用的存储（官方写明 ClickHouse、DuckDB、Postgres 三种已实现）上跑一次 aggregateTraces()，检查成本求和与平均值是否有值，并留意官方提到的覆盖率字段。
4. 如果你使用 MCP 工具，确认是否要补上 requireApproval——官方写明自动发现的工具默认不再需要审批。
5. 若使用 MongoDB 做记忆，测试在省掉客户端 embedder 的情况下语义回忆是否仍能命中。

项目地址与获取方式

官方仓库为 github.com/mastra-ai/mastra，发布页为 github.com/mastra-ai/mastra/releases/tag/@mastra/core@1.75.0，安装走 npm 上的 @mastra/core 包。请通过官方渠道安装，避免来源不明的第三方镜像包。升级前建议先读一遍 release 里的破坏性变更小节。

适合谁用

• 已在生产跑智能体、需要按失败率与成本排查问题的团队
• 用 ClickHouse、DuckDB 或 Postgres 存可观测性数据、想直接算成本与 token 的团队
• 用 MongoDB 做记忆、希望省掉客户端 embedder 配置的团队
• 不必用：只在本地跑演示、没有持久化存储的场景，Span 查询与成本聚合都用不上；也不必用：对 @mastra/connect 有重度定制、暂时无法消化这次 API 改名的项目，建议先在分支上验证

常见问题

升级会破坏现有代码吗？

官方在 release 里单列了破坏性变更一节，受影响的主要是 @mastra/connect：integrations 改名为 providers，移除了部分旧接口，Slack 渠道标识也有调整。建议先在测试分支升级并跑一遍回归。

成本统计的货币怎么处理？

官方写明聚合里的成本度量带货币处理与覆盖率字段。具体支持的货币与换算口径以官方文档为准，不要自行假设统一折算成某一种货币。

我用的是 Postgres 存储，能用吗？

官方写明 token 与成本聚合已在 ClickHouse、DuckDB 与 Postgres 三种可观测性存储中实现。其他存储是否支持以官方文档为准。

语义回忆还需要自己接 embedder 吗？

官方引入了「向量库是否自带嵌入」的标记，能自己生成嵌入的向量库可以在不配置客户端 embedder 的情况下工作，MongoDB 向量库通过 autoEmbed 走这条路。其他向量库是否支持以官方文档为准。

Span 查询和原来的 trace 查询有什么区别？

官方说明 Span 查询面向已完成 span 本身，带过滤、游标、预览与成本字段，典型用法是不先找 trace 就直接列出过去一小时内失败的 tool_call。两者的覆盖范围差异以官方文档为准。

相关工具与内容

• AI 智能体分类：智能体与工作流自动化方向的入口。
• AI 编程分类：面向开发者的 AI 工具入口。
• n8n：可视化编排自动化工作流的平台。
• Docker Agent v1.149.0 快讯：同属智能体运行时的近期版本动态。
• OpenAI Dots 与 Agents 快讯：智能体产品方向的背景阅读。