Herramientas nativas (I): cerrar conversación, asignar a persona o equipo y agregar nota

Estas tres herramientas son la base de cualquier agente de IA en Omnifox y están disponibles desde el plan de entrada con IA activa — son las primeras que deberías activar en un agente nuevo.

Cerrar conversación (close_conversation)

Marca la conversación como cerrada cuando el cliente confirma que su consulta fue resuelta.

• Cuándo activarla: el cliente confirmó que su problema se resolvió, se despidió ("gracias", "listo"), y no quedan preguntas pendientes.
• Cuándo NO: el cliente sigue con dudas, está insatisfecho, o hay una promesa pendiente de tu lado.
• Efecto: la conversación pasa a estado "cerrada" y deja de contar como abierta en las métricas y en la bandeja.

Asignar a persona o equipo (assign_to_user_or_team)

Deriva la conversación a un humano específico o a un equipo completo.

• Parámetros: target_type ("user" o "team"), target_name (nombre del equipo/persona, recomendado) o target_id (numérico), y reason opcional.
• Podés referirte por nombre ("equipo Ventas", "Juan Pérez") sin memorizar IDs — el sistema resuelve el nombre automáticamente. Si hay varias coincidencias, el bot recibe los candidatos y puede pedirle al cliente que aclare.
• Usos típicos: enrutar por categoría (ventas, soporte, facturación), escalar quejas, o pasar a un humano que ya conoce el caso.

Agregar comentario interno (add_comment)

Deja una nota visible SOLO para tu equipo — el cliente nunca la ve.

• Parámetro: comment (texto, máximo 2000 caracteres).
• Cuándo usarla: antes de escalar (resumen del caso), al capturar datos sensibles (cédula, RUC), cuando hay una promesa de pago, o para marcar señales (cliente molesto, riesgo de fuga, oportunidad de venta).

Configuración

Cada herramienta se activa/desactiva de forma independiente para cada agente, en la pestaña Acciones personalizadas del editor. Que una herramienta esté activada no alcanza: el system prompt del agente tiene que decirle explícitamente CUÁNDO usarla.

Ejemplo

Prompt de ejemplo para un agente de soporte:

"Si el cliente confirma que su problema fue resuelto y se despide, cerrá la conversación con !close_conversation. Si el caso es técnico y supera tu conocimiento, dejá primero un !add_comment con el resumen y los pasos ya intentados, y luego !assign_to_user_or_team al equipo Soporte."

Consejos

• Combiná las tres: dejar la nota interna ANTES de derivar le ahorra tiempo al humano que recibe el caso.
• Probá el flujo completo en el Sandbox antes de publicarlo, viendo la traza de cada llamada a herramienta.

Solución de problemas

• Si el agente no cierra ni deriva conversaciones, revisá primero que la herramienta esté activada en Acciones personalizadas, y después que el prompt describa la condición de disparo (ver el artículo de solución de problemas del agente de IA).