🛠️ Attivatore dello Strumento di Conversazione

L'Attivatore dello Strumento di Conversazione consente agli agenti AI all'interno di SmartFlow di interagire dinamicamente con strumenti e sistemi esterni, prendendo decisioni intelligenti per eseguire compiti, recuperare dati o attivare azioni successive. Utilizzando un motore di decisione AI, gli agenti decidono quali strumenti utilizzare e gestiscono più azioni in modo efficiente. Questo sistema supporta fino a 10 azioni di strumento per interazione prima di fornire una risposta.

---

📝 Dettagli dell'Attivatore

Nome: Conversation Tool
Categoria: Attivatori

---

🔧 Parametri

1. Nome dello Strumento

   • Tipo: string
   • Descrizione: Specifica lo strumento da eseguire dall'agente AI. Lo strumento deve essere preconfigurato e integrato in SmartFlow.
   • Obbligatorio: Sì
   • Esempio: "CRM Lookup"

2. Variabili di Input

   • Tipo: object
   • Descrizione: I dati richiesti per consentire allo strumento di eseguire il suo compito, spesso derivati dal contesto del flusso di lavoro o della conversazione.
   • Obbligatorio: Sì
   • Esempio:

     {
       "customerId": "12345"
     }

3. Osservazione

   • Tipo: string (predefinito: output specifico dello strumento)
   • Descrizione: Il risultato dell'azione, che può influenzare il comportamento successivo dell'AI. Per impostazione predefinita, l'osservazione è impostata sull'output dello strumento, ma può essere definita manualmente per guidare la prossima azione dell'agente.
   • Esempio:
     • Osservazione Predefinita: risultato API restituito dallo strumento.
     • Osservazione Personalizzata: "Attiva il prossimo modulo in base alle preferenze dell'utente."

---

🚀 Come Funziona

1. Osservazioni Predefinite:

   • Ogni azione dello strumento genera un'osservazione predefinita basata sul risultato dello strumento.
   • Esempio: Una chiamata API riuscita restituisce la risposta API come osservazione.

2. Impostazione Manuale dell'Osservazione:

   • Gli utenti possono sovrascrivere l'osservazione predefinita per influenzare la prossima decisione dell'AI.
   • Esempio: Invece di utilizzare il risultato API come osservazione, un messaggio personalizzato come "Avvia il processo di invio del modulo" può guidare l'AI a iniziare un'altra azione.

3. Motore di Decisione AI:

   • Il motore di decisione analizza l'osservazione attuale e determina la prossima azione dello strumento, concatenando senza soluzione di continuità più strumenti quando necessario.

4. Formulazione della Risposta:

   • Dopo aver eseguito fino a 10 azioni dello strumento, l'agente AI formula una risposta, utilizzando direttamente le osservazioni o basandosi su ulteriori input dell'utente.

---

💡 Casi d'Uso

1. Supporto Clienti Dinamico:

   • Scenario: Un utente chiede: "Posso avere un aggiornamento sul mio ordine recente?"
   • Flusso di lavoro:
     • Strumento: chiamata API per recuperare i dettagli dell'ordine.
     • Osservazione: risultato API con stato dell'ordine.
     • Risposta: "Il tuo ordine è in viaggio e arriverà il 15 gennaio 2025."

2. Reindirizzamento del Flusso di Lavoro Personalizzato:

   • Scenario: Un utente attiva uno strumento, ma si desidera che l'AI avvii un modulo specifico.
   • Flusso di lavoro:
     • Strumento: "Avvia Modulo."
     • Osservazione: "Inizia il Modulo di Feedback Utente."
     • Risultato: L'AI passa dinamicamente all'invio del modulo.

3. Integrazione Multi-Step:

   • Scenario: "Quanto è la mia fattura attuale e posso pagarla ora?"
   • Flusso di lavoro:
     • Passo 1: Recupera i dettagli della fattura tramite API.
     • Passo 2: Attiva il gateway di pagamento.
     • Le osservazioni guidano la sequenza di queste azioni.

---

🔍 Configurazione Esempio

Osservazione Predefinita

Nome dello Strumento: "Gestione Ordini"
Variabili di Input:

{
  "orderId": "67890"
}

Osservazione: risultato API

{
  "trigger": "ConversationTool",
  "toolName": "Gestione Ordini",
  "input": {
    "orderId": "67890"
  },
  "observation": "Stato dell'ordine recuperato con successo."
}

Osservazione Personalizzata

Nome dello Strumento: "Avvia Modulo"
Variabili di Input:

{
  "formId": "feedbackForm"
}

Osservazione: "Modulo di feedback utente avviato."

{
  "trigger": "ConversationTool",
  "toolName": "Avvia Modulo",
  "input": {
    "formId": "feedbackForm"
  },
  "observation": "Modulo di feedback utente avviato."
}

---

🛠️ Migliori Pratiche

1. Osservazioni Predefinite vs. Personalizzate:

   • Utilizzare osservazioni predefinite per flussi di lavoro standard e integrazioni API.
   • Sovrascrivere le osservazioni per reindirizzare il comportamento dell'AI in scenari specifici.

2. Messaggi di Osservazione Chiari:

   • Assicurarsi che le osservazioni personalizzate siano precise per guidare efficacemente l'AI.

3. Concatenazione delle Azioni:

   • Pianificare i flussi di lavoro per ridurre al minimo i passaggi non necessari, sfruttando in modo efficiente il limite di 10 azioni.

4. Test delle Osservazioni:

   • Simulare flussi di lavoro per verificare che sia le osservazioni predefinite che quelle personalizzate portino a decisioni attese dell'AI.

---

📊 Monitoraggio e Debugging

• Utilizzare il dashboard di monitoraggio di SmartFlow per tracciare:
  • Azioni degli strumenti eseguite.
  • Osservazioni generate.
  • Decisioni dell'AI e i loro risultati.
• Eseguire il debug dei flussi di lavoro esaminando i log delle osservazioni per identificare e risolvere comportamenti imprevisti.