Azioni predefinite che i tuoi agenti IA possono usare per interrogare i dati della piattaforma senza configurazione aggiuntiva.

Strumenti di Consulta Integrati

Gli strumenti integrati sono azioni pronte all'uso che qualsiasi agente WhatsApp o email può invocare durante una conversazione — consultare la prossima manutenzione, assegnare un'attività, generare un report — senza che l'operatore esca dalla chat e senza alcuna configurazione.

A cosa serve

Chiudere il loop nella conversazione: la risposta dell'agente è l'azione eseguita, non "apri la dashboard".
Ridurre frizione operativa: il tecnico chiede via WhatsApp, l'agente risolve e risponde in secondi.
Garantire coerenza: l'agente usa lo stesso strumento canonico per ogni intento invece di risposte libere.

Cosa sono gli strumenti integrati?

Gli strumenti di consulta integrati sono azioni di tipo action predefinite dalla piattaforma che gli agenti WhatsApp ed Email possono usare direttamente, senza necessita di creare o configurare nulla. Una volta registrati sull'agente, sono pronti all'uso.

Come funzionano?

Quando un utente scrive una domanda come "Quando e la prossima manutenzione del compressore?", l'agente analizza la conversazione e usa automaticamente lo strumento corretto per interrogare il sistema e rispondere con dati reali — senza che l'operatore debba aprire nessuna schermata ne esportare alcun file.

L'agente decide quale strumento usare basandosi sulla descrizione di ciascuna azione e sul contesto della conversazione.

Strumenti disponibili

Manutenzione

Strumenti per interrogare lo stato dei piani di manutenzione preventiva.

`query_maintenance_plans`

Interroga la lista dei piani di manutenzione preventiva con la prossima data di esecuzione programmata.


Quando usarlo	Quando l'utente chiede delle prossime date di manutenzione o del calendario di manutenzione.
Esempio	"Quando e la prossima manutenzione del compressore C-101?"
Restituisce	Lista di piani con nome dell'asset, data di prossima esecuzione, frequenza e responsabile assegnato.

`query_overdue_maintenance`

Interroga i piani di manutenzione che hanno superato la data programmata e non sono stati eseguiti.


Quando usarlo	Quando l'utente chiede di manutenzioni scadute, in ritardo o in attesa di esecuzione.
Esempio	"Quali manutenzioni sono in ritardo sulla linea 2?"
Restituisce	Lista di piani scaduti con giorni di ritardo, asset interessato e ultima esecuzione registrata.

`query_compliance`

Interroga il livello di conformita dei piani di manutenzione rispetto agli SLA e ai requisiti normativi del periodo.


Quando usarlo	Quando l'utente chiede la percentuale di conformita o quanti piani sono in regola.
Esempio	"Quanti piani di manutenzione sono in ritardo questo mese?"
Restituisce	Metriche di conformita: piani eseguiti vs. programmati, percentuale di conformita, piani in ritardo e a rischio.

Energia

Strumenti per monitorare il consumo energetico e rilevare anomalie.

`query_energy_consumption`

Interroga il consumo energetico dell'impianto o di fonti specifiche in un determinato periodo.


Quando usarlo	Quando l'utente chiede del consumo energetico, dei costi energetici o dei confronti per periodo.
Esempio	"Quanta energia ha consumato l'impianto la settimana scorsa?"
Restituisce	Consumo totale (kWh), suddivisione per fonte energetica, confronto con periodi precedenti e costo stimato.

`get_energy_anomalies`

Interroga le anomalie di consumo energetico rilevate di recente dal sistema di monitoraggio.


Quando usarlo	Quando l'utente chiede se ci sono apparecchiature con consumi insoliti o picchi energetici non giustificati.
Esempio	"C'e qualche apparecchiatura con consumo energetico anomalo?"
Restituisce	Lista di anomalie energetiche attive con asset interessato, scostamento rispetto alla linea base, severita e data di rilevamento.

Qualita (SPC)

Strumenti per interrogare lo stato del controllo statistico dei processi.

`query_spc_charts`

Interroga la lista delle carte di controllo SPC (Controllo Statistico di Processo) configurate sulla piattaforma.


Quando usarlo	Quando l'utente chiede quante carte di controllo sono attive o quali variabili vengono monitorate.
Esempio	"Quante carte di controllo abbiamo attive?"
Restituisce	Lista di carte SPC con nome, variabile monitorata, processo associato e stato (attiva/inattiva).

