> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Alertas de nodos

> Recibe un correo cuando un nodo API / SOAP falla de forma repetida o cuando un Agente de IA tiene un problema con su modelo o de seguridad

Las **Alertas de nodos** te avisan por correo electrónico cuando algo requiere tu atención en los nodos de tus workflows. Tú eliges quién recibe los correos y, para los Agentes de IA, qué tipos de alerta quieres recibir.

## Qué son las alertas de nodos

Hay dos grupos de alertas, uno por cada tipo de nodo:

| Tipo de nodo | Alertas disponibles |
| - | - |
| **API / SOAP** | Falla repetida contra un mismo endpoint |
| **Agente de IA** | Ciclo de vida del modelo y Seguridad |

<Note>
  Las alertas de ciclo de vida del modelo también aparecen en la campana del Centro de notificaciones, bajo el filtro **Infraestructura**, sin importar si configuraste destinatarios. El correo es un canal adicional.
</Note>

## Cómo configurarlas

<Steps>
  <Step title="Abre Alertas de nodos">
    Ve a **Configuración** > **Alertas de nodos**.
  </Step>

  <Step title="Elige el tipo de nodo">
    En el submenú **Tipo de nodo** selecciona la pestaña **API / SOAP** o **Agente de IA**. Cada pestaña tiene su propia lista de destinatarios.
  </Step>

  <Step title="Agrega destinatarios">
    En la tarjeta **Destinatarios**, escribe un correo electrónico y haz clic en **+ Agregar**. Para quitar uno, haz clic en la **✕** junto a su correo.
  </Step>

  <Step title="Elige los tipos de alerta (solo Agente de IA)">
    En la tarjeta **Tipos de alerta** marca **Ciclo de vida del modelo**, **Seguridad** o ambos.
  </Step>

  <Step title="Guarda los cambios">
    Haz clic en **Guardar**. Si quieres deshacer lo que cambiaste, haz clic en **Descartar**.
  </Step>
</Steps>

<Frame caption="Configuración > Alertas de nodos > Agente de IA">
  <img src="https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/settings-es.png?fit=max&auto=format&n=j5HzQgWZwzH-STMs&q=85&s=e57fc40e8c32683c49cbb6a63eaee355" alt="Pantalla Alertas de nodos con la pestaña Agente de IA, la lista de destinatarios y las casillas de tipos de alerta" width="3200" height="1800" data-path="assets/images/configuracion/alertas-nodos/settings-es.png" />
</Frame>

Mientras una pestaña no tenga destinatarios verás el mensaje *"Aún no hay destinatarios. Las alertas no se enviarán por correo."*

## Alertas de API / SOAP

Se envía un correo cuando un nodo API o SOAP **falla 100 veces en 5 minutos contra el mismo endpoint**. Después de ese aviso, esperamos **8 horas** antes de volver a avisar por ese mismo endpoint.

El correo incluye:

* Empresa, URL del servicio, usuarios afectados, cantidad de eventos e intervalo de monitoreo.
* La solicitud que falló y el mensaje de error.
* Tipo y nombre del modelo, ID de ejecución, ID de alerta e ID del nodo.

## Alertas de Agente de IA

La pestaña **Agente de IA** tiene la tarjeta **Tipos de alerta** con dos opciones. Si no seleccionas ninguna en particular, se envían todos los tipos.

### Ciclo de vida del modelo

Recibes un correo cuando un modelo usado por un nodo **AI Agent** o **AI Task** está por deprecarse, ya fue retirado o ya no existe en el catálogo. Se envía como máximo una vez cada 3 días por modelo.

El correo incluye el modelo, su estado, la fecha de retiro y dónde se usa (skill e ID del nodo).

<Frame caption="Correo de ciclo de vida del modelo">
  <img src="https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/email-ciclo-de-vida.png?fit=max&auto=format&n=j5HzQgWZwzH-STMs&q=85&s=160ce47e6c6a5568e02fc3273dba0b8c" alt="Correo con la insignia ámbar de ciclo de vida del modelo y los detalles del modelo afectado" width="1500" height="1466" data-path="assets/images/configuracion/alertas-nodos/email-ciclo-de-vida.png" />
</Frame>

### Seguridad

Recibes un correo cuando se detecta o se bloquea una amenaza de seguridad en un agente de IA, por ejemplo inyección de prompt, jailbreak o filtración del prompt del sistema.

El correo incluye el resultado (bloqueada o detectada), la fase, los tipos de amenaza, el nivel, la confianza, los métodos de detección y dónde ocurrió.

<Frame caption="Correo de amenaza de seguridad">
  <img src="https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/email-seguridad.png?fit=max&auto=format&n=j5HzQgWZwzH-STMs&q=85&s=a8dd7d0ba1024528694d6dbb1016d441" alt="Correo con la insignia roja de seguridad y los detalles de la amenaza bloqueada" width="1500" height="1466" data-path="assets/images/configuracion/alertas-nodos/email-seguridad.png" />
</Frame>

## Límites para evitar spam

| Alerta | Límite |
| - | - |
| API / SOAP | 100 fallas en 5 minutos por endpoint; luego 8 horas de espera para ese mismo endpoint |
| Ciclo de vida del modelo | Máximo un correo cada 3 días por modelo |
| Seguridad | Máximo un correo por hora para cada nodo y tipo de amenaza |

## Idioma de los correos

Los correos usan el nuevo diseño de Jelou, con una insignia de color según el tipo de alerta: ámbar para ciclo de vida del modelo y rojo para seguridad. Están disponibles en español, inglés y portugués.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Por qué no recibo correos?">
    Revisa estas dos causas:

    * **No hay destinatarios**: la pestaña del tipo de nodo no tiene correos agregados. Agrégalos y haz clic en **Guardar**.
    * **El tipo de alerta está desmarcado**: en la pestaña **Agente de IA**, confirma que **Ciclo de vida del modelo** o **Seguridad** esté marcado.

    También recuerda que los límites de envío pueden hacer que un nuevo evento no genere otro correo de inmediato.
  </Accordion>

  <Accordion title="¿Cada pestaña tiene sus propios destinatarios?">
    Sí. **API / SOAP** y **Agente de IA** se configuran por separado.
  </Accordion>

  <Accordion title="¿Si no configuro correos, me entero de los avisos de modelos?">
    Sí, los avisos de ciclo de vida del modelo siguen apareciendo en la campana, bajo el filtro **Infraestructura**.
  </Accordion>
</AccordionGroup>

## Nodos relacionados

<CardGroup cols={2}>
  <Card title="Nodo API" icon="globe" href="/guides/nodos/api">
    Conecta tu flujo con servicios externos.
  </Card>

  <Card title="Nodo AI Agent" icon="robot" href="/guides/nodos/ai-agent">
    Configura tu agente de IA.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.