ツール選択の失敗と対策

約5分

AIが適切なツールを選ばない・使うべき場面で使わないという問題に悩んでいる方

ツール利用でつまずく原因の多くは、ツールそのものの実装ではなく選択にあります。使うべき場面で使わない、似たツールを取り違える、という失敗は設計で減らせます。

3つの失敗パターン

ツールの数が増えるほど、似た用途のものが混ざり、判断が難しくなります。人間でも、名前の似た機能が20個並んでいれば選び間違えます。

すべてのツールを常に渡す必要はありません。作業の性質に応じて必要なものだけを渡すほうが、精度もコストも改善します。

ツールの説明文は、AIにとって唯一の判断材料です。「何ができるか」だけでなく、いつ使い、いつ使わないかまで書きます。

# 説明が不足している例
検索を実行する

# 十分な説明の例
社内ドキュメントを全文検索する。
公開情報や一般知識を調べる用途には使わない。
検索語は日本語で、3語以内が望ましい。

「使わない場面」を明記することが、取り違えを減らすうえでもっとも効果があります。

用途が重なるツールが並んでいると、どちらを選んでも間違いに見えます。

# 境界が曖昧
- search_docs: ドキュメントを検索する
- find_content: コンテンツを探す

# 境界を明示
- search_docs: 公開済みドキュメントを全文検索する
- find_files: ファイル名とパスから対象を特定する（本文は検索しない）

名前と説明の両方で、担当範囲が重ならないようにします。

ツール選択がうまくいかないときは、次の順で確認します。