Configurar el asistente del sitio de documentación

El asistente de IA responde a las preguntas de tus lectores con palabras sencillas, utilizando solo las páginas que has publicado, y enlaza cada respuesta a las páginas de donde proviene. Este artículo cubre cómo activarlo, los ajustes, las preguntas iniciales y el límite mensual de respuestas.

Antes de empezar#

• El asistente está disponible en todos los planes, incluido el gratuito. Tu plan determina cuántas respuestas recibe tu espacio de trabajo cada mes (consulta Respuestas mensuales).
• Las respuestas no consumen créditos. Solo se descuentan de las respuestas mensuales.
• Para cambiar los ajustes, debes ser el propietario del espacio de trabajo, administrador o editor.
• Los ajustes, al igual que el resto del sitio, llegan a los lectores cuando publicas.

Activar el asistente#

El asistente está desactivado en los sitios nuevos.

1. Abrir los ajustes del asistente#

   Abre tu sitio de documentación y ve a Ajustes → Asistente de IA. También puedes abrir Perspectivas → Asistente y hacer clic en Activar.

2. Activarlo#

   Activa Mostrar el asistente. Los lectores verán entonces Preguntar a la IA en el encabezado, en la página de inicio y en la búsqueda.

   

3. Elegir qué sucede cuando no puede responder#

   En Cuando no puede responder, elige Página de contacto, Un enlace o Nada. Consulta Los ajustes.

4. Guardar y publicar#

   Haz clic en Guardar y luego publica el sitio. El botón Preguntar a la IA aparecerá en el sitio en vivo con esa publicación.

Los ajustes#

Todos estos se encuentran en Ajustes → Asistente de IA. Mientras Mostrar el asistente esté desactivado, las demás filas aparecerán en gris.

Opciones de Cuando no puede responder:

El formulario de contacto se configura en Ajustes → Comentarios y contacto. Consulta Recopilar comentarios y mensajes de los lectores.

Lo que ven los lectores#

• Preguntar a la IA en el encabezado, en la página de inicio y en la búsqueda. Cuando la búsqueda no encuentra nada, se informa a los lectores de que pueden preguntar al asistente de IA en su lugar.
• Preguntar a la IA sobre esta página en un artículo, lo que abre el chat con una pregunta sobre esa página.
• Un panel de chat con algunas preguntas iniciales (Intenta preguntar), un cuadro de pregunta (hasta 2000 caracteres) y Nuevo chat.
• Respuestas con Fuentes numeradas que enlazan a tus páginas, y la línea "La IA puede cometer errores. Comprueba las fuentes."
• Copiar respuesta, Buena respuesta y Mala respuesta debajo de cada respuesta. Las valoraciones aparecen en Perspectivas → Asistente.

Cómo responde el asistente:

• Utiliza solo tus páginas publicadas. Los borradores, los cambios no publicados y las páginas que ocultaste de la navegación quedan fuera. También se utilizan las páginas del sitio como Acerca de, Preguntas frecuentes o páginas legales.
• Responde en el idioma en el que escribe el lector.
• Recuerda los últimos mensajes de la conversación, por lo que los lectores pueden hacer preguntas de seguimiento.
• Cuando la documentación no cubre una pregunta, lo indica en lugar de adivinar, y muestra lo que elegiste en Cuando no puede responder.

Preguntas iniciales#

Las preguntas iniciales son las sugerencias en un chat vacío, bajo Intenta preguntar. Sus respuestas se preparan con antelación, por lo que un lector que hace clic en una obtiene la respuesta al instante y no cuenta para tus respuestas mensuales.

Las gestionas en Perspectivas → Asistente, en la tarjeta Intenta preguntar:

• Cada idioma del sitio tiene su propia lista de hasta 6 preguntas. Los lectores ven las 4 primeras.
• Clevera vuelve a generar la lista una vez al día a partir de lo que los lectores preguntan y buscan. Un sitio nuevo comienza con "Aún no hay sugerencias" hasta que los lectores empiezan a preguntar; puedes añadir las tuyas de inmediato.
• Añadir una pregunta, Editar y Eliminar cambian la lista. Fijar mantiene una pregunta durante la actualización diaria; las preguntas fijadas aparecen primero.
• Regenerar escribe un nuevo conjunto ahora.
• Los cambios llegan a los lectores en la siguiente publicación.

Respuestas mensuales#

Cada espacio de trabajo obtiene un número de respuestas del asistente al mes, compartidas por todos sus sitios de documentación. El recuento se reinicia el día 1 de cada mes (UTC).

Algunas respuestas no cuentan:

• Hacer clic en una pregunta inicial.
• Respuestas servidas desde la caché de respuestas: cuando un lector abre un nuevo chat con una pregunta que ya se respondió recientemente, obtiene la misma respuesta y no se cuenta.
• Preguntas que el asistente no pudo responder debido a un error.

Límites que protegen tus respuestas de un sitio muy activo o de un lector:

Puedes seguir el recuento en dos lugares:

• Ajustes → Asistente de IA → Preguntas mensuales: "Incluidas en" tu plan, la fecha de reinicio y cuántas preguntas se han utilizado.
• Perspectivas → Asistente: el medidor de Respuestas este mes, con "Casi agotadas" a partir del 90%, "Agotadas" al 100%, y cuántas respuestas provienen de la caché. Aumentar límite muestra los planes con más respuestas.

Cuando se alcanza el límite#

• Los lectores que hacen una pregunta ven "El asistente no está disponible en este momento. Busca en la documentación en su lugar." La búsqueda sigue funcionando.
• Perspectivas → Asistente muestra "Las respuestas de la IA están pausadas hasta" la fecha de reinicio, con Actualizar plan.
• El asistente vuelve a estar disponible el día 1 del mes siguiente, o tan pronto como cambies a un plan con más respuestas. Cuando un sitio alcanza su cuota diaria, el asistente en ese sitio vuelve al día siguiente (UTC).

Notificaciones de uso#

El propietario del espacio de trabajo y los administradores reciben las notificaciones de uso; los propietarios, administradores y editores reciben la de las preguntas sin respuesta. Puedes cambiar los canales en tus ajustes de notificación.

Recibes cada notificación de uso una vez al mes.

Revisar conversaciones#

Perspectivas → Asistente muestra lo que preguntaron los lectores, para el rango de fechas que elijas:

• Conversaciones, Respondido (la parte respondida desde la documentación, comparada con el periodo anterior) y Calificado como útil.
• La lista de Conversaciones, de la más reciente a la más antigua. Filtra por Todos, No cubierto (el asistente no pudo responder desde la documentación), Calificado negativamente o Calificado positivamente, o busca en los mensajes. Abre una para ver la transcripción completa con cada respuesta y sus fuentes.
• Preguntas sin respuesta: "Lo que la documentación no pudo responder: escribe esto a continuación". Escribir artículo inicia un nuevo artículo a partir de la pregunta.

Consulta Leer las perspectivas del sitio de documentación para conocer los rangos de fechas y cuánto tiempo se mantiene el historial en cada plan.

Solución de problemas#

Relacionado#