3.A Azioni AI
Queste azioni permettono di integrare i nuovi Strumenti AI all'interno dei processi e quindi automatizzarne l'utilizzo.
3.A.1 Chiama LLM
Permette di eseguire una richiesta ad un LLM precedentemente configurato in Impostazioni > Strumenti AI > LLM.
Una volta selezionato uno tra i modelli LLM disponibili verranno caricati tutti gli elementi configurati in Impostazioni > Strumenti AI > LLM e potranno essere personalizzati.
Figura 1
In aggiunta, è possibile definire ulteriori Headers, Parametri e Campi restituiti potendo passare quindi valori dinamici presi dai record coinvolti all'interno del processo.
Di default è già configurato il campo con il contenuto della risposta del modello (Figura 2) che potrà essere richiamato per applicarlo nelle successive fasi del processo (Figura 3).
Figura 2
Figura 3
3.A.2 Chiama tool MCP
Permette di eseguire una richiesta al tool di un server MCP precedentemente configurato in Impostazioni > Strumenti AI > MCP Client.
Questa azione permette di ottenere la risposta ad un tool MCP in maniera deterministica diversamente da quello che potrebbe fare un agente.
L'utente potrebbe quindi implementare un proprio "agente" all'interno di un processo facendo interagire chiamate a LLM e a tool MCP.
Una volta selezionato uno tra i client MCP disponibili e il tool desiderato verranno caricati i Parametri di input previsti dal tool e i Campi restituiti che potranno essere modificati in base alla risposta del tool.
Figura 1 - esempio di chiamata ad un tool di ricerca web
Normalmente i tool restituiscono il risultato in un formato adatto ad essere interpretato da un modello LLM quindi va verificata la risposta per includerla nel flusso di un processo.
es. di risposta del tool web_search_exa alla domanda "qual'è l'indirizzo email PEC dell'azienda VTENEXT?"
Title: Contatti - vtenext CRM + BPM
URL: https://www.vtenext.com/it/contatti/
Published: 2021-01-28T21:00:22.000Z
Author: N/A
Highlights:
info@vtenext.com Viale Sarca, 336/F 20126 Milano (MI) Tel (+39) 02 3790 1352 P.I. 09869110966 Registration Number MI – 2118732
---
Title: Fatturato Vtenext Srl (MI) – Scarica Bilanci e Visure Camerali Ufficiali
URL: https://www.companyreports.it/vtenext-srl-09869110966
Published: N/A
Author: N/A
Highlights:
**Indirizzo**
Viale Sarca, 336/F - [Milano (](https://www.companyreports.it/comune/milano "Vedi le aziende del comune di Milano")[MI](https://www.companyreports.it/provincia/milano "Vedi le aziende della provincia di Milano"))
...
**
**
...
## **Visura Camerale di Vtenext Srl**
La visura camerale di **Vtenext Srl** fornisce una panoramica completa dell’assetto legale e societario dell’impresa: sede legale, capitale sociale, oggetto sociale, elenco soci, cariche in corso e indirizzo PEC. La visura è disponibile in formato ordinario o storico ed è scaricabile in tempo reale da **CompanyReports.it**.
### **Bilanci e Documenti Aziendali di Vtenext Srl**
...
PEC
*
...
* Email PEC
* Codice di fatturazione
...
```json
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "CompanyReports",
"url": "https://www.companyreports.it",
"logo": "https://www.companyreports.it/dist/img/companyreports-logo-new.webp",
"contactPoint": {
"@type": "ContactPoint",
"contactType": "sales",
"email": "info@adcapital.it"
}
}
...
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Vtenext Srl",
"legalName": "Vtenext Srl",
"image": "https://www.companyreports.it/og-image-Fatturato%20Vtenext%20Srl%20%28MI%29%20%E2%80%93%20Scarica%20Bilanci%20e%20Visure%20Camerali%20Ufficiali.jpg",
"vatID": "09869110966",
"taxID": "09869110966",
"foundingLocation": "MI",
"foundingDate": "2017-04-04",
"isicV4": "6201",
"knowsAbout": "Produzione di software non connesso all'edizione",
"address": {
"@type": "PostalAddress",
"postalCode": "",
"addressLocality": "Milano, Italy",
"addressCountry": "IT",
"addressRegion": "MI",
"streetAddress": "Viale Sarca, 336/F"
},
"keywords": "Vtenext Srl fatturato, utile Vtenext Srl, perdita Vtenext Srl, risultato Vtenext Srl , andamento Vtenext Srl, partita iva Vtenext Srl , bilancio Vtenext Srl , visura Vtenext Srl, 09869110966, Partita Iva 09869110966, Codice Fiscale 09869110966, DUNS Vtenext Srl, D-U-N-S Vtenext Srl, Report Aziende per fatturato"
---
Title: VTENEXT S.R.L. SOCIETA' BENEFIT 03641400233 - Visurissima.it - Le informazioni a portata di click
URL: https://www.visurissima.it/aziende/VTENEXT-SRL-SOCIETA-BENEFIT_03641400233.html
Published: N/A
Author: N/A
Highlights:
Indirizzo completo
...
VIA ALZANA 2/C, 37040 ARCOLE (VR)
...
crmvillage@pec.it
...
Scopri Email Scopri
---
[...]3.A.3 Chiama agente
Permette di eseguire una richiesta ad un agente precedentemente configurato in Impostazioni > Strumenti AI > Agenti.
Una volta selezionato uno tra gli agenti disponibili verranno caricati tutti gli elementi configurati in Impostazioni > Strumenti AI > Agenti e potranno essere personalizzati.
L'agente è in grado di svolgere task in modo automatico in base ai tool attivati e alla conoscenza a cui ha accesso tramite RAG e LLM.
E' possibile modificare il System prompt mentre le istruzioni operative vanno indicate nel campo User message.
Nei Campi restituiti è già configurato di default il contenuto della risposta per poter essere utilizzata nelle fasi successive del processo.
Di seguito un esempio in cui si richiede all'agente di cercare la soluzione ad una richiesta pervenuta via ticket di Assistenza Clienti tramite il tool user_manual e di scriverla in un commento.
Figura 1
Al prompt scritto dall'utente vengono aggiunte altre informazioni per indicare il contesto della richiesta come ad esempio quali sono le entità coinvolte nel processo con nome, modulo, crmid. Ecco perchè l'agente è in grado di capire a quale entità del crm si sta facendo riferimento.
Eventualmente è possibile utilizzare le variabili di processo per rendere ancora più chiara la richiesta:
es. aggiungi un commento al ticket $15-crmid proponendo una soluzione...
3.A.4 Chiama processo tool
Permette di eseguire un processo tool.
Una volta selezionato il tool desiderato verranno caricati i Parametri di input previsti che potranno essere configurati utilizzando come di consueto le variabili di processo.
Questa azione non presenta i limiti dei sotto-processi e può essere richiamata più volte nello stesso processo e anche da più processi diversi.
Di seguito un esempio di chiamata ad un tool per l'aggiunta di un commento ad un ticket. I parametri son quelli definiti nel processo tool che in questo caso sono l'id del ticket e il testo.
3.A.5 Esempi
Di seguito alcune applicazioni di esempio su come questi nuovi strumenti possono essere integrati nei processi.
Web scraping
Questo è un processo che alla creazione di un'azienda esegue una chiamata ad un agente richiedendo di cercare online delle informazioni sull'azienda e valorizzandole nell'anagrafica.
L'agente dovrà aver attivato un tool per la ricerca web (es. web_search_exa) e i tool del client MCP di VTENEXT per poter accedere alla struttura dei moduli e aggiornare il record.
Il processo parte alla creazione di un'azienda ed esegue l'azione Chiama agente.
In User message chiedo di cercare online le informazioni e valorizzarle nell'azienda. Inoltre chiedo di creare un contatto per l'amministratore delegato.
Se nell'azione di processo hai impostato la modalità di esecuzione Backgroud dopo il salvataggio il sistema notificherà che il record è ancora in aggiornamento e una volta terminato la pagina del browser si aggiornerà automaticamente.
Dal tab Storico si avrà evidenza dei campi aggiornati:
Assistenza clienti chiusa
In questo caso implementiamo un processo che negli orari in cui gli uffici sono chiusi risponde automaticamente ai ticket di assistenza tecnica informando il cliente della chiusura e tentando di fornire una soluzione al problema.
Tool add_comment
Per prima cosa realizziamo un processo tool per aggiungere un commento ad un ticket che prevede in input i parametri id ticket e il commento.
Nel secondo step del processo eseguiamo una chiamata LLM per rielaborare il testo del commento applicando un certo stile.
In questo caso basta utilizzare solamente un LLM anziché un agente in quanto non è necessario utilizzare tool ma solamente sfruttare la capacità linguistica del modello.
Infine utilizziamo la funzione SDK Add comment mappando tutti i campi richiesti. In questo caso indico nel parametro ownerid l'id dell'utente Kitt e con ai impostato a true forzo l'aggiunta di una nota informatica in calce al commento che indica che il testo è stato generato tramite AI.
Il tool add_comment va quindi attivato nell'agente che utilizzeremo nei prossimi step, assieme al tool user_manual e/o eventuali documenti nella sezione RAG per la conoscenza necessaria a fornire una soluzione.
Implementazione processo su ticket
Possiamo quindi implementare un nuovo processo oppure integrare le nuove logiche AI in uno già esistente. In questo caso sfrutto un processo già esistente che alla creazione di un ticket imposta lo SLA in base alla priorità.
Nella task AI:check orario eseguo una chiamata all'agente con il seguente prompt:
L'azienda è aperta dal lunedì al venerdì dalle ore 09:00 alle 13:00 e dalle 14:00 alle 18:00 i soli giorni feriali.
Se il ticket è stato creato in orario di apertura restituisci la stringa "open" altrimenti "closed".
Restituisci esattamente quella stringa senza aggiungere altro testo o titoli.e predispongo la form dinamica con un campo popolato con la risposta:
Configuro la condizione sul campo della form dinamica e il gateway successivo in modo che se l'agente ritorna closed il processo vada nella task AI: risp automatica.
Nell'ultima task del processo eseguo prima la chiamata al tool add_comment per informare il cliente della chiusura ed infine la chiamata all'agente per proporre la soluzione.
Il commento qui indicato sarà poi rielaborato dal modello LLM nel processo tool.
prompt per agente:
aggiungi un commento con il tool add_comment proponendo una soluzione al suo problema cercando in user_manual.
Nel testo non usare mai titoli o codice markdown, restituisci solo testo semplice.Test
Testiamo il processo creando un ticket in orario di chiusura con Titolo login fallito e Descrizione "buongiorno stamattina non riesco più a fare il login a vte, potete controllare urgentemente?"
Verranno aggiunti dei commenti simili a questi:
