Decision del Agente

Descripcion

Este modulo evalua el estado actual de una conversacion y determina la accion 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 accion 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 conversacion a un LLM que analiza y decide la accion. Utiliza temperatura baja (0.3) para decisiones consistentes. Puede usar el mismo cerebro configurado en el agente de la sesion o uno propio.
3. Hibrido: Primero evalua las reglas; si ninguna aplica, recurre a la IA como fallback.

Las acciones posibles son:

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

El modulo tiene 5 puertos de salida, uno por cada accion, lo que permite dirigir el flujo de manera diferenciada segun la decision tomada. Opcionalmente actualiza el estado de la sesion en base de datos.

Configuracion

Parametro	Tipo	Requerido	Descripcion
decision_mode	select	Si	Como se toman las decisiones. Opciones: rules, ai, hybrid. Default: rules.
rules	agentDecisionRules	No	Configura las reglas para tomar decisiones automaticas.
ai_prompt	textarea	No	Instrucciones para que la IA determine la accion 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 segun brain_provider. Default: gpt-4o.
credentials_key	credentials	No	Credenciales del proveedor. Visible si use_session_brain es false.
default_action	select	Si	Accion cuando ninguna regla aplica. Opciones: continue, pause, close, escalate, archive. Default: continue.
update_session_status	boolean	No	Actualizar automaticamente el estado de la sesion segun la decision. Default: true.

Credenciales

Opcionales. Si use_session_brain es true, se reutilizan las credenciales del agente de la sesion. 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 basico

{
  "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 sesion del agente.
• follow_up_number: Numero de seguimiento actual.
• previous_follow_ups: Cantidad de follow-ups enviados.
• minutes_since_last_message: Minutos desde el ultimo mensaje.
• messages_count: Total de mensajes en la sesion.
• session_status: Estado actual de la sesion.
• memory: Memoria de la sesion.
• 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 accion 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