Rapports de bugs

Signalement de bugs vocal en une seule touche — capture la transcription, une capture d'écran, les journaux console et la relecture de session, puis transmet le bundle à un agent qui crée des tickets dans le gestionnaire choisi par votre équipe.

La fonctionnalité Rapport de bug permet à n'importe quel utilisateur de soumettre un rapport haute-fidélité sans interrompre son flux de travail. Maintenez un raccourci clavier, décrivez le problème à voix haute, relâchez — la plateforme transcrit l'enregistrement, collecte les captures d'écran et les journaux console, et traite le bundle via un agent configuré par votre administrateur. L'agent crée des tickets, publie des fils de discussion ou alerte les équipes d'astreinte en utilisant les intégrations configurées dans votre organisation. Aucun fournisseur n'est codé en dur ; c'est l'agent qui décide.

Les rapports de bugs sont désactivés par défaut pour les organisations clientes. Un administrateur doit les activer sous Paramètres → Organisation → Rapports de bugs et configurer l'agent avant qu'un utilisateur puisse soumettre un rapport.

Activer les rapports de bugs

Seuls les administrateurs et propriétaires de l'organisation peuvent accéder à cette page.

Choisissez les outils que l'agent peut appeler (par exemple, une intégration GitHub ou une intégration Jira). Ajoutez des instructions pour l'agent et remplacez éventuellement le LLM par défaut. Vous devez compléter cette étape avant que le bouton d'activation ne devienne actif.

Activez le bouton bascule Activer les rapports de bugs. Tous les membres connectés de l'organisation peuvent désormais soumettre des rapports via le raccourci clavier.

Soumettre un rapport

Le raccourci clavier est Ctrl + Maj + B (Windows / Linux) ou Cmd + Maj + B (macOS).

Ce que vous faites	Ce qui se passe
Appuyez et maintenez le raccourci	Un panneau flottant apparaît. La capture d'écran et le tampon de relecture de session sont capturés immédiatement. Le microphone commence l'enregistrement.
Décrivez le problème à voix haute	Décrivez le problème pendant que le panneau affiche une forme d'onde en direct.
Relâchez le raccourci	L'enregistrement s'arrête. Le panneau affiche Envoi… pendant le téléversement du rapport.
Maintien < 0,5 s	Considéré comme un faux déclenchement — rien n'est envoyé.
Appuyez sur Échap pendant l'enregistrement	L'enregistrement est supprimé. Rien n'est téléversé.

Une fois le téléversement terminé, le panneau bascule vers une vue Traitement qui interroge le statut en temps réel. Lorsque l'agent a terminé, vous voyez le ou les liens vers les tickets créés directement dans le panneau, avec un bouton Terminé pour fermer.

Si l'agent échoue, le panneau affiche la raison de l'échec.

Ce qui est capturé

Chaque rapport contient :

Artefact	Détails
Transcription audio	Votre enregistrement vocal, transcrit par le fournisseur STT configuré par votre organisation.
Capture d'écran de la fenêtre	Une image statique de l'écran au moment où vous avez appuyé sur le raccourci.
Relecture de session	Jusqu'à 30 secondes d'activité DOM avant le raccourci (rrweb).
Journaux console	Les 50 dernières lignes de la console du navigateur, collectées automatiquement. Les secrets et jetons sont occultés au mieux avant l'envoi du bundle.
Erreurs serveur récentes	Jusqu'à 10 erreurs de fonctions serveur observées dans la session en cours.
Contexte de page	Nom de l'application, forme de la route (les identifiants remplacés par des espaces réservés), taille de la fenêtre et navigateur/OS.

L'occultation des journaux console est au mieux. Évitez de journaliser des données sensibles dans la console du navigateur en production — le filtre détecte les schémas courants (jetons bearer, clés API, mots de passe) mais ne peut pas garantir une couverture complète.

Occultation au moment de la capture

Avant que quoi que ce soit ne quitte le navigateur :

