> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Agent de Devin

> Utilisez le même moteur d’agent que Devin CLI directement dans Devin Desktop.

Devin Local est notre moteur d’agent de nouvelle génération, commun à [Devin CLI](https://cli.devin.ai).

Il s’exécute sur votre machine avec accès à vos fichiers, outils et environnement locaux, et a vocation à remplacer à terme Cascade comme principal agent local.

<Note>
  Devin Local est actuellement en préversion et présente certaines [limitations](#limitations) par rapport à Cascade. Devin Local n’est pas pris en charge dans le plugin JetBrains pour Devin Desktop.
</Note>

<div id="key-improvements">
  ## Améliorations clés
</div>

Depuis le lancement de Cascade, les capacités des modèles ont considérablement évolué. Devin Local a été conçu de A à Z pour tirer efficacement parti de ces avancées.

<div id="token-efficiency">
  ### Efficacité en tokens
</div>

Le Local Agent de Devin est nettement plus économe en tokens, notamment grâce à une utilisation plus poussée de la mise en cache des prompts. La plupart des tâches nécessitent jusqu’à 30 % de tokens en moins que Cascade pour obtenir le même résultat.

<div id="subagents">
  ### Sous-agents
</div>

Le Local Agent de Devin peut lancer des [sous-agents](https://cli.devin.ai/docs/subagents) indépendants pour traiter des sous-tâches, au premier plan ou en arrière-plan. Les sous-agents partagent les outils et le contexte de la base de code avec l'agent parent, mais opèrent dans leur propre fil de conversation.

<div id="sandboxing">
  ### Sandboxing
</div>

Le Local Agent de Devin prend en charge le sandboxing au niveau du système d’exploitation. Lorsqu’il est activé, le sandbox impose :

* **Isolation du système de fichiers** — les chemins accessibles en lecture et en écriture sont dérivés de vos périmètres d’autorisation
* **Filtrage réseau** — les listes d’autorisation et de refus de domaines contrôlent les domaines auxquels l’agent peut accéder

Les administrateurs Enterprise peuvent imposer le comportement du sandbox à l’échelle de l’organisation via les [paramètres d’équipe](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), notamment en exigeant le mode sandbox pour tous les utilisateurs et en configurant des règles de filtrage de domaines à l’échelle de l’organisation.

<div id="quick-review">
  ### Revue rapide
</div>

[Revue rapide](/fr/desktop/quick-review) est un sous-agent dédié disponible avec le Local Agent de Devin pour obtenir rapidement un retour sur les modifications.

<div id="switching-your-agent">
  ## Changer d’agent
</div>

Dans la plupart des cas, vous pouvez passer à `Devin Local` lorsque vous démarrez de *nouvelles* conversations à l’aide du sélecteur d’agent situé en bas à droite de Devin Desktop.

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=5206df1ec64b71ae0463d56f7453aff3" width="844" height="252" data-path="desktop/assets/windsurf/devin-local-agent-switcher.png" />
</Frame>

<div id="agent-settings">
  ### Paramètres de l’agent
</div>

Si Devin Local n’apparaît pas dans le sélecteur d’agent, vous devrez peut-être l’activer dans `Devin Settings` :

1. Ouvrez la palette de commandes avec `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux)
2. Ouvrez `Devin User Settings`
3. Cliquez sur l’onglet "Agents"
4. Activez l’agent "Devin Local"
5. Redémarrez Devin Desktop

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=b0f42c5d3d679c55c450fd9067c34303" width="1200" height="200" data-path="desktop/assets/windsurf/devin-local-agent-settings.png" />
</Frame>

Vous pouvez également désactiver complètement Cascade avec le paramètre `devin.cascade.enabled`.

<div id="differences">
  ## Différences
</div>

<div id="permissions-model">
  ### Modèle d'autorisations
</div>

Devin Local remplace les [niveaux d'exécution automatique](/fr/desktop/terminal#auto-execution-levels) par un système d'autorisations plus fin pour contrôler les actions que l'agent peut effectuer :

* Les règles **Deny** bloquent complètement les actions (priorité la plus élevée)
* Les règles **Ask** demandent systématiquement une approbation
* Les règles **Allow** approuvent automatiquement les actions sans demander de confirmation

Les autorisations peuvent être définies pour la lecture de fichiers, l'écriture de fichiers, l'exécution de commandes, les requêtes HTTP et les outils MCP. Elles peuvent être configurées au niveau du projet, de l'utilisateur ou de l'organisation.

<div id="mcp-permissions">
  ### Autorisations MCP
</div>

Contrairement à Cascade, la configuration par défaut du Local Agent de Devin demande une approbation avant d’appeler un outil MCP. Lorsque l’agent souhaite appeler un outil MCP, vous pouvez autoriser cet outil précis ou tous les outils de ce serveur MCP, soit pour la session en cours, soit de façon permanente.

<Frame>
  <img src="https://mintcdn.com/cognitionai/awLyB8V-RSMAHpBB/desktop/assets/windsurf/devin-local-mcp-permissions.png?fit=max&auto=format&n=awLyB8V-RSMAHpBB&q=85&s=c10aa13cbe249f0aa4f67d502c25ebf4" width="1300" height="486" data-path="desktop/assets/windsurf/devin-local-mcp-permissions.png" />
</Frame>

Les administrateurs Enterprise peuvent autoriser par défaut certains serveurs MCP ou outils spécifiques afin que les intégrations de confiance ne demandent pas d’approbation à chaque utilisation. Consultez les [autorisations par outil](/fr/cli/reference/permissions#tool-based-permissions) pour savoir comment configurer ces règles.

<div id="mcp-server-configuration">
  ### Configuration des serveurs MCP
</div>

Avec le Local Agent de Devin, les serveurs MCP sont configurés via des [fichiers de configuration](https://cli.devin.ai/docs/extensibility/mcp/configuration) sur votre machine locale.

L’emplacement du fichier dépend du périmètre :

| Périmètre         | Emplacement                   | Partagé avec la Team ?                   |
| ----------------- | ----------------------------- | ---------------------------------------- |
| Projet            | `.devin/config.json`          | Oui (inclus dans le contrôle de version) |
| Dérogation locale | `.devin/config.local.json`    | Non (ignoré par Git)                     |
| Utilisateur       | `~/.config/devin/config.json` | Non                                      |

<div id="skills">
  ## Skills
</div>

Les skills sont des ensembles réutilisables d’instructions invoqués par le modèle (et de scripts facultatifs) qui étendent les capacités du Local Agent de Devin. Comme Devin Local partage le même moteur d’agent que [Devin CLI](https://cli.devin.ai), il utilise le même format de skills et le même mécanisme de détection.

Les skills sont également la méthode recommandée pour migrer les mémoires et workflows de Cascade, qui ne sont pas pris en charge par le Local Agent de Devin (voir [Limites](#limitations)) — il suffit de formaliser une procédure réutilisable une seule fois, puis l’agent l’invoque automatiquement lorsqu’elle est pertinente.

Consultez la [documentation des skills de Devin CLI](/fr/cli/extensibility/skills/overview) pour savoir comment créer, configurer et définir le périmètre des skills.

<div id="limitations">
  ## Limitations
</div>

Les fonctionnalités suivantes ne sont pas encore prises en charge avec le Local Agent de Devin :

* **Mémoires** — Le Local Agent de Devin ne conserve pas les mémoires d’une session à l’autre. Migrez vos mémoires importantes vers les [skills](/fr/desktop/cascade/skills).
* **Workflows** — Les workflows ne sont pas disponibles avec le Local Agent de Devin. Migrez vos workflows vers les [skills](/fr/desktop/cascade/skills).
* **Codemaps** — Le Local Agent de Devin ne lit pas encore les [codemaps](/fr/desktop/codemaps).
* **Code Lenses** - Actuellement, les [code lenses](/fr/desktop/command/windsurf-related-features) n’activent pas encore le Local Agent de Devin.
* **Fast Context** - Devin Local utilise des subagents pour explorer le code, mais ne dispose pas de la même interface de contexte rapide que Cascade.
* **App Deploys** - Le Local Agent de Devin ne prend pas en charge App Deploys.
* **Aperçus Browser** - Le Local Agent de Devin ne prend pas encore en charge les [aperçus Browser](/fr/desktop/previews) dans l’IDE, y compris l’outil de sélection d’éléments du DOM.
* **Conversation Sharing** - Le partage de conversation n’est pas encore disponible avec le Local Agent de Devin.

Le Local Agent de Devin prend en charge les [règles et fichiers AGENTS.md](https://cli.devin.ai/docs/extensibility/rules) ainsi que les [skills](https://cli.devin.ai/docs/extensibility/skills/overview) pour fournir un contexte persistant et des workflows réutilisables.

<div id="analytics">
  ### Analyse
</div>

Le Local Agent de Devin ne remonte pas encore toutes les données d’analyse que Cascade collecte. Les données suivantes sont collectées pour Cascade, mais **pas** pour Devin Local :

* **Utilisation des outils** — La source de données [`cascade_tool_usage`](/fr/desktop/accounts/api-reference/cascade-analytics) (nombre d’appels par outil, comme Code Edit, Run Command, Search Web et MCP Tool) inclut uniquement les sessions Cascade. Les appels d’outil effectués par le Local Agent de Devin ne sont pas remontés. Pour surveiller ou restreindre l’utilisation des outils avec le Local Agent de Devin, utilisez plutôt les [hooks](/fr/cli/extensibility/hooks/overview) et les [permissions](/fr/cli/reference/permissions).
* **Lignes suggérées et acceptées** — La source de données [`cascade_lines`](/fr/desktop/accounts/api-reference/cascade-analytics) (lignes de code suggérées et acceptées chaque jour) n’inclut pas le code écrit par le Local Agent de Devin.
* **Mode Write/Read** — Le Local Agent de Devin ne remonte pas de mode Cascade. Le champ `mode` de la source de données `cascade_runs` n’est donc pas renseigné pour l’activité Devin Local.

L’activité Devin Local est toujours incluse dans la source de données [`cascade_runs`](/fr/desktop/accounts/api-reference/cascade-analytics) (utilisation du modèle, messages envoyés et consommation de crédits), ainsi que dans la [source de données Cascade](/fr/desktop/accounts/analytics-api#cascade-data) de la Custom Analytics API.

Le Devin CLI ne remonte pas de données d’analyse pour les [déploiements hybrides](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

<div id="enterprise-controls">
  ### Contrôles Enterprise
</div>

Les administrateurs Enterprise peuvent configurer le Local Agent de Devin via les [paramètres de l’équipe](https://windsurf.com/team/settings), y compris les [nouveaux contrôles disponibles uniquement avec le Local Agent de Devin](https://cli.devin.ai/docs/enterprise/team-settings) :

* **Application du mode sandbox** - Exiger le mode sandbox pour tous les utilisateurs et configurer des règles de filtrage de domaines à l’échelle de l’organisation
* **Autorisations granulaires** - Contrôler les actions que l’agent peut effectuer avec des autorisations plus précises
* **Contrôle du réseau** - Contrôler l’accès au réseau à l’aide de domaines autorisés et bloqués

De plus, le contrôle « Activer Cascade » peut être utilisé pour désactiver entièrement l’ancien agent Cascade afin de garantir que votre équipe applique les nouveaux contrôles disponibles avec Devin CLI.

<div id="unsupported-enterprise-controls">
  #### Contrôles Enterprise non pris en charge
</div>

Les anciens contrôles Enterprise suivants ne sont pas disponibles avec le Local Agent de Devin :

* **Limiter les appels d’outil à l’espace de travail** - par défaut, le Local Agent de Devin peut uniquement lire et modifier les fichiers dans l’espace de travail.
  Des [autorisations](https://cli.devin.ai/docs/reference/permissions) personnalisées offrent une alternative plus flexible pour reproduire les mêmes règles.
* **App Deploys** - App Deploys n’est pas encore pris en charge avec le Local Agent de Devin.
* **Partage de conversation** - Le partage de conversation n’est pas encore pris en charge avec le Local Agent de Devin.
* **Activer ou désactiver Cascade pour votre Team** - Ce paramètre contrôle uniquement l’ancien agent Cascade et ne s’applique ni au Local Agent de Devin ni à Devin CLI.
* **Appels d’outil globaux désactivés** - Si vous avez déjà désactivé complètement les appels d’outil, créez plutôt une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI.

Les anciens contrôles suivants continueront à être appliqués comme solution de secours si vous n’avez pas encore mis en place une configuration d’autorisations CLI Enterprise :

* **Exécuter automatiquement les commandes du Terminal** - Le Local Agent de Devin utilise son propre [modèle d’autorisations](https://cli.devin.ai/docs/reference/permissions) au lieu de niveaux d’exécution automatique ; nous vous recommandons d’utiliser ce modèle à la place, mais l’ancien contrôle continuera tout de même à être appliqué comme solution de secours.
* **Listes d’autorisation du Terminal** - Mettez en place une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI afin d’autoriser des commandes de terminal spécifiques.
* **Listes de refus du Terminal** - Mettez en place une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI afin de refuser des commandes de terminal spécifiques.

<div id="further-reading">
  ## Pour en savoir plus
</div>

* [Guide de démarrage rapide de Devin CLI](https://cli.devin.ai/docs)
* [Commandes essentielles](https://cli.devin.ai/docs/essential-commands)
* [Vue d’ensemble de l’extensibilité](https://cli.devin.ai/docs/extensibility)
* [Team Settings](https://cli.devin.ai/docs/enterprise/team-settings)