翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Connect AI エージェントをstep-by-stepガイドと統合する
エージェントがソリューションにより早くたどり着けるように、[ステップバイステップガイド](step-by-step-guided-experiences.md)をナレッジ記事などのナレッジベースコンテンツに関連付けることができます。次に、Connect AI エージェントがエージェントに推奨されるソリューションを提供すると、コンテンツに関連付けたstep-by-stepガイドを開始するオプションも提供されます。
このトピックでは、ステップバイステップガイドをナレッジベースコンテンツに関連付ける方法について説明します。
## ステップ 1: 統合するリソースを特定する
最初のステップは、[[ステップ 2: ステップバイステップガイドをナレッジベースコンテンツに関連付ける]](#associate-guide-content) で統合コマンドを実行するために必要な情報を収集することです。
+ ステップバイステップガイドに関連付けるコンテンツリソースを含むナレッジベースの ID。
+ ナレッジベースのコンテンツリソースの ID。
+ コンテンツに関連付けるステップバイステップガイドの ARN。
以下のセクションでは、この情報を取得する方法について説明します。
### ナレッジベースの ID を取得する
ステップバイステップガイドに関連付けるナレッジベースの ID を取得するには、[ListKnowledgeBases](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListKnowledgeBases.html) API `list-knowledge-bases` を呼び出すか、CLI コマンドを実行します。
以下は、すべてのナレッジベースを一覧表示する `list-knowledge-bases` コマンドの例です。
```
aws qconnect list-knowledge-bases
```
関連付けるコンテンツリソースを含むナレッジベースを特定します。`knowledgeBaseId` をコピーして保存します。これは[ステップ 2](#associate-guide-content) で必要になります。
### コンテンツ ID を取得する
ナレッジベースのコンテンツリソースを一覧表示するには、[ListContents](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContents.html) API `list-contents` を呼び出すか、CLI コマンドを実行します。
以下は、コンテンツリソースとそのコンテンツ ID を一覧表示する `list-contents` コマンドの例です。
```
aws qconnect list-contents \
--knowledge-base-id knowledgeBaseId
```
ステップバイステップガイドに関連付けるコンテンツリソースを特定します。`contentId` をコピーして保存します。これは[ステップ 2](#associate-guide-content) で必要になります。
### ステップバイステップガイドの `flowARN` を取得する
コンテンツに関連付けるステップバイステップガイドの `flowARN` を取得する必要があります。を取得するには、管理ウェブサイトまたは CLI `flowARN`を使用するという 2 Amazon Connect つの方法があります。
------
#### [ Amazon Connect admin website ]
1. Amazon Connect 管理ウェブサイトのナビゲーションメニューで、**ルーティング**、**フロー**を選択します。
1. **[フロー]** ページで、ステップバイステップガイドを選択してフローデザイナーで開きます。
1. フローデザイナーで、**[このフローについて]** を選択し、**[ARN の表示]** を選択します。
1. `flowARN` をコピーして保存します。次の図に示すように、これは文字列全体です。
![\[ステップバイステップガイドの完全な flowARN (Amazon リソースネーム) を表示し、統合に必要な一意の識別子を示すダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/qic-flow-id.png)
`flowARN` は[ステップ 2](#associate-guide-content) で使用します。
------
#### [ AWS CLI ]
1. Amazon Connect [ListInstances](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListInstances.html) API を呼び出すか、`list-instances` の CLI コマンドを実行して、使用するインスタンスの `instanceId` を取得できます。
以下が `list-instances` のコマンドの例です。
```
aws connect list-instances
```
`instanceId` をコピーして保存します。
1. Amazon Connect [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API `list-contact-flows` を呼び出すか、CLI コマンドを実行して、使用するステップバイステップガイドを決定できます。
以下は、すべてのフローとステップバイステップガイド、およびそれらの `flowARNs` を一覧表示する `list-contact-flows` コマンドの例です。
```
aws connect list-contact-flows \
--instance-id instanceId
```
ナレッジベースに関連付けるステップバイステップガイドを特定し、その `flowARN` をコピーして保存します。`flowARN` は[ステップ 2](#associate-guide-content) で使用します。
------
## ステップ 2: ステップバイステップガイドをナレッジベースコンテンツに関連付ける
### コンテンツの関連付けを作成する
このステップを完了するには、ステップ 1 で取得した `knowledgeBaseId`、`contentId` と `flowARN` が必要です。
[CreateContentAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateContentAssociation.html) API を呼び出すか、`create-content-association` の CLI コマンドを実行して、コンテンツリソースとステップバイステップガイドをリンクできます。
+ コンテンツリソースごとに作成できるコンテンツ関連付けは 1 つだけです。
+ ステップバイステップガイドは複数のコンテンツリソースに関連付けることができます。
以下は、コンテンツリソースとステップバイステップガイドの間にコンテンツ関連付けを作成するための、`create-content-association` コマンドの例になります。
```
aws qconnect create-content-association \
--knowledge-base-id knowledgeBaseId \
--content-id contentId \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"flowArn"}}'
```
例えば、値を追加すると、コマンドは次の例のように表示されます。
```
aws qconnect create-content-association \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111 \
--association-type AMAZON_CONNECT_GUIDE \
--association '{"amazonConnectGuideAssociation":{"flowId":"arn:aws:connect:us-west-2:111111111111:instance/22222222-2222-2222-2222-222222222222/contact-flow/00711358-cd68-441d-8301-2e847ca80c82"}}'
```
### コンテンツの関連付けが存在することを確認する
[ListContentAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListContentAssociations.html) API を呼び出すか、`list-content-associations` の CLI コマンドを実行して、指定されたコンテンツのすべてのコンテンツ関連付けを一覧表示できます。
以下は、作成した関連付けが存在することを確認するために、コンテンツ関連付けのリストをリターンする `list-content-associations` のコマンドの例です。
```
aws qconnect list-content-associations \
--knowledge-base-id knowledgebaseId \
--content-id contentId
```
例えば、値を追加すると、コマンドは次の例のように表示されます。
```
aws qconnect list-content-associations \
--knowledge-base-id 00000000-0000-0000-0000-000000000000 \
--content-id 11111111-1111-1111-1111-111111111111
```
### エージェントが推奨事項とステップバイステップガイドを表示できるようにアクセス許可を割り当てる
エージェントに次の**エージェントアプリケーション**セキュリティプロファイルのアクセス許可を割り当てて、ナレッジベースコンテンツとステップバイステップガイドを表示できるようにします。
+ **AI エージェントを接続する - 表示**: エージェントがコンテンツを検索して表示できるようにします。Contact Lens 会話分析が有効な場合、自動レコメンデーションを受け取ることもできます。
+ **カスタムビュー - アクセス**: エージェントワークスペースで、エージェントがステップバイステップガイドを表示できるようにします。
既存のセキュリティプロファイルにアクセス許可を追加する方法については、「[Amazon Connect でセキュリティプロファイルを更新する](update-security-profiles.md)」を参照してください。