Principal
Agente IA
Pregunta en lenguaje natural: síntomas, errores, flujos de instalación, configuración. Responde en segundos con fuentes de los manuales.
Guía de uso
Bienvenido a
Policharger Brain
Cargando guía personalizada…
En un vistazo
Herramientas
Lo que tienes disponible
Tickets y seguimiento
Operaciones
Cuando el agente no tiene respuesta, crea un ticket aquí. El equipo técnico lo recoge y tú recibes una notificación cuando hay resolución.
Punto de entrada
Hub
Vista general del ecosistema. Útil para orientarte o acceder rápido al agente y al panel de operaciones.
Flujo de trabajo
Tu recorrido habitual
Cuatro pasos que cubren el 95% de las situaciones de soporte.
1
El cliente tiene una duda o incidencia
Recibe la consulta: error en el cargador, problema de instalación, configuración de red, comportamiento inesperado. Apunta los síntomas concretos antes de buscar.
2
Pregunta al Agente IA
Ve a agent.html y describe el problema con contexto: modelo del cargador, síntoma exacto, lo que ha probado el cliente. El agente busca en los manuales y devuelve una respuesta con la fuente.
3
Si el agente no tiene respuesta → crea un ticket
Pulsa el botón de pulgar abajo en la respuesta del agente y selecciona "Crear ticket". También puedes ir directamente a Operaciones y usar el formulario de reporte. El equipo I+D lo revisará.
4
Sigue el estado del ticket
En Operaciones ves todos tus tickets: pendientes y resueltos. Cuando el equipo técnico lo resuelve recibes una notificación y aparece la respuesta con el conocimiento indexado.
Agente IA
Cómo preguntar bien
El agente da mejores respuestas cuanto más contexto le das. Estos ejemplos te sirven como plantilla.
Problema de carga
Un cliente tiene un Policharger NW y la carga se corta sola después de 10 minutos. ¿Qué puede estar causándolo y qué pasos le digo que siga?
Configuración
¿Cómo se configura la red WiFi en el cargador doméstico? El cliente dice que el LED parpadea naranja y no conecta.
Error visual
El LED del Policharger parpadea rojo cada 3 segundos. ¿Qué significa ese código y cómo se resuelve?
Consejo
Si la respuesta es útil pero incompleta, pide más: "¿Qué manual cubre esto exactamente?" o "¿Hay algún paso previo que deba comprobar primero?". El agente puede profundizar si se lo pides.
Tickets
Cuándo y cómo crear un ticket
Desde el Agente
Después de una búsqueda sin resultado
- Haz la consulta en el agente normalmente.
- Si la respuesta no sirve o no existe, pulsa el pulgar abajo.
- Selecciona "Crear ticket" y describe qué faltó.
- El ticket queda registrado automáticamente con tu consulta.
Desde Operaciones
Sin haber buscado antes
- Ve a Operaciones.
- Usa el formulario "Reportar consulta sin respuesta".
- Escribe la consulta exacta del cliente y qué información faltaba.
- El equipo lo recibe y tú puedes seguir el estado desde ahí.
Si ya fue respondida antes
Si creas un ticket para una consulta que ya tenía resolución, el sistema te avisará automáticamente y te mostrará un enlace directo a la resolución en Operaciones. No hace falta esperar.
Herramientas
Lo que tienes disponible
Consultas
Agente IA
Busca en toda la base de conocimiento: manuales, docs técnicas iOS/Android/Backend. Útil para localizar rápido una fuente o cruzar información entre capas.
Soporte
Tickets
Centro de tickets de I+D y SAT. Asigna, prioriza y responde tickets. Puedes resolver gaps directamente desde aquí adjuntando el conocimiento indexado.
Conocimiento
Gap-Resolve
Añade respuestas al sistema cuando hay una brecha de conocimiento. Lo que resuelves aquí queda indexado y el agente lo usa en búsquedas futuras.
Documentación
Manuales
Sube, cataloga e ingesta PDFs técnicos. La calidad de los metadatos afecta directamente la precisión del agente en las búsquedas de soporte.
Arquitectura
Docs técnicas
iOS, Android y Backend: fases, flujos, módulos y dependencias estructuradas por proyecto. Imprescindible para investigar comportamiento cross-capa.
Análisis
Impact
Visualiza cómo un cambio en una capa afecta al resto del ecosistema. Útil antes de resolver un ticket que toque API, mobile y firmware a la vez.
Flujo de trabajo
Resolver tickets y gaps paso a paso
1
Revisa los tickets pendientes
Entra en Tickets y filtra por estado pendiente. Prioriza por urgencia y tipo: los de tipo support_question suelen necesitar respuesta rápida; los de knowledge_gap requieren investigación.
2
Investiga con el agente o las docs
Usa el Agente IA para localizar la fuente exacta. Si la pregunta es de arquitectura o comportamiento de la app, ve directamente a iOS, Android o Backend. Para firmware o instalación, Manuales.
3
Resuelve el gap con conocimiento
En el ticket, usa "Resolver con conocimiento" para añadir la respuesta al índice. Si hay un manual PDF que lo cubre, puedes adjuntarlo. Así el agente aprende y el próximo SAT no necesitará crear otro ticket.
4
Valida con una búsqueda
Tras resolver, ve al agente y prueba la misma consulta. Si devuelve la respuesta correcta con la fuente, el ciclo está cerrado. Si no, lanza la ingesta desde Manuales si el contenido viene de un PDF.
Agente IA
Prompts para investigación técnica
Cross-capa
¿Qué módulos del backend participan cuando un cargador cambia de estado y cómo encaja MQTT en ese flujo?
Comportamiento móvil
Explícame el flujo de sesión de carga en iOS: desde que el usuario pulsa "iniciar carga" hasta que el backend confirma el inicio por BLE.
Gap de conocimiento
¿Qué información tiene el sistema sobre el manejo de errores OCPP cuando el cargador pierde conectividad a mitad de una sesión?
Manuales
Mantener la base documental
1
Sube el PDF correcto y definitivo
Usa el nombre y la versión final. Si hay duplicados o borradores, el agente mezcla versiones y responde peor. Borra la versión vieja antes de subir la nueva.
2
Rellena bien la metadata
Categoría, tipo de cargador y tipo de documento son los campos más importantes para filtrar. Sin ellos cuesta segmentar qué manual aplica a cada pregunta.
3
Lanza la ingesta y valida
Después de subir, ejecuta la ingesta. Espera a que termine y prueba en el agente con una pregunta cubierta por ese manual. Si responde bien con la fuente correcta, está listo.
Herramientas
Lo que tienes disponible
Búsqueda
Agente IA
Localiza fases, módulos y flujos en lenguaje natural. Más rápido que navegar las docs cuando sabes qué buscar pero no dónde está.
Apps móviles
iOS / Android
Documentación estructurada por fases, pantallas, BLE, autenticación y dependencias. El punto de referencia cuando necesitas entender arquitectura móvil.
Servidor
Backend
API, autenticación, IoT, OCPP, MQTT, reglas de negocio. Úsalo para entender cómo encajan los módulos del servidor y sus dependencias externas.
Dependencias
Impact
Visualiza qué capas se ven afectadas por un cambio. Imprescindible antes de un refactor que toque API, mobile y firmware a la vez.
Producto
Manuales
Documentación de producto en PDF: instalación, configuración, firmware. Útil para entender el comportamiento esperado desde el punto de vista del usuario final.
Flujo de trabajo
Tres recorridos habituales
¿Pregunta de arquitectura?
Agente primero
- Pregunta con contexto: capa, módulo y objetivo.
- Pide la fuente exacta si la respuesta es suficiente.
- Usa la fuente como punto de entrada a las docs estructuradas.
¿Conoces la plataforma?
Docs directamente
- Entra en iOS, Android o Backend según la capa.
- Navega a la fase o módulo concreto.
- Usa el agente solo para conectar piezas entre capas.
¿Cambio cross-proyecto?
Impact primero
- Abre Impact para ver dependencias.
- Identifica qué módulos se ven afectados.
- Luego profundiza en cada capa por separado.
Agente IA
Prompts técnicos útiles
Móvil ↔ Backend
¿Qué endpoints del backend usa la app iOS durante el flujo de inicio de sesión de carga por BLE?
Comportamiento
Explícame cómo se diferencia el flujo de autenticación en Android respecto a iOS y qué módulos del backend participan en ambos casos.
Firmware / OCPP
¿Cómo maneja el backend los mensajes OCPP cuando el cargador pierde conectividad y los reencola al reconectar?
Herramientas
Lo que tienes disponible
Consultas de producto
Agente IA
Pregunta sobre funcionalidades, diferencias entre modelos, casos de uso y especificaciones. El agente busca en manuales y documentación sin que necesites tecnicismos.
Análisis
Research
Análisis de mercado, competencia y tendencias. Información estructurada para decisiones comerciales y presentaciones.
Métricas
Monitor
Dashboard de KPIs y métricas del sistema. Útil para seguimiento de actividad, uso de la plataforma y datos operativos.
Agente IA
Preguntas comerciales típicas
Producto
¿Cuáles son las diferencias entre el Policharger NW y el modelo doméstico en cuanto a potencia y conectividad?
Instalación
¿Qué requisitos de instalación tiene el cargador trifásico? ¿Necesita un técnico certificado o puede hacerlo un electricista estándar?
Integración
¿El sistema de Policharger puede integrarse con plataformas de gestión de flotas de terceros? ¿Qué protocolos usa?
Consejo
El agente está entrenado con los manuales de producto. Si necesitas una respuesta para un cliente o propuesta, pide al agente que te cite la sección del manual para que puedas referenciarla.
Plataforma
Mapa completo de la plataforma
Principal
Agente IA
Interfaz de consulta al sistema RAG. El corazón de la plataforma: busca en manuales, docs técnicas y conocimiento indexado.
I+D / Soporte
Tickets
Centro de tickets de soporte y knowledge gaps. Admin puede ver, asignar, escalar y resolver todos los tickets del sistema.
Conocimiento
Gap-Resolve
Revisar y resolver brechas de conocimiento. Las resoluciones quedan indexadas para el agente.
Documentación
Manuales
Gestión completa de PDFs técnicos: subida, metadata, ingesta al índice vectorial.
Docs técnicas
iOS · Android · Backend
Documentación estructurada por proyecto. Referencia de arquitectura, fases y módulos del ecosistema.
Análisis
Impact · Research · Monitor
Dependencias cross-proyecto, análisis de mercado y dashboard de métricas del sistema.
Administración
Panel de administración
👤
Usuarios y roles — users.html
Crea y gestiona usuarios, asigna roles (admin, sat_tecnico, sat, comercial, desarrollo, general) y vincula al proyecto correspondiente. El rol controla qué páginas y acciones tiene disponibles cada persona.
📄
Contenido y conocimiento — content.html
Gestiona el conocimiento indexado manualmente: crea entradas, edita o archiva respuestas que el agente usa directamente. Complementa a los PDFs de Manuales.
⚙️
Sistema — system.html
Gestión de claves API (Gemini, Pinecone), dashboard de uso y créditos estimados, caché de embeddings de queries frecuentes. Recarga las claves en caliente sin reiniciar el servidor.
Empieza aquí
Lo que tienes disponible
Principal
Agente IA
Haz preguntas en lenguaje natural sobre el sistema Policharger: funcionamiento, especificaciones, cómo se usa. El agente busca en la base de conocimiento y responde con fuentes.
Inicio
Hub
Vista general del ecosistema. Buen punto de entrada para orientarte y ver qué áreas existen en la plataforma.
Agente IA
Cómo hacer una buena pregunta
Ejemplo
¿Cómo funciona el cargador Policharger NW? ¿Qué hace el LED cuando parpadea verde?
Ejemplo
¿Cuántos amperios máximos soporta el cargador doméstico y qué instalación eléctrica necesita?
Buenas Prácticas
Para sacarle partido sin generar ruido
Sí
- Da contexto al agente: modelo, síntoma, plataforma y objetivo.
- Pide la fuente exacta cuando la respuesta sea suficiente pero quieras confirmar.
- Crea tickets solo cuando el agente de verdad no tenga la respuesta.
- Si dudas de dónde buscar, empieza siempre por el Agente IA.
No
- No asumas que una sola respuesta del agente sustituye al documento fuente.
- No crees tickets duplicados: comprueba si ya existe uno para esa consulta.
- No subas PDFs sin metadata: la calidad de los metadatos afecta las búsquedas.
- No lances ingestas o resets por costumbre: comprueba el estado primero.