AIに渡す道具の定義を書く:5項目で整える手順

best

UXリサーチャー/AIツール評価
AIに渡す道具の定義を書く:5項目で整える手順

AIに道具を使わせる仕組みは、用意しただけで動くものではありません。どの道具をいつ使うかをモデルが判断できるよう、定義を書く必要があります。DeepLearning.AI の講座は、関数呼び出しから道具の選択・振り分けまでを段階的に扱っています。

AIに渡す道具の定義を書く:5項目で整える手順のポイント

定義が曖昧だと何が起きるか

用途の説明が短いと、モデルは似た名前の別の道具を選びます。引数の型が書かれていなければ、数値と文字列を取り違えます。講座の構成は、関数呼び出し、抽出、道具の選択と振り分け、会話エージェントという順に進みます。定義の精度が、そのまま選択の精度になります。

手順1:道具の名前を動詞から始める

名前は英小文字とアンダースコアで、「何をするか」が動詞で分かる形にします。名詞だけの名前は、用途が重なったときに区別できません。同じ対象に対する読み取りと更新は、名前の先頭で分けます。

手順2:用途を1文で書き、使う条件を添える

「在庫数を照会する」だけでなく、「受注の可否を答えるときに使う」まで書きます。使う場面が書かれていないと、雑談でも呼ばれます。逆に、呼んではいけない場面も1行足します。

手順3:引数は型と必須かどうかを明記する

引数ごとに、名前・型・必須か任意か・意味を書きます。任意の項目には既定値を入れます。型を曖昧にすると、日付の形式や数値の桁で失敗します。日付は形式まで指定します。

手順4:返り値の形を決める

返す値の項目と型を決めます。空のときに何を返すかも決めておきます。返り値が自由文だと、次の段階が読み取れません。道具の結果をそのまま会話に戻す設計では、この形の安定が効きます。仕組みの全体はツール呼び出しの用語ページにまとめました。

手順5:実行ログで定義を直す

1週間動かして、呼び出しの回数と失敗の種類を数えます。多い失敗が「呼ばれない」なら用途の1文を、「引数が違う」なら型の記述を直します。定義は最初に完成させるものではなく、ログで育てるものです。

FAQ

Q. 道具はいくつまで渡せますか?

A. 決まった上限はありませんが、増やすほど選択の誤りが増えます。用途が重ならない2〜3個から始め、ログを見て足す順が安全です。

Q. 定義は誰が書くべきですか?

A. その道具を運用している人が書きます。実際の入力と出力を知っている人でないと、呼んではいけない条件を書けません。講座でも、道具の選択と振り分けは設計側の仕事として扱われています。

出典

出典:DeepLearning.AI「Functions, Tools and Agents with LangChain」(Harrison Chase 担当、2025年10月7日更新、2026年10月25日参照)

あわせて使いたいツール

本記事の手順を実際に回すときに、候補になるツールを挙げます。いずれも無料から試せる範囲があり、料金や機能は各サービスの公式情報で確認してください。

  • ChatGPT:定義文の下書きと点検に向く
  • Notion AI:定義の一覧をまとめて管理できる

関連ガイド

同じ時期に公開した実務ガイドと、用語の定義ページです。手順の前提が分からない場合は、用語ページから確認してください。コピーして使える依頼文が欲しいときは、プロンプト集も参照してください。

編集部の見解

定義を書き直すだけで失敗が減る、というのは試すと分かります。とくに「呼んではいけない条件」の1行が効きます。ここを書かないと、雑談の途中でも外部システムを叩きにいきます。定義は地味な作業ですが、道具を増やす前にここを固めたほうが、結果的に早いと思います。



メールマガジン

最新のAI情報をメールで受け取る

新着のAIツール比較・ランキング・ニュースを、まとめてお届けします。

ご登録後、確認メールをお送りします。配信停止はいつでも可能です。

週1回・無料

AEO診断・AIクローラー最新情報を、
週1回お届け

AI Botの仕様変更やAEO対策のノウハウ、よくあるトラブル事例を編集部が厳選しメール配信。いつでも配信停止可能です。

  • 新Bot・仕様変更AIクローラーに新しいBotが追加されたとき、判定仕様が変わったときの速報
  • 障害事例と対処AEO診断で多い障害事例と、その対処方法を実例で解説
  • AEO活用術Web制作会社・SEO担当者向けのAEO活用テクニック

登録により 利用規約に同意したとみなされます。確認メールのリンクを押すと登録が完了します。

My-Best.AI|AIツール比較・ランキング・おすすめ最新AI情報
Logo