> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/it/knowledge-base/how-to-articles/set-up-an-ai-assistant.md).

# Configurare un assistente IA

Configuri un assistente AI in Remote Desktop Manager collegando un provider come OpenAI, Gemini o Claude e un server MCP opzionale.

Remote Desktop Manager supporta l'integrazione AI con Azure OpenAI, OpenAI, Ollama, Gemini, Mistral AI, Claude (Anthropic) e Azure AI Inference. Il provider ***Personalizzato*** si collega inoltre a qualsiasi servizio compatibile con l'API OpenAI, Claude o Ollama. È possibile sfruttarle tramite una voce di sessione ***Assistente AI*** o il pannello ***Assistente AI***.

{% hint style="info" %}
I dati vengono elaborati esclusivamente attraverso queste integrazioni AI fornite dal cliente.
{% endhint %}

Per collegare il provider AI preferito a Remote Desktop Manager tramite una voce di sessione, segua i passaggi seguenti:

1. Faccia clic su ***Modifica*** – ***Aggiungi voce***, quindi individui la voce ***Assistente AI*** in ***Sessione*** – ***Altro***. Faccia clic su ***Seleziona***.
2. Inserisca un ***Nome*** per la nuova voce, scelga un ***Provider*** e selezioni un ***Modello***. A seconda del provider, inserisca anche una ***Chiave API***, un ***Endpoint*** o entrambi. Faccia clic su ***Salva***.

Per utilizzare l'assistente AI come pannello laterale separato, vada in ***File*** – ***Impostazioni*** – ***Assistente AI***, inserisca le informazioni del suo provider e faccia clic su ***Salva***. Quindi, faccia clic su ***Finestra*** – ***Assistente AI***, nel gruppo ***Comunicazione***.

### Configurare un provider personalizzato

Utilizzi il provider ***Personalizzato*** per collegarsi a un servizio che non è nell'elenco dei provider, ma che espone un'API compatibile con OpenAI, Claude o Ollama, come un server self-hosted (llama.cpp, ad esempio), un gateway di IA o un proxy approvato dalla sua organizzazione. Quando il servizio è uno dei provider indicati, selezioni invece quel provider.

1. Nell'elenco ***Provider*** (in ***File*** – ***Impostazioni*** – ***Assistente AI*** o in una voce ***Assistente AI***), selezioni ***Personalizzato***, quindi faccia clic su ***Configura***.
2. Compili le impostazioni descritte di seguito, quindi faccia clic su ***Salva***.
3. Faccia clic sul pulsante ***Aggiorna*** accanto all'elenco ***Modello***, quindi selezioni un modello.

<table><thead><tr><th width="220">IMPOSTAZIONI</th><th>DESCRIZIONE</th></tr></thead><tbody><tr><td><strong>Provider</strong></td><td>L'API con cui il servizio è compatibile: <em><strong>OpenAI</strong></em>, <em><strong>Claude</strong></em> o <em><strong>Ollama</strong></em>.</td></tr><tr><td><strong>URL di base</strong></td><td>L'indirizzo del servizio, che inizia con <code>http://</code> o <code>https://</code>. Remote Desktop Manager aggiunge i percorsi API a questo indirizzo, quindi includa il segmento di versione previsto dal servizio. Per un servizio compatibile con OpenAI, l'indirizzo di solito termina con <code>/v1</code> (ad esempio, <code>http://localhost:8080/v1</code>).<br><br>Faccia clic su <em><strong>Convalida</strong></em> per inviare una richiesta all'<em><strong>URL di base</strong></em> con le intestazioni configurate e confermare che il servizio è raggiungibile.</td></tr><tr><td><strong>Modalità API</strong></td><td><p>Visualizzato quando <em><strong>Provider</strong></em> è <em><strong>OpenAI</strong></em>. Scelga l'API OpenAI usata per inviare le richieste:</p><ul><li><strong>Chat completions</strong>: Funziona con backend self-hosted che non conservano lo stato della conversazione sul server. Usi questa modalità per tali backend.</li><li><strong>Responses API</strong>: Richiede un backend che conservi lo stato della conversazione sul server. Con un backend che non lo fa, il primo messaggio di una conversazione riesce e il secondo non riesce.</li></ul></td></tr><tr><td><strong>Intestazione</strong></td><td>Intestazioni HTTP inviate con ogni richiesta, inclusa l'individuazione dei modelli. Faccia clic su <em><strong>Aggiungi</strong></em> per aggiungere un'intestazione, quindi compili <em><strong>Nome</strong></em> e <em><strong>Valore</strong></em> in campi separati. Il provider <em><strong>Personalizzato</strong></em> non ha un campo <em><strong>Chiave API</strong></em>, quindi usi un'intestazione per autenticarsi.<br><br>Ad esempio, inserisca <code>Authorization</code> in <em><strong>Nome</strong></em> e <code>Bearer &#x3C;token></code> in <em><strong>Valore</strong></em>. L'inserimento dell'intestazione completa (<code>Authorization: Bearer &#x3C;token></code>) in <em><strong>Nome</strong></em> non riesce con il messaggio <em>Property Header has an invalid value</em>.</td></tr></tbody></table>