`get_spc_chart_status`

Interroga lo stato attuale di un grafico SPC specifico: se il processo e sotto controllo statistico o ha registrato segnali fuori controllo.


Quando usarlo	Quando l'utente chiede se un processo o una linea di produzione e sotto controllo statistico.
Esempio	"La linea di produzione 3 e fuori controllo statistico?"
Restituisce	Stato attuale della carta (in controllo / fuori controllo), numero di punti fuori dai limiti, ultimo segnale di allarme e tendenze rilevate.

Sicurezza — Ispezioni

Strumenti per interrogare la cronologia e lo stato delle ispezioni.

`query_inspections`

Interroga le ispezioni passate e in attesa con filtri per asset, stato o periodo.


Quando usarlo	Quando l'utente chiede della cronologia delle ispezioni di un asset o se ci sono ispezioni in attesa.
Esempio	"Quando e stata l'ultima ispezione del serbatoio T-10?"
Restituisce	Lista di ispezioni con data, asset ispezionato, risultato (approvato/respinto/osservazioni) e ispettore responsabile.

`get_inspection_details`

Interroga i dettagli completi di un'ispezione specifica.


Quando usarlo	Quando l'utente vuole conoscere i risultati, le osservazioni o le azioni correttive di un'ispezione concreta.
Esempio	"Cosa hanno trovato nell'ispezione della settimana scorsa?"
Restituisce	Report dettagliato dell'ispezione: checklist completata, risultati, foto allegate, osservazioni e azioni correttive generate.

Sicurezza — LOTO

Strumenti per verificare lo stato delle procedure di Blocco/Etichettatura (LOTO).

`query_loto_procedures`

Interroga le procedure LOTO disponibili per un asset specifico.


Quando usarlo	Quando l'utente ha bisogno di sapere se esiste una procedura LOTO per un'apparecchiatura prima di iniziare lavori di manutenzione.
Esempio	"Esiste una procedura LOTO per il trasformatore principale?"
Restituisce	Lista di procedure LOTO disponibili per l'asset con nome, punti di isolamento e data dell'ultima revisione.

`check_loto_status`

Verifica se un asset ha attualmente un blocco LOTO attivo.


Quando usarlo	Quando l'utente deve confermare se un'apparecchiatura e bloccata per manutenzione prima di operare o intervenire.
Esempio	"Il compressore C-101 e bloccato per manutenzione adesso?"
Restituisce	Stato LOTO dell'asset (bloccato/libero), tecnico che ha applicato il blocco, data/ora di inizio e motivo del blocco.

Inventario

Strumenti per interrogare lo stato dell'inventario di ricambi e materiali.

`query_inventory`

Interroga le parti disponibili in inventario con filtri per tipo, riferimento o ubicazione.


Quando usarlo	Quando l'utente chiede della disponibilita di ricambi, componenti o materiali in magazzino.
Esempio	"Abbiamo cuscinetti 6205 in stock?"
Restituisce	Lista di articoli in inventario con riferimento, descrizione, quantita disponibile, ubicazione in magazzino e costo unitario.

`check_stock_level`

Interroga il livello di stock di un pezzo specifico e se e al di sotto del livello minimo di riordino.


Quando usarlo	Quando l'utente chiede la quantita esatta di un articolo o se e necessario effettuare un ordine.
Esempio	"Quanti filtri dell'olio ci rimangono?"
Restituisce	Quantita attuale in stock, livello minimo configurato, indicatore di stock basso e fornitore suggerito per il riordino.

Prestazioni — SLA e KPI

Strumenti per misurare le prestazioni operative e la conformita agli accordi sul livello di servizio.

`get_sla_metrics`

Interroga le metriche SLA del periodo: percentuale di conformita, tempi medi di risposta e risoluzione.


Quando usarlo	Quando l'utente vuole conoscere le prestazioni generali del team di manutenzione rispetto agli SLA.
Esempio	"Qual e la nostra conformita agli SLA questo mese?"
Restituisce	Percentuale di conformita SLA, tempo medio di risposta (MTTR), tempo medio tra guasti (MTBF) e tendenza del periodo.

`get_sla_breaches`

