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?"* ```markdown 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 --- [...] ``` # 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-08-alle-17-05-12.png) Figura 1Al 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...*
# 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-08-alle-17-38-59.png) # 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-25-36.png)[](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-22-05.png) Il processo parte alla creazione di un'azienda ed esegue l'azione **Chiama agente.** [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-17-52.png) In **User message** chiedo di cercare online le informazioni e valorizzarle nell'azienda. Inoltre chiedo di creare un contatto per l'amministratore delegato. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-36-03.png) 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/Etzimage.png) Dal tab Storico si avrà evidenza dei campi aggiornati: [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-40-30.png) --- ### 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-58-16.png)[](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-09-58-34.png) Nel secondo step del processo eseguiamo una chiamata LLM per rielaborare il testo del commento applicando un certo stile. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-01-12.png)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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-10-01.png) 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-20-13.png) #### 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à. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-26-02.png) Nella task **AI:check orario** eseguo una chiamata all'agente con il seguente prompt: ```markdown 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: [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-33-34.png) 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**. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-34-24.png) 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. [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-37-33.png) [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-39-23.png)Il commento qui indicato sarà poi rielaborato dal modello LLM nel processo tool.
prompt per agente: ```markdown 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: [](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/screenshot-2026-07-09-alle-10-47-48.png)