【Amazon Q in Connect】ナレッジの自動推奨が日本語に対応!!さっそく試してみた

## はじめに

Amazon Q in Connect には、「会話の内容に基づくナレッジの自動推奨」機能があります。  
この機能を有効にすると、顧客とのチャットや通話の内容がリアルタイムに解析され、**質問内容に応じた適切なナレッジ記事や回答文がエージェントに自動で提示**されます。
本機能は英語環境が前提でしたが、今回のアップデートにより **日本語にも対応**しました。  
これにより、**日本語のチャットや通話内容をもとにナレッジをリアルタイムで提示**できるようになり、国内環境でも本格的に活用可能となりました。

本記事では、日本語での音声通話を例に、ナレッジ自動推奨がどのように動作するのか、  
また、その導入に必要な設定手順について解説します。

:::note info
本記事の情報は2025年6月時点のものです。
最新情報については公式ドキュメントをご確認ください。
:::


## 目次

[1. 動作環境](#1-動作環境)
[2. 前提条件](#2-前提条件)
[3. アップデート内容](#3-アップデート内容)
[4. 設定](#4-設定)
[5. 動作確認](#5-動作確認)
[6. (付録) Salesforce上の Amazon Q in Connect による自動推奨 ](#6-付録-salesforce上の-amazon-q-in-connect-による自動推奨)

## 1. 動作環境

本記事で使用する環境は以下のとおりです。

- AWS リージョン: 東京(`ap-northeast-1`)

## 2. 前提条件

本記事では以下を前提とします。

- AWSアカウントが作成されていること
- Amazon Connectの初期設定(電話番号の取得やキューの設定など)が完了していること
- 対象のインスタンスで**Amazon Q in Connectが有効化**されていること
    - [こちらの記事](https://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/enable-q.html)を参考に、 **[ナレッジベースの作成](https://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/enable-q.html#enable-q-step-3)** までの初期設定が完了していること
    - データソースの種類は問いません(本記事ではSalesforceをデータソースに選択しています)


## 3. アップデート内容

今回のアップデートにより、日本語を含む以下の6言語がサポートされるようになりました！

- 日本語
- スペイン語
- ポルトガル語
- フランス語
- 韓国語
- 中国語

https://docs.aws.amazon.com/connect/latest/adminguide/supported-languages.html#supported-languages-contact-lens

次章では、日本語での自動推奨を有効にするために必要な設定手順を紹介します。

## 4. 設定

### 4.1 AIプロンプトの作成

**ナレッジの自動推奨(Answer recommendation)** には、下記3タイプのAIプロンプトを設定する必要があります。

1. **ANSWER_GENERATION(回答生成)**
    - **目的:** ナレッジベースの文書や抜粋をもとに、顧客の意図に対応する解決アクションを生成する
    - **特徴:** 生成された応答は、エージェントがすぐに使える簡潔な回答文として提示される
    - **前提:** クエリは `Query Reformulation` によって事前に整形されたものが利用される

2. **INTENT_LABELING_GENERATION(インテントラベル生成)**
    - **目的:** エージェントと顧客の発話を分析し、**顧客の意図（インテント）を特定・要約**する
    - **特徴:** 生成されたインテントのリストは、Amazon Q in Connect ウィジェット内に表示され、エージェントが選択可能となる

3. **QUERY_REFORMULATION(クエリの再構築)**
    - **目的:** エージェントと顧客の会話の書き起こし（Transcript）をもとに、**ナレッジ検索に適したクエリを自動生成**
    - **特徴:** 顧客が直面している問題を要約し、関連性の高いナレッジ記事の検索を補助


デフォルトで用意されているAIプロンプトは、作成したAIエージェントに割り当てることができないため、上記3つのAIプロンプトを新規に作成します。

- 参考: 作成方法

https://docs.aws.amazon.com/connect/latest/adminguide/create-ai-prompts.html

---

- **Amazon Connect コンソール** > **Amazon Q** > **AIプロンプト** > **「AIプロンプトを作成」** より、プロンプトを作成します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/45cb77b2-5910-400a-8aac-ec9580d5d20e.png)


#### 作成するAIプロンプト

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/7797d306-c8b5-41b6-9eec-f74398128327.png)


 - 名前: 任意
 - AIプロンプトタイプ: [プロンプトの作成](#41-aiプロンプトの作成)で紹介した3種類(例：`回答生成`)

**「作成」** をクリックすると、それぞれのタイプに合わせたデフォルトのAIプロンプトが入力されているため、そのまま **「公開」** をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/5f2cf05b-e413-4fa0-99fe-aa2508486b47.png)

上記手順で3タイプ(`回答生成`,`インテントラベル生成`,`クエリの再構築`)のAIプロンプトを作成してください。


### 4.2 AIエージェントの作成

- **Amazon Connect コンソール** > **Amazon Q** > **AIエージェント** > **「AIエージェントを作成」** より、プロンプトを作成します

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/273348d2-a3d7-43ac-b2f0-924ff842cc43.png)


#### 作成するAIエージェント

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/3a33d560-adda-4c97-ae73-fa569b3a2c6c.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/75b08900-65ba-438b-a189-0a1bc1273b6d.png)


- 名前: 任意
- AIエージェントタイプ: **`回答の推奨`**
- ロケール: **`日本(Japanese)`**

**プロンプト**フィールドの **「プロンプトを追加」** より、[作成するAIプロンプト](#作成するaiプロンプト)で作成したAIプロンプトを3つ全て追加し、 **「公開」** をクリックしてください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/29969cff-c897-4a72-a244-ff923694afc0.png)


最後に、**「デフォルト」** >  **「編集」** より、上記で作成したAIエージェントを **「回答の推奨
」** に設定します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/2b79acd2-9707-44b0-aacb-0a4046fcbd8c.png)



### 4.3 Amazon Connectコンタクトフローの作成

検証用のコンタクトフローを作成します。
任意のコンタクトフロー内に以下画像の2つのブロックを追加します。([参考](https://docs.aws.amazon.com/connect/latest/adminguide/q-block.html))

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/1e063107-5f60-4a70-be3c-878e2283e9d6.png)


- 「記録と分析の動作を設定」ブロック
    - **Contact Lens 音声分析**より、 **`リアルタイムおよび通話後の分析`** を有効化する

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/9f02eec7-d3a9-4231-94ea-dde5c6a7baf5.png)

- 「Amazon Q Connect」ブロック
    - Amazon Connectインスタンスに紐づいているAmazon Q in Connectドメインを選択する

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/dc6f610e-70d7-4571-b940-5b7a230d38b6.png)


## 5. 動作確認

エージェントワークスペース上で、動作確認を行います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/2bc3ef9e-7c59-4f16-8a80-4effd556e6f0.png)

- エージェントステータスがAvailableになっていることを確認後、[こちらで作成したコンタクトフロー](#43-amazon-connectコンタクトフローの作成)を紐づけた電話番号に電話をかけます。(図中①)
- 着信確認後 **「通話を受信」**  をクリックします。(図中②)
- 通話が開始されるまで、Amazon Qはローディング状態となります。(図中③)



### 5.1 ナレッジの自動推奨の様子

「Amazon Connectとはどのようなサービスか、具体的に教えてください」と発話したところ、およそ5秒後に「`こちらが新しい提案です...`」と出力され、続いて **顧客の質問事項** (`アマゾンコネクトの詳細とサービス内容について知りたい。`)が出力されました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/00ca9b6b-807e-4559-b315-1aeba094452c.png)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/d270da14-0c0c-4ef7-9502-22962b498801.png)

また、**顧客の質問事項** をクリックすることで、推奨される回答が出力されました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/6650d168-69a6-4683-9385-dadd31752344.png)

::: note warn
データソースを基に出力された回答なため、環境により回答内容が異なります。
:::



## 6 (付録) Salesforce上の Amazon Q in Connect による自動推奨

Amazon Q in Connectは、Amazon Connect CTI Adapterにより、SalesforceのUIに統合することが可能です。

https://amazon-connect.github.io/amazon-connect-salesforce-cti/docs/lightning/cti-adapter/12-amazonq-integration

::: note warn
CTI Adapterのセットアップが完了したSalesforce環境での動作検証となります。
CTI Adapterのセットアップ方法については[こちら](https://amazon-connect.github.io/amazon-connect-salesforce-cti/docs/lightning/notices)を参考にしてください。
:::

### 6.1 動作確認

エージェントワークスペースを利用した場合と同様に、Salesforceと統合したAmazon Q in Connectでも、日本語による発話の検知およびナレッジの自動推奨が行われることを確認しました。(下図: Amazon Q in Connectをユーティリティバーに表示)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3843906/239767d5-fa6d-464b-b96d-5e2f62837060.png)