Interroga le attivita od ordini di lavoro che non hanno rispettato lo SLA nel periodo.


Quando usarlo	Quando l'utente chiede di violazioni SLA specifiche o vuole identificare gli ordini che hanno superato il limite di tempo.
Esempio	"Quali ordini di lavoro hanno superato il limite di tempo?"
Restituisce	Lista di violazioni con ordine di lavoro, asset, tempo di risposta effettivo vs. consentito e responsabile assegnato.

`get_asset_kpis`

Interroga i KPI di affidabilita di un asset specifico: MTBF, MTTR, disponibilita e OEE.


Quando usarlo	Quando l'utente chiede degli indicatori di prestazione di un'apparecchiatura in un determinato periodo.
Esempio	"Qual e il MTBF del compressore C-101 quest'anno?"
Restituisce	KPI dell'asset: MTBF (tempo medio tra guasti), MTTR (tempo medio di riparazione), disponibilita operativa e OEE ove applicabile.

`query_underperforming_assets`

Interroga gli asset con le peggiori prestazioni nei KPI di affidabilita del periodo.


Quando usarlo	Quando l'utente vuole identificare le apparecchiature piu problematiche o che richiedono attenzione prioritaria.
Esempio	"Quali sono i 5 asset con la minore disponibilita?"
Restituisce	Classifica degli asset per prestazioni con nome, KPI di riferimento, valore attuale e confronto con la media dell'impianto.

Prestazioni — Benchmarking

Strumenti per confrontare le prestazioni di asset simili tra loro.

`query_benchmark_groups`

Interroga i gruppi di benchmarking configurati sulla piattaforma e i loro asset membri.


Quando usarlo	Quando l'utente chiede dei gruppi di confronto disponibili o quali asset vengono comparati.
Esempio	"Quali gruppi di benchmarking abbiamo configurato?"
Restituisce	Lista di gruppi di benchmarking con nome, asset membri, KPI di riferimento e data dell'ultimo aggiornamento.

`get_asset_ranking`

Interroga la classifica degli asset all'interno di un gruppo di benchmarking secondo un KPI specifico (disponibilita, MTBF, OEE, ecc.).


Quando usarlo	Quando l'utente vuole sapere quale asset ha le migliori o peggiori prestazioni all'interno di un gruppo comparabile.
Esempio	"Quale compressore ha la maggiore disponibilita nel gruppo?"
Restituisce	Classifica ordinata degli asset del gruppo con valore del KPI, posizione relativa e variazione rispetto alla media del gruppo.

Prestazioni — Salute degli Asset

Strumenti per valutare lo stato di salute generale degli asset industriali.

`query_asset_health`

Interroga l'health score calcolato per gli asset dell'impianto, basato su piu indicatori di affidabilita.


Quando usarlo	Quando l'utente chiede della salute generale di un asset o vuole un riepilogo del suo stato.
Esempio	"Qual e la salute del motore M-205?"
Restituisce	Health score (0–100), fattori che influenzano il punteggio, tendenza e azioni raccomandate.

`get_asset_health`

Interroga l'health score dettagliato di un asset specifico con i KPI di affidabilita che lo compongono.


Quando usarlo	Quando l'utente ha bisogno del dettaglio completo dello stato di salute di un asset concreto.
Esempio	"Qual e lo stato di salute della turbina T-01?"
Restituisce	Health score dettagliato con scomposizione dei KPI (disponibilita, MTBF, conformita della manutenzione), alert attivi e previsione.

`query_critical_assets`

Interroga la lista degli asset il cui health score e al di sotto di una soglia critica.


Quando usarlo	Quando l'utente vuole identificare rapidamente quali apparecchiature sono in stato critico e richiedono intervento.
Esempio	"Quali apparecchiature sono in stato critico?"
Restituisce	Lista di asset critici con health score attuale, soglia di allarme, tempo in stato critico e azioni raccomandate.

`query_asset_prognostics`

Interroga le previsioni di vita utile residua e la probabilita di guasto degli asset monitorati.


Quando usarlo	Quando l'utente chiede quanto tempo rimane a un asset prima di un probabile guasto o quando dovrebbe essere sostituito.
Esempio	"Quante ore rimangono alla pompa B-103 prima del guasto?"
Restituisce	Vita utile residua stimata (ore/giorni), probabilita di guasto nel prossimo periodo, modalita di guasto piu probabile e confidenza del modello.

