cxops-ai

CXOps AI es una plataforma de experiencia del cliente con IA agéntica de estilo producción que combina flujos de trabajo autónomos de IA, generación aumentada por recuperación (RAG), aprobaciones con intervención humana, integración con Zendesk, ejecución en segundo plano duradera y observabilidad de IA. Está diseñada para demostrar cómo los agentes de IA pueden operar de manera segura en un entorno real de atención al cliente, no solo generar respuestas de chatbot. La plataforma puede ingerir tickets de soporte al cliente, analizar la intención del cliente y el contexto operativo, recuperar conocimiento confiable mediante RAG, seleccionar una acción de soporte adecuada, determinar si esa acción puede ejecutarse de forma autónoma, requerir aprobación humana para acciones de mayor riesgo, ejecutar acciones aprobadas contra Zendesk, registrar pistas de auditoría completas y monitorear la latencia, el costo, la confiabilidad y los resultados del flujo de trabajo de la IA. El sistema separa deliberadamente el razonamiento del LLM de la autorización operativa. El modelo puede recomendar una acción, pero las políticas de aplicación deterministas deciden si se permite ejecutar esa acción. Las capacidades principales incluyen: - Flujos de trabajo de IA agéntica que producen decisiones estructuradas como responder, enrutar, escalar, nota_interna, revisión_humana y sin_acción. - Autorización de herramientas consciente del riesgo con políticas independientes del modelo de lenguaje. Las operaciones de bajo riesgo se ejecutan automáticamente; las acciones de mayor riesgo requieren aprobación humana explícita. - Un pipeline RAG completo para fundamentar las decisiones de soporte en conocimiento confiable, compatible con PDF, TXT, Markdown y documentos creados manualmente. Incluye búsqueda de similitud vectorial, umbrales configurables, selección adaptativa de fuentes, citas, protección contra documentos duplicados, protección contra inyección de prompts y comportamiento de rechazo fundamentado. - Integración con Zendesk mediante OAuth y eventos de tickets basados en webhooks, incluida la recuperación, creación, actualización, comentarios, sincronización, búsqueda de clientes, verificación de firmas de webhook, manejo de eventos idempotente, ejecución autónoma de notas internas y acciones externas basadas en aprobación. - Cola de aprobación con intervención humana que permite a los operadores revisar las decisiones de IA, el razonamiento, la evidencia RAG, las respuestas propuestas, las herramientas planificadas y agregar notas del revisor antes de aprobar o rechazar la ejecución. - Ejecución autónoma para acciones de bajo riesgo, validada de extremo a extremo contra la integración de producción de Zendesk. - Trabajos en segundo plano duraderos con estados pendiente/procesando/completado/fallido, reintentos, intentos máximos configurables, retroceso exponencial, claves de deduplicación y registro de errores. Los trabajos fallidos se conservan para fines de auditoría. - Límites de seguridad que impiden que los tickets de demostración locales lleguen a Zendesk a menos que se cumplan todas las condiciones. Los intentos bloqueados se registran como eventos de auditoría. - Observabilidad de IA que registra telemetría de solicitudes, incluidos la característica, el modelo, la latencia, los recuentos de tokens, el costo estimado, el éxito/fracaso y las marcas de tiempo. - KPIs de agentes que rastrean ejecuciones totales, tasa de ejecución autónoma, tasas de éxito, tasas de aprobación, distribución de acciones, distribución de riesgos y estado del flujo de trabajo. - Medición del ROI que estima minutos ahorrados, valor laboral, costo de IA y valor neto, con una evitación deliberada de informar ROI formal hasta alcanzar un tamaño de muestra mínimo. - Flujos de trabajo de evaluación tanto para RAG como para el comportamiento del agente. Los conjuntos actuales informan 6/6 escenarios RAG aprobados y 12/12 escenarios de agente aprobados, con 60/60 ejecuciones repetidas aprobadas. La arquitectura de producción utiliza Vercel para el frontend de Next.js, Render para el backend de FastAPI y el trabajador en segundo plano, Nhost para PostgreSQL con pgvector, OpenAI para LLM y embeddings, y Zendesk para la integración de CX. El frontend proporciona espacios de trabajo operativos para Inicio, Tickets, Nuevo Ticket de Prueba, Agente de IA, Cola de Aprobación, Conocimiento/RAG, Ejecuciones/Pista de Auditoría y Observabilidad. La pila tecnológica incluye Python 3.11, FastAPI, Pydantic, SQLAlchemy, Alembic, asyncpg, métricas de Prometheus, PostgreSQL, pgvector, Next.js, TypeScript, React, Tailwind CSS, GSAP, Lenis, Lucide React, Docker y GitHub Actions. El proyecto incluye instrucciones de configuración local, comandos de prueba y detalles de validación de producción. Es un proyecto de portafolio en desarrollo activo con mejoras planificadas que incluyen capacidad de respuesta móvil, conjuntos de datos de evaluación más amplios, integraciones adicionales de CRM/emisión de tickets, trazado más enriquecido y análisis ampliados.