ゴール
Create and query an indexを参考に、Amazon Kendraでインデックスを作成してクエリを実行することができます。
スタートライン
- AWSアカウントを持っていること
ステップ1：IAMユーザーにAmazonKendraFullAccessをアタッチする
任意のIAMユーザーを選択し、「許可を追加」を選択します。
「AmazonKendraFullAccess」と検索し、「次」へを選択します。
「許可を追加」を選択します。
これで任意のIAMユーザーにAmazonKendraFullAccessがアタッチされました。
ステップ2：Amazon Kendra インデックスを設定する
Amazon Kendra consoleにアクセスし、「Create an Index」を選択します。
以下のように、Index nameとIAM role、Role nameを入力します。各項目名はご自身で
決めてください。入力したら「Next」を選択します。
次の画面では、何も変更せずに「Next」を選択します。
「Developer editions」を選択し、「Next」を選択します。
「Create」を選択します。
Statusが「Active」になったら、作成完了です。
ステップ3：IAMロールを更新する
IAM consoleで先ほど作成したRoleを選択し、「ポリシーをアタッチ」を選択します。
今回はS3を使うため、「AmazonS3ReadOnlyAccess」と検索し、ヒットしたポリシーにチェックを入れた状態で、「許可を追加」を選択します。
許可ポリシーに追加されました。
ステップ4：データソースへのS3コネクタを構成する
まずは、データソースを作成します。作成したインデックスの画面に移動し、「Data management」の「Data sources」タブを選択すると以下のような画面が表示されるので、「Add data sources」を選択します。
Sample AWS documentationの「Add dataset」を選択します。
Data sourse nameを入力し、Default Languageは「Japanese(ja)」を選択し、「Add data sourse」します。
データソースができるまで少し時間がかかるので、その間にクエリ検索に使うデータをS3にアップロードしましょう。
まずは、使用データを準備します。
検索インテントを使用してAmazon KendraとAmazon Lex を統合するに記載されているサンプルデータである、help-desk-faq.csvをダウンロードします。
このサンプルデータは英語なので、ChatGPTを使って日本語化します。
以下をコピーされても構いません。
Question,Answer,URL
ヘルプデスクはどこにありますか？,2階、201号室（エレベーターを降りた後、右に2回曲がってください）。,<document url>
ヘルプデスクの開館時間はいつですか？,営業時間は午前11時から午後2時までです。,<document url>
ラップトップの修理にはどのくらい時間がかかりますか？,ラップトップの修理には通常2時間かかります。,<document url>
スクリーンの修理にはどのくらい時間がかかりますか？,ラップトップのスクリーン修理には通常4時間かかります。,<document url>
バッテリーの修理にはどのくらい時間がかかりますか？,ラップトップのバッテリー修理は通常約1時間かかります。,<document url>
オーディオ問題の修理にはどのくらい時間がかかりますか？,ラップトップのオーディオ修理は通常15-30分かかります。,<document url>
近くにカフェはありますか？,3階にあり、毎日午前8時から午後4時まで営業しています。,<document url>
ラップトップ修理に何を持って行く必要がありますか？,"ラップトップ修理の際は、社員証、ラップトップ、VPNフォブをお持ちください。",<document url>
スクリーン修理に何を持って行く必要がありますか？,"ラップトップスクリーン修理の際は、社員証、ラップトップ、VPNフォブをお持ちください。",<document url>
バッテリー修理に何を持って行く必要がありますか？,"ラップトップバッテリー修理の際は、社員証、ラップトップ、充電ケーブルとアダプター、VPNフォブをお持ちください。",<document url>
オーディオ修理に何を持って行く必要がありますか？,"ラップトップオーディオ修理の際は、社員証、ラップトップ、ヘッドフォン/イヤーポッド、VPNフォブをお持ちください。",<document url>
新しいラップトップに何を持って行く必要がありますか？,"新しいラップトップを受け取る際は、社員証とVPNフォブをお持ちください。",<document url>
ラップトップが修理中の間、ドキュメントにどのようにアクセスしますか？,Amazon Workdocsを使用してドキュメントにアクセスできます。,<document url>
これでデータの準備は完了です。
次に、S3のページに移動し、「バケットを作成」を選択します。
AWSリージョンは「米国東部（バージニア北部）us-east-1、バケットタイプは「汎用」を選択し、バケット名を入力してバケットを作成します。
作成したバケットに移動し、「アップロード」を選択します。
先ほど作成したhelp-desk-faq.csvをアップロードします。
ステップ4：FAQを追加する
Amazon Kendraの「Data management」の「FAQ」タブから「Add FAQ」を選択します。
FAQ nameを入力し、Default languageは「Japanese(ja)」を選択します。
FAQ file formatは「.csv file -Basic」を選択し、S3で先ほどアップロードしたhelp-desk-faq.csvのパスを指定し、「Add」を選択します。
Statusが「Active」になったら追加完了です。
ステップ5：インデックスをクエリする
「Data management」の「Search indexed content」タブに移動します。
右側のSettingsのDefault language of sourse documentsから「Japanese(ja)」を選択します。
その後、「ヘルプデスクはどこにありますか？」というクエリを投げると、以下のように結果が返ってきます。
ファイルの内容を元にして回答できています。
フィニッシュ
お疲れ様でした。
値段が高いので、継続的に使用しない場合は今回作成したリソースは削除しましょう。
以下のXでも情報発信してます！
参考文献