📊 Uso de API

Aaia-WP incluye una supervisión completa del uso de API para ayudarte a rastrear tu consumo de API Gemini, optimizar costos y asegurar que te mantengas dentro de tus límites de cuota. Esta funcionalidad proporciona análisis detallados e insights sobre el rendimiento de tu chatbot.

🎯 ¿Por Qué Supervisar el Uso de API?

Entender tu consumo de API es crucial para:

• Control de Costos: Rastrear costos estimados para evitar facturas inesperadas
• Optimización del Rendimiento: Identificar patrones de uso para optimizar tu chatbot
• Gestión de Cuotas: Mantenerse dentro de los límites del nivel gratuito de Google
• Insights Analíticos: Entender el engagement de usuarios con tu asistente IA

📈 Acceder a los Análisis de Uso

Encontrar la Pestaña Uso de API

En tu panel de WordPress, navega a Ajustes > Aaia XP y haz clic en la pestaña “Uso de API”. Esta sección dedicada proporciona herramientas de supervisión completas y análisis detallados sobre tu consumo de API.

Actualizaciones de Datos en Tiempo Real

El monitor de uso rastrea automáticamente cada solicitud de API hecha por tu chatbot, incluyendo el número de solicitudes, uso estimado de tokens y costos calculados basados en los modelos de precios actuales de Gemini.

💡 Entender las Métricas de Uso

Tarjetas de Resumen

El panel muestra tres métricas clave para los últimos 30 días:

Solicitudes: Número total de llamadas de API hechas a Gemini. Cada mensaje de usuario típicamente genera una solicitud, aunque interacciones complejas pueden requerir múltiples llamadas.

Tokens Estimados: Consumo aproximado de tokens basado en la longitud de mensajes y las instrucciones del sistema. Los tokens representan las “unidades de cómputo” que Gemini utiliza para procesar tus solicitudes.

Costo Estimado: Gastos calculados basados en la estructura de precios actual de Google. Esto te ayuda a entender el impacto financiero del uso de tu chatbot.

📊 Análisis Visuales

Gráficos de Solicitudes Diarias

Los gráficos interactivos muestran tus patrones de solicitudes diarias, ayudándote a identificar:

• Horas Pico: Cuándo tus usuarios están más activos
• Patrones de Tráfico: Tendencias semanales y mensuales
• Detección de Picos: Actividad inusual que podría indicar tráfico de bots o contenido viral

Visualización de Costos

Los gráficos de costos diarios proporcionan insights financieros mostrando:

• Gastos Diarios: Rastrear costos día a día
• Tendencias de Costos: Identificar patrones de uso crecientes o decrecientes
• Planificación de Presupuesto: Proyectar gastos futuros basados en el uso actual

📋 Tablas de Uso Detalladas

Desglose Diario

La tabla detallada muestra:

• Fecha: Día específico de uso
• Solicitudes: Número de llamadas de API para ese día
• Tokens Estimados: Consumo de tokens para el día
• Costo Estimado: Costos asociados en USD

Estos datos granulares te ayudan a entender exactamente cuándo y cómo se consume tu cuota de API.

⚙️ Funcionalidades de Optimización

Integración de Caché de Contexto

Cuando el Caché de Contexto está habilitado en los Ajustes de API, verás reducciones significativas en el consumo de tokens. El caché almacena las instrucciones del sistema y contexto frecuentemente utilizado durante 24 horas, reduciendo:

• Uso de Tokens Repetidos: Las instrucciones del sistema no necesitan enviarse con cada solicitud
• Eficiencia del Contexto: El contexto de conversación se almacena en caché y reutiliza
• Ahorros de Costos: Hasta 60% de reducción en el consumo de tokens para sitios activos

Beneficios de la Gestión de Sesión

Con la Gestión de Sesión habilitada (función Beta), puedes obtener ahorros aún mayores:

• Conversaciones Cortas (5-10 mensajes): ~30% de reducción de tokens
• Conversaciones Medianas (10-30 mensajes): ~70% de reducción de tokens
• Conversaciones Largas (30+ mensajes): ~90% de reducción de tokens

🔄 Gestión de Datos

Función de Actualización

Usa el botón “Actualizar Datos” para:

• Actualizar Estadísticas: Obtener la información de uso más reciente
• Sincronizar Registros: Asegurar precisión entre el rastreo local y el uso real
• Monitoreo en Tiempo Real: Verificar los niveles de consumo actuales

Retención de Datos

Los datos de uso se almacenan localmente en tu base de datos de WordPress y automáticamente:

• Mantiene un Historial de 30 Días: Conserva registros detallados para análisis
• Limpieza Automática: Elimina datos antiguos para evitar saturación de la base de datos
• Protección de Privacidad: Todos los datos permanecen en tu servidor

🚨 Alertas de Uso y Límites

Entender los Límites de Google

El nivel gratuito de Google proporciona:

• 15 solicitudes por minuto: Limitación de tasa para llamadas de API
• 1,500 solicitudes por día: Cuota diaria para cuentas gratuitas
• Asignación Generosa de Tokens: Suficiente para la mayoría de sitios web pequeños y medianos

Recomendaciones de Monitoreo

Verificaciones Diarias: Revisa regularmente los patrones de uso para identificar tendencias

Análisis Semanal: Busca picos o caídas inusuales de actividad

Planificación Mensual: Usa datos históricos para proyectar necesidades futuras

Configuración de Alertas: Considera monitoreo externo si te acercas a los límites de cuota

💰 Estrategias de Optimización de Costos

Habilitar Caché de Contexto

Activa el Caché de Contexto en los Ajustes de API para reducir el consumo de tokens hasta un 60% para sitios con instrucciones del sistema y contexto de página consistentes.

Optimizar las Instrucciones del Sistema

Mantén tus instrucciones del sistema concisas pero efectivas. Instrucciones más largas consumen más tokens con cada solicitud.

Configurar Gestión de Sesión

Habilita la función beta Gestión de Sesión para ahorros dramáticos de tokens en sitios con conversaciones más largas.

Revisar la Configuración del Asistente

Evalúa regularmente los ajustes de tu chatbot para asegurar rendimiento óptimo sin consumo innecesario de tokens.

🔍 Solución de Problemas de Uso

Preocupaciones de Uso Alto

Si notas un uso inesperadamente alto:

Verifica Tráfico de Bots: Las solicitudes automatizadas pueden inflar el uso Revisa las Instrucciones del Sistema: Instrucciones largas aumentan el consumo de tokens Analiza Patrones de Usuario: Busca longitudes de conversación inusuales Verifica Limitación de Tasa: Asegura limitación apropiada de solicitudes

Análisis de Uso Bajo

Un uso inesperadamente bajo podría indicar:

Problemas de Configuración: Verifica si el chatbot se muestra correctamente Problemas de UX: Verifica accesibilidad y posicionamiento del chatbot Relevancia del Contenido: Asegura que tu asistente aporta valor a los visitantes

🚀 Próximos Pasos

Entender tu uso de API asegura operación rentable mientras maximiza el valor. Continúa hacia Gestión de Sesión para aprender sobre funciones avanzadas de optimización de tokens, o explora Contexto de Página para entender cómo la integración de contenido afecta el consumo.