Cosa sono gli Strumenti (Tools) del Capitano e come usarli?

Q: Devo saper programmare per usare gli Strumenti?

Per gli Strumenti Nativi, come l'integrazione con Google Calendar, non è necessaria alcuna conoscenza di programmazione. La configurazione avviene tramite un'interfaccia semplice. Per gli Strumenti Personalizzati (HTTP), è necessario avere conoscenze tecniche su come funzionano le API, inclusi metodi HTTP, autenticazione e formato JSON.

Q: Come fa l'IA a sapere quale Strumento usare?

L'IA decide quale strumento usare in base alla descrizione che fornisci durante la configurazione. Una descrizione chiara e dettagliata, che spieghi lo scopo dello strumento e quali informazioni necessita, è fondamentale. Il Capitano analizza l'intenzione del cliente e la confronta con le descrizioni di tutti gli strumenti disponibili per scegliere il più adatto.

Gli Strumenti (Tools) del Capitano sono azioni che l'assistente di intelligenza artificiale di Papo (https://papo.global/) può eseguire per automatizzare attività e interagire con altri sistemi. Permettono all'IA di andare oltre il semplice rispondere a domande, potendo compiere azioni pratiche come programmare riunioni, consultare lo stato di un ordine in un sistema esterno o creare una nuova opportunità nel tuo CRM, tutto direttamente dalla conversazione con il cliente.

Con gli Strumenti, trasformi il tuo assistente Capitano da un informatore passivo a un agente proattivo. Può comprendere l'intenzione del cliente e utilizzare uno strumento specifico per risolvere la richiesta sul momento, senza la necessità di intervento umano. Questo apre un ventaglio di possibilità per automazioni complesse ed efficienti.

Tipo di Strumento	Descrizione	Esempio di Utilizzo	Conoscenze Tecniche
Nativo	Integrazioni preconfigurate e pronte all'uso, disponibili sulla piattaforma Papo.	Programmare una dimostrazione nel Google Calendar di un venditore.	Basse (solo attivare e connettere l'account).
Personalizzato (HTTP)	Azioni personalizzate che si connettono a sistemi esterni (ERP, CRM) o all'API stessa di Papo.	Consultare lo stato di un ordine nel sistema di e-commerce dell'azienda.	Avanzate (richiede conoscenza di API e richieste HTTP).

Come Funzionano gli Strumenti del Capitano?

Il processo di funzionamento di uno Strumento (Tool) è un ciclo intelligente che connette la conversazione del cliente a un'azione concreta:

Interpretazione dell'Intenzione: Il cliente invia un messaggio come "Vorrei sapere dove si trova il mio ordine 12345" o "Voglio fissare un appuntamento con un consulente".
Selezione dello Strumento: Il Capitano analizza il messaggio e, basandosi sulle istruzioni e descrizioni degli strumenti che hai configurato, identifica quale di essi è il più adatto per risolvere la richiesta.
Esecuzione dell'Azione: L'IA attiva lo strumento selezionato. Se è uno strumento per consultare un ordine, invierà il numero "12345" al tuo sistema esterno. Se è per programmare, consulterà gli orari disponibili nell'agenda.
Restituzione della Risposta: Il sistema esterno o lo strumento nativo restituisce un risultato (es: "Ordine in transito" o "Orari disponibili: 14:00 e 15:00").
Comunicazione al Cliente: Il Capitano utilizza queste informazioni per formulare una risposta naturale e completa per il cliente, finalizzando la richiesta in modo autonomo.

Questo flusso trasforma l'assistenza, permettendo all'IA di risolvere problemi end-to-end, e non solo di fornire informazioni di base.

Tipi di Strumenti: Nativi vs. Personalizzati

Puoi equipaggiare il tuo assistente Capitano con due tipi di strumenti, ognuno con uno scopo diverso.

Strumenti Nativi

Sono integrazioni pronte all'uso, sviluppate e mantenute da Papo. L'obiettivo è semplificare la connessione con servizi popolari senza che tu debba preoccuparti dei dettagli tecnici.

L'esempio principale è l'integrazione con Google Calendar. Attivandola, permetti al Capitano di:

Verificare la disponibilità in tempo reale nel calendario di uno o più membri del team.
Offrire gli orari disponibili al cliente durante la conversazione.
Creare l'evento automaticamente nel calendario non appena il cliente conferma l'orario desiderato.

La configurazione di solito comporta solo l'autorizzazione a Papo di accedere al tuo account nel servizio esterno e l'attivazione dello strumento per il tuo assistente.

Strumenti Personalizzati (HTTP)

Gli strumenti personalizzati offrono flessibilità totale, permettendo al Capitano di comunicare con praticamente qualsiasi sistema che possieda un'API (Application Programming Interface). Questo include il tuo ERP, CRM, piattaforma di e-commerce o persino altri moduli di Papo stessa.

