Decision del Agente

Descripción

Este modulo evalua el estado actual de una conversación y determina la acción a seguir. Soporta tres modos de decision:

1. Reglas: Evalua un conjunto de reglas configuradas contra los datos de entrada. Cada regla define un campo, operador, valor y acción resultante. Los operadores soportados incluyen: equals, not_equals, greater_than, less_than, contains, not_contains, is_empty, is_not_empty, in, not_in.
2. IA: Envia el contexto de la conversación a un LLM que analiza y decide la acción. Utiliza temperatura baja (0.3) para decisiones consistentes. Puede usar el mismo cerebro configurado en el agente de la sesión o uno propio.
3. Hibrido: Primero evalua las reglas; si ninguna aplica, recurre a la IA como fallback.

Las acciones posibles son:

• continue: La conversación continua normalmente (estado: active).
• pause: Pausar la conversación (estado: dormant).
• close: Cerrar la conversación (estado: closed).
• escalate: Escalar a un humano (estado: active, marcado para escalamiento).
• archive: Archivar la conversación (estado: archived).

El modulo tiene 5 puertos de salida, uno por cada acción, lo que permite dirigir el flujo de manera diferenciada según la decision tomada. Opcionalmente actualiza el estado de la sesión en base de datos.

Configuración

Parámetro	Tipo	Requerido	Descripción
decision_mode	select	Si	Como se toman las decisiones. Opciones: rules, ai, hybrid. Default: rules.
rules	agentDecisionRules	No	Configura las reglas para tomar decisiones automáticas.
ai_prompt	textarea	No	Instrucciones para que la IA determine la acción a tomar. Visible en modos ai e hybrid.
use_session_brain	boolean	No	Usar la misma IA configurada en el agente. Default: true. Visible en modos ai e hybrid.
brain_provider	select	No	Proveedor de IA. Opciones: openai, anthropic, google, deepseek, qwen, llama. Visible si use_session_brain es false.
brain_model	aiModelSelector	No	Modelo de IA a utilizar. Visible según brain_provider. Default: gpt-4o.
credentials_key	credentials	No	Credenciales del proveedor. Visible si use_session_brain es false.
default_action	select	Si	Acción cuando ninguna regla aplica. Opciones: continue, pause, close, escalate, archive. Default: continue.
update_session_status	boolean	No	Actualizar automáticamente el estado de la sesión según la decision. Default: true.

Credenciales

Opcionales. Si use_session_brain es true, se reutilizan las credenciales del agente de la sesión. De lo contrario, se requiere configurar credentials_key con credenciales de tipo: openai, anthropic, google_ai, deepseek, qwen, llama.

Salida

{
  "success": true,
  "action": "continue",
  "reason": "Regla aplicada: mensajes > 5",
  "confidence": 1.0,
  "session_id": "uuid-sesion",
  "previous_status": "active",
  "new_status": "active",
  "decision_mode": "rules",
  "decided_at": "2026-03-23T10:00:00.000Z",
  "_outputPort": "continue"
}

Ejemplo de Uso

Caso básico

{
  "decision_mode": "rules",
  "rules": [
    {
      "field": "follow_up_number",
      "operator": ">=",
      "value": "3",
      "action": "close",
      "name": "Cerrar tras 3 follow-ups sin respuesta"
    }
  ],
  "default_action": "continue",
  "update_session_status": true
}

Datos de entrada esperados

• session_id: ID de la sesión del agente.
• follow_up_number: Número de seguimiento actual.
• previous_follow_ups: Cantidad de follow-ups enviados.
• minutes_since_last_message: Minutos desde el último mensaje.
• messages_count: Total de mensajes en la sesión.
• session_status: Estado actual de la sesión.
• memory: Memoria de la sesión.
• entities: Entidades extraidas.

API Utilizada

En modo IA o hibrido, se llama a la API del proveedor configurado (OpenAI, Anthropic, Google, etc.) para que el LLM tome la decision.

Notas

• El campo _outputPort en la salida determina por cual de los 5 puertos sale el flujo (continue, pause, close, escalate, archive).
• En modo hibrido, las reglas tienen prioridad sobre la IA.
• La decision por IA usa temperatura 0.3 para mayor consistencia.
• Si la IA no puede parsear una respuesta valida, se usa la acción por defecto.
• Los datos de entrada se pasan completos al siguiente nodo junto con el resultado de la decision.

Nodos Relacionados

• Agent - Agente IA
• AgentSendFollowUp - Enviar Seguimiento