AIUsage · Mide y tarifá el uso de IA
AIUsage es el módulo de WhatsUY que registra, agrega y tarifa cada llamada a un modelo de IA. Es un choke point único: todas las invocaciones (de AIFlows, del agente IA directa, del asistente, del análisis de sentimiento, de la transcripción de audios y de la generación de imágenes) pasan por él.
¿Por qué existe?
- Visibilidad: saber cuánto cuesta cada conversación.
- Tarificación dinámica: poder cambiar el precio por modelo sin redeploy.
- Auditoría: tener un registro inmutable de qué se consumió.
- Reportes: dar al usuario final una UI con breakdown por proveedor, modelo y origen.
¿Qué mide?
| Unidad | Cuándo aplica | Ejemplo |
|---|---|---|
tokens (input/output) | Modelos LLM y de embedding | gpt-4o, claude-3.5 |
reasoningTokens | Modelos con razonamiento explícito | o1, o1-mini |
cacheReadTokens | Modelos con caché de contexto | claude-3.5 con cache |
cacheWriteTokens | Modelos con caché escribible | claude-3.5 con cache |
seconds | Modelos audio (TTS/STT) | Whisper |
units | Modelos de generación de imágenes | dall-e-3 |
Orígenes de llamada (callOrigin)
Cada evento de uso lleva un callOrigin que identifica quién lo generó:
aiflows— nodo IA dentro de un flujo AIFlows.ia_direct— agente IA directa con MCP.assist— asistente de edición por chat.analysis— análisis de sentimiento u otro análisis.transcription— transcripción de audios.image— generación de imagen.bot_legacy— bot V2 legacy.other— casos no categorizados.
Estado de implementación
🟢 ~95% implementado (septiembre 2026):
- ✅ Fases 0-4 completas y auditadas.
- ✅ Fase 5 parcial.
- ✅ Fase 6 completa (tarifas por credencial, autocarga, cierre de deuda).
- ⏳ Deuda documentada: H10 (cobertura parcial de
callOrigin) y H13 (UI deusage-detail).
Detalle: doc-iausage/IMPLEMENTATION-REVIEW.md.