data insights with amazon q business

Amazon Q Businessとのデータ洞察

導入

Amazon Q Businessを使用して、自然言語の理解で構造化されたデータをクエリします。この例では、Amazon Q Businessを使用して構造化されたデータを照会するアーキテクチャを調べ、Amazon Q BusinessでAmazon Athenaでコストと使用データを照会するアプリケーションを構築します。 Qビジネスを使用することができます。データベーススキーマ、列とテーブルを説明する追加のメタデータ、および指示のプロンプトを提供すると、データソースにSQLクエリを作成できます。このアーキテクチャは、追加のデータソース、クエリの検証、およびより広い範囲のユースケースをカバーするためのプロンプトテクニックを使用するために拡張できます。

建築

ワークフローには、次の手順が含まれています。

1. 最初に、ユーザーはアプリケーションロードバランサーの背後にあるチャットボットアプリケーションにアクセスします。

2. ユーザーは、Cognitoでログを記録するように求められます

3. アプリケーションは、Amazon Q Businessの範囲とIAM IDセンタートークンとCognitoからのトークンを交換します

4. このアプリケーションはIAMの役割を想定し、Secure Token Service（STS）からAWSセッションを取得し、Iam Identity Centerトークンで拡張してAmazon Q Businessと対話します

5. このアプリケーションは、自然言語クエリに基づいて、関連するプロンプトとメタデータを備えたAmazon Q BusinessのChat_Sync APIを呼び出します。 Amazon Q Businessは、関連するAthenaのクエリで実行されます

6. クエリはアテナに対して実行され、結果がWebAppに表示されます

前提条件

• AWS IDセンターを設定し、Qビジネスアプリケーションでアクセスできるユーザーを追加する必要があります。
• 既存の機能しているAmazon Qビジネスアプリケーションと、アプリケーションの前のステップで作成されたユーザーへのアクセスを提供します。
• CURデータはAthenaで利用できます。 CURデータがある場合は、以下の手順をスキップしてCURデータセットアップを行うことができます。そうでない場合は、CURデータをセットアップするいくつかのオプションがあります。
  • サンプルCURデータをセットアップするには、このラボに移動して指示に従ってください。
  • また、Athenaでデータを利用できるようにするために、接着剤クローラーをセットアップする必要があります。
• すでにSSL証明書を持っている場合は、この手順をスキップできます。
• 証明書をAWS証明書マネージャー（ACM）にインポートします。詳細については、証明書のインポートを参照してください。

このソリューションを展開します。

ステップ1：Git Repoをクローンします

 git clone https://github.com/aws-samples/data-insights-with-amazon-q-business.git

• アプリ/schemas/cur_schema.txtでテーブル名を確認します。 CURデータセットアップ手順で作成したテーブル名と一致するはずです。デフォルトでは、テーブル名はcustomer_allです。データごとにスキーマ/テーブル名を変更することもできます。
• また、 APP/QB_CONFIG.pyでプロンプトを確認してください。デモについては、コードリポジトリをzipり、S3バケットにアップロードします。後でテスト結果に基づいてプロンプトを変更することもできます。

ステップ2：AWS CloudFormationテンプレートを起動して、ECG2インスタンスを含むELB、Cognitoユーザープールを展開します。WebAppをホストします。

Stackに次のパラメーターを提供します

•スタック名- CloudFormationスタックの名前（たとえば、AmazonQ-Data-Insights-Demo）

• athenadbname- athenaテーブルが存在するAthenaデータベース名

• Athenas3loc -S3アテナ出力用の場所

• AuthName - AmazonCognitoユーザープールに割り当てるグローバルにユニークな名前

• CertificateArn - 前のステップから生成されたCertificateArn

• IDCAPPLICITIONAN - アイデンティティセンターのカスタマーアプリケーションARN、このスタックの一部としてCognitoユーザープールを作成する必要があるため、最初の実行時に空白を保ちます。

• publicsubnetids -少なくとも2つを使用します。 EC2インスタンスとアプリケーションロードバランサーの展開に使用できるパブリックサブネットのID

• QapplicationID - Amazon Qの既存のアプリケーションID

• s3codeloc-コードzipファイルのフルS3位置

• VPCID - デモの展開に使用できる既存のVPCのID

スタックが完了したら、[出力]タブから次のキーをコピーします。

オーディエンス：アイデンティティセンターで顧客アプリケーションをセットアップする視聴者

ROLEARN ：アイデンティティセンターでトークン交換をセットアップするために必要なIAMの役割のARN

Trustedissuerurl ：信頼できる発行者のエンドポイントからIDセンターをセットアップする

URL ：Road -Balancer URLは、流れ目アプリにアクセスする

次のステップ：さらに進めるには、このソリューションにリストされている手順2-6に従って、WebAppを展開する必要があります。

ログイン

これで、資格情報を使用してアプリにログインできるようになりました。

例

エンドツーエンドワークフローには5つの主要なステップがあります -

1. ユーザーの意図 - 自然言語クエリ
2. プロンプトビルダー - Qビジネスのオープンドメインプロンプトとテーブルスキーマおよびメタデータ情報
3. Amazon Q Businessがクエリを生成します
4. クエリはアテナに対して実行されます
5. 結果はWebAppに表示されます。

サンプルデータセットは2023年からのものであることに注意してください。現在の年を参照する自然言語クエリは、結果を返さないでしょう。

これがあなたが今実行できるより多くのサンプルの自然言語クエリを紹介します

 - what were the top 3 services by spend last year
- Total spend for ES for each month of 1st quarter of last year
- Give me a list of the top 3 products by total spend last year. For each of these products, what percentage of the overall spend is from this product?
- what all sagemaker instance types i used last year and what was their cost

掃除

クラウドフォーメーションスタック、Qビジネスアプリケーション、アテナテーブルを削除します。

安全

詳細については、貢献を参照してください。

ライセンス

このライブラリは、MIT-0ライセンスに基づいてライセンスされています。ライセンスファイルを参照してください。