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许可证的许可。请参阅许可证文件。