Skip to Content
ドキュメントインテグレーション概要

Mastra統合の使用

Mastraの統合は、サードパーティサービス用の自動生成された型安全なAPIクライアントです。これらはエージェントのツールとして、またはワークフローのステップとして使用できます。

インテグレーションのインストール

Mastraのデフォルトインテグレーションは、個別にインストール可能なnpmモジュールとしてパッケージ化されています。npmを通じてインテグレーションをインストールし、Mastraの設定にインポートすることで、プロジェクトにインテグレーションを追加できます。

例:GitHubインテグレーションの追加

  1. インテグレーションパッケージのインストール

GitHubインテグレーションをインストールするには、次のコマンドを実行します:

npm install @mastra/github@latest
  1. プロジェクトにインテグレーションを追加する

インテグレーション用の新しいファイル(例:src/mastra/integrations/index.ts)を作成し、インテグレーションをインポートします:

src/mastra/integrations/index.ts
import { GithubIntegration } from "@mastra/github"; export const github = new GithubIntegration({ config: { PERSONAL_ACCESS_TOKEN: process.env.GITHUB_PAT!, }, });

process.env.GITHUB_PAT!を実際のGitHub個人アクセストークンに置き換えるか、環境変数が適切に設定されていることを確認してください。

  1. ツールやワークフローでインテグレーションを使用する

これで、エージェントのツールを定義する際やワークフローでインテグレーションを使用できます。

src/mastra/tools/index.ts
import { createTool } from "@mastra/core"; import { z } from "zod"; import { github } from "../integrations"; export const getMainBranchRef = createTool({ id: "getMainBranchRef", description: "Fetch the main branch reference from a GitHub repository", inputSchema: z.object({ owner: z.string(), repo: z.string(), }), outputSchema: z.object({ ref: z.string().optional(), }), execute: async ({ context }) => { const client = await github.getApiClient(); const mainRef = await client.gitGetRef({ path: { owner: context.owner, repo: context.repo, ref: "heads/main", }, }); return { ref: mainRef.data?.ref }; }, });

上記の例では:

  • githubインテグレーションをインポートしています。
  • GitHub APIクライアントを使用してリポジトリのメインブランチの参照を取得するgetMainBranchRefというツールを定義しています。
  • このツールは入力としてownerrepoを受け取り、参照文字列を返します。

エージェントでの統合の使用

統合を利用するツールを定義したら、これらのツールをエージェントに含めることができます。

