そもそもMastraってなに？
Mastraは、エージェント（AIで考える小さな作業者）を組み合わせて、自動的にタスクをこなしてくれるフレームワークです。
Mastraでできること
例えば、こんな流れが作れます。
- Webスクレイピングツールでデータを集める（Tool）
- AIエージェントでデータを要約する（Agent）
- プランナーで一連の流れを管理する（Plan）
これを、少ないコードで自然に構築できるのがMastraです！
Mastraのコンポーネント構成
Mastraは、
たった4つのコンポーネントでできています！
| コンポーネント | 役割 | 例 |
|---|---|---|
| Tool | 単純な作業をする | API叩く、ファイル読む |
| Agent | 判断・推論する | テキスト要約、分類 |
| Plan | 作業の流れを組み立てる | 「AしてBしてCする」フロー |
| Memory | 状態や履歴を記録する | 作業ログ保存（予定機能含む） |
このシンプルさが、初心者にもわかりやすく、応用しやすいポイントです。
1. Tool（ツール）
単純な作業を担当するパーツ。
- Webスクレイピングをする
- APIを叩いてデータを取ってくる
- ファイルを読み込む
など、「何かをする」シンプルな処理をToolにまとめます。
✅ たとえば：
class FetchUserData extends Tool {
async run() {
return await fetch("https://api.example.com/user");
}
}
→ データ取得だけに専念する！
2. Agent（エージェント）
考えたり、判断したりするパーツ。
- テキストを要約する
- データを分類する
- 意思決定をする
など、**「知的な作業」**をAgentに任せます。
✅ たとえば：
class SummarizeTextAgent extends Agent {
async run(text: string) {
return `要約: ${text.substring(0, 100)}...`;
}
}
→ 簡単な要約ロジックを持たせたりできる！
3. Plan（プランナー）
ToolとAgentをつないで流れを作るパーツ。
- 「最初にこれをやって、次にあれをやって」という順番管理をします。
- 分岐や並列処理もサポート予定！（発展）
✅ たとえば：
const plan = new Plan([
new FetchUserData(),
new SummarizeTextAgent()
]);
→ 流れを組み立てて「一気に自動実行」できる！
4. Memory（メモリー）
データや履歴を保存するパーツ。（※将来拡張される予定）
- 途中結果を覚えさせたり
- 成功・失敗の履歴を取ったり
- チームで共有するために使う
現在はシンプルな使い方が中心ですが、
ログ管理・状態保持などに活用できるようになる方向です。
【コンポーネントまとめ図】
[ Tool ] → [ Agent ] → [ Tool ] → [ Agent ]
↓ ↓ ↓ ↓
作業 判断 作業 判断
↓
[ Plan ] ← 流れを管理
- Tool：動く手
- Agent：考える頭
- Plan：流れを設計する設計図
これがMastraの基本設計！
Mastraを使うメリット
- TypeScriptだけで完結（Node.js上で動く）
- Tool/Agent/Planをシンプルに設計できる
- 拡張・カスタマイズが超しやすい
- 軽量＆最小構成から始められる
Mastraの始め方（超かんたんステップ）
1. インストール
まずnpmでインストール！
npm install mastra
またはyarnなら
yarn add mastra
これだけで準備完了！
2. 最初のサンプルコード
超シンプルな例を見てみよう！
import { Tool, Agent, Plan } from 'mastra';
// Toolの定義（単純作業）
class FetchDataTool extends Tool {
async run() {
return "データを取得しました！";
}
}
// Agentの定義（AI的な作業）
class SummarizeAgent extends Agent {
async run(input: string) {
return `要約結果: ${input}`;
}
}
// Planの定義（流れを設計）
const plan = new Plan([
new FetchDataTool(),
new SummarizeAgent()
]);
// 実行
(async () => {
const result = await plan.execute();
console.log(result); // => 要約結果: データを取得しました！
})();
これだけで
**「データ取得 → 要約」**の流れが自動で動きます！
Mastraのイメージ図
[ FetchDataTool ] → [ SummarizeAgent ]
↓
Planが順番に実行
こんな感じで、小さな部品を順番に組み立てていくスタイルです！
Mastraはどんな人に向いている？
✅ TypeScript/Node.jsでAIや自動化に挑戦したい人
✅ シンプルな自動ワークフローを作りたい人
✅ フロントと連携して使いたい人（Next.js、NestJSとの相性も良い）