Chat IA
Chaque site de documentation Jamdesk inclut un assistant de chat IA intégré. Les visiteurs posent des questions et obtiennent des réponses avec des citations de votre documentation.
Chaque site Jamdesk inclut un assistant de chat qui répond aux questions des visiteurs à partir de votre documentation. Il récupère les sections pertinentes, les envoie à Claude et diffuse une réponse avec des liens vers les pages sources. Le chat est activé par défaut sur tous les plans sans coût supplémentaire.
Les captures d'écran montrent l'interface en anglais.
Cas d'utilisation
Un développeur intégrant votre API demande « Comment authentifier les requêtes ? » et obtient les étapes exactes avec un exemple de code, ainsi qu'un lien vers la page source.
Fonctionnement
À chaque build, Jamdesk divise vos pages en sections et les stocke sous forme d'embeddings consultables.
Le bouton « Ask AI » (ou Cmd+I / Ctrl+I) ouvre un panneau de chat sur n'importe quelle page.
Les sections pertinentes sont récupérées, envoyées à Claude comme contexte, et la réponse est diffusée avec des liens de citation vers les pages sources.
Fonctionnalités
| Fonctionnalité | Détail |
|---|---|
| Réponses en streaming | Les réponses arrivent en temps réel |
| Liens de citation | Chaque réponse renvoie vers les pages de documentation dont elle est issue |
| Désambiguïsation | Lorsqu'une question correspond à plusieurs sujets, l'IA demande lequel le visiteur souhaite explorer |
| Contexte de conversation | Historique de 10 messages, persisté par onglet de navigateur |
| Questions de démarrage | Auto-générées à partir de votre documentation, ou définies manuellement dans docs.json |
| Raccourcis clavier | Cmd+I / Ctrl+I pour afficher/masquer, Échap pour fermer |
| Rendu Markdown | Les blocs de code, tableaux et listes s'affichent dans les réponses |
Configuration
{
"chat": {
"enabled": true,
"starterQuestions": [
"How do I get started?",
"What API endpoints are available?"
]
}
}| Champ | Type | Défaut | Description |
|---|---|---|---|
enabled | boolean | true | Définir à false pour supprimer le panneau de chat et le raccourci clavier de votre site |
starterQuestions | string[] | auto-générées | Jusqu'à 4 questions affichées à l'ouverture du panneau (5 à 200 caractères chacune). Auto-générées lors des builds si omises. Définir à [] pour n'en afficher aucune |
Le chat est activé par défaut. Vous n'avez besoin du champ chat dans docs.json que pour personnaliser les questions de démarrage ou désactiver le chat entièrement.
Pour désactiver le chat, définissez enabled à false :
{
"chat": {
"enabled": false
}
}Limites
| Limite | Valeur |
|---|---|
| Longueur maximale d'un message | 2 000 caractères |
| Longueur maximale d'une réponse | 2 048 tokens |
| Limite de débit | 10 requêtes / 60 secondes par visiteur par site |
| Historique de conversation | 10 messages par onglet |
| Questions de démarrage | 4 maximum |
Le chat fonctionne sur les domaines personnalisés. L'endpoint /_chat est same-origin, il fonctionne donc sur tout domaine depuis lequel votre documentation est servie.
À chaque build, Jamdesk divise vos pages en sections et stocke des embeddings vectoriels pour chacune. Lorsqu'un visiteur pose une question, le système effectue une recherche hybride (correspondance par mots-clés combinée à une similarité sémantique) pour trouver les sections les plus pertinentes dans votre documentation. Ces sections sont envoyées à Claude comme contexte avec des instructions pour répondre uniquement à partir de la documentation fournie. Les citations sont extraites en faisant correspondre les références de pages dans la réponse de Claude avec les sections récupérées.