Skyler Assistant
Skyler es el asistente público de portafolio de Patrick Araujo, enfocado en el contexto del proyecto, stack técnico, experiencia profesional y orientación de contacto.
El asistente está diseñado para una orquestación predecible: respuesta local de saludo simple, uso manual de RAG y llamadas LLM solo cuando sea necesario.
Arquitectura del sistema
Skyler separa las responsabilidades claramente. La interfaz maneja la interacción y la voz. El worker organiza llamadas de memoria, conscientes de la intención RAG y de proveedor. El modelo maneja respuestas directas para mensajes fuera de tema y respuestas guiadas por el portafolio cuando se detecta la intención del portafolio.
Flujo de decisión en tiempo de ejecución
Experiencia frontal
- Lanzador de íconos flotantes en las páginas del sitio usando
/images/icon_skyler.webp - Asistente interactivo dedicado en /asistente-skyler/
- Enter envía el mensaje, Shift+Enter agrega un salto de línea
- Alternancia de salida de transmisión y salida de voz opcional
- Uso público/invitado sin inicio de sesión obligatorio
Detalles del worker y de los datos
- Entrada:
src/chatbot/worker/src/index.ts - RAG manual:
src/chatbot/worker/src/manual-rag.ts - Caché KV: caché de respuesta, caché de incrustación, caché de contexto del sitio
- D1: usuarios, conversaciones, mensajes, eventos analíticos, versiones de avisos
- Fijaciones:
DB,CACHE,SESSIONS
RAG Cobertura
El RAG manual incluye identidad, enfoque de rol, stack, enlaces, empresas, métricas de impacto y contexto de credenciales actual. Se fusiona con las páginas del sitio público almacenadas en caché solo cuando el usuario pregunta sobre temas de portafolio, lo que mantiene directas las respuestas fuera de tema y reduce la conexión a tierra no deseada.
- Identidad y posicionamiento (backend, integraciones, arquitectura)
- Guía de descubrimiento de proyectos y blogs
- Referencias de contacto y perfil (GitHub, LinkedIn, correo electrónico)
- Credenciales, empresas y proyectos conocidos del contexto interno más páginas públicas.
- Reglas de respuesta en texto plano para respuestas de cursos, empresas y proyectos
Estrategia de confiabilidad y respaldo
- Ruta de ejecución del proveedor principal con reintentos
- Proveedor de respaldo automático cuando falla el primario
- Ruta de saludo local más RAG consciente de la intención para reducir llamadas de modelo innecesarias
- Almacenamiento en caché de respuestas para minimizar el gasto repetido de tokens
Caminos principales
- Asistente en vivo: /asistente-skyler/
- Página de ejemplo de widget global: /sobre/
- Listado de proyectos: /proyectos/
- Fuente de workers:
src/chatbot/worker/src/index.ts - RAG manual:
src/chatbot/worker/src/manual-rag.ts