Anomalie

Strumenti per rilevare e gestire le anomalie identificate dai modelli di machine learning.

`query_anomalies`

Interroga le anomalie rilevate dai modelli ML con filtri per fonte, asset o stato.


Quando usarlo	Quando l'utente chiede se ci sono anomalie attive in un'area, linea o apparecchiatura specifica.
Esempio	"Ci sono anomalie attive sulla linea di confezionamento?"
Restituisce	Lista di anomalie con asset, tipo di anomalia, severita (bassa/media/alta/critica), fonte del modello e data di rilevamento.

`get_anomaly_summary`

Interroga un riepilogo aggregato delle anomalie attive classificate per severita.


Quando usarlo	Quando l'utente vuole un quadro rapido dello stato delle anomalie nell'impianto senza entrare nel dettaglio.
Esempio	"Quante anomalie critiche abbiamo oggi?"
Restituisce	Conteggio delle anomalie per livello di severita (critica, alta, media, bassa), tendenza rispetto al giorno precedente e aree piu colpite.

Note d'uso

Gli strumenti integrati non richiedono configurazione di parametri ne URL. Devono solo essere registrati sull'agente.
L'agente seleziona automaticamente lo strumento corretto in base al contesto della conversazione.
Per attivare uno strumento integrato sul tuo agente, vai alle impostazioni dell'agente e aggiungilo dalla sezione degli strumenti disponibili.
Se hai bisogno di filtrare i risultati per impianto, linea o periodo specifico, puoi configurare valori predefiniti nello strumento per fissare quel contesto.

Strumenti di Azione

Gli strumenti di azione consentono all'agente di eseguire operazioni reali nel sistema: creare ordini di lavoro, inviare messaggi, generare documenti e verificare identita. A differenza degli strumenti di consulta, questi modificano dati o attivano azioni esterne (notifiche, email, messaggi WhatsApp).

Gestione Attivita e Personale

`locate_nearest_personnel`

Trova il tecnico attivo piu vicino a una posizione geografica all'interno di un dipartimento. Utile per l'assegnazione rapida durante emergenze o lavori sul campo.


Quando usarlo	Quando si ha bisogno di sapere chi e disponibile vicino a una posizione per gestire un incidente o una manutenzione urgente.
Esempio 1	"Chi e disponibile a Milano per gestire il guasto al compressore?"
Esempio 2	"Ho bisogno di un tecnico di strumentazione vicino all'impianto nord."
Esempio 3	"C'e qualcuno dell'area elettrica a Torino?"
Richiede	Paese e citta della posizione target. Il dipartimento e configurato nell'agente.
Restituisce	Lista di tecnici attivi ordinata per prossimita: nome completo, email, telefono, ruolo e livello di distanza (stessa citta / stesso stato / stesso paese).

`assign_task`

Crea un ordine di lavoro e lo assegna a un tecnico. Genera automaticamente un codice attivita univoco (es. MAN-042). Se configurato, invia notifiche via email e/o WhatsApp al tecnico assegnato al momento della creazione.


Quando usarlo	Quando l'utente vuole aprire un ordine di lavoro o assegnare un lavoro dalla conversazione.
Esempio 1	"Assegna a Marco Rossi la sostituzione dei filtri sulla pompa B-201, priorita alta."
Esempio 2	"Crea un'attivita per verificare il livello dell'olio del compressore C-101 e avvisa Roberto su WhatsApp."
Esempio 3	"Apri un ordine di manutenzione urgente per la turbina T-03."
Richiede	Titolo dell'attivita e il tecnico assegnato (l'agente puo cercarlo con `locate_nearest_personnel`). Priorita, descrizione e data di scadenza sono opzionali.
Restituisce	Codice dell'attivita creata, nome del tecnico assegnato e stato delle notifiche inviate (email / WhatsApp).

`update_task`

Aggiorna lo stato, la priorita, la descrizione o il tecnico assegnato di un'attivita esistente. L'agente puo registrare progressi durante la conversazione senza che l'operatore acceda al dashboard.


