Passer au contenu principal

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.

Les agents ACP sont disponibles pour les utilisateurs Pro, Max et Teams. Les administrateurs Enterprise doivent contacter l’équipe en charge de leur compte pour activer les agents tiers.
Devin Desktop prend en charge l’exécution d’agents tiers dans le centre de commande des agents. Nous utilisons pour cela l’Agent Client Protocol (ACP). ACP est un protocole ouvert qui standardise la communication entre les éditeurs de code et les agents de développement — à l’image du Language Server Protocol (LSP), qui a standardisé l’intégration des serveurs de langage. Tout agent qui implémente ACP peut être intégré à Devin Desktop, et Devin Desktop peut communiquer avec tout agent compatible ACP.
Lorsque vous utilisez un agent ACP externe, toutes les opérations sont déléguées à cet agent. La politique de confidentialité et les conditions juridiques de Devin Desktop ne s’appliquent pas, et la facturation se fait directement entre vous et le fournisseur tiers de l’agent.
En plus de prendre en charge des agents tiers comme Claude Code et Codex, vous pouvez utiliser ACP pour intégrer un agent personnalisé à Devin Desktop.

Activer des agents personnalisés

Une fois un agent ajouté à votre registre local ou Team, vous pouvez l’activer depuis Windsurf Settings :
  1. Ouvrez la palette de commandes avec Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
  2. Ouvrez Windsurf User Settings
  3. Cliquez sur l’onglet « Agents »
  4. Activez les agents ACP que vous souhaitez utiliser
  5. Redémarrez Devin Desktop
Une fois activé, l’agent apparaît dans le sélecteur d’agents en bas à droite de Devin Desktop lorsque vous démarrez de nouvelles conversations, aux côtés d’agents intégrés comme Cascade et Devin Local.

Configuration du registre local

Chaque utilisateur peut configurer ses propres agents ACP en modifiant un fichier de registre local :
  • Devin Desktop: ~/.windsurf/acp/registry.json
  • Devin Desktop Next: ~/.windsurf-next/acp/registry.json
Vous pouvez aussi ouvrir directement le fichier depuis la palette de commandes en lançant Open Local ACP Registry Config. Le fichier suit la spécification du registre ACP.

Exemple de configuration pour Devin Local

Si vous souhaitez tester Devin Local sur votre machine sans l’activer pour toute votre Team, vous pouvez configurer un registre local qui pointe vers Devin CLI. Cela suppose que la CLI devin est déjà installée et accessible dans votre PATH. Devin Desktop la lance avec devin acp.
{
  "version": "1.0.0",
  "agents": [
    {
      "id": "devin-cli",
      "name": "Devin Local",
      "version": "1.0.0",
      "description": "Devin AI coding agent via Devin CLI",
      "authors": [
        "Cognition AI"
      ],
      "license": "proprietary",
      "distribution": {
        "binary": {
          "darwin-aarch64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          },
          "darwin-x86_64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          },
          "linux-aarch64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          },
          "linux-x86_64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          },
          "windows-aarch64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          },
          "windows-x86_64": {
            "archive": "",
            "cmd": "devin",
            "args": [
              "acp"
            ]
          }
        }
      }
    }
  ],
  "extensions": []
}

Configuration du registre Team

Les administrateurs de Team peuvent déployer une configuration ACP personnalisée pour leur Team via le paramètre “ACP Registry Config” dans Windsurf Settings. Cela vous permet de maintenir un registre statique des agents ACP approuvés que tous les membres de votre Team peuvent utiliser, sans que chaque utilisateur ait à les configurer individuellement.
Pour des raisons de sécurité, Devin Desktop ne télécharge pas actuellement les distributions d’agents directement depuis le registre. Le binaire de l’agent doit déjà être installé sur la machine de l’utilisateur — la configuration du registre indique à Devin Desktop comment le lancer. Les URL distribution.binary.<platform>.archive dans l’exemple ci-dessous font partie du schéma du registre ACP pour assurer la compatibilité avec l’ensemble de l’écosystème, mais Devin Desktop ne les télécharge pas à ce jour.

Exemple de configuration pour OpenCode

{
  "version": "1.0.0",
  "agents": [
    {
      "id": "opencode",
      "name": "OpenCode",
      "version": "1.15.7",
      "description": "The open source coding agent",
      "repository": "https://github.com/anomalyco/opencode",
      "website": "https://opencode.ai",
      "authors": [
        "Anomaly"
      ],
      "license": "MIT",
      "icon": "https://cdn.agentclientprotocol.com/registry/v1/latest/opencode.svg",
      "distribution": {
        "binary": {
          "darwin-aarch64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-arm64.zip",
            "cmd": "./opencode",
            "args": [
              "acp"
            ]
          },
          "darwin-x86_64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-x64.zip",
            "cmd": "./opencode",
            "args": [
              "acp"
            ]
          },
          "linux-aarch64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-arm64.tar.gz",
            "cmd": "./opencode",
            "args": [
              "acp"
            ]
          },
          "linux-x86_64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-x64.tar.gz",
            "cmd": "./opencode",
            "args": [
              "acp"
            ]
          },
          "windows-aarch64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-arm64.zip",
            "cmd": "./opencode.exe",
            "args": [
              "acp"
            ]
          },
          "windows-x86_64": {
            "archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-x64.zip",
            "cmd": "./opencode.exe",
            "args": [
              "acp"
            ]
          }
        }
      }
    }
  ],
  "extensions": []
}

Dépannage

La configuration de mon agent existant ne fonctionne pas

Les agents tiers lisent leurs propres fichiers de configuration pour la plupart des paramètres, mais l’authentification est généralement gérée séparément. Plus précisément, vous devez généralement :
  • Vous authentifier à l’aide de la commande slash /login dans l’agent.
  • Configurer des variables d’environnement à l’aide du bouton « … » dans l’onglet Agents de Windsurf User Settings.
  • Définir des variables d’environnement via le paramètre windsurf.acp.agentEnv.<agentName> dans votre fichier settings.json.