翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Bedrock ガードレールのユースケース
<a name="guardrails-use"></a>

ガードレールを作成したら、次の機能を使用して適用できます。
+ [モデル推論](inference.md) – モデルで推論を実行する際に、送信されたプロンプトと生成されたレスポンスにガードレールを適用します。
+ [エージェント](agents.md) – ガードレールをエージェントに関連付けて、エージェントに送信されたプロンプトとエージェントから返されたレスポンスに適用します。
+ [ナレッジベース](knowledge-base.md) – ナレッジベースをクエリし、そこからレスポンスを生成する際にガードレールを適用します。
+ [フロー](flows.md) – フロー内のプロンプトノードまたはナレッジベースノードにガードレールを追加して、これらのノードの入力と出力に適用します。

次の表は、 AWS マネジメントコンソール または Amazon Bedrock API を使用して、これらの各機能にガードレールを含める方法を示しています。


****  

| ユースケース | コンソール | API | 
| --- | --- | --- | 
| モデル推論 | [プレイグラウンドを使用する](playgrounds.md)際に、ガードレールを選択する。 | [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) リクエストまたは [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) リクエストのヘッダーで指定するか、[Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) リクエストまたは [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) リクエストの本文の guardrailConfig フィールドに含めます。 | 
| エージェントに関連付ける | エージェントを[作成または更新](agents-build-modify.md)する際に、エージェントビルダーの [ガードレールの詳細] セクションで指定します。 | [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) リクエストまたは [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html) リクエストの本文に、guardrailConfiguration フィールドを含めます。 | 
| ナレッジベースへのクエリの際に使用する | クエリ設定の [ガードレール](kb-test-config.md#kb-test-config-guardrails) セクションのステップに従います。設定時にガードレールを追加します。 | [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) リクエストの本文に、guardrailConfiguration フィールドを含めます。 | 
| フローのプロンプトノードに含める | フローを[作成](flows-create.md)または[更新](flows-modify.md)する際に、[設定] セクションでプロンプトノードを選択し、ガードレールを指定します。 | [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html) リクエストまたは [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html) リクエストの nodes フィールドにプロンプトノードを定義する場合は、[PromptFlowNodeConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptFlowNodeConfiguration.html) に guardrailConfiguration フィールドを含めます。 | 
| フローのナレッジベースノードに含める | フローを[作成](flows-create.md)または[更新](flows-modify.md)する際に、[設定] セクションでナレッジベースノードを選択し、ガードレールを指定します。 | [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html) リクエストまたは [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html) リクエストの nodes フィールドにナレッジベースノードを定義する場合は、[KnowledgeBaseFlowNodeConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseFlowNodeConfiguration.html) に guardrailConfiguration フィールドを含めます。 | 

このセクションでは、モデル推論と Amazon Bedrock API でのガードレールの使用について説明します。基本の推論オペレーション ([InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) および [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)) と Converse API ([Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) および [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)) を使用できます。どちらのオペレーションセットでも、同期型とストリーミング型のモデル推論でガードレールを使用できます。また、ユーザー入力の一部を選択して評価し、ストリーミングレスポンスの動作を設定することもできます。

**Topics**
+ [推論オペレーションでガードレールを使用してユーザー入力を評価する](guardrails-input-tagging-base-inference.md)
+ [アプリケーションで ApplyGuardrail API を使用する](guardrails-use-independent-api.md)