Mastra Client SDK
Mastra Client SDKは、クライアント環境からMastraサーバーとやり取りするためのシンプルで型安全なインターフェースを提供します。
開発要件
スムーズなローカル開発を確保するために、以下のものを用意してください：
- Node.js 18.x 以降がインストールされていること
- TypeScript 4.7+ (TypeScriptを使用する場合)
- Fetch APIをサポートする最新のブラウザ環境
- ローカルのMastraサーバーが実行中であること（通常はポート4111で）
インストール
npm
npm install @mastra/client-js@latestMastra Clientの初期化
始めるには、必要なパラメータでMastraClientを初期化する必要があります：
import { MastraClient } from "@mastra/client-js";
const client = new MastraClient({
baseUrl: "http://localhost:4111", // デフォルトのMastra開発サーバーポート
});設定オプション
様々なオプションでクライアントをカスタマイズできます：
const client = new MastraClient({
// 必須
baseUrl: "http://localhost:4111",
// 開発用のオプション設定
retries: 3, // リトライ試行回数
backoffMs: 300, // 初期リトライバックオフ時間
maxBackoffMs: 5000, // 最大リトライバックオフ時間
headers: {
// 開発用のカスタムヘッダー
"X-Development": "true",
},
});例
MastraClientが初期化されると、型安全なインターフェースを通じてクライアント呼び出しを開始できます
// Get a reference to your local agent
const agent = client.getAgent("dev-agent-id");
// Generate responses
const response = await agent.generate({
messages: [
{
role: "user",
content: "Hello, I'm testing the local development setup!",
},
],
});利用可能な機能
Mastraクライアントは、Mastraサーバーが提供するすべてのリソースを公開しています
- エージェント: AIエージェントの作成と管理、レスポンスの生成、ストリーミング対話の処理
- メモリ: 会話スレッドとメッセージ履歴の管理
- ツール: エージェントが利用できるツールへのアクセスと実行
- ワークフロー: 自動化されたワークフローの作成と管理
- ベクトル: セマンティック検索と類似性マッチングのためのベクトル操作の処理
ベストプラクティス
- エラー処理: 開発シナリオに適切なエラー処理を実装する
- 環境変数: 設定には環境変数を使用する
- デバッグ: 必要に応じて詳細なログ記録を有効にする
// エラー処理とログ記録の例
try {
const agent = client.getAgent("dev-agent-id");
const response = await agent.generate({
messages: [{ role: "user", content: "Test message" }],
});
console.log("Response:", response);
} catch (error) {
console.error("Development error:", error);
}デバッグ
- MastraClientをクライアントではなくサーバー上で使用する場合（例：
/api/chat）、 クライアントへのレスポンスを再作成する必要があることがあります：
const result = agent.stream(/* get your agent stream */)
return new Response(result.body);