Gráficos en las respuestas: lo que obtienes gratis y lo que no debes hacer
Tu agente dibuja un gráfico cuando una respuesta contiene números comparables. No hay nada que activar. Lo que controlas es si las cifras están en la base de conocimientos y si los números derivados pasan por una herramienta.
list_toolsupdate_agentsearch_knowledge_basePrincipio — el agente puede copiar números, nunca calcularlos. Copiar de un texto recuperado es fiable; la aritmética no lo es. Todo lo que se expone en esta página se deriva de esa única medición. Más información en Principios de diseño.
Cuando una respuesta ya contiene un conjunto de números comparables, el agente los dibuja —sin que se le pida, en medio de una conversación ordinaria. No hay nada que activar: cualquier agente con una base de conocimientos o herramientas lo hace. Los gráficos se renderizan en el widget, la consola, el panel de pruebas y la Bandeja de entrada, y se degradan a una tabla compacta en Telegram, WhatsApp y lectores de pantalla.
Por tanto, la pregunta útil no es "cómo activo los gráficos". Es qué hace la diferencia entre un gráfico que aparece y uno que se descarta.
Cada cifra debe estar en el material
Antes de que se renderice un gráfico, se ejecuta una comprobación determinista sobre él: cada par etiqueta-valor debe aparecer en los fragmentos que el agente recuperó en esa turno. Un par que no se encuentra significa que se desecha todo el bloque —el visitante conserva las palabras y pierde la imagen, y nada en la respuesta indica por qué.
Esa comprobación es la razón por la que el trabajo práctico reside en tu base de conocimientos, no en ningún ajuste:
- Los documentos cortos y específicos ganan. Una página larga sobre un producto que nunca indica su precio se recuperará para una pregunta sobre precios y no responderá nada. Proporciona a cada elemento su propio documento corto que indique sus números.
- Escribe los números tal como la gente pregunta por ellos.
25M,25,000,000y2500万se emparejan todos, al igual que$49,49 USDy49 美元. Las unidades no se comprueban, así que mantenlas en el texto junto a la cifra. - Verifica con
search_knowledge_baseantes de confiar en ello. Si el fragmento que se devuelve no tiene ningún número, tampoco habrá gráfico.
Los números derivados pasan por compute_chart
Las acciones, las tasas de crecimiento, los totales acumulados y las facturas son exactamente lo que un modelo falla al calcular, y exactamente lo que hace que un gráfico valga la pena mirar. Por ello, el agente no los calcula: pasa las cifras literales a compute_chart, la plataforma calcula la serie en código, y los números se rellenan en el gráfico sin pasar de nuevo por el modelo.
derive | Para | Dale |
|---|---|---|
share | porcentaje del total | labels + series |
growth | cambio porcentual frente al período anterior | labels + series |
cumulative | total acumulado | labels + series |
project | "crece un X% por período durante N períodos" | base, rate_pct, periods |
tier | "a ese nivel de uso, ¿cuánto cuesta?" | included, rate_per_unit, base_fee — más base/rate_pct/periods para proyectar y facturar en una sola llamada |
La herramienta se adjunta automáticamente a cualquier agente que ya tenga herramientas, por lo que suele no haber nada que añadir. Confírmalo con list_tools() en tu inquilino.
Dos protecciones que vale la pena conocer, porque explican los gráficos que "deberían haber aparecido":
- Las entradas también se comprueban. Un precio pasado a
tiertiene que existir en el material como dinero —junto a una marca de moneda. Un modelo que inventa una cuota mensual produce una factura exactamente calculada basada en una cifra que nadie publicó, y el gráfico se desecha por ello. - Las unidades deben coincidir.
included,rate_per_unity los valores de uso están todos en la misma unidad. Proporciona el uso en tokens crudos y una asignación en millones y la llamada se rechazará en lugar de facturar a un millón de veces la tarifa.
Lo que no puedes estilizar, y por qué
Los colores de los gráficos se derivan de tu color del tema —toda la paleta, tanto en modo claro como oscuro, el estado al pasar el cursor y el tooltip. Un único ajuste, todos los tipos de gráfico.
No intentes acceder a los gráficos desde custom_css: se dibujan en un lienzo, y CSS no puede acceder al interior de uno. Una regla que apunta a un gráfico no se sobrescribe, simplemente no hace nada, lo cual es peor que ser rechazado. Si un gráfico no se ajusta a tu marca, cambia el color del tema.
Cuándo se mantiene en silencio
Tres números es el mínimo —"desde 120k hasta 150k" es una frase, no un gráfico de barras. Las preguntas de sí/no y las búsquedas de un solo valor obtienen una respuesta, no una imagen. Como máximo dos gráficos por respuesta, y un segundo solo cuando las dos medidas están en unidades diferentes.
Y si no se recuperó nada en ese turno, no hay nada que dibujar. El agente dice lo que sabe y lo que no sabe, que es lo que hace también con las palabras.