用語比較
入力ガードレールと出力ガードレールの違い|AIエージェントで確認する場面(生成AIパスポート)
入力ガードレールと出力ガードレールの違いは、確認する場面です。入力ガードレールは利用者の最初の入力を確認し、出力ガードレールはエージェントが返す最終的な出力を確認します。
生成AIパスポートの公式シラバス(2027年2月試験より適用)はAIエージェントの章に「ガードレール」を載せています。この記事は、OpenAI Agents SDKの公式文書が説明する入力と出力の区別で整理します。
この記事の目次
この記事の根拠と出典
各セクションの見出しの下に、公式資料で確認した内容か編集部の整理かをラベルで示しています。 試験日・料金・申込条件・試験方式は変わることがあるため、申込前に公式サイトで確認してください。
入力ガードレールと出力ガードレールの要点
入力ガードレール
最初のユーザー入力に対して動く。連鎖の最初のエージェントでだけ動き、悪用の入力をエージェント本体が処理する前に止めるために使う。
出力ガードレール
最終的なエージェントの出力に対して動く。最終出力を出すエージェントでだけ、エージェントが完了したあとに動く。
違いを表で確認
| 比較軸 | 入力ガードレール | 出力ガードレール |
|---|---|---|
| 確認する対象 | 最初のユーザー入力 | エージェントの最終的な出力 |
| 動くエージェント | 連鎖の最初のエージェントだけ | 最終出力を出すエージェントだけ |
| 動くタイミング | エージェントと並列(既定)か、エージェントの開始前(ブロッキング)かを選べる | エージェントが完了したあとに必ず動く。並列実行の指定はない |
| 発動したときの影響 | 並列では、止まる前にエージェントがトークンを消費しツールを実行している可能性がある。ブロッキングならエージェントは実行されない | エージェントの処理が済んだあとに確認するので、出力を作る処理は終わっている |
| 発動の知らせ方 | 判定結果の tripwire_triggered が真なら例外を出す | 同じく tripwire_triggered が真なら例外を出す |
生成AIパスポートの学習に使う書籍(Amazon)
PRどこで迷っているかを切り分ける
高価なモデルを悪用の入力から守りたい人
公式文書は、速く安いモデルで入力を確認し、悪用を検知したら即座に例外を出して時間と費用を節約する場面を例にしています。入力ガードレールの典型的な使い方です。
利用者に返す前に回答の中身を確かめたい人
エージェントが作った最終出力を確認するのは、出力ガードレールの役割です。最終出力を出すエージェントに付けます。
途中のツール呼び出しも確認したい人
入力と出力のガードレールはエージェントの入口と出口で動きます。関数ツールを呼ぶたびに確認したいときは、公式文書が別に挙げるツールガードレールを使います。
具体例で使い分ける
例 1
宿題の質問を高価なモデルに回さない
問い合わせ対応のエージェントが、高性能で遅く費用もかかるモデルで動いています。悪意のある利用者が、問い合わせと関係のない数学の宿題を解かせようとしました。
- OpenAI Agents SDKの公式文書は、この場面を入力ガードレールの例に挙げています。速く安いモデルのガードレールで入力を確認し、悪用と判断したら例外を出します。
- 実行方式がブロッキングなら、ガードレールの確認が終わるまでエージェントは始まりません。発動すれば高価なモデルは動かず、トークンもツールの実行も発生しません。
- 並列(既定)の場合は、ガードレールとエージェントが同時に始まります。発動しても、その時点で高価なモデルがすでにトークンを使っている可能性があります。
結論: 入力を止めて費用を抑えたいなら入力ガードレール、実行方式はブロッキングが向きます。
例 2
返答の中身を確認してから渡す
エージェントが利用者への最終回答を作りました。回答を返す前に、社内の基準に合うかを確かめたい場面です。
- 確認する対象はエージェントの最終出力なので、出力ガードレールの役割です。
- 出力ガードレールはエージェントが完了したあとに動くため、回答を作る処理そのものは済んでいます。発動すると例外が出て、アプリケーション側で利用者への返し方を決めます。
結論: 回答を渡す直前の確認は出力ガードレールです。処理の前に止める目的には使えません。
問題文から答えを選ぶ手順
- 1
確認したい対象を見る
利用者の入力を確認したいのか、エージェントの最終回答を確認したいのかを決めます。
- 2
止めたい時点を見る
エージェントが動く前に止めたいなら入力ガードレールです。回答が出たあとの確認なら出力ガードレールです。
- 3
費用や副作用を見る
入力ガードレールで副作用や費用を避けたいときは、エージェントの開始前に完了するブロッキング実行を選びます。
試験での見分け方
- 1入力ガードレールは、最初のユーザー入力に対して、最初のエージェントでだけ動く。
- 2出力ガードレールは、最終的なエージェント出力に対して、最終出力を出すエージェントでだけ動く。
- 3入力ガードレールの実行方式は並列(既定)とブロッキングの2つ。出力ガードレールはエージェント完了後に必ず動く。
- 4どちらも tripwire_triggered が真になると例外が出て、アプリケーションが対応を決める。
- 5ここでの区別は、OpenAI Agents SDKの公式文書の用語。公式シラバスが載せているのは「ガードレール」という語。
誤答しやすい選択肢
出力ガードレールで、エージェントの実行そのものを止められると考える
修正: 出力ガードレールは、エージェントが完了したあとに動きます。実行の前に止めたいときは入力ガードレールを使い、実行方式はブロッキングを選びます。
入力ガードレールは必ずエージェントより先に終わると考える
修正: 既定は並列実行です。発動した時点で、エージェントがすでにトークンを消費しツールを実行している可能性があります。先に終わらせるにはブロッキング実行を指定します。
連鎖のどのエージェントにも入力と出力のガードレールが動くと考える
修正: 公式文書では、入力ガードレールは最初のエージェント、出力ガードレールは最終出力を出すエージェントでだけ動きます。途中のツール呼び出しにはツールガードレールを使います。
確認問題
Q1最初のユーザー入力に対して動くのは、入力ガードレールと出力ガードレールのどちらか?
答え: 入力ガードレール
公式文書は、入力ガードレールは最初のユーザー入力に、出力ガードレールは最終的なエージェント出力に動くと説明しています。
Q2エージェントの開始前に確認を終え、発動すればエージェントを実行させない入力ガードレールの実行方式は?
答え: ブロッキング実行
並列実行(既定)では、ガードレールが発動しても、エージェントがすでにトークンを消費しツールを実行している可能性があります。
Q3出力ガードレールが動くのは、エージェントの処理の前か後か?
答え: 後(エージェントが完了したあと)
公式文書は、出力ガードレールは常にエージェントの完了後に動くため、並列実行の指定に対応しないと述べています。
到達チェック
- 入力ガードレールと出力ガードレールが確認する対象を説明できる
- 入力ガードレールの並列実行とブロッキング実行の違いを説明できる
- ガードレールが特定のSDKの用語であり、公式シラバスは「ガードレール」の語を載せていることを説明できる
関連ページで確認する
同じ資格で次に知りたいこと
- モデルカードとデータシートの違い|AIモデルに添える文書と、データセットに添える文書(生成AIパスポートの補足)
モデルカード(学習済みモデルに添える短い文書)とデータシート(データセットに添える文書)の違いを、対象・記載項目・知りたいことで整理。2本の原論文に基づく比較表と確認問題つき。生成AIパスポートでAIの透明性を学ぶ際の補足。
- AIエージェントの短期メモリと長期メモリの違い|保持する範囲と中身(生成AIパスポート)
AIエージェントの短期メモリと長期メモリの違いを、保持する範囲・保存する中身・長くなったときの課題で整理します。LangChain公式文書の記述にもとづく解説と確認問題つき。
- LLMとSLM(小規模言語モデル)の違い|規模・動かす場所・補い方
LLM(大規模言語モデル)とSLM(小規模言語モデル)の違いを、パラメータ数の例、動かす場所、知識量の限界とその補い方、生成AIパスポートのシラバスでの位置づけまで、公開されている論文の数値で整理します。
よくある質問
Q入力ガードレールと出力ガードレールの違いは何ですか?
確認する対象と場面です。入力ガードレールは最初のユーザー入力、出力ガードレールは最終的なエージェント出力に対して動きます。OpenAI Agents SDK公式文書の記述にもとづきます。
Qガードレールが発動するとどうなりますか?
判定結果の tripwire_triggered が真になると例外が出ます。例外をどう扱うか、利用者に何を返すかはアプリケーション側で決めます。
Q入力ガードレールは並列とブロッキングのどちらがよいですか?
費用やツール実行の副作用を避けたいなら、エージェントの開始前に完了するブロッキング実行です。並列は応答の遅れが小さい一方、発動前にエージェントが動いている可能性があります。
Q生成AIパスポートで入力と出力の区別は問われますか?
公式シラバス(2027年2月試験より適用の版)が載せているのは「ガードレール」という語で、入力と出力の区別は書かれていません。この記事の区別は特定のSDKの公式文書による整理です。出題の形式は受験前に公式の案内で確認してください。
次に見る比較
- G検定・DS検定・統計検定2級で重なる用語10語の比較
同じ名前の用語の定義と収録章を、資格ごとに並べます。
- ベイズの定理と条件付き確率の違い(統計検定2級の式と計算例)
求める確率の向きの違いと、陽性になる確率の計算例を確かめます。
- 紛らわしい用語ペア早見表
混同しやすい用語の違いと判定の手掛かりを、資格別の一覧で確かめます。
執筆: AI資格ドリル編集部(運営者情報を見る)