Quando usarlo	Quando l'utente segnala che un'attivita ha cambiato stato, deve essere riassegnata o la sua descrizione deve essere aggiornata.
Esempio 1	"L'attivita MAN-042 e ora in corso."
Esempio 2	"Cambia la priorita dell'ordine VEN-015 a urgente."
Esempio 3	"L'attivita MAN-042 e completata."
Richiede	Codice dell'attivita (es. `MAN-042`) o il suo ID, e almeno un campo da aggiornare: stato, priorita, descrizione, data di scadenza o tecnico.
Restituisce	Conferma dei campi aggiornati, stato attuale e priorita attuale dell'attivita.

Stati validi: backlog, todo, in_progress, done, cancelled.

`get_task`

Recupera tutti i dettagli di un'attivita tramite il suo codice o ID. Utile quando l'operatore vuole conoscere lo stato attuale di un ordine di lavoro specifico.


Quando usarlo	Quando l'utente chiede dello stato, del responsabile o dei dettagli di un'attivita specifica.
Esempio 1	"In che stato e l'ordine MAN-042?"
Esempio 2	"Chi ha assegnata l'attivita VEN-015?"
Esempio 3	"Dammi i dettagli dell'ordine di lavoro 003."
Richiede	Codice dell'attivita (es. `MAN-042`) o il suo ID.
Restituisce	Tutti i dettagli dell'attivita: titolo, descrizione, stato, priorita, tecnico assegnato, date di creazione e aggiornamento, codice attivita.

Autenticazione e Accesso

`authenticate_conversation`

Verifica l'identita dell'utente cercando i suoi dati in un database configurato. Consente di limitare l'accesso a determinati dati o azioni in base al ruolo dell'utente autenticato.


Quando usarlo	Quando l'agente deve confermare l'identita dell'utente prima di mostrare informazioni sensibili o eseguire azioni protette.
Esempio 1	"Solo il personale autorizzato puo visualizzare questo rapporto. Fornisci il tuo numero di matricola."
Esempio 2	"Per continuare, devo verificare la tua identita. Qual e il tuo codice di accesso?"
Richiede	Il valore di identificazione che l'utente fornisce nella conversazione (es. numero di matricola, codice fiscale, chiave). Il campo di ricerca e la raccolta dati sono configurati nell'agente.
Restituisce	Stato della sessione: `authenticated` se il record e stato trovato, o `pending` se e richiesta una verifica OTP aggiuntiva. I ruoli assegnati all'utente diventano disponibili per l'agente.

`send_verification_otp`

Genera e invia un codice di verifica a 6 cifre (OTP) al telefono o all'email dell'utente per confermarne l'identita in un processo a due fattori. Il codice scade in 5 minuti e consente un massimo di 3 tentativi.


Quando usarlo	Dopo `authenticate_conversation` quando e richiesta una conferma aggiuntiva a due fattori.
Esempio 1	"Ti ho inviato un codice di verifica al numero registrato. Inseriscilo per continuare."
Esempio 2	"Per confermare la tua identita, abbiamo inviato un codice all'email registrata."
Richiede	L'autenticazione precedente deve essere in stato `pending`. Il canale di consegna (WhatsApp o email) e configurato nell'agente.
Restituisce	Conferma di invio, canale utilizzato (whatsapp/email), destinazione mascherata per la privacy (es. `***5678`) e tempo di scadenza.

`verify_otp`

Verifica il codice OTP inserito dall'utente. Se corretto, completa l'autenticazione e concede l'accesso per 24 ore.


Quando usarlo	Quando l'utente inserisce il codice OTP ricevuto via WhatsApp o email.
Esempio 1	"Il mio codice e 482931."
Esempio 2	"Il codice che ho ricevuto e 771204."
Richiede	Il codice a 6 cifre fornito dall'utente nella conversazione.
Restituisce	Stato `authenticated` se il codice e corretto, insieme ai ruoli dell'utente. Se il codice non e corretto, informa quanti tentativi rimangono.

Rapporti

`generate_report`

Genera un rapporto in formato PDF con branding aziendale (logo, colori, intestazione e pie di pagina). Il rapporto viene archiviato nel cloud e l'agente puo inviarlo via WhatsApp o email immediatamente dopo la generazione.


