Azioni interne

Strumenti che eseguono funzioni di sistema — report, attivita, messaggi e localizzazione del personale.

Come funziona

Uno strumento di azione interna esegue una funzione predefinita del backend durante una conversazione. Questo permette all'agente di effettuare operazioni di sistema senza intervento manuale — dalla generazione di un PDF all'invio di un messaggio WhatsApp.

Azioni disponibili

Azione	Descrizione	Parametri principali
generate_report	Genera un report PDF con blocchi di contenuto strutturato e branding aziendale	titolo, blocchi di contenuto, collezione (opzionale)
assign_task	Crea un'attivita e la assegna a un membro del team. Invia notifiche via email e/o WhatsApp	titolo, descrizione, assegnatario, dipartimento, priorita
send_whatsapp_message	Invia un messaggio WhatsApp a un contatto	numero di telefono, messaggio
send_file	Invia un file (PDF, immagine) tramite WhatsApp	numero, file
send_email	Invia un'email tramite Postmark. Puo includere PDF allegati	destinatario, oggetto, corpo
locate_nearest_personnel	Localizza il personale piu vicino a una posizione per prossimita geografica (citta, stato, paese)	citta, stato, paese, dipartimento (opzionale)

Puoi visualizzare l'elenco completo quando crei uno strumento di tipo Azione interna nel selettore delle azioni.

Configurazione

Campo	Descrizione
Nome dell'azione	Funzione interna da eseguire (seleziona dall'elenco)
Valori predefiniti	Parametri predefiniti che vengono inviati automaticamente senza che l'agente li richieda

Valori predefiniti

I valori predefiniti permettono di fissare parametri che vengono sempre inviati all'azione. Questo e utile per:

Configurare il branding aziendale in generate_report (logo, nome dell'azienda, pie di pagina).
Fissare il dipartimento in assign_task quando l'agente assegna sempre allo stesso team.
Preconfigurare l'account email in send_email.

I parametri che l'agente ottiene dall'utente durante la conversazione hanno la priorita sui valori predefiniti.

Esempio: Generare report

Scenario: Un agente che genera report di inventario quando il cliente lo richiede.

Crea uno strumento con azione generate_report.

Nei valori predefiniti, configura il tuo branding:

{
  "company_name": "Acme Corp",
  "logo_url": "https://acme.com/logo.png",
  "header_lines": ["Divisione Industriale", "Tel: +39 02 1234567"],
  "footer_text": "Documento riservato"
}

Aggiungi parametri affinche l'agente chieda: titolo del report e tipo di dati.
Assegna lo strumento all'agente.

Quando un utente dice "genera un report delle apparecchiature in magazzino", l'agente:

Raccoglie le informazioni necessarie dall'utente.
Esegue l'azione generate_report con il branding preconfigurato.
Il PDF viene generato con intestazione aziendale, tabelle di dati e pie di pagina.
Restituisce il report all'utente (URL di download o allegato).

Esempio: Assegnare attivita con notifica

Scenario: Un agente di supporto che crea attivita di manutenzione e notifica il tecnico assegnato.

Crea uno strumento con azione assign_task.

Nei valori predefiniti, configura:

{
  "department_id": "ID_DEL_DIPARTIMENTO",
  "notify_email": true,
  "notify_whatsapp": true,
  "priority": "medium"
}

Aggiungi parametri: titolo, descrizione, nome del tecnico.
Assegna lo strumento all'agente.

Quando l'agente crea l'attivita:

Viene generato un codice automatico (es: MAN-042).
Viene inviata un'email al tecnico con i dettagli.
Viene inviato un messaggio WhatsApp al tecnico.
L'attivita appare nella bacheca Kanban della dashboard.

Esempio: Localizzare il personale piu vicino

Scenario: Un agente che deve trovare il tecnico piu vicino alla posizione del cliente.

Crea uno strumento con azione locate_nearest_personnel.
Aggiungi parametri: citta, stato/provincia (opzionali).
L'agente chiedera la posizione all'utente.

La localizzazione funziona per prossimita geografica:

Priorita 1: Personale nella stessa citta.
Priorita 2: Personale nello stesso stato/provincia.
Priorita 3: Personale nello stesso paese.