n8n
Envía trazas desde tus workflows de n8n con el nodo comunitario Verica Trace.
Si tus agentes viven en n8n, puedes mandar sus ejecuciones a Verica como trazas evaluables. Hay dos caminos: el nodo comunitario (recomendado) y un workflow receta que no requiere instalar nada.
La credencial
Los dos caminos necesitan lo mismo: un token de API de Verica con permiso de ingesta. Se crea desde Configuración del proyecto → API Keys, marcando Ingesta de trazas (ingest).
En n8n, la credencial se llama Verica API y tiene dos campos:
| Campo | Por defecto | Para qué |
|---|---|---|
| Ingest Token | — | El token con permiso de ingesta. |
| Endpoint | https://ingest.verica.app | Cámbialo solo en instalaciones propias. |
n8n puede probar la credencial: envía un lote OTLP vacío, que autentica sin ingerir nada.
El nodo Verica Trace
Instalación
- n8n autoalojado: Settings → Community Nodes → instalar
n8n-nodes-verica. - n8n Cloud: disponible una vez que el nodo esté verificado. Mientras tanto, usa el workflow receta.
Uso
Coloca Verica Trace después de tu AI Agent (o de cualquier paso de LLM). Los valores por defecto ya leen los campos habituales — $json.output, $json.chatInput, $json.intermediateSteps, $json.sessionId — así que en la mayoría de los casos solo tienes que completar el Model.
Activa Return intermediate steps en el AI Agent para que las llamadas a herramientas lleguen a la traza; con eso el criterio tool_check puede hacer aserciones sobre ellas.
Parámetros
| Parámetro | A qué campo de la traza va |
|---|---|
| Model | El modelo. Hace falta para que la traza quede costeada. |
| Input | El mensaje del usuario. |
| Output | La respuesta final del asistente. |
| Tool Calls | Cada llamada se convierte en un mensaje de asistente, y su resultado en un mensaje tool — llamada → resultado → … → respuesta, en orden cronológico. |
En Options:
| Opción | A qué va |
|---|---|
| Provider | El proveedor. auto lo deduce del nombre del modelo. |
| Session ID | Agrupa las ejecuciones en una sesión. |
| Input Tokens | Tokens de entrada. |
| Output Tokens | Tokens de salida. |
| Reasoning Tokens | Tokens de razonamiento (un desglose de los de salida). |
| Cached Tokens | Tokens cacheados (un desglose de los de entrada, con su propia tarifa). |
| Latency (Ms) | La duración de la llamada. |
| Tags | Tags separados por coma. |
A los tags que pongas, el nodo agrega dos automáticamente: n8n:{nombre del workflow} y execution:{id de la ejecución}.
vericaError. Cuando todo sale bien, el ítem recibe un vericaTraceId.Mapeos que conviene conocer
El modelo del AI Agent vive en el sub-nodo de chat, así que hay que ir a buscarlo:
{{ $('OpenAI Chat Model').params.model.value || $('OpenAI Chat Model').params.model }}"Message a model" (la API de Responses de OpenAI) no devuelve el prompt que le enviaste, así que el Input hay que mapearlo al parámetro del nodo:
{{ $('Message a model').params.responses.values[0].content }}Pasa el mouse por el campo Prompt para confirmar la ruta exacta en tu versión de n8n. El uso de tokens sí se toma solo, en cuanto agregas las opciones de Input Tokens y Output Tokens.
tokenUsage del modelo de chat ni a la salida del agente ni a las expresiones posteriores (n8n#26302). La traza llega sin tokens ni costo, pero sigue siendo completamente evaluable.Sesiones
Las ejecuciones que comparten un sessionId — el Chat Trigger provee uno — se reensamblan en una sesión de Verica, un turno por ejecución.
Aplica la misma advertencia que a los SDKs: reenvía la historia exactamente como la mandaste, o cada turno terminará guardando la conversación entera. Ver Sesiones multi-turno.
El workflow receta
Para n8n Cloud, donde todavía no puedes instalar nodos comunitarios, Verica genera un workflow importable que hace lo mismo sin instalar nada. Se descarga desde Observabilidad → Conectar aplicación → n8n.
Son dos nodos, Build Verica trace (un nodo Code con el mapeo) y POST to Verica (un HTTP Request), conectados entre sí.
Los pasos que muestra el diálogo:
Importar
"Descarga el workflow y en n8n usa 'Import from File'."
Conectar
"Conecta el nodo 'Build Verica trace' después de tu AI Agent y activa 'Return intermediate steps' en el agente."
Configurar
"Abre 'Build Verica trace' y completa MODEL con el modelo de tu agente (por ejemplo gpt-4o) para costear la traza; si tu trigger de chat tiene otro nombre, cámbialo en la línea $('When chat message received')."
Si reutilizas un token existente, su secreto ya no se puede mostrar: el workflow lleva el marcador VERICA_TOKEN y hay que reemplazarlo después de importar.
n8n-nodes-verica y usa el nodo 'Verica Trace' con su credencial."Siguientes pasos
- Trazas y sesiones de producción — qué hacer con lo que llega.
- SDKs — la alternativa desde código.