Chat contextuel & support
Ce que vous allez apprendre
Dans cette page vous verrez comment utiliser la zone “Chat with code” : démarrer des conversations avec sélection du modèle, lire l’historique, recevoir les réponses en streaming et profiter du contexte code automatique (RAG). Vous apprendrez aussi à copier l’adresse inbound email du projet, gérer vos API keys et activer le plugin Crisp pour un support intégré.
1) Démarrer une conversation — zone « Chat with code »
Ouvrir l'onglet Chat with code
Allez dans l’interface principale et cliquez sur l’onglet “Chat with code”.
Sélectionner un modèle AI
Dans le menu du chat, choisissez le modèle souhaité (p.ex. GPT-4, GPT-4o, etc.). Le choix influence la qualité et la rapidité des réponses.
Saisir votre message
Tapez votre question ou demande (ex. “Comment corriger cette erreur dans file X ?”) puis envoyez.
Recevoir la réponse en streaming
La réponse arrive en streaming : vous verrez le texte s’afficher au fur et à mesure. Cela évite d’attendre la réponse complète pour commencer à lire.
Consulter l'historique de conversation
L’historique se conserve : revenez à de précédents échanges pour copier une réponse, relancer ou poursuivre la conversation.
2) Le chat enrichit automatiquement avec le contexte code (RAG)
Posez une question liée au code
Exemple : “Pourquoi ce test unit échoue dans service X ?”
Le système recherche dans l'index RAG
Le chat recherche automatiquement dans l’index de votre code (RAG) : fichiers, snippets et documents indexés sont consultés sans action supplémentaire.
Réponse augmentée avec extraits de code
Si des passages pertinents sont trouvés, la réponse inclura des extraits, références de fichiers et explications concrètes.
Que faire si rien n'est trouvé
Si aucun contexte n’est trouvé, le chat l’indiquera. Dans ce cas, fournissez un extrait de code ou indexez les fichiers manquants via la page “Indexation & recherche RAG”.
Astuce
Pour de meilleurs résultats RAG, indexez les dossiers contenant vos tests et fichiers de configuration (README, logs, fichiers de build). Plus l’index est riche, plus les réponses seront précises.
3) Afficher et copier l'adresse inbound email du projet
Ouvrir le popover email du projet
Dans la barre d’en-tête du projet (ou Paramètres du projet), cliquez sur l’icône/email pour ouvrir le popover contenant l’adresse inbound.
Copier l'adresse inbound
Cliquez sur “Copier” pour récupérer l’adresse inbound. Utilisez-la pour envoyer des tickets ou emails entrants automatiquement reliés au projet.
Utilisation courante
Envoyez des rapports d’erreur, fichiers logs ou demandes de support à cette adresse pour qu’ils deviennent des tickets traitables par vos agents.
4) Emails de sortie et plugin Crisp pour le support
Configurer l'envoi d'email depuis un Agent
Quand vous créez/éditez un AgentHook, activez is_output_emailed et renseignez la liste output_emails (adresses séparées par des virgules) pour recevoir automatiquement les outputs par email (HTML/texte).
Envoyer manuellement depuis un DialogDocument
Ouvrez un DialogDocument, choisissez “Envoyer par email” et suivez la boîte de dialogue pour expédier manuellement le résultat à une adresse.
Activer le plugin Crisp (support intégré)
Allez dans Integrations / Plugins, cherchez “Crisp” puis activez-le. Connectez votre compte Crisp pour permettre le chat support directement depuis votre site ou application.
Templates d'email
Les agents utilisent des templates d’email générés automatiquement (HTML/texte). Vous pouvez prévisualiser ces templates lors de la configuration d’un AgentHook.
Erreur fréquente
Ne supposez pas que tous les emails seront envoyés sans config : si is_output_emailed n’est pas activé ou output_emails n’est pas renseigné, l’agent ne mailera pas ses résultats.
5) Gérer les clés API (non technique — guide pratique)
Accéder à Paramètres > API Keys
Ouvrez le menu Paramètres, choisissez “API Keys”.
Créer une nouvelle clé
Cliquez sur “Créer une clé”, donnez un nom et une description. Vous pouvez définir une date d’expiration optionnelle.
Copier la clé (affichée une seule fois)
Copiez la clé immédiatement : elle est affichée une seule fois pour sécurité.
Utilisation simple
Pour les intégrations, fournissez la clé dans l’entête X-API-KEY ou Authorization: Bearer <votre_clé>. Si vous n’êtes pas à l’aise, demandez à un collègue technique d’ajouter l’entête pour vous.
Révoquer une clé
Si une clé est compromise, revenez à la liste et supprimez-la (révocation immédiate).
Pour les développeurs
Les utilitaires serveur (p.ex. server/utils/auth/apiKeyUtils.ts et server/utils/auth/apiKeyAuth.ts) aident à valider et gérer les clés côté backend.
Bonnes pratiques pour les clés API
Nommez chaque clé par usage (p.ex. “CI/CD Deploy”, “Service de monitoring”) et supprimez celles qui ne servent plus. Ne partagez jamais une clé par email non chiffré.
Piège courant
Si vous ne copiez pas la clé au moment de la création, elle ne pourra pas être récupérée : il faudra générer une nouvelle clé.
Next steps
- Suivez la page suivante pour configurer les destinations, webhooks et intégrations (page 8).
- Besoin d’aide ? Activez Crisp pour discuter avec le support directement depuis votre projet.
- Pour améliorer les réponses du chat, retournez à “Indexation & recherche RAG” (page 3) et indexez les fichiers manquants.
Aller à la page suivante : Destinations, webhooks & intégrations
Passez à la configuration des destinations et intégrations pour automatiser les envois et connecter vos outils externes.