Proactive Agents

Agentes siempre activos que monitorean las condiciones y actúan de forma autónoma, sin esperar a que usted active una ejecución. Observan su Knowledge Graph, su memoria y sus APIs externos, luego inician flujos de trabajo o envían notificaciones cuando algo cambia.


Bajo demanda frente a proactivo

Se ejecuta un flujo de trabajo normal cuando usted (o una llamada API) lo activa. Un agente proactivo ejecuta un ciclo de latidos en un intervalo configurable (cada minuto, cada 5 minutos, cada hora o diariamente) y decide por sí solo si actuar en función de lo que observa.

Esto convierte a AgentLed en una capa de monitoreo. En lugar de que usted revise los paneles, el agente los revisa por usted y solo muestra lo que importa.


Tipos de monitores

Cada agente proactivo define uno o más monitores. Todos los monitores deben pasar (o cualquiera, dependiendo de tu conditionOperator) antes de que el agente active sus acciones.

Lista Knowledge Graph

Mire una lista de conocimientos para ver los cambios. Se activa cuando aparecen nuevas filas, cuando el recuento de filas cruza un umbral o cuando un campo específico cambia en cualquier fila.

Condiciones: new_rows · row_count_above · row_count_below · field_changed

Knowledge Graph Perspicacia

Se activa cuando se escribe una nueva información en KG con al menos una puntuación de impacto mínima. Útil para actuar sobre descubrimientos high-signal AI sin sondeo.

Persistent Memory

Supervise una clave de memoria y dispare cuando su valor cruce un umbral o cambie. Combínelo con la memoria workflow-scope para crear bucles de retroalimentación self-adjusting.

Operadores: == · != · > · < · changed · exists

Historial de ejecución

Fuego basado en patrones en ejecuciones pasadas: ninguna ejecución en las últimas N horas, fallas consecutivas o la tasa de éxito cae por debajo de un umbral.

Patrones: no_execution_since · consecutive_failures · success_rate_below

Externo API

Sondea un punto final HTTP externo, extrae un valor con una expresión JSONPath y activa cuando ese valor cumple una condición. No se requiere integración personalizada.


Comportamiento

Cuando los monitores pasan, el agente ejecuta una o más acciones:

  • Iniciar flujo de trabajo — Activa un flujo de trabajo específico con entrada opcional. El monitor decide si actúa; el flujo de trabajo decide cómo.
  • Notificar — Envíe un mensaje a Slack, correo electrónico o al centro de notificaciones in-app sin iniciar un flujo de trabajo completo.
  • Almacenar memoria — Escribir un hecho o contrarrestar la memoria persistente. Útil para la contabilidad (por ejemplo, rastrear la última vez que el agente despidió).

Configuración

{
  monitorInterval: "15m",       // 1m | 5m | 15m | 1h | 6h | 24h
  conditionOperator: "and",     // all monitors must pass; "or" = any one
  cooldownMs: 3600000,          // 1 hour between fires on same trigger
  maxActionsPerDay: 10,         // safety cap
  pauseOnConsecutiveErrors: 3,  // auto-pause after N failures

  monitors: [
    {
      type: "kg_list",
      listKey: "prospects",
      condition: "new_rows",
      threshold: 5
    }
  ],
  actions: [
    {
      type: "start_workflow",
      workflowId: "wf_enrich_and_score"
    },
    {
      type: "notify",
      channel: "slack",
      message: "{{monitors.0.newRowCount}} new prospects ready"
    }
  ]
}

Casos de uso de ejemplo

Resumen diario de plomo

Monitorear el prospects lista de nuevas filas cada 24 horas. Cuando haya nuevas entradas, active el flujo de trabajo de enriquecimiento + puntuación y envíe un resumen Slack con los 10 primeros por puntuación.

Alerta de caída de puntuación

Monitorear una clave workflow-memory avg_score_last_run para valores inferiores a 60. Cuando baje, notifique al equipo y suspenda el flujo de trabajo de divulgación hasta que un humano lo revise.

Monitor de canalización obsoleta

Utilice un execution_history monitor configurado en no_execution_since: 48h. Si el flujo de trabajo deal-sourcing no se ha ejecutado en dos días, envíe un correo electrónico y registre la brecha en la memoria persistente.


Controles de seguridad

  • Enfriarse — Evita que el agente dispare dos veces con el mismo disparador dentro de una ventana configurable.
  • Acciones máximas por día — Límite estricto de cuántas veces el agente puede realizar acciones en un período de 24 horas.
  • Pausa automática en caso de errores — Después de N fallas consecutivas, el agente se detiene y notifica al administrador del espacio de trabajo.

Próximos pasos