Premiers pas & configuration

Ce que vous allez apprendre

Dans cette page, vous allez créer votre premier projet, mettre à jour son nom et ses paramètres (langue, user_prompt, clé OpenAI), configurer le site public et le branding (logo, couleurs, liens, domaine personnalisé), découvrir l’adresse inbound email du projet, régler vos préférences UI (langue et thème) et ajouter des clés API pour un accès programmatique. C’est le guide pas-à-pas pour démarrer rapidement — sans jargon technique.

Premiers pas — étapes séquentielles

1

Créer un nouveau projet

  1. Ouvrez la page “Gestion de projets” et cliquez sur “Créer un projet”.
  2. Dans le formulaire, saisissez un nom clair (ex. “Support client FR”) et choisissez la langue par défaut.
  3. Optionnel : renseignez un user_prompt (le message initial pour les assistants du projet) et collez votre clé OpenAI si vous souhaitez que le projet utilise directement l’API OpenAI.
  4. Soumettez le formulaire : le projet apparaît dans la liste et vous pouvez cliquer dessus pour ouvrir son tableau de bord (onglets : Chat, Agents, Site, Insights).

::step{title=“Mettre à jour le nom et les paramètres du projet” icon=“lucide:settings”}

  1. Ouvrez le projet puis cliquez sur “Paramètres” ou l’icône de crayon.
  2. Modifiez le nom, changez la langue du projet ou ajustez le user_prompt.
  3. Pour la clé OpenAI : collez la nouvelle clé et enregistrez si vous voulez que les appels LLM du projet passent par cette clé.
  4. Cliquez sur “Enregistrer” : les changements sont immédiatement pris en compte. :::

::step{title=“Configurer le site public et le branding” icon=“lucide:globe”}

  1. Dans le projet, allez dans Paramètres > Site.
  2. Modifiez le titre public, uploadez un logo et choisissez les couleurs principales (couleurs et tokens Tailwind sont appliqués globalement).
  3. Ajoutez des liens de footer (ex. Mentions légales, Contact). Vous pouvez aussi “Scraper” une URL pour pré-remplir logo/titre/description.
  4. Pour domaine personnalisé : collez votre nom de domaine, puis suivez les instructions DNS affichées pour pointer le domaine vers la plateforme.
  5. Sauvegardez : le site public du projet utilisera le branding et, une fois le DNS propagé, sera accessible depuis votre domaine personnalisé. :::

::step{title=“Trouver l’adresse inbound email et explorer le tableau de bord” icon=“lucide:mail”}

  1. Dans le tableau de bord du projet, ouvrez la section Site ou Paramètres > Site pour voir l’adresse inbound email (utilisée pour recevoir des messages/tickets publics).
  2. Accédez aux onglets : Chat (conversations), Agents (agents configurés), Site (aperçu public) et Insights (statistiques).
  3. Les insights sont générés côté serveur (server/utils/llm/projectInsights.ts) et affichés via les helpers dans src/components/projects/tabs/Insights.vue (fonctions generateOrderedEntries, humanize). :::

::step{title=“Gérer vos préférences UI (langue & thème)” icon=“lucide:users”}

  1. En haut à droite, ouvrez le sélecteur de langue (LanguageSelector) pour changer la langue d’interface (ex. fr). Cette préférence est sauvegardée en localStorage.
  2. Cliquez sur ThemeToggle pour basculer Clair/Sombre : votre choix est également persisté en localStorage.
  3. Ces réglages sont personnels et n’affectent pas les paramètres du projet partagé avec d’autres utilisateurs. :::

::step{title=“Ajouter et gérer des clés API (accès programmatique)” icon=“lucide:key”}

  1. Allez dans Paramètres > API Keys.
  2. Cliquez sur “Créer une clé”, donnez-lui un nom et une description, choisissez une expiration si voulu, puis créez.
  3. Copiez la clé affichée — elle n’est visible qu’une seule fois à la création.
  4. Pour utiliser la clé dans vos requêtes : ajoutez l’en-tête x-api-key: VOTRE_CLE ou Authorization: Bearer VOTRE_CLE.
  5. Pour révoquer une clé : sélectionnez-la dans la liste et confirmez la suppression. Le middleware côté serveur valide x-api-key / Bearer (server/utils/auth/apiKeyAuth.ts). :::

::step{title=“Supprimer un projet et ses ressources” icon=“lucide:trash-2”}

  1. Ouvrez le menu du projet et choisissez “Supprimer”.
  2. Confirmez la suppression (attention : cette action est irréversible).
  3. La suppression nettoie les ressources associées : collections Milvus, webhooks et autres données liées au projet. :: :::

Pro tip — nommage et user_prompt

Donnez au projet un nom explicite (ex. “FAQ Produit — FR”) et rédigez un user_prompt concis. Un prompt clair améliore la pertinence des réponses générées par les agents du projet.

À éviter — suppression et clés

Supprimer un projet entraîne la suppression définitive de ses ressources (collections Milvus, webhooks…). De même, une clé API visible à la création ne pourra plus être récupérée plus tard : copiez-la et stockez-la en lieu sûr.

Récapitulatif rapide

  • Créez un projet : Paramètres > Nouveau projet.
  • Modifiez paramètres : Nom, Langue, user_prompt, Clé OpenAI dans Paramètres du projet.
  • Branding : Paramètres > Site (logo, couleurs, footer, domaine).
  • Inbound email : affichée dans Paramètres > Site pour recevoir tickets publics.
  • API Keys : Paramètres > API Keys — créez/copiez une seule fois, utilisez x-api-key ou Bearer.
  • Préférences UI : LanguageSelector et ThemeToggle (persistés en localStorage).

Prochaines étapes

  • Page 2 : Configurer et lancer un Agent (agents & workflows).
  • Page 3 : Gestion des conversations et du chat.
  • Page 4 : Insights approfondis et rapports.

Si vous êtes prêt·e, passez à la page suivante pour apprendre à créer votre premier Agent et le connecter au projet.