> 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/fr/guides/ai-agents.md).

# Travailler avec des agents d’IA

Deux façons de travailler avec les agents d’IA dans Devolutions CLI, lancer des outils avec devo secret run ou connecter un client MCP. Choisissez selon ce que le modèle peut voir.

Les agents de codage d’IA, comme Claude Code ou GitHub Copilot, ont souvent besoin d’un identifiant pour terminer une tâche : un mot de passe de base de données, un jeton d’API, une clé de déploiement. Devolutions CLI vous offre deux façons de laisser un agent travailler avec votre coffre. La différence est de savoir si la valeur du secret peut atteindre le modèle.

## Choisir la bonne approche

<table><thead><tr><th width="220">CHOISIR</th><th>CE QUI SE PASSE</th><th>À UTILISER QUAND</th></tr></thead><tbody><tr><td><strong>L’agent exécute <code>devo secret run</code></strong></td><td>L’agent ne manipule que des références <code>devo://</code>. Devolutions CLI les résout au démarrage de l’outil, donne les valeurs à cet outil seulement et les masque dans ce que l’outil affiche. La valeur reste hors de la conversation.</td><td>L’agent doit <strong>utiliser</strong> un identifiant : exécuter une migration, appeler une API, déployer. C’est le choix le plus sûr par défaut.</td></tr><tr><td><strong>L’agent se connecte avec MCP</strong></td><td>Votre client d’IA démarre <code>devo mcp</code> et obtient des outils pour lister, chercher et gérer les coffres et les entrées. L’un de ces outils retourne une valeur de secret au client, de sorte que la valeur peut atteindre le modèle.</td><td>L’agent doit <strong>travailler sur</strong> votre espace de travail : trouver des entrées, examiner les accès, organiser les coffres. Limitez les outils à ce que la tâche exige.</td></tr></tbody></table>

{% hint style="info" %}
Vous pouvez combiner les deux. Connectez le serveur MCP avec l’outil de résolution de secrets désactivé pour que l’agent puisse explorer vos coffres, et faites-lui lancer des outils par `devo secret run` quand il a besoin d’un identifiant.
{% 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>Donner un identifiant à un agent sans l’exposer</strong></td><td>Laissez l’agent trouver des références et lancer des outils par <code>devo secret run</code>.</td><td><a href="/cli/fr/guides/ai-agents/run-an-agent.md">Donner un identifiant à un agent sans l’exposer</a></td></tr><tr><td><strong>Connecter un client d’IA avec MCP</strong></td><td>Ajoutez <code>devo mcp</code> à votre client MCP et voyez ce que le modèle peut faire.</td><td><a href="/cli/fr/guides/ai-agents/connect-mcp.md">Connecter un client d’IA avec MCP</a></td></tr><tr><td><strong>Limiter ce qu’un agent peut faire</strong></td><td>Gardez le serveur MCP en lecture seule, masquez les outils destructifs ou gardez les valeurs de secret hors du modèle.</td><td><a href="/cli/fr/guides/ai-agents/limit-tools.md">Limiter ce qu’un agent peut faire</a></td></tr><tr><td><strong>Ce qui reste caché, et ce qui ne l’est pas</strong></td><td>Quelles commandes transmettent un secret, et où s’arrête la protection de Devolutions CLI.</td><td><a href="/cli/fr/guides/understand/security-model.md">Ce qui reste caché, et ce qui ne l’est pas</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/fr/guides/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.