Cosa sono gli Strumenti (Tools) del Capitão e come usarli per automatizzare le attività?

Q: Devo saper programmare per usare gli Strumenti del Capitão?

Per gli strumenti nativi, no. La configurazione è semplice e guidata, e comporta clic e autorizzazioni dell'account. Per gli strumenti personalizzati (HTTP), sì, è necessario avere una conoscenza di base su come funzionano le API e le richieste HTTP. Questa è una risorsa più avanzata, rivolta a sviluppatori o team con supporto tecnico.

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

Con gli Strumenti, trasformi il tuo assistente Capitão 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	Conoscenza Tecnica
Nativo	Integrazioni pre-configurate e pronte all'uso, disponibili sulla piattaforma Papo.	Programmare una dimostrazione nel Google Calendar del venditore.	Bassa (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.	Avanzata (richiede conoscenza di API e richieste HTTP).

Come Funzionano gli Strumenti del Capitão?

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 una riunione con un consulente".
Selezione dello Strumento: Il Capitão analizza il messaggio e, in base alle istruzioni e descrizioni degli strumenti che hai configurato, identifica quale sia il più adatto a risolvere la richiesta.
Esecuzione dell'Azione: L'AI 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.
Ritorno 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 Capitão utilizza questa informazione per formulare una risposta naturale e completa al cliente, finalizzando la richiesta in modo autonomo.

Questo flusso trasforma l'assistenza, permettendo all'AI 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 Capitão 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 Capitão 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 Capitão 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 della stessa Papo.

Per configurare uno strumento personalizzato, devi fornire i dettagli della richiesta HTTP che l'AI 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 Capitão

Sebbene i nomi esatti dei menu possano 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 Capitão che desideri migliorare.
Localizza la Sezione Strumenti (Tools): All'interno delle impostazioni dell'assistente, cerca l'opzione per gestire o aggiungere nuovi strumenti.
Aggiungi un Nuovo Strumento: Scegli tra l'utilizzo di uno "Strumento Nativo" dall'elenco o la creazione di uno "Strumento Personalizzato".
Per gli Strumenti Nativi:
- Seleziona l'integrazione desiderata (es: Google Calendar).
- Segui le istruzioni sullo schermo per connettere il tuo account e concedere le autorizzazioni necessarie.
- Attiva lo strumento affinché il Capitão possa iniziare a usarlo.
Per gli Strumenti Personalizzati (HTTP):
- Dai un Nome e una Descrizione: Questa è una fase cruciale. Il nome deve essere chiaro (es: "VerificaStatoOrdine") e la descrizione deve spiegare in linguaggio naturale cosa fa lo strumento e quando deve essere usato (es: "Usa questo strumento per ottenere lo stato di un ordine quando il cliente fornisce il numero"). L'AI userà questa descrizione per decidere quando attivare l'azione.
- Configura la Richiesta: Compila i campi tecnici: URL dell'endpoint, metodo HTTP, intestazioni di autenticazione e il corpo della richiesta, utilizzando variabili quando necessario.
- Salva e Attiva: Dopo aver compilato tutti i dati, salva la configurazione.
Testa lo Strumento: Invia un messaggio all'assistente in un canale di test, simulando la richiesta di un cliente, per assicurarti che lo strumento venga attivato correttamente e che la risposta sia quella attesa.

Domande Frequenti (FAQ)

Cos'è un'API e perché ne ho bisogno per gli strumenti personalizzati?

Un'API (Application Programming Interface) è un insieme di regole e definizioni che permette a diversi sistemi software di comunicare. Per gli strumenti personalizzati, l'API del tuo sistema (ERP, CRM, ecc.) è il "ponte" che permette al Capitão di inviare e ricevere informazioni, come consultare un ordine o creare un cliente.

Devo saper programmare per usare gli Strumenti del Capitão?

Per gli strumenti nativi, no. La configurazione è semplice e guidata, e comporta clic e autorizzazioni dell'account. Per gli strumenti personalizzati (HTTP), sì, è necessario avere una conoscenza di base su come funzionano le API e le richieste HTTP. Questa è una risorsa più avanzata, rivolta a sviluppatori o team con supporto tecnico.

Il Capitão può usare gli strumenti per eseguire azioni all'interno di Papo stessa?

Sì. Puoi usare gli strumenti personalizzati per interagire con l'API di Papo stessa. Ad esempio, è possibile creare uno strumento che, identificando un nuovo lead nella conversazione, effettua una chiamata all'API di Papo e crea un nuovo contatto nel CRM o gli aggiunge un'etichetta specifica.

Come fa l'AI a sapere quale strumento usare in ogni situazione?

L'AI decide in base a due fattori principali: l'intenzione rilevata nel messaggio dell'utente e la descrizione che fornisci quando configuri lo strumento. Una descrizione chiara e precisa, come "Usa questo strumento per programmare una visita tecnica", è fondamentale affinché il Capitão comprenda il contesto e scelga l'azione corretta.

Gli strumenti personalizzati sono sicuri?

La sicurezza delle connessioni tramite strumenti personalizzati dipende dall'implementazione corretta. Papo memorizza le tue chiavi API in modo sicuro, ma è tua responsabilità assicurarti di connetterti a endpoint sicuri (HTTPS) e di utilizzare chiavi API che abbiano solo le autorizzazioni necessarie per eseguire l'azione, minimizzando i rischi.