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)

1

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.

2

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.

3

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).

4

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.

5

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)

1

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.

2

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.

3

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.

4

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.

5

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.

6

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.

7

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.
8

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.

9

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.

10

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)

1

É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.

2

É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.
3

É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éé.

4

É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.

5

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é)

1

É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”.

2

É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.

3

Étape 3 — Valider et sauvegarder

Cliquez sur “Enregistrer” ou “Sauvegarder”. L’interface confirme la réussite de l’opération (notification ou message “saved”).

4

É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)

1

Étape 1 — Ouvrir le menu du projet

Dans la page du projet, cliquez sur le menu d’actions puis choisissez “Supprimer” ou “Destroy”.

2

É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.

3

É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.

4

É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.

5

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é)

1

Étape 1 — Accéder aux paramètres Site

Dans la page du projet, allez dans Paramètres > Site (ou “Site / Branding”).

2

É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.

3

É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.

4

É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.

5

É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.

6

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”.

Les sections Marketing et Tech affichent les entrées ordonnées. Vous pouvez lire, copier et exporter les éléments. Action recommandée : regénérer si vous avez mis à jour des contenus.

L’interface montre une progression en pourcentage. Pendant ce temps, évitez de lancer plusieurs régénérations simultanées ; attendez la fin pour consulter les résultats.

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.