Chat con IA
Cada sitio de documentación de Jamdesk incluye un asistente de chat con IA integrado. Los visitantes hacen preguntas y obtienen respuestas con citas de tu documentación.
Cada sitio de Jamdesk incluye un asistente de chat que responde las preguntas de los visitantes a partir de tu documentación. Recupera las secciones relevantes, las envía a Claude y transmite una respuesta con enlaces a las páginas fuente. El chat está habilitado de forma predeterminada en todos los planes sin costo adicional.
Las capturas de pantalla muestran la interfaz en inglés.
Casos de uso
Un desarrollador que integra tu API pregunta "¿Cómo autentico las solicitudes?" y recibe los pasos exactos con un ejemplo de código, más un enlace a la página fuente.
Cómo funciona
Durante cada build, Jamdesk divide tus páginas en secciones y las almacena como embeddings buscables.
El botón "Ask AI" (o Cmd+I / Ctrl+I) abre un panel de chat en cualquier página.
Se recuperan las secciones relevantes, se envían a Claude como contexto y la respuesta se transmite con enlaces de citas a las páginas fuente.
Características
| Característica | Detalle |
|---|---|
| Respuestas en streaming | Las respuestas llegan en tiempo real |
| Enlaces de citas | Cada respuesta enlaza a las páginas de documentación de las que se obtuvo |
| Desambiguación | Cuando una pregunta coincide con varios temas, la IA pregunta cuál quiere el visitante |
| Contexto de conversación | Historial de 10 mensajes, persistido por pestaña del navegador |
| Preguntas iniciales | Generadas automáticamente desde tu documentación, o define las tuyas en docs.json |
| Atajos de teclado | Cmd+I / Ctrl+I para alternar, Escape para cerrar |
| Renderizado Markdown | Bloques de código, tablas y listas se renderizan dentro de las respuestas |
Configuración
{
"chat": {
"enabled": true,
"starterQuestions": [
"How do I get started?",
"What API endpoints are available?"
]
}
}| Campo | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enabled | boolean | true | Establece false para eliminar el panel de chat y el atajo de teclado de tu sitio |
starterQuestions | string[] | generado automáticamente | Hasta 4 preguntas que se muestran al abrir el panel (entre 5 y 200 caracteres cada una). Se generan automáticamente durante los builds si se omiten. Establece [] para no mostrar ninguna |
El chat está habilitado de forma predeterminada. Solo necesitas el campo chat en docs.json para personalizar las preguntas iniciales o deshabilitarlo por completo.
Para deshabilitar el chat, establece enabled en false:
{
"chat": {
"enabled": false
}
}Límites
| Límite | Valor |
|---|---|
| Longitud máxima de mensaje | 2,000 caracteres |
| Longitud máxima de respuesta | 2,048 tokens |
| Límite de tasa | 10 solicitudes / 60 segundos por visitante por sitio |
| Historial de conversación | 10 mensajes por pestaña |
| Preguntas iniciales | 4 como máximo |
El chat funciona en dominios personalizados. El endpoint /_chat es del mismo origen, por lo que funciona en cualquier dominio donde se sirva tu documentación.
Durante cada build, Jamdesk divide tus páginas en secciones y almacena embeddings vectoriales para cada una. Cuando un visitante hace una pregunta, el sistema ejecuta una búsqueda híbrida (coincidencia de palabras clave combinada con similitud semántica) para encontrar las secciones más relevantes de tu documentación. Esas secciones se envían a Claude como contexto con instrucciones de responder únicamente desde la documentación proporcionada. Las citas se extraen haciendo coincidir las referencias de página en la respuesta de Claude con las secciones recuperadas.