data insights with amazon q business

Data Insights com a Amazon Q Business

Introdução

Consulte quaisquer dados estruturados com entendimento da linguagem natural usando os negócios da Amazon Q. Neste exemplo, examinaremos uma arquitetura para consultar dados estruturados usando os negócios da Amazon Q e criar um aplicativo para consultar dados de custo e uso na Amazon Athena com os negócios da Amazon Q. Q Os negócios podem ser usados ​​Crie consultas SQL para suas fontes de dados quando fornecidas com o esquema de banco de dados, metadados adicionais descrevendo as colunas e tabelas e instruções de solicitação. Essa arquitetura pode ser estendida para usar fontes de dados adicionais, validação de consultas e técnicas de solicitação para cobrir uma ampla gama de casos de uso.

Arquitetura

O fluxo de trabalho inclui as seguintes etapas:

1. Primeiro, o usuário acessa o aplicativo Chatbot, que está hospedado atrás de um balanceador de carga de aplicativos.

2. O usuário é solicitado a registrar com o Cognito

3. O aplicativo troca o token da Cognito com um token do IAM Identity Center com o escopo para a Amazon Q Business

4. O aplicativo assume um papel de IAM e recupera uma sessão da AWS do Secure Token Service (STS), aumentado com o IAM Identity Center Token para interagir com a Amazon Q Business

5. O aplicativo chama a API Chat_sync da Amazon Q Business com prompt e metadados relevantes com base na consulta de linguagem natural. Amazon Q Business responde de volta com a consulta relevante de Athena para ser executada

6. A consulta é executada contra a Athena e os resultados exibidos no webApp

Pré -requisitos

• Você precisa configurar o AWS Identity Center e adicionar usuários aos quais você pretende dar acesso ao seu aplicativo comercial Q.
• Um aplicativo de negócios da Amazon Q existente e fornece acesso aos usuários criados na etapa anterior do aplicativo.
• Os dados CUR estão disponíveis em Athena. Se você tiver dados CUR, poderá pular as etapas abaixo para configuração de dados CUR. Caso contrário, você tem algumas opções para configurar dados CUR:
  • Para configurar dados de amostra, vá para este laboratório e siga as instruções.
  • Você também precisará configurar um rastreador de cola para disponibilizar os dados em Athena.
• Se você já possui um certificado SSL, pode pular esta etapa, de outra forma, gerar um certificado privado
• Importe o certificado para o AWS Certificate Manager (ACM). Para mais detalhes, consulte a importação de um certificado.

Implante esta solução:

Etapa 1: Clone the Git Repo

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

• Revise o nome da tabela em App/Schemas/Cur_schema.txt . Ele deve corresponder ao nome da tabela que você criou nas etapas de configuração de dados CUR. Por padrão, o nome da tabela é cliente_all . Você também pode modificar o nome do esquema/tabela de acordo com seus dados.
• Além disso, revise os prompts em app/qb_config.py . Para a demonstração, faça um zíper do repositório de código e envie -o para um balde S3. Você também pode modificar os avisos com base nos resultados do seu teste posteriormente.

Etapa 2: Inicie o Modelo de Formação em Cloud da AWS para implantar o Pool de usuários Cognito, incluindo a instância do EC2 para hospedar o WebApp.

Forneça os seguintes parâmetros para a pilha

• Nome da pilha -o nome da pilha de informações sobre a nuvem (por exemplo, Amazonq-Data-Insights-Demo)

• Athenadbname - Nome do banco de dados Athena onde a tabela CUR reside

• ATHENAS3LOC - S3 Localização para a produção de Athena

• Authname - um nome globalmente único a ser atribuído ao pool de usuários da Amazon Cognito

• certatearn - o certificado gerado a partir da etapa anterior

• IDCAPplicationAn - Aplicativo do cliente do Centro de Identidade Arn, mantenha -o em branco na primeira execução , pois precisamos criar o pool de usuários da Cognito como parte dessa pilha para criar o aplicativo IAM Identity Center com um emissor de token confiável

• PublicsubNetids - Use pelo menos dois . Os IDs das sub -redes públicas que podem ser usadas para implantar a instância do EC2 e o balanceador de carga do aplicativo

• qapplicationId - o ID do aplicativo existente da Amazon Q

• S3Codeloc - Localização completa do S3 do arquivo zip de código

• VPCID - o ID do VPC existente que pode ser usado para implantar a demonstração

Quando a pilha estiver concluída, copie as seguintes teclas da guia Saída.

Audiência : público para configurar o aplicativo de cliente no centro de identidade

Rolearn : ARN da função de IAM necessária para configurar a troca de token no centro de identidade

Trustedissuerurl : endpoint do emissor confiável para configurar o Centro de Identidade

URL : o URL do balanceador de carga para acessar o aplicativo Streamlit

Próximas etapas: Para prosseguir, você precisa seguir as etapas 2-6 listadas nesta solução para implantar o WebApp

Conecte-se

Agora você pode fazer login no aplicativo usando suas credenciais.

Exemplos

O fluxo de trabalho de ponta a ponta tem 5 etapas principais -

1. Intenção do usuário - consulta de linguagem natural
2. Prompt Builder - Prompt de domínio aberto para negócios Q, juntamente com o esquema de tabela e informações de metadados
3. Amazon Q Business gera a consulta
4. A consulta é executada contra Athena
5. Os resultados são exibidos no WebApp.

Observe que o conjunto de dados de amostra é do ano 2023. Consultas de idioma natural referente ao ano atual não darão resultados de retorno.

Aqui estão mais algumas amostras de consultas de linguagem natural que você pode executar agora

 - 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

Limpar

Exclua a pilha de formação em nuvem, o aplicativo de negócios Q e as tabelas Athena.

Segurança

Consulte contribuindo para mais informações.

Licença

Esta biblioteca está licenciada sob a licença MIT-0. Veja o arquivo de licença.