🛠️ Activador de Herramienta de Conversación

El Activador de Herramienta de Conversación permite a los agentes de IA dentro de SmartFlow interactuar dinámicamente con herramientas y sistemas externos, tomando decisiones inteligentes para realizar tareas, recuperar datos o activar acciones subsecuentes. Utilizando un motor de decisión de IA, los agentes deciden qué herramientas usar y gestionan múltiples acciones de manera eficiente. Este sistema admite hasta 10 acciones de herramienta por interacción antes de proporcionar una respuesta.

---

📝 Detalles del Activador

Nombre: Conversation Tool
Categoría: Triggers

---

🔧 Parámetros

1. Nombre de la Herramienta

   • Tipo: string
   • Descripción: Especifica la herramienta que debe ser ejecutada por el agente de IA. La herramienta debe estar preconfigurada e integrada en SmartFlow.
   • Requerido: Sí
   • Ejemplo: "CRM Lookup"

2. Variables de Entrada

   • Tipo: object
   • Descripción: Los datos requeridos para que la herramienta realice su tarea, a menudo derivados del contexto del flujo de trabajo o la conversación.
   • Requerido: Sí
   • Ejemplo:

     {
       "customerId": "12345"
     }

3. Observación

   • Tipo: string (predeterminado: salida específica de la herramienta)
   • Descripción: El resultado de la acción, que puede influir en el comportamiento subsecuente de la IA. Por defecto, la observación se establece en la salida de la herramienta, pero puede definirse manualmente para guiar la próxima acción del agente.
   • Ejemplo:
     • Observación Predeterminada: Resultado de la API devuelto por la herramienta.
     • Observación Personalizada: "Activar el siguiente formulario basado en las preferencias del usuario."

---

🚀 Cómo Funciona

1. Observaciones Predeterminadas:

   • Cada acción de herramienta genera una observación predeterminada basada en el resultado de la herramienta.
   • Ejemplo: Una llamada a la API exitosa devuelve la respuesta de la API como la observación.

2. Configuración Manual de Observaciones:

   • Los usuarios pueden anular la observación predeterminada para influir en la próxima decisión de la IA.
   • Ejemplo: En lugar de usar el resultado de la API como la observación, un mensaje personalizado como "Iniciar el proceso de envío de formularios" puede guiar a la IA para iniciar otra acción.

3. Motor de Decisión de IA:

   • El motor de decisión analiza la observación actual y determina la siguiente acción de la herramienta, encadenando múltiples herramientas sin problemas cuando es necesario.

4. Formulación de Respuestas:

   • Después de ejecutar hasta 10 acciones de herramienta, el agente de IA formula una respuesta, ya sea utilizando directamente las observaciones o basándose en entradas adicionales del usuario.

---

💡 Casos de Uso

1. Soporte al Cliente Dinámico:

   • Escenario: Un usuario pregunta: "¿Puedo obtener una actualización sobre mi pedido reciente?"
   • Flujo de Trabajo:
     • Herramienta: Llamada a la API para obtener detalles del pedido.
     • Observación: Resultado de la API con el estado del pedido.
     • Respuesta: "Su pedido está en camino y llegará el 15 de enero de 2025."

2. Redirección de Flujo de Trabajo Personalizado:

   • Escenario: Un usuario activa una herramienta, pero quieres que la IA inicie un formulario específico en su lugar.
   • Flujo de Trabajo:
     • Herramienta: "Iniciador de Formularios."
     • Observación: "Iniciar Formulario de Retroalimentación del Usuario."
     • Resultado: La IA transiciona dinámicamente al envío del formulario.

3. Integración de Múltiples Pasos:

   • Escenario: "¿Cuánto es mi factura actual y puedo pagarla ahora?"
   • Flujo de Trabajo:
     • Paso 1: Recuperar detalles de la factura a través de la API.
     • Paso 2: Activar la pasarela de pago.
     • Las observaciones guían la secuencia de estas acciones.

---

🔍 Ejemplo de Configuración

Observación Predeterminada

Nombre de la Herramienta: "Gestión de Pedidos"
Variables de Entrada:

{
  "orderId": "67890"
}

Observación: Resultado de la API

{
  "trigger": "ConversationTool",
  "toolName": "Gestión de Pedidos",
  "input": {
    "orderId": "67890"
  },
  "observation": "Estado del pedido obtenido con éxito."
}

Observación Personalizada

Nombre de la Herramienta: "Iniciar Formulario"
Variables de Entrada:

{
  "formId": "feedbackForm"
}

Observación: "Formulario de retroalimentación del usuario iniciado."

{
  "trigger": "ConversationTool",
  "toolName": "Iniciar Formulario",
  "input": {
    "formId": "feedbackForm"
  },
  "observation": "Formulario de retroalimentación del usuario iniciado."
}

---

🛠️ Mejores Prácticas

1. Observaciones Predeterminadas vs. Personalizadas:

   • Utiliza observaciones predeterminadas para flujos de trabajo estándar e integraciones de API.
   • Anula las observaciones para redirigir el comportamiento de la IA en escenarios específicos.

2. Mensajes de Observación Claros:

   • Asegúrate de que las observaciones personalizadas sean precisas para guiar efectivamente a la IA.

3. Encadenamiento de Acciones:

   • Planifica flujos de trabajo para minimizar pasos innecesarios mientras aprovechas eficientemente el límite de 10 acciones.

4. Pruebas de Observaciones:

   • Simula flujos de trabajo para verificar que tanto las observaciones predeterminadas como las personalizadas conduzcan a decisiones esperadas de la IA.

---

📊 Monitoreo y Depuración

• Utiliza el tablero de monitoreo de SmartFlow para rastrear:
  • Acciones de herramientas ejecutadas.
  • Observaciones generadas.
  • Decisiones de IA y sus resultados.
• Depura flujos de trabajo revisando los registros de observación para identificar y resolver comportamientos inesperados.