カスタムツール

仕組み

ツールは組織レベルのリソースとして一度だけ定義します。リクエストメソッド（GET/POST/PUT/PATCH/DELETE）、{{param}} のプレースホルダーを含むエンドポイント URL、認証（API キー、ベアラートークン、Basic 認証。認証情報は暗号化され、モデルに渡ることはありません）、AI に渡させるパラメータ、任意の JSON ボディテンプレート、そしてレスポンスをエージェントに必要な範囲まで削るマッピングを指定します。

各ツールには Read か Write の型が付きます。Read ツールはデータを取得するだけです。Write ツールは作成、更新、削除を行い、コネクタの書き込みツールと同じく、対話型チャットでは実行前に確認のため一時停止します。定義したツールは、必要なエージェントに割り当てて使います。

なぜ重要か

カスタムツールがあるからこそ、エージェントは Macha が標準コネクタを用意しているシステムだけでなく、自社のスタック、つまり社内 CRM、物流事業者、ニッチな SaaS にまで手を伸ばせます。チームがすでに使っているツールに対してエージェント型 AIを実際に働かせるための、現実的な形です。

手作業で組み立てることも、API の内容を Sidekick に説明することもできます。Sidekick はエンドポイントを探し出し、認証情報をテストし、ツールを組み上げてくれます。