翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Connect AI エージェント用の AI ガードレールを作成する
*AI ガードレール*は、ユースケースと責任ある AI ポリシーに基づいた保護を実装できるリソースです。
Connect AI エージェントは Amazon Bedrock ガードレールを使用します。これらのガードレールは、 Amazon Connect 管理ウェブサイトで作成および編集できます。
**Topics**
+ [重要事項](#important-ai-guardrail)
+ [AI ガードレールを作成する方法](#create-ai-guardrail)
+ [デフォルトのブロックされたメッセージを変更する](#change-default-blocked-message)
+ [AI ガードレールポリシーを設定するための CLI コマンドの例](#guardrail-policy-configurations)
## 重要事項
+ 最大 3 つのカスタムガードレールを作成できます。
+ Connect AI エージェント用のガードレールは、Amazon Bedrock ガードレールのクラシック階層と同じ言語をサポートしています。サポートされている言語の完全なリストについては、「[Amazon Bedrock ガードレールでサポートされる言語](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-supported-languages.html)」を参照してください。他の言語でのテキストコンテンツの評価は無効になります。
+ ガードレールを設定または編集する場合は、さまざまな設定でテストを行うことを強くお勧めします。一部の組み合わせは、意図しない結果をもたらす可能性があります。ガードレールをテストして、結果がユースケースの要件を満たしていることを確認します。
## AI ガードレールを作成する方法
1. AI **エージェントデザイナー、AI** **ガードレール - セキュリティプロファイルでアクセス**許可を作成するアカウントを使用して、 Amazon Connect 管理者ウェブサイトにログインします。
1. Amazon Connect 管理ウェブサイトの左側のナビゲーションメニューで、**AI エージェントデザイナー**、**AI ガードレール**を選択します。
1. **[ガードレール]** ページで、**[ガードレールの作成]** を選択します。
1. **[AI ガードレールの作成]** ダイアログボックスで、ガードレールの名前と説明を入力し、**[作成]** を選択します。
1. **[AI ガードレールビルダー]** ページで、作成するガードレールでの必要性に応じて、以下のフィールドを入力します。
+ **コンテンツフィルター**: フィルターの強度を調整して、有害なコンテンツを含む入力プロンプトやモデルレスポンスをブロックできます。フィルタリングは、ヘイト、侮辱、性的、暴力、不正行為、プロンプト攻撃など、事前に定義された特定の有害なコンテンツカテゴリの検出に基づいて行われます。
+ **拒否トピック**: アプリケーションのコンテキストでは望ましくない一連のトピックを定義しておきます。定義したトピックがユーザークエリやモデルレスポンスで検出された場合に、ブロックできます。最大 30 個の拒否トピックを追加できます。
+ **コンテキストグラウンディングチェック**: 情報源の接続 (グラウンディング) やユーザークエリとの関連性に基づいて、モデルレスポンスのハルシネーション (事実に基づかない誤情報が生成されること) を検出し、フィルタリングすることができます。
+ **ワードフィルター**: 望ましくない単語、フレーズ、冒涜的な表現 (完全一致) をブロックするようにフィルターを設定します。対象となる単語は、不快な用語、競合相手の名前などです。
+ **機密情報フィルター**: ユーザー入力やモデルレスポンスで、個人を特定できる情報 (PII) などの機密情報やカスタムの正規表現をブロックまたはマスク処理するようにフィルターを設定します。
ブロックまたはマスキングは、SSN 番号、生年月日、住所などのエンティティの標準形式の機密情報の確率的検出に基づいて行われます。識別子のパターンの正規表現ベースの検出を設定することもできます。
+ **ブロックされたメッセージング**: ガードレールが入力またはモデルレスポンスをブロックした場合にユーザーに表示されるデフォルトのメッセージをカスタマイズします。
Amazon Connect は、不適切または有害なイメージコンテンツを検出してフィルタリングする**イメージコンテンツフィルター**をサポートしていません。
1. ガードレールが完了したら、**[保存]** を選択します。
バージョンドロップダウンから選択する場合、**[最新: ドラフト]** は常に AI ガードレールの保存状態を返します。
1. **[公開]** を選択します。AI ガードレールの更新が保存され、AI ガードレールの可視性ステータスが **[公開済み]** に設定され、新しい AI ガードレールバージョンが作成されます。
![\[AI ガードレールページ。可視性ステータスが公開済みに設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-created-guardrail.png)
バージョンドロップダウンから選択する場合、**[最新: 公開済み]** は常に AI ガードレールの保存状態を返します。
## デフォルトのブロックされたメッセージを変更する
このセクションでは、ユーザーに表示されるブロックされたメッセージを変更する例を使用して、 Amazon Connect 管理ウェブサイトの AI ガードレールビルダーとエディタにアクセスする方法について説明します。
次の図は、ユーザーに表示されるデフォルトのブロックされたメッセージの例を示しています。デフォルトのメッセージは「ガードレールにより入力テキストがブロックされました」です。
![\[顧客に表示されるデフォルトのガードレールメッセージの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-blocked-by-guardrail.png)
**デフォルトのブロックされたメッセージを変更するには、以下を実行します。**
1. https://*instance name*.my.connect.aws/ の Amazon Connect 管理者ウェブサイトにログインします。管理者アカウントを使用するか、**AI エージェントデザイナー** - **AI ガードレール** - セキュリティプロファイルでアクセス許可**を作成します**。
1. ナビゲーションメニューで、**AI エージェントデザイナー**、**AI ガードレール**を選択します。
1. **[AI ガードレール]** ページで、**[AI ガードレールの作成]** を選択します。名前と説明を割り当てるダイアログが表示されます。
1. **[AI ガードレールの作成]** ダイアログボックスで、名前と説明を入力して **[作成]** を選択します。ビジネスにすでに 3 つのガードレールがある場合は、次の図に示すように、エラーメッセージが表示されます。
![\[ビジネスにはすでに 3 つのガードレールがあることを示すメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-guardrail-limit.png)
このメッセージが表示された場合は、別のガードレールを作成する代わりに、ニーズに合わせて既存のガードレールを編集することを検討してください。または、既存のガードレールを削除して、新しいガードレールを作成します。
1. ガードレールがモデルレスポンスをブロックする際に表示されるデフォルトのメッセージを変更するには、**[ブロックされたメッセージ]** セクションにスクロールします。
1. 表示するブロックメッセージテキストを入力し、**[保存]** を選択してから **[公開]** を選択します。
## AI ガードレールポリシーを設定するための CLI コマンドの例
AWS CLI を使用して AI ガードレールポリシーを設定する方法の例を次に示します。
### 望ましくないトピックをブロックする
次のサンプル AWS CLI コマンドを使用して、望ましくないトピックをブロックします。
```
aws qconnect update-ai-guardrail
--cli-input-json {
"assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
"aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
"blockedInputMessaging": "Blocked input text by guardrail",
"blockedOutputsMessaging": "Blocked output text by guardrail",
"visibilityStatus": "PUBLISHED",
"topicPolicyConfig": {
"topicsConfig": [
{
"name": "Financial Advice",
"definition": "Investment advice refers to financial inquiries, guidance, or recommendations with the goal of generating returns or achieving specific financial objectives.",
"examples": ["- Is investment in stocks better than index funds?", "Which stocks should I invest into?", "- Can you manage my personal finance?"],
"type": "DENY"
}
]
}
}
```
### 有害および不適切なコンテンツをフィルタリングする
次のサンプル AWS CLI コマンドを使用して、有害および不適切なコンテンツをフィルタリングします。
```
aws qconnect update-ai-guardrail
--cli-input-json {
"assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
"aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
"blockedInputMessaging": "Blocked input text by guardrail",
"blockedOutputsMessaging": "Blocked output text by guardrail",
"visibilityStatus": "PUBLISHED",
"contentPolicyConfig": {
"filtersConfig": [
{
"inputStrength": "HIGH",
"outputStrength": "HIGH",
"type": "INSULTS"
}
]
}
}
```
### 有害および不適切な単語をフィルタリングする
次のサンプル AWS CLI コマンドを使用して、有害および不適切な単語をフィルタリングします。
```
aws qconnect update-ai-guardrail
--cli-input-json {
"assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
"aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
"blockedInputMessaging": "Blocked input text by guardrail",
"blockedOutputsMessaging": "Blocked output text by guardrail",
"visibilityStatus": "PUBLISHED",
"wordPolicyConfig": {
"wordsConfig": [
{
"text": "Nvidia",
},
]
}
}
```
### モデルレスポンスでハルシネーションを検出する
次のサンプル AWS CLI コマンドを使用して、モデルレスポンスのハルシネーションを検出します。
```
aws qconnect update-ai-guardrail
--cli-input-json {
"assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
"aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
"blockedInputMessaging": "Blocked input text by guardrail",
"blockedOutputsMessaging": "Blocked output text by guardrail",
"visibilityStatus": "PUBLISHED",
"contextualGroundPolicyConfig": {
"filtersConfig": [
{
"type": "RELEVANCE",
"threshold": 0.50
},
]
}
}
```
### 機密情報の編集
次のサンプル AWS CLI コマンドを使用して、個人を特定できる情報 (PII) などの機密情報を編集します。
```
aws qconnect update-ai-guardrail
--cli-input-json {
"assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
"aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
"blockedInputMessaging": "Blocked input text by guardrail",
"blockedOutputsMessaging": "Blocked output text by guardrail",
"visibilityStatus": "PUBLISHED",
"sensitiveInformationPolicyConfig": {
"piiEntitiesConfig": [
{
"type": "CREDIT_DEBIT_CARD_NUMBER",
"action":"BLOCK",
},
]
}
}
```