Tous les champs de formulaire sont masqués (le contenu n'est pas capturé).
Les éléments DOM marqués data-private ou .sensitive sont floutés dans la capture d'écran et supprimés de la relecture.
Les chemins de routes ont leurs identifiants de locataires et UUID remplacés par des jetons de forme, préservant la structure de l'URL sans divulguer les identifiants réels.

Ce que reçoit l'agent

Le prompt de l'agent est initialisé avec le nom de votre organisation et lui demande de :

Inclure la transcription et les notes textuellement.
Intégrer la capture d'écran dans le ticket créé.
Ajouter une section Diagnostics avec les journaux console, les erreurs serveur récentes, le contexte de page et le lien de relecture de session.

Les administrateurs peuvent personnaliser les instructions sous Paramètres → Organisation → Rapports de bugs → Configuration de l'agent. Le champ des instructions est une zone de texte libre. Le prompt par défaut est neutre vis-à-vis des fournisseurs et fonctionne avec n'importe quel gestionnaire de tickets.

Journaux serveur

Si votre organisation dispose d'une intégration exposant un outil de requête de journaux serveur (par exemple, une intégration Grafana/Loki personnalisée créée avec le SDK d'authoring d'intégrations) et qu'elle est ajoutée aux intégrations d'outils de l'agent de rapport de bug, l'agent peut récupérer les journaux serveur corrélés dans le cadre du triage.

Lors de la soumission d'un rapport, l'agent reçoit l'identifiant utilisateur du rapporteur, les identifiants de trace des erreurs serveur récentes capturées dans la session, et la fenêtre temporelle de capture. Les instructions par défaut de l'agent lui demandent d'appeler l'outil de requête de journaux avec ce contexte pour récupérer les lignes de journaux correspondantes, puis d'inclure les lignes pertinentes dans la section Diagnostics du ticket créé — aux côtés des journaux console et de la relecture de session qui sont toujours présents.

Le triage des journaux serveur est piloté par l'agent, pas déterministe. L'agent décide quelles lignes de journaux sont pertinentes et si les inclure. La qualité de la corrélation dépend du fait que votre application journalise systématiquement les identifiants utilisateur et les identifiants de trace dans le texte de chaque ligne de journal (l'outil les fait correspondre comme des sous-chaînes brutes — filtres de ligne LogQL — plutôt qu'en exigeant des champs d'étiquettes structurés).

Pour activer :

Installez et configurez une intégration qui expose un outil de requête de journaux serveur.
Accédez à Paramètres → Organisation → Rapports de bugs → Configuration de l'agent et ajoutez cette intégration à la liste des Intégrations d'outils.

Ce que voit le rapporteur après la soumission

Le panneau reste ouvert et affiche une ligne de statut en direct pendant le traitement du rapport :

Envoi — téléversement des artefacts.
Traitement — exécution de l'agent.
Terminé — le ou les liens vers les tickets créés apparaissent sous forme de puces cliquables. Appuyez sur Terminé pour fermer le panneau.
Échec — la raison de l'échec est affichée. Le rapport est enregistré dans l'historique dans tous les cas.

Résoudre les intégrations avant la soumission

Si l'administrateur a configuré un outil nécessitant un compte OAuth personnel (par exemple, un gestionnaire de tickets qui identifie les tickets sous le nom de l'utilisateur rapporteur), le panneau affiche une section Intégrations après l'arrêt de l'enregistrement et avant l'envoi. Pour chaque outil :

Une coche verte signifie que vous avez un compte connecté — rien à faire.
Un sélecteur apparaît si vous avez plus d'un compte connecté — sélectionnez lequel utiliser.
Un bouton Connecter apparaît si aucun compte n'est connecté — cliquez dessus pour ouvrir Paramètres → Compte → Intégrations dans un nouvel onglet. Revenez au panneau après la connexion ; il revérifie automatiquement.

Le bouton Envoyer le rapport reste désactivé tant que chaque outil n'a pas d'identifiant résolvable.

Configurer l'agent

Sous Paramètres → Organisation → Rapports de bugs → Configuration de l'agent :

Champ	Ce qu'il fait
Outils	Les intégrations que l'agent peut appeler. Sélectionnez une ou plusieurs de vos intégrations installées.
Instructions	Instructions libres pour l'agent. Initialisées avec un prompt par défaut utilisant le nom de votre organisation et fonctionnant avec n'importe quel gestionnaire de tickets.
Remplacement de modèle	Facultatif. Par défaut, le LLM par défaut de l'organisation résolu via le registre d'intégrations.

Instructions par défaut

Le prompt par défaut est généré à partir du nom de votre organisation et demande à l'agent de trier le rapport, d'inclure la transcription et les notes textuellement, d'intégrer les captures d'écran, et d'ajouter une section Diagnostics. Vous pouvez le modifier librement.

Limites de débit

Les administrateurs peuvent configurer les valeurs des limites de débit sous Paramètres → Organisation → Rapports de bugs → Avancé :

Limite	Plage configurable
Par utilisateur, par heure	Configurable
Par utilisateur, par jour	Configurable
Par organisation, par jour	Configurable

Les valeurs des limites de débit sont configurables dans les paramètres. L'application en temps réel (retour d'un rejet lorsque la limite est dépassée) est planifiée et pas encore active — les rapports ne sont pas actuellement bloqués lorsque ces seuils sont atteints.

Conservation des artefacts

L'enregistrement du workflow de rapport de bug (transcription, journal de l'agent, liens vers les tickets, statut) est conservé pendant la fenêtre de rétention configurée par l'administrateur (minimum 7 jours, maximum 90 jours) et purgé par une tâche planifiée à l'expiration.

Les captures d'écran intégrées dans les tickets sont servies via des URL de service permanentes — le même mécanisme qui affiche les avatars des organisations — de sorte que l'image intégrée reste accessible pendant toute la durée de vie du ticket et ne se casse jamais. L'objet de capture d'écran est stocké sous une clé à portée de rapport non devinable dans le stockage de votre organisation ; l'accès en lecture est public-par-clé-non-devinable (afin que le proxy d'image du gestionnaire de tickets puisse le récupérer), tandis que le ticket ou le dépôt lui-même reste la surface contrôlée par accès. Le couplage de la suppression automatique des objets de capture d'écran stockés à votre fenêtre de rétention configurée est une amélioration planifiée.

Les captures d'écran s'affichent dans les tickets de dépôts privés car le proxy d'image du gestionnaire de tickets met en cache les octets au moment du rendu. La page d'historique des rapports (accessible aux administrateurs de l'organisation et au rapporteur d'origine) conserve l'enregistrement complet du rapport pendant la fenêtre de rétention configurée.

Historique des rapports

Paramètres → Organisation → Rapports de bugs → Historique affiche tous les rapports soumis dans votre organisation. Chaque entrée comprend le statut, la transcription, le journal de l'agent, les liens vers les tickets externes et des liens pour télécharger les artefacts. Seuls les administrateurs et propriétaires de l'organisation peuvent consulter l'historique complet de l'organisation ; les rapporteurs peuvent consulter leurs propres rapports.

En rapport

Intégrations — comment installer et connecter des intégrations.
Intégrations de compte — connecter des comptes OAuth personnels.
Sécurité → Occultation — le modèle d'occultation à l'échelle de la plateforme.

Rapports de bugs

Sur cette page