Skip to Content
ドキュメントツールとMCP概要

ツール概要

ツールは、エージェントが特定のタスクを実行したり外部情報にアクセスしたりするために実行できる関数です。これらは単純なテキスト生成を超えてエージェントの能力を拡張し、API、データベース、または他のシステムとの対話を可能にします。

各ツールは通常、以下を定義します：

  • 入力： ツールの実行に必要な情報（多くの場合、Zodを使用したinputSchemaで定義）。
  • 出力： ツールが返すデータの構造（outputSchemaで定義）。
  • 実行ロジック： ツールのアクションを実行するコード。
  • 説明： エージェントがツールの機能と使用タイミングを理解するのに役立つテキスト。

ツールの作成

Mastraでは、@mastra/core/toolsパッケージのcreateTool関数を使用してツールを作成します。

src/mastra/tools/weatherInfo.ts
import { createTool } from "@mastra/core/tools";
import { z } from "zod";
 
const getWeatherInfo = async (city: string) => {
  // Replace with an actual API call to a weather service
  console.log(`Fetching weather for ${city}...`);
  // Example data structure
  return { temperature: 20, conditions: "Sunny" };
};
 
export const weatherTool = createTool({
  id: "Get Weather Information",
  description: `Fetches the current weather information for a given city`,
  inputSchema: z.object({
    city: z.string().describe("City name"),
  }),
  outputSchema: z.object({
    temperature: z.number(),
    conditions: z.string(),
  }),
  execute: async ({ context: { city } }) => {
    console.log("Using tool to fetch weather information for", city);
    return await getWeatherInfo(city);
  },
});

この例では、都市の入力スキーマ、天気データの出力スキーマ、およびツールのロジックを含むexecute関数を持つweatherToolを定義しています。

ツールを作成する際は、ツールの説明をシンプルに保ち、ツールが何をするのか、いつ使用するのかに焦点を当て、その主な使用例を強調してください。技術的な詳細はパラメータスキーマに含め、エージェントがツールを正しく使用する_方法_について、わかりやすい名前、明確な説明、デフォルト値の説明などで案内します。

エージェントへのツールの追加

ツールをエージェントが利用できるようにするには、エージェントの定義でそれらを設定します。エージェントのシステムプロンプトで利用可能なツールとその一般的な目的に言及することも、ツールの使用を改善することができます。詳細な手順と例については、エージェントでのツールとMCPの使用のガイドを参照してください。

ツールスキーマの互換レイヤー

異なるモデルはスキーマを異なる方法で解釈します。特定のスキーマプロパティが渡されるとエラーになるモデルもあれば、特定のスキーマプロパティを無視してエラーを出さないモデルもあります。Mastra はツールスキーマのための互換レイヤーを追加し、ツールが異なるモデルプロバイダー間で一貫して動作し、スキーマの制約が守られるようにします。

このレイヤーを適用している主なプロバイダーは以下の通りです：

  • Google Gemini & Anthropic: サポートされていないスキーマプロパティを削除し、関連する制約をツールの説明に追加します。
  • OpenAI（推論モデルを含む）: 無視される、またはサポートされていないスキーマフィールドを削除または調整し、エージェントのガイダンスのために説明に指示を追加します。
  • DeepSeek & Meta: スキーマの整合性とツールの使いやすさを確保するため、同様の互換ロジックを適用します。

このアプローチにより、カスタムツールと MCP ツールの両方で、ツールの利用がより信頼性が高く、モデル非依存になります。

MCPをMastraで使用する | エージェント | MastraドキュメントMCP概要