mcp-server

Collecte le feedback de l'utilisateur sur la réponse fournie.

Quand utiliser ce tool ?

• Après avoir fourni une analyse, une requête SQL, ou une réponse importante

• Quand tu veux savoir si la réponse était utile

• Proposer naturellement : "Cette réponse t'a été utile ? 👍 👎"

Ratings :

• 'positive' : La réponse était utile et correcte

• 'negative' : La réponse n'était pas satisfaisante

• 'neutral' : Ni satisfait ni insatisfait

Catégories (optionnel) :

• 'accuracy' : La réponse était-elle exacte ?

• 'relevance' : La réponse répondait-elle à la question ?

• 'completeness' : La réponse était-elle complète ?

• 'speed' : Le temps de réponse était-il acceptable ?

• 'other' : Autre feedback

Utilisation du feedback : Le feedback est utilisé pour améliorer les réponses futures (RAG, analytics).

Crée et sauvegarde un nouveau use case (analyse réutilisable).

Quand utiliser ce tool ?

• Quand l'utilisateur demande de "sauvegarder cette analyse", "créer un use case", "mémoriser cette requête"

• Après avoir construit une requête SQL que l'utilisateur veut réutiliser

• Pour capitaliser sur une analyse métier récurrente

Scopes disponibles :

• 'member' (défaut) : Use case personnel, visible uniquement par vous

• 'project' : Use case partagé avec toute l'équipe du projet (nécessite project_id)

Bonnes pratiques :

• Slug : identifiant technique en snake_case (ex: weekly_campaign_performance)

• Name : nom lisible pour l'utilisateur (ex: "Performance hebdo des campagnes")

• Description : expliquez le contexte métier et quand utiliser cette analyse

• SQL template : incluez la requête SQL si elle est générique et réutilisable

Supprime définitivement un use case que vous avez créé.

Quand utiliser ce tool ?

• Quand l'utilisateur demande explicitement de supprimer un use case

• Pour nettoyer des use cases obsolètes ou en doublon

⚠️ Attention : Cette action est irréversible. Le use case sera supprimé définitivement.

Permissions : Vous pouvez uniquement supprimer les use cases dont vous êtes le créateur.

Astuce : Demandez confirmation à l'utilisateur avant de supprimer.

Exécute une requête SQL SELECT sur le datawarehouse BigQuery du projet. Lecture seule, pas de modification des données.

Format des tables: Utilisez dataset.table (ex: prod_google_ads_v2.campaign_stats). Ne préfixez PAS avec un project_id.

Obtient le contexte d'un projet (connecteurs actifs, datasets disponibles). Utilisez le folderId obtenu via list_projects.

Construit le contexte schéma pour générer des requêtes SQL BigQuery. Retourne les tables pertinentes avec leurs champs et définitions sémantiques. Appelez cette fonction avec la question de l'utilisateur avant d'écrire du SQL.

IMPORTANT pour les requêtes SQL: Utilisez UNIQUEMENT le format dataset.table (ex: prod_google_ads_v2.campaign_stats). N'ajoutez JAMAIS de project_id devant les tables. Le champ full_name de chaque table contient déjà le nom complet à utiliser dans vos requêtes.

Recherche des use cases (cas d'usage) pertinents pour répondre à la question de l'utilisateur. Les use cases contiennent des templates SQL et des définitions métier. Utilisez cette fonction pour découvrir les analyses possibles.

Liste vos use cases personnels (scope: member).

Qu'est-ce qu'un use case ? Un use case est une analyse réutilisable que vous avez créée ou sauvegardée. Il contient une description métier et optionnellement un template SQL.

Quand utiliser ce tool ?

• Quand l'utilisateur demande "mes analyses", "mes use cases", "ce que j'ai sauvegardé"

• Avant de créer un nouveau use case pour vérifier qu'il n'existe pas déjà

• Pour retrouver l'ID d'un use case à modifier ou supprimer

Visibilité : Ces use cases sont privés et visibles uniquement par vous.

Liste les projets accessibles par l'utilisateur. Appelez cette fonction en premier pour connaître les projets disponibles.

Liste les use cases partagés avec l'équipe du projet (scope: project).

Quand utiliser ce tool ?

• Quand l'utilisateur demande "les analyses de l'équipe", "les use cases du projet"

• Pour voir ce que les collègues ont partagé

• Avant de partager un nouveau use case pour éviter les doublons

Visibilité : Ces use cases sont visibles par tous les membres du projet.

Modifie un use case existant que vous avez créé.

Quand utiliser ce tool ?

• Pour améliorer la description ou le SQL d'un use case existant

• Pour corriger une erreur dans un use case

• Pour changer la catégorie d'un use case

Permissions : Vous pouvez uniquement modifier les use cases dont vous êtes le créateur.

Astuce : Utilisez d'abord list_my_use_cases ou list_project_use_cases pour obtenir l'ID du use case.