src/mastra/agents/index.ts
import { openai } from "@ai-sdk/openai"; import { Agent } from "@mastra/core/agent"; import { getMainBranchRef } from "../tools"; export const codeReviewAgent = new Agent({ name: "Code Review Agent", instructions: "An agent that reviews code repositories and provides feedback.", model: openai("gpt-4o-mini"), tools: { getMainBranchRef, // other tools... }, });

このセットアップでは:

  • Code Review Agent という名前のエージェントを作成します。
  • エージェントの利用可能なツールに getMainBranchRef ツールを含めます。
  • エージェントは会話中にこのツールを使用してGitHubリポジトリと対話できるようになります。

環境設定

統合に必要なAPIキーやトークンが環境変数に適切に設定されていることを確認してください。例えば、GitHub統合では、GitHubパーソナルアクセストークンを設定する必要があります:

GITHUB_PAT=your_personal_access_token

機密情報を管理するには、.envファイルや他の安全な方法の使用を検討してください。

例:Mem0統合の追加

この例では、Mem0プラットフォームを使用して、ツール使用を通じてエージェントに長期記憶機能を追加する方法を学びます。 この記憶統合は、Mastraの独自のエージェント記憶機能と併用することができます。 Mem0を使用すると、エージェントはユーザーごとに事実を記憶し、そのユーザーとのすべてのやり取りで後で思い出すことができます。一方、Mastraの記憶はスレッドごとに機能します。両方を組み合わせて使用することで、Mem0は会話/やり取りを超えた長期的な記憶を保存し、Mastraの記憶は個々の会話内での線形的な会話履歴を維持します。

  1. 統合パッケージのインストール

Mem0統合をインストールするには、次のコマンドを実行します:

npm install @mastra/mem0@latest
  1. プロジェクトに統合を追加する

統合用の新しいファイル(例:src/mastra/integrations/index.ts)を作成し、統合をインポートします:

src/mastra/integrations/index.ts
import { Mem0Integration } from "@mastra/mem0"; export const mem0 = new Mem0Integration({ config: { apiKey: process.env.MEM0_API_KEY!, userId: "alice", }, });
  1. ツールやワークフローで統合を使用する

これで、エージェントのツールやワークフローを定義する際に統合を使用できます。

src/mastra/tools/index.ts
import { createTool } from "@mastra/core"; import { z } from "zod"; import { mem0 } from "../integrations"; export const mem0RememberTool = createTool({ id: "Mem0-remember", description: "Remember your agent memories that you've previously saved using the Mem0-memorize tool.", inputSchema: z.object({ question: z .string() .describe("Question used to look up the answer in saved memories."), }), outputSchema: z.object({ answer: z.string().describe("Remembered answer"), }), execute: async ({ context }) => { console.log(`Searching memory "${context.question}"`); const memory = await mem0.searchMemory(context.question); console.log(`\nFound memory "${memory}"\n`); return { answer: memory, }; }, }); export const mem0MemorizeTool = createTool({ id: "Mem0-memorize", description: "Save information to mem0 so you can remember it later using the Mem0-remember tool.", inputSchema: z.object({ statement: z.string().describe("A statement to save into memory"), }), execute: async ({ context }) => { console.log(`\nCreating memory "${context.statement}"\n`); // to reduce latency memories can be saved async without blocking tool execution void mem0.createMemory(context.statement).then(() => { console.log(`\nMemory "${context.statement}" saved.\n`); }); return { success: true }; }, });

上記の例では:

  • @mastra/mem0統合をインポートします。
  • Mem0 APIクライアントを使用して新しい記憶を作成し、以前に保存した記憶を呼び出す2つのツールを定義します。
  • このツールは入力としてquestionを受け取り、記憶を文字列として返します。
src/mastra/tools/index.ts
import { createTool } from "@mastra/core"; import { z } from "zod"; import { mem0 } from "../integrations"; export const mem0RememberTool = createTool({ id: "Mem0-remember", description: "Mem0-memorizeツールを使用して以前に保存したエージェントの記憶を思い出します。", inputSchema: z.object({ question: z .string() .describe("保存された記憶の中から答えを探すために使用される質問。"), }), outputSchema: z.object({ answer: z.string().describe("思い出された答え"), }), execute: async ({ context }) => { console.log(`Searching memory "${context.question}"`); const memory = await mem0.searchMemory(context.question); console.log(`\nFound memory "${memory}"\n`); return { answer: memory, }; }, }); export const mem0MemorizeTool = createTool({ id: "Mem0-memorize", description: "Mem0に情報を保存し、後でMem0-rememberツールを使用して思い出せるようにします。", inputSchema: z.object({ statement: z.string().describe("メモリに保存する文"), }), execute: async ({ context }) => { console.log(`\nCreating memory "${context.statement}"\n`); // レイテンシーを減らすために、メモリはツールの実行をブロックせずに非同期で保存できます void mem0.createMemory(context.statement).then(() => { console.log(`\nMemory "${context.statement}" saved.\n`); }); return { success: true }; }, });

上記の例では:

  • @mastra/mem0統合をインポートします。
  • Mem0 APIクライアントを使用して新しい記憶を作成し、以前に保存された記憶を呼び出す2つのツールを定義します。
  • ツールはquestionを入力として受け取り、記憶を文字列として返します。

利用可能な統合

Mastraは、いくつかの組み込み統合を提供しています。主にOAuthを必要としないAPIキーに基づく統合です。利用可能な統合には、Github、Stripe、Resend、Firecrawlなどがあります。

利用可能な統合の完全なリストについては、Mastraのコードベースまたはnpmパッケージを確認してください。