# Processi

##### Azione cicla record  


Nuova funzione "Cicla record" consente di ciclare su tutti i record di un determinato modulo. E' possibile definire criteri di filtro e di ordinamento, così da limitare l'operazione ai soli record di interesse ed elaborarli nell'ordine desiderato.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/Iy9image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/Iy9image.png)

##### Modalità di esecuzione

Per tutte le azioni del processo, è possibile specificare la Modalità di Esecuzione:  
\- Standard: il processo di esecuzione attende che l’azione venga completata prima di procedere con quella successiva.  
\- Background: il processo si interrompe e l’azione viene eseguita in background tramite worker o cron.

##### Nuove opzioni nelle condizioni  


Sono state aggiunte le opzioni "in" e "not in" nelle condizioni sui campi picklist per verificare più valori contemporaneamente.  
Nell'opzione "è cambiato in" è stata aggiunta la voce "Valore qualsiasi" per verificare se un campo picklist è stato modificato assumendo un qualsiasi valore.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/yZZimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/yZZimage.png)

##### Nuovo pannello per i log del grafico del processo  


Migliorata l’interfaccia utente del grafico del processo nella visualizzazione del dettaglio del record.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/wQZimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/wQZimage.png)

##### Processi di tipo Tool

È possibile creare nuovi processi di tipo Tool che possono essere richiamati più volte all’interno dello stesso processo oppure da processi differenti, comportandosi come delle vere e proprie funzioni.

Possono inoltre essere pubblicati come strumenti (Tool) su un server MCP.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/UV1image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/UV1image.png)

---

### Worker  


Il worker è il nuovo servizio che consente di eseguire immediatamente operazioni in background (senza bloccare l’interfaccia utente) e senza dover demandare l’operazione a un cron job, evitando quindi di dover attendere il tempo minimo di 1 minuto.  
Il worker riceve una richiesta di esecuzione tramite PHP e successivamente invia la risposta direttamente al browser tramite eventi SSE (Server-Sent Events).  
Attualmente è stato implementato per eseguire le seguenti operazioni:

- notifiche (ModNotifications);
- azioni dei processi con modalità di esecuzione Background;
- tutte le richieste relative ai nuovi AI Tools.

Documentazione tecnica è disponibile [qui](https://usermanual.vtenext.com/books/developers/page/worker).

---

### Documentazione OpenAPI  


Le API REST sono ora compatibili con il formato OpenAPI 3.0.

È stato inoltre aggiunto un pulsante nella sezione Impostazioni &gt; REST Webservices che permette di visualizzare la documentazione Swagger e testare direttamente le API all’interno del CRM, con la possibilità di scegliere l’utente con cui eseguire le chiamate.  
  
Documentazione tecnica disponibile [qu](https://usermanual.vtenext.com/books/developers/page/rest-webservice-methods)i.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/JZ5image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/JZ5image.png)

---

### Strumenti AI  


##### LLM

E' possibile configurare un modello LLM in accordo con il formato [OpenAI.](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/WtTimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/WtTimage.png)

##### MCP Server  


È possibile configurare i server MCP esposti da VTENEXT.  
Per ciascun server è possibile selezionare quali tool pubblicare, scegliendo tra:

- API REST;
- tool personalizzati (Custom Tools);
- Processi.

Documentazione tecnica disponibile [qui](https://usermanual.vtenext.com/books/developers/page/mcp-server).

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/Bj5image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/Bj5image.png)

##### MCP Client

È possibile configurare i server MCP di cui si desidera utilizzare i tool.  
Sono supportati esclusivamente i server esposti tramite HTTP.  
Di default sono disponibili:

- un server VTENEXT MCP;
- un server [Exa](https://exa.ai/) MCP per effettuare ricerche sul web.[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/gsSimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/gsSimage.png)

##### Agent  


È possibile configurare gli agenti AI da utilizzare all’interno del proprio assistente e nei processi.  
Un agente può utilizzare:

- LLM;
- tool MCP;
- RAG;

per completare automaticamente le attività assegnate.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/P6Dimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/P6Dimage.png)

##### Assistant  


Il nuovo assistente si chiama Kitt, ma è possibile modificarne il nome e la foto dalle preferenze utente.

L’assistente può interrogare:

- un LLM;
- un Agent;
- un Webservice REST personalizzato.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/eouimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/eouimage.png)

È possibile porre domande all’assistente tramite conversazioni oppure utilizzando il nuovo pannello laterale.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/srTimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/srTimage.png)

È inoltre possibile utilizzare azioni rapide preconfigurate per:

- riepilogare;
- elaborare testi;
- tradurre.

Queste azioni rapide possono inoltre essere pubblicate come tool MCP.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/JODimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/JODimage.png)

##### Agent Logs

È stata aggiunta una voce in Impostazioni &gt; Log di sistema per gestire i log degli agenti.

---

### Azioni AI in ProcessMaker

È possibile configurare le azioni dei processi ed eseguire:

##### Chiama LLM

Effettuare una richiesta a un LLM e utilizzare la risposta all'interno del processo.

##### Chiama MCP tool

Eseguire un tool MCP.

##### Chiama Agente  


Effettuare una richiesta a un Agent per completare automaticamente le attività e utilizzare la risposta all’interno del processo.

##### Chiama Process Tool  


Eseguire un Processo di tipo Tool.

---

### Ulteriori miglioramenti  


##### Scadenza nelle Access Key

Nelle Preferenze Utente &gt; Webservices &gt; Configurazione API REST è possibile specificare una data di scadenza per le nuove Access Key. Una volta raggiunta la data di scadenza, l'Access Key verrà eliminata automaticamente.

##### L'elenco dei modelli e-mail (Email Template) nelle newsletter è ora ricercabile.  


Aggiunta la ricerca nella griglia dei modelli e-mail (Email Template) all'interno delle newsletter.

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/s7nimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/s7nimage.png)

---

##### Migliorata la gestione dei report schedulati  


Nella configurazione dei report schedulati sono state aggiunte due nuove opzioni:

1. Escludi giorni festivi/weekend: consente di non inviare il report nei giorni festivi o nei fine settimana. I giorni festivi vengono determinati in base al campo "Holiday Countries" presente nel profilo dell'utente Amministratore.
2. Escludi report vuoti: consente di evitare l'invio del report quando non sono presenti dati che soddisfano i criteri di estrazione.
    
    [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/dFYimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/dFYimage.png)

##### Modifica titolo Widget

Possibilità di modificare il titolo dei widget della home page

[![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/scaled-1680-/inEimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2026-07/inEimage.png)