Documentación · Referencia del administrador
Referencia de soporte
Este documento es una referencia para la pantalla de Soporte del plugin ADP Car Market Hub (Car Market Hub → Support). Cubre el AI Support Assistant, el formulario de escalada de contacto, los enlaces de documentación y los controles de la base de conocimientos local.
Cuándo usar este documento
Lea esto si necesita:
- Hacer una pregunta sobre el plugin y obtener una respuesta basada en la base de conocimientos oficial.
- Abrir un ticket de soporte estructurado cuando el asistente no pueda resolver el problema.
- Encontrar las secciones de documentación oficial y el repositorio completo de documentación.
- Gestionar el índice de conocimiento de IA local y la documentación externa almacenada en caché.
- Buscar respuestas a las preguntas más comunes en las preguntas frecuentes integradas.
Descripción general
La pantalla de Soporte es el centro de ayuda principal. Una fila de tarjetas de estado (KPI) en la parte superior resume la instalación de un vistazo, seguida de las tarjetas principales:
- Tarjetas de estado — Versión del plugin, Licencia (plan y estado operativo), Última actualización, Estado del soporte (Operativo, N errores recientes o Atención requerida) y Base de conocimientos (número de entradas indexadas).
- AI Support Assistant — interfaz de chat respaldada por un proveedor de IA gestionado, basada en la base de conocimientos local del plugin y (opcionalmente) en la documentación oficial almacenada en caché.
- Escalada de contacto — formulario de ticket estructurado que envía un correo electrónico al equipo de soporte de ADP, con adjunto opcional de diagnóstico automático.
- Documentación y recursos — enlaces a las secciones de documentación oficial y al repositorio completo de documentación.
- Conocimiento y caché — contadores y botones de mantenimiento para la base de conocimientos de IA local y la caché de documentación externa.
- Resolución rápida de problemas y preguntas frecuentes — respuestas breves seleccionadas para las preguntas más comunes.
Requisitos o prerrequisitos
- Un usuario con la capacidad de gestión del plugin.
- Para el AI Support Assistant y la caché de documentación externa: acceso HTTPS saliente desde el servidor web.
- Para el formulario de contacto: una configuración de correo de WordPress que funcione (normalmente un plugin SMTP o un relé de correo gestionado por el alojamiento).
- Cookies y JavaScript habilitados en la sesión del navegador del administrador (el asistente y el formulario dependen de AJAX).
Instrucciones paso a paso
Preguntar al AI Support Assistant
- Abra
Car Market Hub → Support. - In la tarjeta del AI Support Assistant, escriba su pregunta con sus propias palabras.
- Haga clic en Preguntar a la IA o presione
Ctrl + Enter(oCmd + Enteren macOS). - La respuesta se muestra en el panel de conversación. Cuando la respuesta hace referencia a páginas de documentación, la lista de fuentes se muestra debajo de ella.
El asistente prefiere las respuestas de la base de conocimientos local y recurre a la documentación externa almacenada en caché cuando es necesario. La pestaña activa del administrador se envía como contexto para que la respuesta pueda orientarse hacia el área en la que está trabajando actualmente. El asistente intenta responder en su idioma de administración de WordPress; si escribe en un idioma diferente, seguirá el idioma de su mensaje.
Abrir un ticket de soporte
- Desplácese hasta Escalada de contacto.
- Complete el Nombre, Correo electrónico, Asunto y Mensaje. El nombre y el correo electrónico se completan automáticamente desde su perfil de WordPress.
- Elija una Prioridad (
Low,Normal(por defecto),High,Urgent). - Deje habilitada la opción Adjuntar diagnósticos del sistema automáticamente si desea que se adjunten el registro del plugin y el WordPress
debug.log(cada uno con un límite de 2 MB). - Haga clic en Enviar ticket. Un mensaje de estado confirma el resultado en línea.
Abrir la documentación oficial
- Utilice la tarjeta Documentación y recursos para abrir: - Empezando — primeros pasos y configuración inicial. - Referencia del administrador — referencia para cada pantalla de administración. - Resolución de problemas y preguntas frecuentes — respuestas a problemas y preguntas comunes. - Guía del frontend — las páginas de búsqueda, listados y detalles orientadas al visitante. - Operaciones y mantenimiento — funcionamiento diario, importaciones y mantenimiento. - Lista de comprobación de información de soporte — qué recopilar antes de contactar con el soporte. - Documentación completa — el repositorio completo de documentación.
Cada enlace se abre en una nueva pestaña del navegador.
Mantener la base de conocimientos de IA y la caché de documentación
- En la tarjeta Conocimiento y caché, revise los contadores:
- Entradas de la base de conocimientos local — número de entradas de conocimiento indexadas localmente.
- Pares de preguntas y respuestas indexados — número de pares de preguntas y respuestas con los que el asistente puede comparar.
- Documentos en caché — páginas de documentación externa de
cached / totalalmacenadas localmente. - Utilice los botones: - Reconstruir índice de conocimiento de IA — vuelve a indexar la base de conocimientos local desde el origen. - Actualizar caché de documentación — vuelve a descargar las páginas de documentación externa. - Borrar caché de documentación — elimina la documentación externa almacenada en caché. Acción destructiva.
Usar las preguntas frecuentes
- Abra
Quick Troubleshooting & FAQen la parte inferior de la pantalla. - Haga clic en cualquier pregunta para expandir la respuesta. Las categorías se muestran en la parte inferior de cada entrada cuando están establecidas.
Referencia de configuración
La pantalla de Soporte no almacena su propia configuración. Expone el estado de tiempo de ejecución y acciones directas.
Campos del formulario de contacto
| Campo | Requerido | Notas |
|---|---|---|
| Nombre | Sí | Completado automáticamente desde el perfil del usuario actual. |
| Correo electrónico | Sí | Completado automáticamente desde el perfil del usuario actual. |
| Asunto | Sí | Texto plano. |
| Prioridad | No | Una de Low, Normal, High, Urgent. Por defecto es Normal. |
| Mensaje | Sí | Texto plano. |
| Adjuntar diagnósticos del sistema automáticamente | No | Activado por defecto. Adjunta el registro del plugin y WordPress debug.log (máx. 2 MB cada uno). |
Controles de conocimiento y caché
| Control | Efecto |
|---|---|
| Reconstruir índice de conocimiento de IA | Vuelve a crear el índice de conocimiento local utilizado para fundamentar al asistente. |
| Actualizar caché de documentación | Vuelve a descargar la instantánea de la documentación externa. |
| Borrar caché de documentación | Vacía la documentación externa almacenada en caché (el asistente dependerá únicamente de la base de conocimientos local). |
Notas operativas
- El AI Assistant llama a un proveedor de IA gestionado a través del plugin. No se envían datos brutos del cliente final a menos que los escriba explícitamente en el chat.
- El formulario de contacto envía su mensaje y cualquier diagnóstico adjunto a una dirección de soporte fija de ADP a través del correo de WordPress; este destino no es configurable en el sitio. La entrega depende de la configuración de correo de su sitio.
- El archivo adjunto de diagnóstico está destinado a ayudar a reproducir los problemas rápidamente. Cada archivo adjunto está limitado a 2 MB. Si su registro supera este límite, solo se incluirá la parte más reciente.
- La base de conocimientos local se incluye con el plugin y se reconstruye a partir de los archivos de origen. La caché de documentación externa se obtiene del repositorio de documentación oficial y se almacena localmente para que no se consulte a GitHub en cada pregunta.
- El asistente siempre recomienda abrir un ticket de soporte cuando no está seguro; considere esto como una señal explícita, no como un fallo.
Resolución de problemas
- El asistente devuelve un error. Confirme el acceso HTTPS saliente desde el servidor. Abra la consola del navegador para ver un error más específico. Inténtelo de nuevo después de un breve retraso; los errores ascendentes transitorios son comunes.
- El formulario de contacto informa de un fallo. El correo de WordPress no está configurado. Instale un plugin de correo transaccional (o haga que su proveedor de alojamiento configure SMTP) y vuelva a enviarlo.
- Falta el archivo adjunto de diagnóstico. O bien los archivos de registro no eran legibles, o bien cada uno superaba los 2 MB y se omitió. Verifique la ruta del archivo de registro en la Referencia de sistema y ayuda.
- El contador de documentos en caché muestra
0 / N. La documentación externa aún no se ha obtenido. Haga clic en Actualizar caché de documentación. - La reconstrucción del índice de conocimiento de IA informa de cero entradas. Verifique que los archivos del plugin estén intactos. Vuelva a instalar el plugin si es necesario.
- Los enlaces de recursos abren la página incorrecta. Es posible que la caché esté desactualizada; haga clic en Actualizar caché de documentación y vuelva a cargar la pantalla.