

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

# AI エージェントの初期セットアップ
<a name="ai-agent-initial-setup"></a>



Connect AI エージェントの使用を開始するには、まずドメインを作成する必要があります。このプロセスの一環として、オプションで以下を行うこともできます。
+ エージェントへの推奨事項に記載されている抜粋を暗号化するための暗号化キーを作成します。
+ 外部データを使用してナレッジベースを作成します。
+ KMS キーを使用して、これらのアプリケーションからインポートするコンテンツを暗号化します。

以下のセクションでは、Amazon Connect コンソールを使用して Connect AI エージェントを有効にする方法について説明します。記載されている順序に従ってください。APIs、必要なプログラミングスキルがあることを前提としています。

**Topics**
+ [サポートされているコンテンツタイプ](#q-content-types)
+ [インテグレーションの概要](#ai-agent-overview)
+ [[開始する前に]](#ai-agent-requirements)
+ [ステップ 1: ドメインを作成する](#enable-ai-agents-step1)
+ [ステップ 2: ドメインを暗号化する](#enable-ai-agents-step-2)
+ [ステップ 3: 統合 (ナレッジベース) を作成する](#enable-ai-agents-step-3)
+ [ステップ 4: Connect AI エージェントのフローを設定する](#enable-ai-agents-step4)
+ [ナレッジベースが複数ある場合はどうなりますか?](#multiple-knowledge-base-tips)
+ [ナレッジベースが最後に更新された日時を確認する方法](#enable-ai-agents-tips)
+ [クロスリージョン推論サービス](#enable-ai-agents-cross-region-inference-service)

## サポートされているコンテンツタイプ
<a name="q-content-types"></a>

Connect AI エージェントは、HTML、Word、PDF、およびテキストファイルの取り込みを最大 1 MB までサポートします。次の点に注意してください。
+ プレーンテキストファイルは UTF-8 である必要があります。
+ Word ドキュメントは DOCX 形式である必要があります。
+ Word ドキュメントは自動的に簡易 HTML に変換され、ソース文書のフォントファミリー、サイズ、色、強調表示、配置、または背景色、ヘッダー、フッターなどのその他の書式設定は保持されません。
+ PDF ファイルは、暗号化またはパスワード保護できません。
+ PDF ファイルに埋め込まれたアクションとスクリプトはサポートされていません。

ナレッジベースごとのクイックレスポンス数など、調整可能なクォータの一覧については、「[AI エージェントサービスクォータを接続する](amazon-connect-service-limits.md#connect-ai-agents-quotas)」を参照してください。

## インテグレーションの概要
<a name="ai-agent-overview"></a>

Connect AI エージェントを有効にするには、以下の広範なステップに従います。

1. ドメイン (アシスタント) を作成します。ドメインは、SalesForce や Zendesk などの単一のナレッジベースで構成されます。

1. エージェントへの推奨事項に記載されている抜粋を暗号化するための暗号化キーを作成します。

1. 外部データを使用してナレッジベースを作成します。
   + Amazon Connect コンソールで事前構築済みのコネクタを使用して、Amazon S3、Microsoft SharePoint Online、[Salesforce](https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_objects_knowledge__kav.htm)、[ServiceNow](https://developer.servicenow.com/dev.do#!/reference/api/rome/rest/knowledge-management-api)、ZenDesk からのデータ統合を追加します。
   + KMS キーを使用して、これらのアプリケーションからインポートするコンテンツを暗号化します。
   + 一部の統合では、同期の頻度を指定します。
   + 統合を確認します。

1. フローを設定します。

1. アクセス許可を割り当てます。

## [開始する前に]
<a name="ai-agent-requirements"></a>

次に、主要な概念の概要と、セットアッププロセス中に入力を求められる情報を示します。

Connect AI エージェントの使用を開始するには、*ドメイン*を作成する必要があります。1 つのナレッジベースで構成されるアシスタントです。ドメインを作成する際は、次のガイドラインに従います。
+ 複数のドメインを作成できますが、外部アプリケーション統合や顧客データを相互に共有することはできません。
+ 各ドメインは、1 つ以上の Amazon Connect インスタンスに関連付けることができますが、Amazon Connect インスタンスは、1 つのドメインにのみ関連付けることができます。
**注記**  
作成する外部アプリケーション統合はすべて、ドメインレベルです。ドメインに関連付けられているすべての Amazon Connect インスタンスは、ドメインの統合を継承します。  
別のドメインを選択することで、Amazon Connect インスタンスを別のドメインにいつでも関連付けることができます。
+ 作成する外部アプリケーション統合はすべて、ドメインレベルです。ドメインに関連付けられたすべての Amazon Connect インスタンスは、ドメインの統合を継承します。
+ 別のドメインを選択することで、Amazon Connect インスタンスを別のドメインにいつでも関連付けることができます。

### ドメインに名前を付ける方法
<a name="enable-domains-ai-agents"></a>

ドメインを作成すると、組織名など、わかりやすいドメイン名を指定するように求められます。

### (オプション) AWS KMS keys を作成してドメインとコンテンツを暗号化する
<a name="enable-awsmanagedkey-ai-agents"></a>

Connect AI エージェントを有効にすると、デフォルトでドメインと接続は で暗号化されます AWS 所有のキー。ただし、キーを管理する場合は、次の 2 つの [AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys) を作成または指定できます。
+ Connect AI エージェントドメインには 1 つのキーを使用します。これは、推奨事項に記載されている抜粋を暗号化するために使用されます。
+ 2 つ目のキーを使用して、Amazon S3、Microsoft SharePoint Online、Salesforce、ServiceNow、または ZenDesk からインポートされたコンテンツを暗号化します。Connect AI エージェントの検索インデックスは、保管時に常に を使用して暗号化されることに注意してください AWS 所有のキー。

KMS キーを作成するには、このセクションで後述する [ステップ 1: ドメインを作成する](#enable-ai-agents-step1) のステップに従ってください。

カスタマー管理キーは、ユーザーが作成、所有、管理します。KMS キーを完全に制御でき、 AWS KMS 料金が適用されます。

他のユーザーが管理者である KMS キーを設定する場合、キーには、Connect AI エージェントを呼び出すために キーを使用して IAM ID に `kms:CreateGrant`、`kms:DescribeKey`、`kms:Decrypt`および アクセス`kms:GenerateDataKey*`許可を付与するポリシーが必要です。チャット、タスク、E メールで Connect AI エージェントを使用するには、Connect AI エージェントドメインのキーポリシーで、`connect.amazonaws.com`サービスプリンシパルへの `kms:Decrypt`、`kms:GenerateDataKey*`、および アクセス`kms:DescribeKey`許可を許可する必要があります。

**注記**  
チャット、タスク、E メールで Connect AI エージェントを使用するには、ドメインのキーポリシーで`connect.amazonaws.com`サービスプリンシパルに次のアクセス許可を付与する必要があります。  
`kms:GenerateDataKey*`
`kms:DescribeKey`
`kms:Decrypt`
キーポリシーの変更方法については、「AWS Key Management Service Developer Guide」の「[Changing a key policy](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html)」を参照してください。**

## ステップ 1: ドメインを作成する
<a name="enable-ai-agents-step1"></a>

以下のステップでは、Amazon Connect インスタンスにドメインを追加する方法、およびドメインに統合を追加する方法について説明します。これらのステップを完了するには、ドメインのないインスタンスが必要です。

1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。

1. **[Amazon Connect 仮想コンタクトセンターインスタンス]** ページの **[インスタンスエイリアス]** で、インスタンス名を選択します。次の図は、一般的なインスタンス名を示しています。  
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)

1. ナビゲーションペインで AI **エージェント**を選択し、**ドメインの追加**を選択します。

1. [**Add domain**] (ドメインの追加) ページで [**Create a domain**] (ドメインの作成) を選択します。

1. **[ドメイン名]** ボックスに組織名などのわかりやすいドメイン名を入力します。  
![\[[ドメインの追加] ページ、[新しいドメインの作成] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agent-enter-domain-name.png)

1. ページを開いたまま、次のステップに進みます。

## ステップ 2: ドメインを暗号化する
<a name="enable-ai-agents-step-2"></a>

Amazon Connect のデフォルトキーを使用してドメインを暗号化できます。既存のキーを使用することも、独自のキーを作成することもできます。以下のステップでは、各キータイプの使用方法を説明します。必要に応じて各セクションを展開してください。

### デフォルトのキーを使用する
<a name="q-key-use-default"></a>

1. **[暗号化]** の下にある **[暗号化設定のカスタマイズ]** チェックボックスのチェックを外します。

1. **[ドメインを追加する]** を選択します。

### 既存のキーを使用する
<a name="q-key-use-existing"></a>

1. **[暗号化]** の下にある **[AWS KMS キー]** の一覧を開き、使用するキーを選択します。

1. **[ドメインを追加する]** を選択します。

**注記**  
Amazon Connect チャット、タスク、E メールで既存のキーを使用するには、`connect.amazonaws.com`サービスプリンシパルに `kms:Decrypt`、`kms:GenerateDataKey*`、および アクセス`kms:DescribeKey`許可を付与する必要があります。

以下に、一般的なポリシーの例を示します。

------
#### [ JSON ]

****  

```
{
    "Id": "key-consolepolicy-3",
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": "kms:*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "connect.amazonaws.com"
            },
            "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey*",
                "kms:DescribeKey"
            ],
            "Resource": "*"
        }
    ]
}
```

------

### AWS KMS キーを作成する
<a name="q-create-key"></a>

1. **[ドメインを追加する]** ページの **[暗号化]** で、**[ AWS KMS keyを作成する]** を選択します。  
![\[AWS KMS キーを作成するボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/q-encryption-settings-1.png)

   Key Management Service (KMS) コンソールが表示されます。以下のステップに従います。

   1. KMS コンソールの **[キーの設定]** ページで、**[対称]** を選択し **[次へ]** を選択します。  
![\[[キーの設定] ページ、[対称] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)

   1. **[ラベルの追加]** ページで KMS キーのエイリアスと説明を入力して、**[次へ]** を選択します。  
![\[[ラベルの追加] ページ、エイリアス名と説明。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-create-kms-key-add-labels.png)

   1. **[キー管理者権限の定義]** ページで **[次へ]** を選択し、**[キーの使用権限の定義]** ページでもう一度 **[次へ]** を選択します。

   1. **[キーポリシーの確認と編集]** ページで、**[キーポリシー]** までスクロールします。
**注記**  
チャット、タスク、E メールで Connect AI エージェントを使用するには、キーポリシーを変更して`kms:Decrypt`、、` kms:GenerateDataKey*`、および アクセス`kms:DescribeKey`許可を` connect.amazonaws.com`サービスプリンシパルに許可します。次のコードはサンプルポリシーを示しています。  

****  

      ```
      {
          "Id": "key-consolepolicy-3",
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Principal": {
                      "AWS": "arn:aws:iam::111122223333:root"
                  },
                  "Action": "kms:*",
                  "Resource": "*"
              },
              {
                  "Effect": "Allow",
                  "Principal": {
                      "Service": "connect.amazonaws.com"
                  },
                  "Action": [
                      "kms:Decrypt",
                      "kms:GenerateDataKey*",
                      "kms:DescribeKey"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

   1. [**Finish**] を選択してください。

      次の例では、KMS キーの名前は **82af7d87** で始まります。  
![\[一般的なキーが表示されているカスタマーマネージドキーページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-create-kms-key.png)

1. **AI エージェント**の接続ブラウザタブに戻り、**AWS KMS key**リストを開き、前のステップで作成したキーを選択します。  
![\[KMS AWS キーをカスタマイズおよび選択するオプションを備えた暗号化設定インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-choose-kms-key.png)

1. **[ドメインを追加する]** を選択します。

## ステップ 3: 統合 (ナレッジベース) を作成する
<a name="enable-ai-agents-step-3"></a>

1. **AI エージェント**ページで、**統合の追加**を選択します。

1. **[統合の追加]** ページで、**[新しい統合を作成]** を選択し、ソースを選択します。  
![\[統合の追加ページ、新しい統合を作成オプション、ソースドロップダウンリスト。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wisdom-select-integration.png)

   統合を作成するステップは、選択するソースによって異なります。必要に応じて次のセクションを展開して、統合の作成を完了します。

### Salesforce 統合を作成する
<a name="salesforce-instance"></a>

Salesforce 統合を作成するには、複数ステップで構成される以下のプロセスに従います。以下のセクションでは、プロセスの各ステップを完了する方法について説明します。

#### ステップ 1: 統合を追加する
<a name="q-salesforce-1"></a>

1. 表示されるすべてのチェックボックスを選択します。これで Salesforce アカウントを適切に設定できます。  
![\[API、接続アプリの使用、および AppFlow アクセスに関する Salesforce での承認。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/q-integration-salesforce-1.png)

1. **[統合名]** ボックスに統合の名前を入力します。
**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[既存の接続を使用する]** を選択し、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

   —OR—

   **[新しい接続を作成する]** を選択し、次のステップに従います。

   1. **[本番稼働用]** または **[サンドボックス]** を選択します。

   1. **[接続名]** ボックスに接続の名前を入力します。この名前は、**https://** を除いた Salesforce の URL です。

   1. **[接続]** を選択して Salesforce にサインインし、プロンプトが表示されたら **[許可]** を選択します。

1. **[暗号化]** の下にある **[AWS KMS キー]** リストを開き、キーを選択します。

   —OR—

   **KMS AWS キーの作成**を選択し[AWS KMS キーを作成する](#q-create-key)、このセクションの前半にある「」に記載されているステップに従います。

1. (オプション) **[同期の頻度]** で **[同期の頻度]** リストを開き、同期間隔を選択します。システムのデフォルトは 1 時間です。

1. (オプション) **[取り込み開始日]** で、**[次よりも後に作成されたレコードを取り込む]** を選択して、開始日を選択します。システムはデフォルトですべてのレコードを取り込みます。

1. **[次へ]** を選択し、このトピックの次のセクションのステップに従います。

#### ステップ 2: オブジェクトとフィールドを選択する
<a name="q-salesforce-2"></a>

**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[オブジェクトとフィールドの選択]** ページで、**[使用可能なオブジェクト]** リストを開き、オブジェクトを選択します。リストにはナレッジオブジェクトのみが表示されます。

1. **[オブジェクト名のフィールドを選択]** で、使用するフィールドを選択します。**
**注記**  
デフォルトでは、システムによってすべての必須フィールドが自動的に選択されます。

1. [**次へ**] を選択します。

#### ステップ 3: 統合を確認して追加する
<a name="q-salesforce-3"></a>
+ 統合の設定を確認します。完了したら、**[統合を追加]** を選択します。

### ServiceNow 統合を作成する
<a name="servicenow-instance"></a>

1. **[統合のセットアップ]** で、**[ServiceNow アカウントが統合の要件を満たしていることを確認する]** の横にあるチェックボックスを選択します。

1. **[統合名]** ボックスに統合の名前を入力します。
**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[既存の接続を使用する]** を選択し、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

   —OR—

   **[新しい接続を作成する]** を選択し、次のステップに従います。

   1. **[ユーザー名]** ボックスに ServiceNow のユーザー名を入力します。管理者権限を持っている必要があります。

   1. **[パスワード]** ボックスにパスワードを入力します。

   1. **[インスタンス URL]** ボックスに ServiceNow の URL を入力します。

   1. **[接続名]** ボックスに接続の名前を入力します。

   1. **接続** を選択します。

   1. **[暗号化]** の下にある **[AWS KMS キー]** リストを開き、キーを選択します。

      —OR—

      **KMS AWS キーの作成**を選択し[AWS KMS キーを作成する](#q-create-key)、このセクションの前半にある「」に記載されているステップに従います。

   1. (オプション) **[同期の頻度]** で **[同期の頻度]** リストを開き、同期間隔を選択します。システムのデフォルトは 1 時間です。

   1. (オプション) **[取り込み開始日]** で、**[次よりも後に作成されたレコードを取り込む]** を選択して、開始日を選択します。システムはデフォルトですべてのレコードを取り込みます。

   1. [**次へ**] を選択します。

1. ナレッジベースのフィールドを選択します。以下のフィールドが必要です。
   + short\$1description
   + 数値
   + workflow\$1state
   + sys\$1mod\$1count
   + アクティブ
   + テキスト
   + sys\$1updated\$1on
   + 最新
   + sys\$1id

1. [**次へ**] を選択します。

1. 設定を確認し、必要に応じて変更し、**[統合を追加する]** を選択します。

### Zendesk 統合を作成する
<a name="zendesk-instance"></a>

**前提条件**  
Zendesk に接続するには、以下が必要です。
+ クライアント ID およびクライアントシークレット。ID とシークレットは、アプリケーションを Zendesk に登録し、OAuth 認可フローを有効にすることで取得できます。詳細については、Zendesk サポートサイトの「[Using OAuth authentication with your application](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application)」を参照してください。
+ Zendesk では、URL は `https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth` で設定されます。例えば、`https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`。

これらを取得したら、以下の手順に従います。

1. **[統合のセットアップ]** でチェックボックスを選択し、統合の名前を入力します。
**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[既存の接続を使用する]** を選択し、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

   —OR—

   **[新しい接続を作成する]** を選択し、次のステップに従います。

   1. 有効なクライアント ID、クライアントシークレット、アカウント名、接続名をそれぞれのボックスに入力し、**[接続]** を選択します。

   1. E メールアドレスとパスワードを入力して、**[サインイン]** を選択します。

   1. 表示されるポップアップで **[許可]** を選択します。

   1. **[暗号化]** の下にある **[AWS KMS キー]** リストを開き、キーを選択します。

      —OR—

      **KMS AWS キーの作成**を選択し[AWS KMS キーを作成する](#q-create-key)、このセクションの前半にある「」に記載されているステップに従います。

1. (オプション) **[同期の頻度]** で **[同期の頻度]** リストを開き、同期間隔を選択します。システムのデフォルトは 1 時間です。

1. (オプション) **[取り込み開始日]** で、**[次よりも後に作成されたレコードを取り込む]** を選択して、開始日を選択します。システムはデフォルトですべてのレコードを取り込みます。

1. [**次へ**] を選択します。

1. ナレッジベースのフィールドを選択して、**[次へ]** を選択します。

1. 設定を確認し、必要に応じて変更し、**[統合を追加する]** を選択します。

統合の作成後は、URL のみを編集できます。

### SharePoint Online 統合を作成する
<a name="sharepoint-instance"></a>

**前提条件**  
SharePoint に接続するには、以下の項目が必要です。
+ SharePoint では、リダイレクト URL は `https://[AWS REGION].console.aws.amazon.com/connect/v2/oauth` で設定されます。例えば、`https://ap-southeast-2.console.aws.amazon.com/connect/v2/oauth`。

**注記**  
SharePoint Online 接続では、AUTHORIZATION\$1CODE のみがサポートされています。CLIENT\$1CREDENTIALS はサポートされていません。

この項目を取得したら、以下の手順に従います。

1. **[統合のセットアップ]** でチェックボックスを選択し、統合の名前を入力します。
**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[S3 との接続]** で、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

   —OR—

   **[新しい接続を作成する]** を選択し、次のステップに従います。

   1. 両方のボックスにテナント ID を入力し、接続名を入力して **[接続]** を選択します。

   1. E メールアドレスとパスワードを入力して SharePoint にサインインします。

   1. **[暗号化]** の下にある **[AWS KMS キー]** リストを開き、キーを選択します。

      —OR—

      **KMS AWS キーの作成**を選択し[AWS KMS キーを作成する](#q-create-key)、このセクションの前半にある「」に記載されているステップに従います。

   1. **[同期の頻度]** で **[同期の頻度]** リストを開き、同期間隔を選択します。

   1. [**次へ**] を選択します。

1. **[Microsoft SharePoint Online サイトの選択]** で、リストを開いてサイトを選択します。

1. **[サイト名からフォルダを選択]** で、ドメインに含めるフォルダを選択し、**[次へ]** を選択します。**

1. 設定を確認し、必要に応じて変更し、**[統合を追加する]** を選択します。

### Amazon Simple Storage Service 統合を作成する
<a name="s3-instance"></a>

1. **[統合名]** ボックスに統合の名前を入力します。
**ヒント**  
同じソースから複数の統合を作成する場合は、名前を区別しやすくするための命名規則を作成することをお勧めします。

1. **[Microsoft SharePoint Online との接続]** で、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

   —OR—

   **[S3 との接続]** で Amazon S3 バケットの URI を入力し、**[次へ]** を選択します。

   —OR—

   **[S3 を参照]** を選択し、検索ボックスを使用してバケットを検索し、その横にあるボタンを選択して **[選択]** を選択します。

1. **[暗号化]** の下にある **[AWS KMS キー]** リストを開き、キーを選択します。

   —OR—

   **KMS AWS キーの作成**を選択し[AWS KMS キーを作成する](#q-create-key)、このセクションの前半にある「」に記載されているステップに従います。

1. [**次へ**] を選択します。

1. 設定を確認し、必要に応じて変更し、**[統合を追加する]** を選択します。

### Web クローラー統合を作成する
<a name="web-crawler-q"></a>

 Web クローラーは、シード URL から始まる HTML ページに接続してクロールし、同じ上位のプライマリドメインとパスの下にあるすべての子リンクを巡回します。HTML ページのいずれかがサポートされているドキュメントを参照している場合、それらのドキュメントが同じ上位のプライマリドメイン内にあるかどうかにかかわらず、Web クローラーはそれらのドキュメントを取得します。

**サポートされている機能**
+  クロールする複数の URL を選択します。
+  「許可」や「拒否」などの標準の robots.txt ディレクティブを尊重します。
+  クロールする URL の範囲を制限し、オプションでフィルターパターンに一致する URL を除外します。
+  URL のクローリング速度を制限します。
+  Amazon CloudWatch でクローリング中にアクセスされた URL のステータスを表示します。

#### 前提条件
<a name="web-crawler-q-prerequisites"></a>
+  ソース URL をクロールする権限があることを確認します。
+  ソース URL に対応する robots.txt へのパスが URL のクロールをブロックしていないことを確認します。Web クローラーは、robots.txt の基準に準拠しています。ウェブサイトに robots.txt が見つからない場合は、デフォルトで許可しません。Web クローラーは、[RFC 9309](https://www.rfc-editor.org/rfc/rfc9309.html) に従って robots.txt を尊重します 
+  動的に生成されたコンテンツのクローリングは現在サポートされていないため、ソース URL ページが JavaScript で動的に生成されたかどうかを確認します。これは、ブラウザに次のリンクを入力して確認できます: `view-source:https://examplesite.com/site/` 本文要素に含まれる `div` の要素が 1 つだけで、`a href` の要素がほとんどまたはまったくない場合、ページは動的に生成されている可能性があります。ブラウザで JavaScript を無効にしてウェブページを再読み込みし、コンテンツが正しくレンダリングされ、目的のウェブページへのリンクが含まれているかどうかを観察できます。

**注記**  
ウェブクロールのデフォルトのタイムアウトは 1 時間で、この制限に達すると自動的に停止します。

**注記**  
クロールするウェブサイトを選択するときは、[Amazon 適正利用規約](https://aws.amazon.com/aup/)およびその他の Amazon 利用規約のすべてに準拠する必要があります。自分のウェブページ、またはクロールすることを許可されているウェブページをインデックスするためにのみ、ウェブクローラーを使用することに留意してください。

#### 接続設定
<a name="web-crawler-q-config"></a>

 オブジェクトフィールドを持つ既存の統合を再利用するには、**[既存の接続を使用する]** を選択し、**[既存の接続の選択]** リストを開いて接続を選択し、**[次へ]** を選択します。

新しい統合を作成するには、以下のステップに従います。

1. **[新しい接続を作成する]** を選択します。

1.  **[統合名]** ボックスで、統合にわかりやすい名を割り当てます。  
![\[ユーザーが新しい接続の名前を入力する統合名フィールドを示すウェブクローラー統合設定ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/web-crawler-ai-agent-config-1.png)

1.  **ウェブクローラーとの接続 > ソース URL **セクションで、クロールする URL の**ソース URL** を指定します。**ソース URL の追加**を選択すると、最大 9 つの URL を追加できます。ソース URL を提供することで、そのドメインをクロールする権限があることを確認することになります。    
![\[クロールする URL を入力するフィールドでウェブクローラー接続を設定するためのソース URL セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/web-crawler-q-config-2.png)

1.  詳細設定では、オプションでデフォルトの KMS キーまたはカスタマーマネージドキー (CMK) を使用するように設定できます。

1.  **[同期の範囲]** の下 

   1.  ソース URL をクローリングする**範囲** のオプションを選択します。各ページ URL とシード URL の特定の関係に基づいて、クロールする URL の範囲を制限することができます。クローリングを高速化するために、シード URL のホストと初期 URL パスと同じものを持つ URL に制限できます。より広い範囲をクロールする場合は、同じホストを持つ URL をクロールするか、シード URL の任意のサブドメイン内をクロールするかを選択できます。  
**注記**  
過剰になりうるウェブページをクローリングしていないことを確認してください。フィルターや範囲の制限なしで wikipedia.org などの大規模なウェブサイトをクロールすることはお勧めしません。大規模なウェブサイトのクローリングには非常に時間がかかります。  
[サポートされているファイルタイプ](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html)は、範囲に関係なく、またファイルタイプに除外パターンがない場合にクロールされます。

   1.  **クローリング速度の最大スロットリング** を入力します。ホストごとに 1 分あたり 1～300 URL を取り込みます。クローリング速度が高いほど負荷は増加しますが、所要時間は短くなります。

   1.  **URL 正規表現**パターン (オプション) では、ボックスに正規表現パターンを入力して、**包含パターン**または**除外パターン**を追加できます。**[新しいパターンを追加する]** を選択すると、包含および除外フィルターパターンをそれぞれ最大 25 個追加できます。包含パターンと除外パターンは、適用範囲に従ってクロールされます。競合がある場合、除外パターンが優先されます。

      1.  適用範囲に従って、特定の URL を含めることも除外することもできます。[サポートされているファイルタイプ](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-ds.html)は、範囲に関係なく、またファイルタイプに除外パターンがない場合にクロールされます。包含フィルターと除外フィルターを指定し、両方が URL に一致する場合、除外フィルターが優先され、ウェブコンテンツはクロールされません。
**重要**  
[破壊的なバックトラック](https://docs.aws.amazon.com/codeguru/detector-library/python/catastrophic-backtracking-regex/)と先読みにつながる問題のある正規表現パターンフィルターは拒否されます。

      1.  以下は、「.pdf」または PDF ウェブページの添付ファイルで終わる URL を除外する正規表現フィルターパターンの例です: `.*\.pdf$`   
![\[PDF ファイルの除外パターンの例を示す URL 正規表現パターンセクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/web-crawler-q-config-3.png)

1. [**次へ**] を選択します。

1.  統合の詳細をすべて確認します。  
![\[最終送信前のウェブクローラー設定のすべての統合の詳細を示すレビューページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/web-crawler-q-config-4.png)

1.  **[統合を追加する]** を選択します。

1.  統合がリストに追加されます。

### Bedrock ナレッジベース統合を作成する
<a name="bedrock-knowledge-base-integration-ai-agents"></a>

オーケストレーションタイプ AI エージェントでは、独自の Bedrock ナレッジベースを使用して、Connect AI エージェントをシームレスに操作できるようになりました。

**注記**  
Bedrock ナレッジベース統合タイプは、オーケストレーションエージェントタイプとのみ互換性があります。

**注記**  
Bedrock ナレッジベースの統合は、コンタクト時の呼び出しでのみ使用でき、コンタクト外の手動検索はサポートされていません。

1. 新しい統合を追加する  
![\[統合の追加ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/add-integration-page-ai-agents.png)

1. Bedrock ナレッジベースを選択する  
![\[データソースリストから Bedrock ナレッジベースを選択する\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-select-byobkb-data-source.png)

1. 既存の Bedrock ナレッジベースを選択する  
![\[既存の Bedrock ナレッジベースの選択\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-selecting-bedrock-knowledge-base.png)

1. 統合を確認して追加する  
![\[BYOBKB のレビューと統合ページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ai-agents-byobkb-review-and-integrate.png)

既存の Bedrock ナレッジベースを Connect の AI エージェントと正常に統合しました

**注記**  
SalesForce や ServiceNow などの SaaS アプリケーションからオブジェクトを削除した場合、Amazon Connect ナレッジベースはそれらの削除を処理しません。ナレッジベースからオブジェクトを削除するには、SalesForce でオブジェクトをアーカイブし、ServiceNow で記事を廃止する必要があります。
Zendesk の場合、Amazon Connect ナレッジベースは記事のハード削除やアーカイブを処理しません。ナレッジベースから記事を削除するには、Zendesk で記事を非公開にする必要があります。
Microsoft SharePoint Online の場合、最大 10 個のフォルダを選択できます。
Amazon Connect は、ナレッジベースや Assistant など、Amazon Connect インスタンスに関連付けられた Connect AI エージェントリソースに`AmazonConnectEnabled:True`タグを自動的に追加します。これは、Amazon Connect から AI エージェントリソースに接続するアクセスを承認するために行われます。このアクションは、Amazon Connect のサービスにリンクされたロールの管理ポリシーにおけるタグベースのアクセスコントロールの結果として実行されます。詳細については、「[Amazon Connect でのサービスにリンクされたロールのアクセス許可](connect-slr.md#slr-permissions)」を参照してください。

## ステップ 4: Connect AI エージェントのフローを設定する
<a name="enable-ai-agents-step4"></a>

1. [接続アシスタント](connect-assistant-block.md) ブロックをフローに追加します。ブロックは、Connect AI エージェントドメインを現在の連絡先に関連付けます。これにより、問い合わせに関する基準に基づいて、特定のドメインの情報を表示できます。

   エクスペリエンス[をカスタマイズ](customize-connect-ai-agents.md)する場合は、代わりに Lambda を作成し、 [AWS Lambda 関数](invoke-lambda-function-block.md)ブロックを使用してフローに追加します。

1. Connect AI エージェントを呼び出しで使用するには、Contact Lens会話分析をリアルタイムで実行するように設定された[記録と分析の動作の設定](set-recording-behavior.md)ブロックを追加して、フローでContact Lens会話分析を有効にする必要があります。[記録と分析の動作の設定](set-recording-behavior.md) ブロックを追加するフロー内の位置は重要ではありません。

## ナレッジベースが複数ある場合はどうなりますか?
<a name="multiple-knowledge-base-tips"></a>

複数の[取得ツールを設定することで、複数のナレッジベースを利用するようにオーケストレーションエージェントを設定できます。](https://docs.aws.amazon.com/connect/latest/adminguide/multiple-knowledge-base-setup-and-content-segmentation.html)

## ナレッジベースが最後に更新された日時を確認する方法
<a name="enable-ai-agents-tips"></a>

ナレッジベースが最後に更新された日時 (使用可能なコンテンツの変更) を確認するには、[GetKnowledgeBase](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_GetKnowledgeBase.html) API を使用して `lastContentModificationTime` を参照します。

## クロスリージョン推論サービス
<a name="enable-ai-agents-cross-region-inference-service"></a>

Connect AI エージェントは[クロスリージョン推論](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html)を使用して、データ処理に最適な AWS リージョンを自動的に選択し、利用可能なリソースとモデルの可用性を最大化することでカスタマーエクスペリエンスを向上させます。選択したリージョンとは異なるリージョンでデータを処理したくない場合は、 AWS サポートにお問い合わせください。

**注記**  
既存のカスタムプロンプトは引き続きリージョン内推論を使用しますが、クロスリージョン推論機能を活用できるように、サポートされている最新のモデルにアップグレードすることをお勧めします。既存のプロンプトの移行支援については、AWS サポートにお問い合わせください。