Quando usarlo	Quando l'utente richiede un rapporto, riepilogo o documento da condividere con il proprio team.
Esempio 1	"Genera il rapporto di manutenzione settimanale e mandamelo su WhatsApp."
Esempio 2	"Ho bisogno di un PDF con il riepilogo degli allarmi del turno."
Esempio 3	"Prepara un rapporto sugli asset critici e invialo al supervisore."
Richiede	Titolo del rapporto e il contenuto che l'agente raccoglie durante la conversazione (puo combinare dati da altri strumenti). Il branding e configurato nell'agente.
Restituisce	ID del rapporto generato, URL firmato per il download del PDF e numero di pagine. L'agente puo usare quell'ID direttamente per allegare il PDF in un'email o inviarlo via WhatsApp.

Ricerca Web

`web_search`

Cerca informazioni su internet usando il motore di ricerca configurato. Supporta ricerche web generali e ricerche di notizie. Puo filtrare i risultati per dominio specifico se configurato dall'amministratore.


Quando usarlo	Quando l'utente chiede informazioni non presenti nei dati interni dell'impianto: notizie del settore, specifiche tecniche delle apparecchiature, normative, prezzi degli insumo.
Esempio 1	"Quali sono gli ultimi standard ISO per la manutenzione industriale?"
Esempio 2	"Trova il manuale tecnico del motore Siemens 1LA7."
Esempio 3	"Cosa sta succedendo con il prezzo dell'acciaio questa settimana?"
Richiede	Il testo di ricerca fornito dall'utente. Il numero massimo di risultati e i domini consentiti sono configurati nell'agente.
Restituisce	Lista di risultati con titolo, link e riepilogo di ogni pagina trovata. Include anche suggerimenti di ricerca alternativi se i risultati sono limitati.

Messaggistica WhatsApp

Questi strumenti sono disponibili automaticamente in tutti gli agenti del canale WhatsApp.

`send_whatsapp_message`

Invia un messaggio di testo a un numero WhatsApp. Disponibile negli agenti WhatsApp e Email.


Quando usarlo	Quando l'agente deve inviare una notifica, un riepilogo o una conferma a un numero specifico.
Esempio 1	"Avvisa Roberto al 3401234567 che la pompa B-201 necessita di ispezione urgente."
Esempio 2	"Manda un messaggio al supervisore con il riepilogo del turno."
Richiede	Numero di telefono di destinazione (con prefisso internazionale) e il testo del messaggio. Il numero WhatsApp dell'agente e configurato nello strumento.
Restituisce	Conferma di invio con il numero di destinazione e anteprima del messaggio.

`send_file` (WhatsApp)

Invia un file (PDF, immagine) all'utente WhatsApp corrente. Viene tipicamente usato dopo aver generato un rapporto con generate_report.


Quando usarlo	Quando l'utente chiede di ricevere un documento o un'immagine durante la conversazione WhatsApp.
Esempio 1	"Mandami il rapporto in PDF."
Esempio 2	"Inviami l'immagine dello schema."
Richiede	URL firmato del file (ottenuto da `generate_report` o un altro strumento) e nome del file.
Restituisce	Conferma che il file e stato inviato all'utente corrente della conversazione.

`send_message_to`

Invia un messaggio WhatsApp a un numero diverso da quello dell'utente corrente della conversazione. Utile per notificare terze parti (supervisore, tecnico, area di supporto).


Quando usarlo	Quando l'agente deve comunicare qualcosa a una persona diversa dall'interlocutore corrente.
Esempio 1	"Avvisa il capo turno che c'e un allarme attivo sulla linea 3."
Esempio 2	"Inoltra questo messaggio al reparto acquisti."
Richiede	Numero di telefono di destinazione (con prefisso internazionale) e il testo del messaggio. Disponibile solo nelle conversazioni WhatsApp.
Restituisce	Conferma di invio al numero indicato.

`send_contact`

Invia una scheda contatto all'utente WhatsApp corrente. Utile quando l'agente individua un tecnico con locate_nearest_personnel e vuole condividerne i dati di contatto.


Quando usarlo	Quando l'utente chiede le informazioni di contatto di una persona trovata nel sistema.
Esempio 1	"Condividi con me il contatto del tecnico disponibile."
Esempio 2	"Mandami i dati del supervisore di turno."
Richiede	Nome completo e numero di telefono del contatto (con prefisso internazionale). Disponibile solo nelle conversazioni WhatsApp.
Restituisce	Conferma che la scheda contatto e stata inviata all'utente.

`send_location`