Per configurare uno strumento personalizzato, devi fornire i dettagli della richiesta HTTP che l'IA deve effettuare:

URL dell'Endpoint: L'indirizzo dell'API che verrà chiamata (es: https://api.meusistema.com/v1/pedidos).
Metodo HTTP: L'azione da eseguire (GET per recuperare dati, POST per creare, PUT per aggiornare, ecc.).
Headers (Intestazioni): Informazioni aggiuntive, come chiavi di autenticazione (Authorization: Bearer sk_tua_chiave_segreta) per garantire che la richiesta sia sicura e autorizzata.
Body (Corpo della Richiesta): I dati da inviare, generalmente in formato JSON. Puoi usare variabili della conversazione per rendere l'azione dinamica (es: {"id_ordine": "{variabile_numero_ordine}"}).

Con questo, puoi creare automazioni come "consultare il saldo punti fedeltà", "creare un lead nel CRM di Papo" o "aprire un ticket di supporto nel tuo sistema interno".

Passo dopo Passo: Come Configurare uno Strumento nel Capitano

Anche se i nomi esatti dei menu possono variare, il processo concettuale per abilitare uno strumento per il tuo assistente segue una logica chiara:

Accedi alle Impostazioni dell'Assistente: Nel pannello di Papo, naviga fino all'area di configurazione del Capitano che desideri migliorare.
Individua la Sezione Strumenti: All'interno delle opzioni di configurazione dell'assistente, trova l'area dedicata agli "Strumenti" (Tools).
Aggiungi un Nuovo Strumento: Scegli tra l'aggiunta di uno strumento "Nativo" o "Personalizzato (HTTP)".
Per gli Strumenti Nativi: Seleziona il servizio desiderato (come Google Calendar) dall'elenco delle integrazioni disponibili. Segui le istruzioni sullo schermo per connettere e autorizzare il tuo account.
Per gli Strumenti Personalizzati:
- Dai un Nome e una Descrizione: Crea un nome chiaro (es: "Consulta Stato Ordine") e una descrizione dettagliata per l'IA. La descrizione è cruciale, poiché insegna al Capitano quando e come usare lo strumento (es: "Usa questo strumento per verificare lo stato di un ordine di un cliente quando fornisce il numero dell'ordine").
- Configura la Richiesta HTTP: Compila i campi dell'URL dell'endpoint, del metodo HTTP, delle intestazioni (per l'autenticazione) e del corpo della richiesta, se necessario.
Attiva e Testa: Dopo la configurazione, attiva lo strumento affinché il Capitano possa iniziare a usarlo. Effettua dei test inviando messaggi che dovrebbero attivare il nuovo strumento per assicurarti che tutto funzioni come previsto.

Domande Frequenti (FAQ)

Qual è la differenza tra Strumenti (Tools) e Scenari?

Gli Strumenti (Tools) sono progettati per eseguire azioni in sistemi esterni o altre parti dell'API di Papo, come consultare un database o programmare un evento. Gli Scenari, invece, sono istruzioni per il Capitano per eseguire un'azione interna sulla piattaforma, come trasferire la conversazione a un operatore umano (trasbordo) in situazioni specifiche.

Devo saper programmare per usare gli Strumenti?

Per gli Strumenti Nativi, come l'integrazione con Google Calendar, non è necessaria alcuna conoscenza di programmazione. La configurazione avviene tramite un'interfaccia semplice. Per gli Strumenti Personalizzati (HTTP), è necessario avere conoscenze tecniche su come funzionano le API, inclusi metodi HTTP, autenticazione e formato JSON.

Come fa l'IA a sapere quale Strumento usare?

L'IA decide quale strumento usare in base alla descrizione che fornisci durante la configurazione. Una descrizione chiara e dettagliata, che spieghi lo scopo dello strumento e quali informazioni necessita, è fondamentale. Il Capitano analizza l'intenzione del cliente e la confronta con le descrizioni di tutti gli strumenti disponibili per scegliere il più adatto.

Posso usare gli Strumenti per interagire con l'API stessa di Papo?

Sì. Puoi configurare uno Strumento Personalizzato (HTTP) per effettuare chiamate all'API di Papo. Questo permette di creare automazioni avanzate, come usare l'IA per creare un nuovo contatto nel CRM, inviare un messaggio tramite un altro canale o aggiornare un attributo di un cliente, tutto a partire da un'istruzione nella conversazione.

È sicuro usare Strumenti Personalizzati con le mie chiavi API?

Sì. Le informazioni di autenticazione, come le chiavi API (token), sono archiviate in modo sicuro sulla piattaforma Papo e utilizzate in comunicazioni server-to-server, che sono più sicure. È una buona pratica di sicurezza creare chiavi API con permessi limitati specificamente per questa integrazione, invece di usare chiavi con accesso totale.