Observaciones en SmartFlow

Las observaciones proporcionan retroalimentación en tiempo real a tu asistente de IA durante las conversaciones. Permiten que los SmartFlows comuniquen resultados de vuelta a la IA.

---

¿Qué Son las Observaciones?

Cuando un SmartFlow se ejecuta (activado por una Herramienta de Conversación), puede enviar observaciones de vuelta a la IA. La IA utiliza estas observaciones para:

• Proporcionar respuestas informadas a los usuarios
• Mostrar datos recuperados de sistemas externos
• Confirmar que las acciones se completaron con éxito
• Manejar errores de manera adecuada

---

Cómo Funciona

El usuario hace una pregunta → La IA activa el SmartFlow → El SmartFlow se ejecuta → 
Se envía la observación → La IA lee la observación → La IA responde al usuario

Ejemplo:

1. Usuario: "¿Cuál es el estado de mi pedido #12345?"
2. La IA activa el SmartFlow "Verificar Estado del Pedido"
3. El SmartFlow llama a la API de eCommerce
4. El SmartFlow envía la observación: {"status": "shipped", "tracking": "ABC123"}
5. La IA responde: "¡Tu pedido #12345 ha sido enviado! Seguimiento: ABC123"

---

Configuración de Observaciones

Utiliza el nodo de acción Establecer Observación en tu SmartFlow:

Campo	Descripción
Observación	Texto o datos JSON para enviar a la IA
Variables	Usa {{variable}} para incluir datos dinámicos

Ejemplo de configuración:

{
  "status": "{{apiResponse.orderStatus}}",
  "tracking": "{{apiResponse.trackingNumber}}",
  "estimatedDelivery": "{{apiResponse.eta}}"
}

---

Mejores Prácticas

Mantén las Observaciones Concisas

La IA procesa las observaciones como contexto. Mantenlas enfocadas:

// Bueno
{"found": true, "productName": "Blue Widget", "price": 29.99}

// Demasiado verboso
{"query": "...", "timestamp": "...", "requestId": "...", "fullResponse": {...}}

Maneja Errores

Siempre incluye el manejo de errores en tus observaciones:

// Éxito
{"success": true, "data": {...}}

// Error
{"success": false, "error": "Pedido no encontrado"}

Usa Datos Estructurados

JSON es preferido sobre texto plano para datos complejos:

{
  "tickets": [
    {"id": "JIRA-123", "status": "En Progreso"},
    {"id": "JIRA-124", "status": "Hecho"}
  ],
  "total": 2
}

---

Casos de Uso Comunes

Caso de Uso	La Observación Contiene
Búsqueda de pedido	Estado, seguimiento, fecha de entrega
Reserva de cita	Confirmación, fecha/hora, detalles
Búsqueda de conocimiento	Artículos relevantes, resúmenes
Búsqueda en CRM	Información del cliente, historial
Verificación de inventario	Niveles de stock, disponibilidad

---

Relacionado

• Acción Establecer Observación — Referencia del nodo
• Activador de Herramienta de Conversación — Cómo la IA activa flujos
• Acción de Solicitud de IA — Solicitar procesamiento de IA