data insights with amazon q business

Aperçu des données avec Amazon Q Business

Introduction

Interrogez toutes les données structurées avec une compréhension du langage naturel à l'aide d'Amazon Q Business. Dans cet exemple, nous examinerons une architecture pour interroger les données structurées à l'aide d'Amazon Q Business, et créer une application pour interroger les données sur les coûts et l'utilisation dans Amazon Athena avec Amazon Q Business. Q Les activités peuvent être utilisées Créer des requêtes SQL à vos sources de données lorsqu'elles sont fournies avec le schéma de base de données, les métadonnées supplémentaires décrivant les colonnes et les tables et les instructions. Cette architecture peut être étendue pour utiliser des sources de données supplémentaires, des techniques de validation de requête et d'incitation pour couvrir une plus large gamme de cas d'utilisation.

Architecture

Le flux de travail comprend les étapes suivantes:

1. L'utilisateur accède d'abord à l'application Chatbot, qui est hébergée derrière un équilibreur de chargement d'application.

2. L'utilisateur est invité à se connecter avec Cognito

3. L'application échange le jeton de Cognito avec un jeton IAM Identity Center avec la portée d'Amazon Q Business

4. L'application assume un rôle IAM et récupère une session AWS de Secure Token Service (STS), augmentée avec le jeton IAM Identity Center pour interagir avec Amazon Q Business

5. L'application appelle l'API CHAT_SYNC d'Amazon Q Business avec une invite et des métadonnées pertinentes basées sur la requête en langue naturelle. Amazon Q Business réagit avec une requête d'Athéna pertinente à exécuter

6. La requête est exécutée contre Athena et les résultats affichés sur le WebApp

Condition préalable

• Vous devez configurer AWS Identity Center et ajouter des utilisateurs auxquels vous avez l'intention de donner accès dans votre application commerciale Q.
• Une application commerciale Amazon Q qui fonctionne et donne accès aux utilisateurs créés à l'étape précédente de l'application.
• Les données Cur sont disponibles à Athena. Si vous avez des données Cur, vous pouvez ignorer les étapes ci-dessous pour la configuration des données Cur. Sinon, vous avez quelques options pour configurer les données Cur:
  • Pour configurer des exemples de données Cur, accédez à ce laboratoire et suivez les instructions.
  • Vous devrez également configurer un robot de colle pour rendre les données disponibles à Athena.
• Si vous avez déjà un certificat SSL, vous pouvez ignorer cette étape autrement générer un certificat privé
• Importez le certificat dans AWS Certificate Manager (ACM). Pour plus de détails, reportez-vous à l'importation d'un certificat.

Déployez cette solution:

Étape 1: cloner le repo git

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

• Passez en revue le nom de la table sous APP / schémas / cur_schema.txt . Il doit correspondre au nom de la table que vous avez créé dans les étapes de configuration des données Cur. Par défaut, le nom de la table est client_all . Vous pouvez également modifier le nom du schéma / table selon vos données.
• Examinez également les invites sous APP / QB_CONFIG.py . Pour la démo, zippez le référentiel de code et téléchargez-le dans un seau S3. Vous pouvez également modifier les invites en fonction de vos résultats de test ultérieurement.

Étape 2: Lancez le modèle AWS CloudFormation pour déployer ELB, Cognito User Pool, y compris l'instance EC2 pour héberger le WebApp.

Fournir les paramètres suivants pour la pile

• Nom de la pile - le nom de la pile CloudFormation (par exemple, Amazonq-data-Insights-Demo)

• ATHENADBNAME - Nom de la base de données Athena où réside la table Cur

• ATHENAS3LOC - Emplacement S3 pour la sortie d'Athena

• Authname - un nom unique à affecter au pool d'utilisateurs Amazon Cognito

• Certificatarn - le certificatation généré à partir de l'étape précédente

• idcapplicationarn - Application client d'identité Centre ARN, gardez-la vide lors de la première exécution car nous devons créer le pool d'utilisateurs cognito dans le cadre de cette pile pour créer une application IAM Identity Center avec un émetteur de jeton de confiance

• Publicsubnetids - Utilisez au moins deux . Les ID des sous-réseaux publics qui peuvent être utilisés pour déployer l'instance EC2 et l'équilibreur de chargement d'application

• QapplicationId - L'ID d'application existant d'Amazon Q

• S3Codeloc - Emplacement S3 complet du fichier zip de code

• VPCID - L'ID du VPC existant qui peut être utilisé pour déployer la démo

Une fois la pile terminée, copiez les clés suivantes à partir de l'onglet de sortie.

Public : public pour configurer l'application client dans Identity Center

Rolearn : ARN du rôle IAM requis pour configurer l'échange de jetons dans le centre d'identité

TRUSTEDISSUERURL : point final de l'émetteur de confiance pour configurer le centre d'identité

URL : L'URL de l'équilibreur de chargement pour accéder à l'application rationalisée

Étapes suivantes: Pour continuer davantage, vous devez suivre les étapes 2 à 6 répertoriées dans cette solution pour déployer le webApp

Se connecter

Vous pouvez maintenant vous connecter à l'application en utilisant vos informations d'identification.

Exemples

Le flux de travail de bout en bout a 5 étapes majeures -

1. Intention de l'utilisateur - Requête en langue naturelle
2. Prompt Builder - Open Domain Invite for Q Business ainsi que le schéma de table et les informations sur les métadonnées
3. Amazon Q Business génère la requête
4. La requête est dirigée contre Athena
5. Les résultats sont affichés sur WebApp.

Notez que l'ensemble de données d'échantillon provient de l'année 2023. Les requêtes en langage naturel se référant à l'année en cours donneront des résultats de retour.

Voici quelques autres échantillons de requêtes en langage naturel que vous pouvez maintenant exécuter

 - 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

Nettoyage

Supprimez la pile de formation cloud, les tables de l'application commerciale Q et Athena.

Sécurité

Voir contribuer pour plus d'informations.

Licence

Cette bibliothèque est autorisée sous la licence MIT-0. Voir le fichier de licence.