> 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/cli/it/guide/ai-agents.md).

# Lavorare con gli agenti IA

Due modi per lavorare con gli agenti IA in Devolutions CLI, avviare strumenti con devo secret run o connettere un client MCP. Scelga in base a ciò che il modello può vedere.

Gli agenti di programmazione IA, come Claude Code o GitHub Copilot, hanno spesso bisogno di una credenziale per finire un’attività: una password di database, un token API, una chiave di distribuzione. Devolutions CLI offre due modi per lasciare che un agente lavori con la cassaforte. La differenza è se il valore del segreto può raggiungere il modello.

## Scegliere l’approccio giusto

<table><thead><tr><th width="220">SCELGA</th><th>CHE COSA SUCCEDE</th><th>LO USI QUANDO</th></tr></thead><tbody><tr><td><strong>L’agente esegue <code>devo secret run</code></strong></td><td>L’agente gestisce solo riferimenti <code>devo://</code>. Devolutions CLI li risolve all’avvio dello strumento, dà i valori solo a quello strumento e li nasconde in ciò che lo strumento stampa. Il valore resta fuori dalla conversazione.</td><td>L’agente deve <strong>usare</strong> una credenziale: eseguire una migrazione, chiamare un’API, distribuire. È la scelta più sicura per impostazione predefinita.</td></tr><tr><td><strong>L’agente si connette con MCP</strong></td><td>Il client IA avvia <code>devo mcp</code> e ottiene strumenti per elencare, cercare e gestire casseforti e voci. Uno di questi strumenti restituisce un valore di segreto al client, così il valore può raggiungere il modello.</td><td>L’agente deve <strong>lavorare su</strong> lo spazio di lavoro: trovare voci, esaminare gli accessi, organizzare le casseforti. Limiti gli strumenti a ciò che serve all’attività.</td></tr></tbody></table>

{% hint style="info" %}
Può combinare entrambi. Connetta il server MCP con lo strumento di risoluzione dei segreti disattivato, così l’agente può esplorare le casseforti, e gli faccia avviare gli strumenti tramite `devo secret run` quando gli serve una credenziale.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Dare una credenziale a un agente senza esporla</strong></td><td>Lasci che l’agente trovi i riferimenti e avvii gli strumenti tramite <code>devo secret run</code>.</td><td><a href="/cli/it/guide/ai-agents/run-an-agent.md">Dare una credenziale a un agente senza esporla</a></td></tr><tr><td><strong>Connettere un client IA con MCP</strong></td><td>Aggiunga <code>devo mcp</code> al client MCP e veda che cosa può fare il modello.</td><td><a href="/cli/it/guide/ai-agents/connect-mcp.md">Connettere un client IA con MCP</a></td></tr><tr><td><strong>Limitare ciò che un agente può fare</strong></td><td>Tenga il server MCP in sola lettura, nasconda gli strumenti distruttivi o tenga i valori dei segreti fuori dal modello.</td><td><a href="/cli/it/guide/ai-agents/limit-tools.md">Limitare ciò che un agente può fare</a></td></tr><tr><td><strong>Che cosa resta nascosto e che cosa no</strong></td><td>Quali comandi consegnano un segreto e dove finisce la protezione di Devolutions CLI.</td><td><a href="/cli/it/guide/understand/security-model.md">Che cosa resta nascosto e che cosa no</a></td></tr></tbody></table>


---

# 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/cli/it/guide/ai-agents.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.