Tableau de bord, onglets et Insights
Tableau de bord, onglets et Insights
Guide détaillé pour naviguer dans le tableau de bord du projet, utiliser les onglets (Chat, Agents, Site) et comprendre la génération / le formatage des Insights
Explorez comment accéder aux différentes vues du projet, lancer la génération d’insights et interpréter leur rendu (marketing & technique).
Ce que couvre cette page
Navigation claire
Accédez rapidement aux trois onglets principaux du projet : Chat (avec contexte code), Agents (automatisation) et Site (site public et branding).
Génération d'insights
Lancer la génération automatique d’insights projet, suivre la progression en temps réel et regénérer à volonté.
Formatage lisible
Insights organisés en catégories Marketing et Technique, titres humanisés et rendu Markdown/listes/objets pour une lecture facile.
Gestion complète du projet
Créer, modifier, supprimer un projet et gérer le site (branding et domaine personnalisé) depuis les paramètres.
Suivi visuel
Progression visuelle lors de la génération (barre/anneau), persistance locale de la progression pour reprise après rechargement.
Bonnes pratiques intégrées
Conseils pour optimiser la qualité des insights : sources bien indexées, langue et prompt adaptés, tests avant publication.
Astuce — préparez vos sources
Avant de générer les insights, vérifiez que vos sources (contenus soumis, dépôt, documents) sont bien indexées et à jour. Plus les sources sont complètes et structurées, plus les insights seront pertinents.
Astuce — utilisez le bon niveau de détail
Pour des insights marketing riches, fournissez des descriptions produit et des exemples d’utilisation. Pour les insights techniques, renseignez la configuration, les dépendances et les limitations connues.
Attention — suppression définitive
La suppression d’un projet est irréversible : elle supprime ses ressources associées (indexations, webhooks, etc.). Confirmez toujours le projet et sauvegardez les éléments importants avant de supprimer.
Voir le tableau de bord et accéder aux onglets (Chat, Agents, Site)
Ouvrir la page du projet
Depuis la liste de projets, cliquez sur la carte ou le nom du projet à consulter. Vous arrivez sur la page principale du projet contenant l’en-tête (titre, actions) et le contenu central.
Repérer les onglets principaux
Sous l’en-tête du projet vous verrez les onglets principaux (généralement : Chat / Agents / Site). Ils sont présentés comme des boutons ou onglets de navigation horizontaux.
Changer d'onglet
Cliquez sur l’onglet souhaité pour basculer : Chat (conversation assistée, souvent “Chat avec le code”), Agents (configurer et lancer des agents d’automatisation) ou Site (aperçu & paramètres du site public).
Actions contextuelles
Chaque onglet expose ses propres actions (ex. générer le site, lancer un agent, ouvrir l’éditeur de prompt). Utilisez les boutons d’action dans l’en-tête ou la zone dédiée à droite.
Retour au tableau de bord
Pour revenir à la liste des projets ou au tableau de bord global, utilisez le lien de navigation ou le bouton “Retour” en haut à gauche.
Génération et formatage des Insights (onglet Insights)
Où trouver l'onglet Insights
Si le projet a déjà des insights, l’onglet Insights / Dashboard affiche deux cartes d’introduction (“Marketing” et “Technical”) et des onglets internes pour parcourir les catégories.
Lancer la génération d'insights
Cliquez sur le bouton “Générer” ou “Regénérer les insights”. Une progression s’affiche (barre ou anneau). Pendant l’opération, l’interface indique un pourcentage de progression et un message d’état.
Suivi en temps réel et persistance
La progression se met à jour en temps réel dans la page. Si vous rechargez la page pendant la génération, la progression en cours est restaurée (si elle n’est pas terminée), et la génération reprend son affichage.
Comprendre l'organisation des insights
Les insights sont séparés en deux grands groupes visibles : Marketing (ex. aperçu du projet, propositions de valeur, audience) et Technique (ex. langages, technologies, architecture, limitations). Chaque groupe est affiché sous forme d’entrées ordonnées.
Ordre d'affichage
Les éléments favorisent un ordre lisible : un ensemble de catégories prioritaires (aperçu, fonctionnalités clés, proposition de valeur côté marketing ; langages, technologies, architecture côté technique) est affiché en premier. Les autres éléments trouvés sont ajoutés ensuite.
Titres lisibles (humanisation)
Les clés techniques (p.ex. projectOverview ou programmingLanguages) sont transformées en titres lisibles : les majuscules et underscores sont convertis en espaces et la première lettre est capitalisée, pour créer des en-têtes compréhensibles.
Rendu des contenus
- Si la valeur est une chaîne : elle est affichée comme texte riche (Markdown rendu).
- Si la valeur est une liste : elle est affichée en tant que liste à puces.
- Si la valeur est un objet : chaque sous-entrée est rendue séparément (texte, listes ou sous-sections).
- Si le format n’est pas standard : il est affiché sous forme brute (JSON) pour inspection.
Interpréter les résultats
Lisez d’abord les cartes d’introduction (aperçu global), puis parcourez les sections prioritaires. Si un item vous semble incomplet, vérifiez les sources du projet (contenu et dépôt) et relancez la génération après mise à jour.
Regénérer les insights
Vous pouvez regénérer les insights à tout moment via le bouton “Regénérer”. Préférez regénérer après avoir ajouté ou corrigé du contenu pour obtenir des insights à jour.
Quand la génération échoue ou est incomplète
Si la génération ne produit pas d’items attendus, vérifiez : disponibilité des sources, langue du projet, prompt personnalisé et permissions. Mettez à jour ce qui manque, puis relancez.
Créer un projet (workflow complet)
Étape 1 — Ouvrir le formulaire de création
Dans la vue “Projets”, cliquez sur “Nouveau projet” ou le bouton “Créer un projet” visible dans l’en-tête.
Étape 2 — Renseigner le nom et paramètres
- Donnez un nom explicite au projet.
- Choisissez la langue principale.
- (Facultatif) Saisissez un prompt par défaut / pré-prompt si disponible.
- (Facultatif) Ajoutez une clé API externe si la plateforme la demande pour certaines fonctionnalités.
Étape 3 — Soumettre le formulaire
Validez le formulaire en cliquant sur “Créer” ou “Soumettre”. Vous serez redirigé vers la page du projet nouvellement créé.
Étape 4 — Résultat attendu
Le projet apparaît dans la liste. Selon votre workflow, le traitement initial des sources peut démarrer automatiquement (indexation des contenus) et vous pourrez ensuite lancer la génération d’insights.
Remarque importante
La création d’un projet nécessite d’être connecté. Si vous êtes hors session, vous serez invité à vous authentifier avant de pouvoir finaliser la création.
Modifier un projet (changer nom, langue, prompt, clé)
Étape 1 — Ouvrir les paramètres du projet
Depuis la page du projet, ouvrez le menu d’actions (souvent une icône “…”) et choisissez “Paramètres” ou “Modifier le projet”.
Étape 2 — Modifier les champs
Dans le formulaire des paramètres, mettez à jour le nom, la langue, le prompt d’accueil ou la clé externe (si applicable). Vérifiez la conformité des champs requis.
Étape 3 — Valider et sauvegarder
Cliquez sur “Enregistrer” ou “Sauvegarder”. L’interface confirme la réussite de l’opération (notification ou message “saved”).
Étape 4 — Après modification
Après modification, pensez à : régénérer les insights si le prompt/langue a changé, et vérifier la visibilité du site si vous modifiez le domaine.
Supprimer un projet (précautions et étapes)
Étape 1 — Ouvrir le menu du projet
Dans la page du projet, cliquez sur le menu d’actions puis choisissez “Supprimer” ou “Destroy”.
Étape 2 — Confirmer la suppression
La suppression demande une confirmation explicite (ex. saisir le nom du projet ou un bouton “Confirmer”). Confirmez si vous êtes certain.
Étape 3 — Conséquences à prévoir
La suppression entraîne la suppression des ressources associées (indexations, webhooks et éléments liés). Ces actions sont irréversibles ; assurez-vous d’avoir exporté ce dont vous avez besoin avant de confirmer.
Étape 4 — Vérifier la liste
Après suppression, le projet disparaît de la liste. Si nécessaire, rafraîchissez la liste des projets pour vérifier l’état.
Bonnes pratiques avant suppression
Exportez rapports ou documents importants, retirez ou désactivez webhooks externes et informez les membres du projet avant suppression.
Gérer le site du projet (branding et domaine personnalisé)
Étape 1 — Accéder aux paramètres Site
Dans la page du projet, allez dans Paramètres > Site (ou “Site / Branding”).
Étape 2 — Modifier le branding
Éditez le titre public, le logo, la palette de couleurs, le texte d’introduction et les liens de pied de page selon vos besoins.
Étape 3 — Ajouter un domaine personnalisé
Collez votre domaine personnalisé dans le champ dédié. Le système vérifiera que le domaine est unique et valide avant publication.
Étape 4 — Sauvegarder et valider
Cliquez sur “Sauvegarder”. Si le domaine nécessite une validation DNS ou une vérification, suivez les instructions qui apparaissent.
Étape 5 — Tester le site public
Une fois sauvegardé et validé, visitez le site public pour vérifier le rendu du branding et la résolution du domaine.
Astuce de sécurité
N’utilisez pas de domaines déjà rattachés à d’autres projets et conservez les informations DNS sous contrôle avant de publier.
Vous verrez les cartes d’introduction (Marketing/Technical) et un bouton pour générer les insights. Action recommandée : vérifier que vos sources ont été ajoutées puis cliquer sur “Générer”.
Marketing — ce que vous trouvez et comment l’utiliser
- Aperçu du projet (pitch court)
- Fonctionnalités clés à mettre en avant
- Proposition de valeur principale
- Exemple d’email d’introduction produit
- Segments d’audience et analyse concurrentielle
Utilisez ces éléments pour la page produit, descriptions store, pages marketing.
Technique — ce que vous trouvez et comment l’utiliser
- Langages et technologies utilisés
- Vue d’architecture condensée
- Limitations identifiées et suggestions d’amélioration
- Considérations de sécurité et scalabilité
Utilisez ces éléments pour documentation interne, onboarding d’ingénieurs et audits rapides.
Limites et erreurs courantes
- Regénérer trop fréquemment peut produire des résultats redondants ; préférez regénérer après de vraies modifications.
- Certains champs (ex. domaine personnalisé) doivent être uniques et validés avant publication : une tentative d’enregistrement d’un domaine déjà utilisé sera refusée.
- La création d’un projet n’est possible que si vous êtes authentifié ; si vous perdez la session, vous devrez vous reconnecter.
Conseil — versioning des insights
Si vos insights sont destinés à une utilisation externe (communiqués, pages produit), conservez une copie exportée avant chaque régénération afin de comparer l’évolution et revenir à une version antérieure si nécessaire.
Frequently Asked Questions
Prêt à explorer vos Insights ?
Si vous avez des projets prêts, ouvrez l’un d’eux et lancez la génération d’insights depuis l’onglet Insights pour obtenir un résumé marketing et technique immédiatement exploitable.