冪等性と副作用を考慮したツール
同じ呼び出しを繰り返しても安全で予測可能になるようにします。
「冪等性と副作用を考慮したツール」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
モデルは2回呼び出すことがある
AIクライアントは、タイムアウトや接続切断の後にツールを再試行することがあります。その場合、ユーザーは1回のつもりでもツールがtwice実行される可能性があります。
べき等性とは
同じ入力で再度呼び出しても、それ以上の変更が起きない場合、そのツールはidempotentです。2回目の呼び出しは安全に何もしない処理になります。
読み取りは本来安全
レコードの取得など、純粋なreadツールはすでにべき等です。繰り返しても同じ結果が返るだけで、悪影響はありません。
@mcp.tool()
def get_user(id: int) -> dict:
return db.find(id)書き込みには注意が必要
データをcreatesしたり料金を請求したりするツールは、繰り返すと危険です。無条件の再試行によって、重複行の追加や二重請求が起こる可能性があります。
クライアント提供のキーを使う
呼び出し元にidempotencyキーを要求します。そのキーをすでに処理済みなら、再度実行するのではなく保存済みの結果を返します。
if key in seen:
return seen[key]
seen[key] = do_work()InsertよりUpsertを優先する
upsertは安定したIDに基づいて書き込みまたは更新を行うため、2回実行しても行は2つではなく1つのままです。再試行を1つの状態にまとめられます。
INSERT ... ON CONFLICT (id)
DO UPDATE SET ...副作用を明確に宣言する
ツールのdescriptionに、データを変更するかどうかを記載します。破壊的な呼び出しであることが分かれば、モデルはより適切に判断できます。
読み取りツールと書き込みツールを分ける
場合によって書き込みも行う1つのツールではなく、クエリツールと変更ツールをdistinctに保ちます。境界を明確にすると、意図しない変更を減らせます。
結果を決定的にする
可能な限り、同じ入力に対して同じoutputを返します。予測可能な結果は、クライアントによるキャッシュやツールの動作の理解に役立ちます。
実行前に確認する
書き込みの前に、対象の現在のstateを確認します。変更がすでに適用されている場合は、再実行せずに成功を報告します。
if order.status == "shipped":
return "already shipped"複数ステップの処理をトランザクションで包む
ツールが複数の行を操作する場合は、1つのtransactionで実行します。再試行時にはすべて適用されるか、すべてロールバックされるかのどちらかになり、途中までの状態にはなりません。
クイックチェック
レコードを作成するMCPツールで、なぜべき等性が重要なのでしょうか。
まとめ：安全な再実行
キーやupsertを使って書き込みをidempotentにし、副作用を宣言し、読み取りと書き込みを分け、トランザクションを使います。次はバージョニングです。♻️
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「冪等性と副作用を考慮したツール」レッスンは無料ですか？
はい。「冪等性と副作用を考慮したツール」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「冪等性と副作用を考慮したツール」で何を学びますか？
同じ呼び出しを繰り返しても安全で予測可能になるようにします。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。
「冪等性と副作用を考慮したツール」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- 階層型サーバーアーキテクチャ
- 環境変数による設定とシークレット管理
- 冪等性と副作用を考慮したツール
- ツールとスキーマのバージョン管理