data insights with amazon q business

亞馬遜Q業務的數據見解

介紹

使用Amazon Q業務查詢任何具有自然語言理解的結構化數據。在此示例中，我們將使用Amazon Q業務來查看一個架構來查詢結構化數據，並通過Amazon Q Business在Amazon Athena查詢成本和使用數據的應用程序。 Q業務可用於與數據庫架構，其他描述列和表格的其他元數據以及提示說明時，可以在數據源中創建SQL查詢。可以擴展此體系結構以使用其他數據源，查詢驗證和提示技術來涵蓋更廣泛的用例。

建築學

工作流包括以下步驟：

1. 首先，用戶訪問聊天機器人應用程序，該應用程序託管在應用程序負載平衡器後面。

2. 提示用戶與cognito登錄

3. 該應用程序將來自Cognito的令牌與IAM身份中心代幣與Amazon Q Business的範圍交換

4. 該應用程序扮演IAM角色，並從安全令牌服務（STS）中檢索AWS會話，並加上IAM身份中心令牌與Amazon Q Business互動

5. 該應用程序根據自然語言查詢，使用相關的提示和元數據調用Amazon Q業務的CHAT_SYNC API。亞馬遜Q業務與相關的雅典娜查詢回應

6. 該查詢與雅典娜有關，並在WebApp上顯示結果

先決條件

• 您需要設置AWS身份中心，並添加打算在Q業務應用程序中訪問的用戶。
• 現有的，有效的Amazon Q業務應用程序，並訪問該應用程序上一步中創建的用戶。
• CUR數據可在雅典娜獲得。如果您有CUR數據，則可以跳過以下步驟進行CUR數據設置。如果沒有，您已經有幾個選項來設置CUR數據：
  • 要設置示例CUR數據，請轉到此實驗室並按照說明進行操作。
  • 您還需要設置一個膠水軌，以使數據在雅典娜提供。
• 如果您已經擁有SSL證書，則可以跳過此步驟，否則會生成私人證書
• 將證書導入AWS證書經理（ACM）。有關更多詳細信息，請參閱導入證書。

部署此解決方案：

步驟1：克隆git倉庫

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

• 查看app/schemas/cur_schema.txt下的表名稱。它應該匹配您在CUR數據設置步驟中創建的表名稱。默認情況下，表名是customer_all 。您還可以根據數據修改模式/表名稱。
• 另外，請查看app/qb_config.py下的提示。對於演示，將代碼存儲庫匯總並將其上傳到S3存儲庫。您還可以根據測試結果修改提示。

步驟2：啟動AWS雲形式模板以部署ELB，Cognito用戶池，包括EC2實例，以託管WebApp。

為堆棧提供以下參數

•堆棧名稱- CloudFormation stack的名稱（例如，Amazonq-Data-Inglights-demo）

• athenadbname-雅典娜數據庫名稱cur桌子所在的位置

• Athenas3loc -S3雅典娜輸出位置

• authname - 一個全球唯一名稱，要分配給亞馬遜cognito用戶池

•證書- 從上一步生成的證書

• IDCAPPLICATIONARN - 身份中心客戶應用程序ARN，在第一次運行中保持空白，因為我們需要創建Cognito用戶池作為此堆棧的一部分，以創建IAM身份中心應用程序，並具有可信賴的令牌發行者

• PublicSubnetids -使用至少兩。可用於部署EC2實例和應用程序負載平衡器的公共子網的ID

• QapplicationID - Amazon Q的現有應用程序ID

• S3Codeloc-完整的S3代碼zip文件的位置

• VPCID - 可用於部署演示的現有VPC的ID

堆棧完成後，從“輸出”選項卡中復制以下鍵。

受眾：在身份中心設置客戶應用的受眾

Rolearn ：在身份中心設置令牌交換所需的IAM角色的ARN

Trustedissuerurl ：受信任的發行人到設置身份中心的終點

URL ：負載平衡器URL訪問簡化應用程序

下一步：要進一步，您需要按照本解決方案中列出的步驟2-6進行部署WebApp

登入

現在，您可以使用憑據登錄到該應用程序。

例子

端到端工作流有5個主要步驟 -

1. 用戶意圖 - 自然語言查詢
2. 提示構建器 - 開放域提示Q業務以及表格架構和元數據信息
3. 亞馬遜Q業務生成查詢
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許可證的許可。請參閱許可證文件。