跳到主要内容
开源 TypeScript Agent 框架

构建真正可用于生产环境的 AI Agent

构建、观测并持续改进能够运行数天的 Agent。Mastra 为 TypeScript 团队提供统一的 Agent、Workflow、Memory、Evals 和部署框架。

npm create mastra@latest几分钟内获得可运行的项目
mastra-project
运行中
Workspace
Agents
Tools
Workflows
Memory
观测
Traces
Evals
Agent 运行research-assistant
已完成
Agent 已启动已加载 instructions 和 Memory
18ms
模型生成已选择 Tool 并规划响应
842ms
searchDocs返回 3 篇相关文档
126ms
响应已完成已记录 Trace、Token 和评分
1.2s
Tokens1,284Tool 调用1Score0.94

为交付真实 Agent 系统的团队而构建

ReplitSanityWorkOSMongoDBPayPalSoftBank
使用代码构建

从第一个 prompt 到最后一次 Tool 调用,全程类型安全

使用团队现有的语言、包管理器、Schema 和部署 Workflow 来定义 Agent。

  • 类型安全的输入与结构化输出
  • 与 Provider 无关的模型路由
  • 内置 Tool、Memory 和 Workflow
探索 Agent
src/mastra/agents/assistant.tsTypeScript
import { Agent } from '@mastra/core/agent'

export const assistant = new Agent({
  id: 'assistant',
  name: 'Assistant',
  instructions: 'Help users complete their work.',
  model: process.env.MODEL,
  tools: { searchDocs },
})
观测与改进

看清每个 Agent 正在做什么

追踪每次模型调用和 Tool 决策,评估结果,并将生产反馈转化为更好的行为。

使用场景

一套覆盖全公司的框架

面向产品团队

面向客户的 Agent

回答问题、完成任务、流式呈现结构化 UI,并将用户顺畅带回产品流程。

面向运营团队

内部自动化

连接 Tool 与业务系统,再通过明确的 Workflow 控制来协调可重复执行的工作。

面向平台团队

Agent 基础设施

通过 Server API、模型路由、Storage、Evals 和 Observability 提供共享的 Agent 基础能力。

FAQ

常见问题

在本站同步的最新官方文档中查找实现细节。

打开文档
Mastra 是什么?

Mastra 是用于构建 AI 应用和 Agent 的开源 TypeScript 框架,内置 Agent、Workflow、Memory、模型路由、Evals、Observability 和部署 Tool。

Mastra 可以在现有 TypeScript 应用中运行吗?

可以。你可以在 Node.js 和 Web 框架项目中使用 Mastra,也可以将其作为独立 Server 运行。同一套 Agent 和 Workflow 定义可以从本地开发直接迁移到生产环境。

Mastra 支持哪些 AI 模型?

Mastra 为主流 Provider 和 Gateway 提供统一的模型接口。打开模型目录即可浏览当前 Provider 与模型文档。

如何调试一次 Agent 运行?

Mastra 会记录模型调用、Tool 调用、Workflow 和 handoff 的 Trace。开发时使用 Studio,生产环境则使用 Observability 集成。

Mastra 是开源的吗?

是。框架和这套文档都在公开的 mastra-ai/mastra GitHub 仓库中开发,并采用 Apache 2.0 许可证。

开始构建

今天就交付你的第一个 Mastra Agent

从本地开始,检查每次运行,再使用同一个 TypeScript 项目完成部署。