Passa al contenuto principale

🛠️ Conversation Tool Trigger

Il Conversation Tool Trigger 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 strumenti per interazione prima di fornire una risposta.

pasted-image.png

📝 Trigger Details​

Name: Conversation Tool
Category: Triggers

🔧 Parametri​

  1. Nome 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 necessari affinché lo strumento possa svolgere il proprio 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 dell'API come osservazione, un messaggio personalizzato come "Inizia il processo di invio del modulo" può guidare l'AI a iniziare un'altra azione.

  3. Motore Decisionale AI:

    • Il motore decisionale analizza l'osservazione attuale e determina la prossima azione dello strumento, concatenando senza problemi 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 input aggiuntivi dell'utente.

💡 Casi d'uso​

  1. Supporto Clienti Dinamico:

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

  2. Reindirizzamento del Workflow Personalizzato:

    • Scenario: Un utente attiva uno strumento, ma vuoi che l'IA avvii un modulo specifico invece.
    • Workflow:
      • Tool: "Avviatore di Moduli."
      • Osservazione: "Inizia il Modulo di Feedback degli Utenti."
      • Risultato: L'IA passa dinamicamente all'invio del modulo.

  3. Integrazione Multi-Passo:

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

🔍 Esempio di Configurazione​

Osservazione Predefinita​

Nome Strumento: "Order Management"
Variabili di Input:

{
  "orderId": "67890"
}

Osservazione: API result

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

Osservazione Personalizzata​

Nome Strumento: "Start Form"
Variabili di Input:

{
  "formId": "feedbackForm"
}

Osservazione: "Modulo di feedback utente avviato."

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

🛠️ Migliori Pratiche​

  1. Osservazioni Predefinite vs. Personalizzate:

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

  2. Messaggi di Osservazione Chiari:

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

  3. Catena di Azioni:

    • Pianifica i flussi di lavoro per ridurre al minimo i passaggi non necessari sfruttando efficacemente il limite di 10 azioni.

  4. Test delle Osservazioni:

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

📊 Monitoraggio e Debugging​

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