四条 TypeScript AI 路径
Vercel AI SDK
Vercel 出品,专注"把 LLM 调用包装成流式 API"。功能聚焦于 model 抽象、streaming、tool calling,不涉及 workflow/memory/eval。轻,适合 Next.js App 的聊天功能。
LangChain.js / LangGraph
Python 版 port。生态大但 JS 版一直慢一拍,LangGraph 近年追上,但 API 仍略重,与 TS 惯用写法有距离。
Genkit(Google/Firebase)
Firebase 子产品,绑定 Google Cloud 较深,适合 GCP 重度用户。
Mastra
Gatsby 原班人马 2024 开源,目标:让 TS 全栈开发者用最少概念完成 Agent/Workflow/RAG/Eval 全链路。底层用 AI SDK,上层自己做 Memory、Workflow、Eval。
能力矩阵
| 能力 | AI SDK | LangGraph JS | Genkit | Mastra |
|---|---|---|---|---|
| 模型抽象 | ✅ | ✅ | ✅ | ✅(直接用 AI SDK) |
| Tool Calling | ✅ | ✅ | ✅ | ✅(Zod schema) |
| Workflow 编排 | ❌ | ✅ | 部分 | ✅ |
| Memory 层 | ❌ | Checkpointer | ❌ | ✅(线程+语义+工作) |
| RAG 开箱 | ❌ | 需自拼 | ✅ | ✅ |
| Eval | ❌ | 社区 | Firebase Test | ✅(LLM-as-judge) |
| 本地 Playground | ❌ | LangGraph Studio | Genkit UI | ✅(npm run dev) |
| 观测性 | ❌ | LangSmith | Google Cloud | ✅(OTel 标准) |
| TS 风格 | 原生 | 混 Py 翻译味 | 原生 | 原生 |
Mastra 的六个核心概念
┌────────────────────────────────────────┐
│ Mastra (入口) │
│ agents, tools, workflows, │
│ vectors, storage, logger, telemetry │
└────────────────────────────────────────┘
│
┌───────┼───────┐
▼ ▼ ▼
Agent Workflow RAG
│ │ │
│ step/branch Vector Store
▼ │
Tools ...
│
▼
External API
Mastra(主入口)
类似 NestJS 的 App,把所有 agent/tool/workflow 注册到同一个实例,便于统一日志、遥测、部署。
Agent
一个指定 instructions、model、可用 tools 的 LLM 角色。
agent.generate(text) 返回答案。Tool
Agent 可调用的外部能力,参数用 Zod schema 描述,运行时类型安全。
Workflow
由 step 组成的 DAG,支持分支、并行、循环。比 Agent 更可控,适合多步流程。
Memory
Agent 上下文的持久化层,线程对话、语义召回、长期工作记忆。
Storage / Vector
跨组件共享的底层存储,libsql/pg/cloudflare D1 等 provider,RAG 用 pgvector/pinecone/qdrant。
什么时候选 Mastra
适用场景
- TS 全栈团队,不想切到 Python 栈
- 需要 Agent + Workflow + RAG + Memory 一起,不想拼装多个库
- 重视本地开发体验(Playground UI、热重载)
- 要部署到 Vercel / Cloudflare / 自托管 Node
- 需要企业级观测(OTel 标准导出)
什么时候别选
- 你只要"聊天流式输出一个 LLM 回答"——直接用 AI SDK,Mastra 过重
- 团队已在深度用 LangGraph Python,ecosystem 迁移代价大
- 想要零第三方依赖从零实现——Mastra 是约定框架,配不得极简主义
社区与版本
- 首个公开版本:2024 年 7 月
- 1.0 GA:2025 年 3 月
- 当前主要维护者:Mastra Inc.,融资 Y Combinator + Samsung Next
- GitHub star(2026-05):42k+
- 主要集成:Cloudflare、Vercel、Supabase、Upstash、Langfuse、Braintrust
本章小结
- TypeScript AI 生态有 AI SDK、LangGraph JS、Genkit、Mastra 四条路
- Mastra 定位:端到端框架,覆盖 Agent/Tool/Workflow/Memory/RAG/Eval
- 底层复用 AI SDK 的 model 抽象,上层自成一派
- 本地 Playground + TS 风格 + OTel 观测是卖点
- 纯聊天应用用 AI SDK 足够,端到端 AI 产品选 Mastra