第 10 章：Mastra TypeScript Agent¶
Mastra 是 Y Combinator 支持的 TypeScript 优先 Agent 框架，适合 Node.js 全栈开发者。
10.1 核心特性¶
| 特性 | 说明 |
|---|---|
| TypeScript 原生 | 完整的类型支持 |
| 工作流优先 | 内置工作流引擎 |
| 多 Provider | 支持 81+ Provider，2400+ 模型 |
| observability | 内置可观测性 |
10.2 环境准备¶
10.3 第一个 Mastra Agent¶
// basic-agent.ts
import { Agent } from '@mastra/core/agent';
import { openai } from '@ai-sdk/openai';
const agent = new Agent({
name: 'Research Assistant',
instructions: '你是一个研究助手，帮助用户查找和总结信息。',
// 也可以直接用模型字符串：model: 'openai/gpt-4o-mini'
model: openai('gpt-4o-mini')
});
// 注意：使用 generate()（旧版 API 为 prompt()，已废弃）
const result = await agent.generate('总结一下 AI Agent 的发展趋势');
console.log(result.text);
Mastra 新版统一使用 agent.generate() / agent.stream() 方法，旧版 agent.prompt() 已废弃，请勿在新代码中使用。
10.4 工具定义¶
// tools.ts
import { z } from 'zod';
import { createTool } from '@mastra/core/tools';
const searchTool = createTool({
id: 'web-search',
description: '搜索互联网信息',
inputSchema: z.object({
query: z.string().describe('搜索关键词'),
limit: z.number().default(5)
}),
outputSchema: z.array(z.object({
title: z.string(),
url: z.string(),
snippet: z.string()
})),
execute: async ({ context }) => {
// 实现搜索逻辑
return searchWeb(context.query, context.limit);
}
});
10.5 工作流编排¶
// workflow.ts
import { z } from 'zod';
import { Workflow } from '@mastra/core/workflow';
const workflow = new Workflow({
name: 'research-workflow',
// 注意：新版参数名为 triggerSchema（旧版 trigger 已废弃）
triggerSchema: z.object({
topic: z.string()
})
});
// 添加步骤
workflow
.step({
id: 'research',
execute: async (context) => {
// 通过 context.triggerData 访问触发数据
return { research: await doResearch(context.triggerData.topic) };
}
})
.step({
id: 'synthesize',
execute: async (context) => {
return { summary: await synthesize(context.research) };
}
})
.commit();
// 运行工作流
await workflow.run({ triggerData: { topic: 'AI Agent' } });
10.6 本章小结¶
✅ 了解了 Mastra 的核心架构
✅ 学会了工具定义和工作流编排
✅ 掌握了 TypeScript 类型安全的使用方法