Amazon Bedrock ガードレールのユースケース
ガードレールを作成したら、次の機能を使用して適用できます。
次の表は、AWS マネジメントコンソール または Amazon Bedrock API を使用して、これらの機能ごとにガードレールを含める方法について説明しています。
| ユースケース | コンソール | API |
|---|---|---|
| モデル推論 | プレイグラウンドを使用する際に、ガードレールを選択する。 | InvokeModel リクエストまたは InvokeModelWithResponseStream リクエストのヘッダーで指定するか、Converse リクエストまたは ConverseStream リクエストの本文の guardrailConfig フィールドに含めます。 |
| エージェントに関連付ける | エージェントを作成または更新する際に、エージェントビルダーの [ガードレールの詳細] セクションで指定します。 | CreateAgent リクエストまたは UpdateAgent リクエストの本文に、guardrailConfiguration フィールドを含めます。 |
| ナレッジベースへのクエリの際に使用する | クエリ設定の ガードレール セクションのステップに従います。設定時にガードレールを追加します。 | RetrieveAndGenerate リクエストの本文に、guardrailConfiguration フィールドを含めます。 |
| フローのプロンプトノードに含める | フローを作成または更新する際に、[設定] セクションでプロンプトノードを選択し、ガードレールを指定します。 | CreateFlow リクエストまたは UpdateFlow リクエストの nodes フィールドにプロンプトノードを定義する場合は、PromptFlowNodeConfiguration に guardrailConfiguration フィールドを含めます。 |
| フローのナレッジベースノードに含める | フローを作成または更新する際に、[設定] セクションでナレッジベースノードを選択し、ガードレールを指定します。 | CreateFlow リクエストまたは UpdateFlow リクエストの nodes フィールドにナレッジベースノードを定義する場合は、KnowledgeBaseFlowNodeConfiguration に guardrailConfiguration フィールドを含めます。 |
このセクションでは、モデル推論と Amazon Bedrock API でのガードレールの使用について説明します。基本の推論オペレーション (InvokeModel および InvokeModelWithResponseStream) と Converse API (Converse および ConverseStream) を使用できます。どちらのオペレーションセットでも、同期型とストリーミング型のモデル推論でガードレールを使用できます。また、ユーザー入力の一部を選択して評価し、ストリーミングレスポンスの動作を設定することもできます。