Huella de IA

Cada vez que algo dentro de tu servidor usa IA —el chat de tu página, tu línea de WhatsApp, un proceso interno— esa llamada queda registrada con su modelo, sus tokens y su costo. La huella es la etiqueta que acompaña cada registro y que dice quién pidió el trabajo y para qué.

El resultado: en lugar de un total del mes que no explica nada («$12.40 en IA»), ves algo que sí puedes gestionar: «el asesor de repuestos del chat web se llevó $6, el clasificador de tickets $3, y el resto son tareas internas». Con eso decides qué optimizar, qué apagar y qué está dando resultados.

Cada llamada de IA se clasifica en cuatro niveles, de lo general a lo específico. Un ejemplo real: tu servidor «tienda-repuestos» atiende clientes por el chat de tu página. Un cliente pregunta por un filtro, y el asesor le responde. Esa llamada queda así:

Y debajo de todo eso, la evidencia de la llamada: el modelo que respondió, los tokens que consumió y su costo exacto.

Abre tu servidor en Dev Studio y entra a la pestaña Uso de IA. Encuentras, de arriba hacia abajo:

• KPIs del periodo — el costo total de IA, las llamadas y los tokens del rango que elijas, de un vistazo.
• Barras por día — una barra por cada día, apilada por origen (cada canal con su color). Ahí ves de inmediato si un día se disparó el consumo y por qué canal fue.
• Desglose expandible — la tabla principal: cada origen se abre para mostrar sus funciones, cada función sus acciones y cada acción los modelos que usó, siempre con su costo y sus tokens.
• Actividad reciente — las últimas llamadas una a una: hora, modelo, tokens, costo y latencia. Es la evidencia detrás de las gráficas.

Las etiquetas nacen del código, así que llegan con nombres técnicos como asesor-repuestos. Pulsa el lápiz junto al nombre y ponle el que quieras mostrar — por ejemplo, «Asesor de repuestos».

El cambio es solo visual: el código técnico no cambia, así que el historial se conserva completo y los desarrolladores no tienen que tocar nada.

Si ves una porción llamada «sin-etiqueta» (o genérica, como «Ide»), es consumo de IA completamente real cuyo código todavía no declara su huella. No es un error ni un cobro extraño: solo falta que la aplicación diga «esto fue del asesor», «esto del clasificador».

La solución no requiere programadores externos: pídeselo al asistente de IA de tu propio servidor (el Constructor). Dile, por ejemplo: «Etiqueta el consumo de IA de mi app con la huella de SIAC». El servidor trae instrucciones que le enseñan a hacerlo solo (la skill api-siac), así que sabe exactamente qué tocar.

Si una aplicación crea demasiadas etiquetas distintas (por ejemplo, por un error, una etiqueta nueva por cada cliente o por cada conversación), el reporte se volvería una lista infinita e ilegible. Para evitarlo, la plataforma aplica un freno de cardinalidad: las etiquetas más allá del límite se agrupan en un cajón llamado «Otros».

Si «Otros» crece, no se perdió dinero ni información de cobro — solo detalle de clasificación. La causa casi siempre es un etiquetado mal diseñado en el código; pídele al asistente del servidor que lo corrija usando etiquetas estables.

La huella es informativa. Etiquetar bien, mal o no etiquetar no cambia un centavo del cobro: el costo de cada llamada se calcula igual, con la tarifa de tu organización.

Por eso los totales de «Uso de IA» siempre cuadran con la pestaña Costos del mismo servidor y con la vista «Inversión en servidores»: son el mismo dinero, contado una sola vez, visto con más o menos detalle.

Si programas contra la API de IA de la plataforma, declarar la huella son un par de cabeceras por llamada. El manual técnico trae los ejemplos listos para copiar (Python, Node y curl), las reglas de los slugs y el patrón recomendado.