モデルが認識できるツールエラー
AIが読み取り、対処できるエラーを返します。
「モデルが認識できるツールエラー」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
エラーは追加のコンテキストです
ツールが失敗しても、AI がクラッシュすることはありません。結果と同じように、error をコンテキストとして読み取り、次に何をするかを判断します。
良いエラーは次の行動につながる
エラーを、それを読んで対処する人に向けて書きます。Exception よりも City not found のほうが優れています。モデルがユーザーに都市名の修正を求められるからです。
エラー文字列を返す
最も単純なパターンは、問題が発生したときに明確なmessage文字列を返すことです。これにより、モデルは何が失敗したのかを正確に読み取れます。
@mcp.tool()
def get_user(uid: int) -> str:
if uid < 1:
return "Error: uid must be positive."ツールエラーを示すには raise を使う
通常の Python 例外をraiseすることもできます。FastMCP はそれを捕捉し、サーバーをクラッシュさせずにツールエラーとしてモデルへ返します。
@mcp.tool()
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("b cannot be zero")
return a / bisError が結果を示す
内部では、失敗したツール呼び出しは isError を true に設定したコンテンツを返します。このフラグは、その結果が失敗を表していることをクライアントに伝えます。
モデルは復旧できる
読みやすいerrorがあれば、AI はより適切な入力で再試行したり、問題をユーザーに説明したりできます。失敗を役立つ次の一手に変えられるのです。🔁
何が、なぜ失敗したかを伝える
良いエラーは、何が失敗したのか、そしてなぜ失敗したのかを示します。単なる Not found よりも、File missing: report.csv のほうがmodelにとってはるかに役立ちます。
修正方法を示す
可能であれば、errorの中に解決方法のヒントを含めます。Date must be YYYY-MM-DD と示せば、モデルは次の呼び出しですぐに自分で修正できます。
if not iso_date:
raise ValueError("Date must be in YYYY-MM-DD format")内部情報を決して漏らさない
エラーはモデルに届き、多くの場合はユーザーにも届きます。そのため、返すメッセージにsecrets、生のスタックトレース、接続文字列を含めないでください。
検証してから、早めにエラーを返す
まず引数を確認し、実際の処理を行う前にerrorを返します。早い段階で失敗させると、ツールの動作が予測しやすく、理解もしやすくなります。
エラーも契約の一部です
失敗も、あらかじめ設計された出力として扱います。起こりうるerrorsを示すツールは、成功時の動作を文書化したツールと同じようにモデルに役立ちます。
クイックチェック
なぜツールのエラーを明確で読みやすいメッセージとして書くのでしょうか。
まとめ
ツールのerrorsはモデルが読み取るコンテキストです。明確にし、何がなぜ起きたかを伝え、修正方法を示し、内部情報は決して漏らさないでください。✅
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「モデルが認識できるツールエラー」レッスンは無料ですか？
はい。「モデルが認識できるツールエラー」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「モデルが認識できるツールエラー」で何を学びますか？
AIが読み取り、対処できるエラーを返します。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「モデルが認識できるツールエラー」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- モデルが認識できるツールエラー
- プロトコルエラーとツールの失敗
- 実行前に入力を検証する
- 安全に失敗させ、ハングさせない