Aura
Documentación interna para desarrolladores de Aura, el copiloto de IA para el soporte técnico de equipos médicos de oxígeno (Oxitec).
¿Qué es Aura?
Aura asiste a los agentes del Centro de Atención al Paciente (CAP) durante las llamadas de soporte. Escucha la conversación, recupera información relevante (manuales técnicos + correcciones pasadas de supervisores) y propone la respuesta que daría, para que el humano la valide. Las respuestas validadas alimentan una base vectorial que mejora las sugerencias futuras (flywheel de mejora continua).
Trabaja sobre dos canales:
| Canal | Rol de Aura | Estado |
|---|---|---|
| Audio-fork (Yeastar / FreeSWITCH) | Copiloto pasivo: el humano habla con el paciente; Aura escucha (vía transcripción en vivo) y sugiere. | Producción (foco actual) |
| Retell (voz IA) | Aura actúa como Custom LLM: responde directamente en la llamada de voz. | Integrado (fase de voz) |
En ambos casos el motor es el mismo: un pipeline RAG de dos bases (correcciones + manuales) sobre un LLM, más un dashboard de copiloto en tiempo real para el agente y el supervisor.
Stack
| Backend | NestJS 10 (repo Aura-reloaded) |
| Frontend | React 18 + Vite + Tailwind + shadcn/ui (repo aura-front) |
| Base de datos | PostgreSQL + pgvector |
| ORM / migraciones | Drizzle ORM |
| Embeddings | OpenAI (text-embedding-3-small) |
| LLM | gpt-5.4-mini (configurable por env) |
| STT (audio-fork) | Deepgram Nova-3 Multilingual |
| Auth | Ajolote (servicio propio de sesión + roles) |
| Package manager | pnpm (no usar npm/yarn) |
Repos
Aura-reloaded— backend NestJS (Custom LLM, RAG, WebSockets, API).aura-front— dashboard del agente/supervisor (React).
Son repos git separados; los cambios de una feature suelen tocar backend y front.
Cómo está organizada esta documentación
- Arquitectura — componentes, flujos de llamada y esquema de base de datos.
- Setup — entorno local y pruebas con Retell.
- RAG — cómo funciona la recuperación y cómo cargar manuales en la base vectorial.
- Autenticación — Ajolote, sesión, roles y gating.
- Observabilidad — logging de eventos y paneles de métricas/auditoría.
- Frontend — estructura del dashboard y convenciones.
- Operaciones — despliegue y migraciones en producción.