Observations dans SmartFlow

Les observations fournissent un retour d'information en temps réel à votre assistant IA lors des conversations. Elles permettent aux SmartFlows de communiquer les résultats à l'IA.

---

Qu'est-ce que les Observations ?

Lorsqu'un SmartFlow s'exécute (déclenché par un Outil de Conversation), il peut envoyer des observations à l'IA. L'IA utilise ces observations pour :

• Fournir des réponses éclairées aux utilisateurs
• Afficher des données récupérées à partir de systèmes externes
• Confirmer que les actions ont été réalisées avec succès
• Gérer les erreurs de manière élégante

---

Comment ça fonctionne

L'utilisateur pose une question → L'IA déclenche le SmartFlow → Le SmartFlow s'exécute → 
Observation envoyée → L'IA lit l'observation → L'IA répond à l'utilisateur

Exemple :

1. Utilisateur : "Quel est le statut de ma commande #12345 ?"
2. L'IA déclenche le SmartFlow "Vérifier le Statut de la Commande"
3. Le SmartFlow appelle l'API eCommerce
4. Le SmartFlow envoie l'observation : {"status": "shipped", "tracking": "ABC123"}
5. L'IA répond : "Votre commande #12345 a été expédiée ! Suivi : ABC123"

---

Définir des Observations

Utilisez le nœud d'action Définir l'Observation dans votre SmartFlow :

Champ	Description
Observation	Texte ou données JSON à envoyer à l'IA
Variables	Utilisez {{variable}} pour inclure des données dynamiques

Exemple de configuration :

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

---

Meilleures Pratiques

Gardez les Observations Concises

L'IA traite les observations comme contexte. Gardez-les ciblées :

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

// Trop verbeux
{"query": "...", "timestamp": "...", "requestId": "...", "fullResponse": {...}}

Gérer les Erreurs

Incluez toujours la gestion des erreurs dans vos observations :

// Succès
{"success": true, "data": {...}}

// Erreur
{"success": false, "error": "Commande non trouvée"}

Utiliser des Données Structurées

JSON est préféré au texte brut pour les données complexes :

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

---

Cas d'Utilisation Courants

Cas d'Utilisation	Contenu de l'Observation
Recherche de commande	Statut, suivi, date de livraison
Prise de rendez-vous	Confirmation, date/heure, détails
Recherche de connaissances	Articles pertinents, résumés
Recherche CRM	Informations sur le client, historique
Vérification des stocks	Niveaux de stock, disponibilité

---

Liens Connexes

• Action Définir l'Observation — Référence du nœud
• Déclencheur d'Outil de Conversation — Comment l'IA déclenche des flux
• Action Demande IA — Demander le traitement de l'IA