{% hint style="info" %}
Quando il ***Provider*** è ***OpenAI***, l'elenco dei modelli proviene da una richiesta `GET` a `<Base URL>/models`. Con un ***URL di base*** che termina con `/v1`, questo è l'endpoint standard `/v1/models`. Quando il ***Provider*** è ***Ollama***, l'elenco mostra i modelli installati sul server Ollama.
{% endhint %}

### Collegare un assistente AI a un server MCP locale

1. Per prima cosa, configuri un [server MCP locale](/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server.md).
2. Apra la scheda ***Server MCP*** (in ***File*** – ***Impostazioni*** – ***Assistente AI*** o in una voce ***Assistente AI***), quindi faccia clic su ***Aggiungi***. La scheda viene mostrata dopo che è stato selezionato un ***Provider***.
3. Inserisca un ***Nome*** per il server MCP e selezioni il suo ***Trasporto***. Per ***HTTP***, inserisca l'***URL del server***. Per ***Stdio***, inserisca il ***Comando***. Faccia clic su ***Salva*** per chiudere la finestra di dialogo, quindi faccia clic di nuovo su ***Salva*** per applicare le modifiche.

{% hint style="warning" %}
Eviti di abilitare un server MCP di recupero dei contenuti e un server MCP in grado di eseguire azioni nello stesso assistente IA, a meno che il suo flusso di lavoro non richieda entrambi. Un server di recupero dei contenuti, come il [server MCP della documentazione Devolutions](/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server/access-devolutions-documentation-mcp-server.md) o un server di ricerca web, inserisce testo di terze parti nel contesto del modello. Un server in grado di eseguire azioni, come il [server MCP di Remote Desktop Manager](/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server.md), espone strumenti che possono aggiornare le password archiviate, generare OTP o eseguire comandi sugli host connessi. Quando entrambi condividono un contesto, istruzioni nascoste nel contenuto recuperato potrebbero indurre il modello a chiamare tali strumenti (prompt injection indiretta).

Le pagine restituite dal server MCP della documentazione Devolutions sono contrassegnate come contenuto non attendibile che il modello deve trattare come dati da citare, mai come istruzioni da seguire. Questo riduce il rischio, ma non lo elimina, e altri server di recupero dei contenuti di terze parti potrebbero non offrire questa protezione.
{% endhint %}

### Vedi anche

* [Focus su – l'assistente AI di Remote Desktop Manager](https://blog.devolutions.net/2025/03/spotlight-on-remote-desktop-manager-ai-assistant/)
* [Devolutions Academy – Creare e utilizzare l'assistente AI in RDM](https://academy.devolutions.net/student/activity/2639962-create-and-use-ai-assistant-in-rdm)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/it/knowledge-base/how-to-articles/set-up-an-ai-assistant.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
IMPOSTAZIONI	DESCRIZIONE
Provider	L'API con cui il servizio è compatibile: OpenAI, Claude o Ollama.
URL di base	L'indirizzo del servizio, che inizia con `http://` o `https://`. Remote Desktop Manager aggiunge i percorsi API a questo indirizzo, quindi includa il segmento di versione previsto dal servizio. Per un servizio compatibile con OpenAI, l'indirizzo di solito termina con `/v1` (ad esempio, `http://localhost:8080/v1`). Faccia clic su Convalida per inviare una richiesta all'URL di base con le intestazioni configurate e confermare che il servizio è raggiungibile.
Modalità API	Visualizzato quando Provider è OpenAI. Scelga l'API OpenAI usata per inviare le richieste: Chat completions: Funziona con backend self-hosted che non conservano lo stato della conversazione sul server. Usi questa modalità per tali backend. Responses API: Richiede un backend che conservi lo stato della conversazione sul server. Con un backend che non lo fa, il primo messaggio di una conversazione riesce e il secondo non riesce.
Intestazione	Intestazioni HTTP inviate con ogni richiesta, inclusa l'individuazione dei modelli. Faccia clic su Aggiungi per aggiungere un'intestazione, quindi compili Nome e Valore in campi separati. Il provider Personalizzato non ha un campo Chiave API, quindi usi un'intestazione per autenticarsi. Ad esempio, inserisca `Authorization` in Nome e `Bearer <token>` in Valore. L'inserimento dell'intestazione completa (`Authorization: Bearer <token>`) in Nome non riesce con il messaggio Property Header has an invalid value.