Osservazioni in SmartFlow
Le osservazioni forniscono feedback in tempo reale al tuo assistente AI durante le conversazioni. Consentono a SmartFlow di comunicare i risultati all'AI.
Cosa Sono le Osservazioni?
Quando un SmartFlow viene eseguito (attivato da uno strumento di conversazione), può inviare osservazioni all'AI. L'AI utilizza queste osservazioni per:
- Fornire risposte informate agli utenti
- Visualizzare dati recuperati da sistemi esterni
- Confermare che le azioni siano state completate con successo
- Gestire gli errori in modo elegante
Come Funziona
L'utente pone una domanda → L'AI attiva SmartFlow → SmartFlow viene eseguito →
Osservazione inviata → L'AI legge l'osservazione → L'AI risponde all'utente
Esempio:
- Utente: "Qual è lo stato del mio ordine #12345?"
- L'AI attiva il SmartFlow "Controlla Stato Ordine"
- SmartFlow chiama l'API eCommerce
- SmartFlow invia l'osservazione:
{"status": "shipped", "tracking": "ABC123"} - L'AI risponde: "Il tuo ordine #12345 è stato spedito! Tracciamento: ABC123"
Impostare Osservazioni
Utilizza il nodo di azione Imposta Osservazione nel tuo SmartFlow:
| Campo | Descrizione |
|---|---|
| Osservazione | Testo o dati JSON da inviare all'AI |
| Variabili | Usa {{variabile}} per includere dati dinamici |
Esempio di configurazione:
{
"status": "{{apiResponse.orderStatus}}",
"tracking": "{{apiResponse.trackingNumber}}",
"estimatedDelivery": "{{apiResponse.eta}}"
}
Migliori Pratiche
Mantieni le Osservazioni Concise
L'AI elabora le osservazioni come contesto. Mantienile focalizzate:
// Buono
{"found": true, "productName": "Blue Widget", "price": 29.99}
// Troppo verboso
{"query": "...", "timestamp": "...", "requestId": "...", "fullResponse": {...}}
Gestisci gli Errori
Includi sempre la gestione degli errori nelle tue osservazioni:
// Successo
{"success": true, "data": {...}}
// Errore
{"success": false, "error": "Ordine non trovato"}
Usa Dati Strutturati
JSON è preferito rispetto al testo semplice per dati complessi:
{
"tickets": [
{"id": "JIRA-123", "status": "In Progress"},
{"id": "JIRA-124", "status": "Done"}
],
"total": 2
}
Casi d'Uso Comuni
| Caso d'Uso | L'Osservazione Contiene |
|---|---|
| Ricerca ordine | Stato, tracciamento, data di consegna |
| Prenotazione appuntamento | Conferma, data/ora, dettagli |
| Ricerca conoscenze | Articoli pertinenti, riassunti |
| Ricerca CRM | Informazioni cliente, cronologia |
| Controllo inventario | Livelli di stock, disponibilità |
Correlati
- Azione Imposta Osservazione — Riferimento nodo
- Attivazione Strumento di Conversazione — Come l'AI attiva i flussi
- Azione Richiesta AI — Richiesta di elaborazione AI