AIモデルが呼び出せる、名前、説明、パラメーター付きのツールの定義を作成します。プレーンなJSON Schemaとして、または一般的なツール呼び出しAPIやMCPサーバーが期待する形で書き出し、モデルがつまずく前に、問題を確認できます。ブラウザ上で動作し、無料で、プライバシーも守られます。
ツールの定義を作成する方法
- 「ツール名」と、わかりやすい「説明」を入力します。
- 入力ごとに「パラメーターを追加」を押して、名前、型、説明、必須かどうかを設定します。
- 複数のツールには「別のツールを追加」を、1つを削除するには「このツールを削除」を押します。「最初からやり直す」で、すべてクリアされます。
- 出力を選びます：JSON Schema、提供元の形式のいずれか、またはMCP。必要なら、「strictモード（構造化出力）」をオンにします。
- 「JSONをコピー」または「ダウンロード」を押します。「引数の例をコピー」で、呼び出しのサンプルが得られます。
すでに定義がありますか？「インポートするJSON」に貼り付けて、「インポート」を押します。
モデルがうまく使えるツールを書く
モデルは、名前と説明を読んでツールを選ぶため、何をするものか、いつ使うかを、はっきり書いてください。たとえば、「ヘルプセンターを検索します。アプリで何かのやり方をユーザーが尋ねたときに使います。」のように。単位や形式を含め、すべてのパラメーターを説明してください。たとえば、「ISO形式の日付、YYYY-MM-DD」のように。選択肢が限られている場合は、許可される値の固定リストを使い、本当に必要なフィールドだけを必須にしてください。
形式の違い
パラメーターのスキーマは、どこでも同じJSON Schemaで、変わるのはラッパーです。あるプロバイダーは、function.parametersの下に入れ子にし、別のものは、input_schemaと呼び、別のものは、関数宣言を一覧にし、MCPサーバーは、inputSchemaを返します。strictモードは、規則を追加します：すべてのプロパティを必須として一覧にし、余分なプロパティを拒否する必要があるため、省略可能なフィールドは、代わりにnullを許可するものとして書かれます。
チェックが検出するもの
スペースや64文字を超えるなどのAPIの規則に違反する名前、ツールやパラメーターの名前の重複、型に合わない許可された値、プロパティのないオブジェクト、説明の欠落。エラーはAPI呼び出しを止め、警告は、モデルが間違ったツールを選んだり、間違った値を入力したりしやすくなるものです。
ヒント
- search_ordersやget_weatherのように、動詞ベースの短い名前を使い、文字、数字、アンダースコアのみにしてください。
- ツールの数は少なく保ってください。モデルは、短いリストのほうが、よりよく選べます。
- 形式が明らかでない場合は、各パラメーターの説明に例を入れてください。
- AI回答スキーマチェックで、実際の回答に対してスキーマをテストします。
こんな方に
開発者、クライアント向けにアシスタントを作るフリーランサー、ツール呼び出しのしくみを学ぶ学生。JSONオブジェクトの例を、コード用の型にするには、JSONから型へをご覧ください。
よくある質問
strictモードとは何ですか？
モデルがスキーマに厳密に従うようになります。すべてのプロパティをrequiredとして列挙し、余分なプロパティを拒否する必要があります。
定義はアップロードされますか？
いいえ。ブラウザ上で作成されます。
既存の定義を編集できますか？
はい。インポート欄に貼り付けて変更し、もう一度書き出せます。