Invia un pin di posizione GPS all'utente WhatsApp corrente.


Quando usarlo	Quando l'agente deve indicare la posizione di un asset, un impianto o un punto di incontro.
Esempio 1	"Dove si trova la sala compressori?"
Esempio 2	"Mandami la posizione della sottostazione elettrica nord."
Richiede	Coordinate di latitudine e longitudine. Nome e indirizzo sono opzionali. Disponibile solo nelle conversazioni WhatsApp.
Restituisce	Conferma che il pin di posizione e stato inviato all'utente.

Messaggistica Email

Questi strumenti sono disponibili automaticamente in tutti gli agenti del canale email.

`send_email`

Invia un'email da un account di posta registrato sulla piattaforma. Puo allegare automaticamente un rapporto PDF se ne e stato generato uno in precedenza.


Quando usarlo	Quando l'utente richiede l'invio di un'email dall'agente email, o l'agente deve inviare una notifica formale via email.
Esempio 1	"Manda il rapporto settimanale al responsabile dell'impianto."
Esempio 2	"Invia un'email a acquisti@azienda.com con il riepilogo delle richieste."
Esempio 3	"Manda il PDF dell'analisi dei guasti al team di ingegneria."
Richiede	Indirizzo di destinazione, oggetto e corpo dell'email. Se e stato generato un rapporto, l'agente puo allegarlo automaticamente con l'ID del rapporto. L'account email mittente e configurato nell'agente.
Restituisce	Conferma di invio con mittente, destinatario, oggetto e indicatore se e stato allegato un file.

`attach_file` (Email)

Allega un file all'email di risposta che l'agente sta componendo. Il file rimane in attesa e viene incluso quando l'agente invia la risposta all'utente corrente della conversazione.


Quando usarlo	Quando l'utente chiede di allegare un documento all'email di risposta che sta per essere inviata.
Esempio 1	"Allega il rapporto all'email di risposta."
Esempio 2	"Includi il PDF nella tua risposta."
Richiede	URL firmato del file (ottenuto da `generate_report` o un altro strumento) e nome del file. Disponibile solo nelle conversazioni email. Limite: 5 file e 10 MB per file.
Restituisce	Conferma che il file e in attesa di essere allegato alla risposta corrente.

`send_email_to`

Invia un'email a un destinatario diverso dal mittente originale della conversazione. Utile per notificare terze parti o inoltrare informazioni a un altro reparto.


Quando usarlo	Quando l'agente deve notificare qualcuno diverso dal partecipante corrente della conversazione.
Esempio 1	"Avvisa il responsabile della manutenzione di questo allarme."
Esempio 2	"Inoltra il riepilogo all'area sicurezza industriale."
Richiede	Indirizzo email di destinazione, oggetto e corpo del messaggio. Puo includere opzionalmente un ID rapporto per allegarlo. Disponibile solo nelle conversazioni email.
Restituisce	Conferma di invio con il destinatario e l'oggetto.

Note d'uso degli strumenti di azione

Gli strumenti di azione che modificano i dati (crea attivita, aggiorna attivita) registrano il creatore come ai_assistant per la tracciabilita.
Le notifiche di assign_task vengono inviate automaticamente alla creazione dell'attivita — l'agente non ha bisogno di invocare strumenti di messaggistica aggiuntivi per questo.
Gli strumenti WhatsApp (send_file, send_message_to, send_contact, send_location) funzionano solo nelle conversazioni WhatsApp.
Gli strumenti email (attach_file, send_email_to) funzionano solo nelle conversazioni email.
Il flusso tipico per un rapporto e: generate_report → ottenere report_id → send_file (WhatsApp) o send_email con il report_id.
Il flusso tipico per un'assegnazione di emergenza e: locate_nearest_personnel → scegliere tecnico → assign_task → notifica automatica.

Benefici chiave

Conversazione → azione senza uscire dalla chat: l'agente esegue e risponde.
Tracciabilità registrata (ai_assistant come creatore) per audit.
Notifiche lanciate server-side, indipendentemente da se l'IA invoca strumenti di messaggistica aggiuntivi.
Flussi tipici concatenati (es: locate → assign → notify) riducono frizione operativa.
Ogni nuovo strumento diventa disponibile a tutti gli agenti del tenant automaticamente.

Strumenti di Consulta Integrati

In questa pagina