Apportez votre propre agent (BYOA)

Qu'est-ce que BYOA ?

BYOA (Apportez votre propre agent) vous permet de choisir quel runtime Agent alimente les Workers de Manager. Au lieu d'utiliser uniquement les Agents par défaut de Verdent, les tâches Worker envoyées par Manager peuvent s'exécuter sur un Agent que vous utilisez déjà ou pour lequel vous disposez d'une licence.

Vous souhaitez plutôt utiliser votre propre clé API de fournisseur avec les agents intégrés de Verdent ? Consultez BYOK.

Types d'agents pris en charge

Agent	Description	Prérequis
Agent intégré	Agent par défaut fourni par Verdent	Aucun
Claude Code	CLI Claude Code d'Anthropic	Node.js installé (pour `npx`)
Codex	CLI Codex de OpenAI	CLI Codex installée et environnement OpenAI configuré

Cas d'usage

Accéder à des modèles spécifiques — Exposez des versions de modèles non incluses dans l'ensemble par défaut de Verdent via le sélecteur de modèles.
Standardisation d'équipe — Utilisez une licence d'entreprise partagée pour que l'usage de l'équipe soit facturé de manière centralisée.
Flux de travail familier — Conservez votre expérience Claude Code ou Codex existante tout en laissant Manager y envoyer des tâches Worker.

Accès rapide

Paramètres BYOA : Settings → Models → CLI Agents
Sélection du modèle dans le chat Manager : désactivez le mode Auto dans la zone de saisie pour choisir un Task Model
Les clés API configurées dans BYOA sont stockées uniquement en local et ne sont jamais envoyées aux serveurs de Verdent

Codex

Codex est la CLI d'agent de codage de OpenAI. Contrairement à Claude Code, Codex ne nécessite pas de clé API dans Verdent — il utilise l'authentification déjà configurée dans votre environnement Codex local.

Prérequis

CLI Codex installée (codex doit être disponible dans votre PATH)
CLI Codex authentifiée et utilisable dans votre terminal

Étapes de configuration

Ouvrir les paramètres CLI Agents

Allez dans Settings → Models → CLI Agents.

Ajouter Codex si absent

Si la carte Codex n'est pas visible, cliquez sur Add CLI Agent. Verdent analyse le PATH de votre système à la recherche de la commande codex.

Activer Codex

Activez le bouton Codex.

Sélectionner les modèles

Verdent détecte automatiquement les modèles disponibles. Sélectionnez ceux que vous souhaitez utiliser.

Découverte des modèles

Les modèles Codex sont découverts de manière dynamique. Après le lancement de Codex, Verdent récupère les modèles disponibles via son API /models. Si de nouveaux modèles sont ajoutés côté Codex, cliquez sur Refresh Models pour mettre à jour la liste.

Authentification

Verdent ne gère pas l'authentification de Codex. Codex s'appuie sur votre environnement shell local (généralement OPENAI_API_KEY ou son flux de connexion intégré). Tant que codex fonctionne dans votre terminal, l'intégration fonctionne.

Claude Code

Claude Code est l'Agent le plus riche en fonctionnalités de BYOA et prend en charge plusieurs fournisseurs. Vous pouvez connecter Anthropic, OpenRouter, Zhipu GLM et d'autres, puis basculer entre eux dans le sélecteur de modèles.

Prérequis

Node.js installé (seul npx est requis)

Verdent lance Claude Code via :

npx -y @agentclientprotocol/claude-agent-acp

Aucune installation globale n'est requise.

Étapes de configuration

Ouvrir les paramètres CLI Agents

Allez dans Settings → Models → CLI Agents.

Ajouter Claude Code si absent

Si la carte Claude Code n'est pas visible, cliquez sur Add CLI Agent. Verdent détecte npx.

Activer Claude Code

Activez le bouton Claude Code.

Ajouter un fournisseur

Cliquez sur Add provider et sélectionnez un fournisseur (par exemple, Anthropic).

Saisir les identifiants

Saisissez la clé API. Les valeurs par défaut sont pré-remplies.

Tester et enregistrer

Cliquez éventuellement sur Test Connection, puis sur Save.

Une fois l'enregistrement effectué, les modèles du fournisseur apparaissent dans la liste des modèles. Les modèles activés sont sélectionnés par défaut, mais peuvent être basculés manuellement.

Fournisseurs pris en charge

Claude Code prend en charge plusieurs fournisseurs. Vous pouvez en configurer plusieurs à la fois, et tous les modèles apparaissent dans le sélecteur.

Anthropic

API officielle d'Anthropic pour les modèles Claude.

Authentification : clé API
URL de base : https://api.anthropic.com
Modèles : Opus / Sonnet / Haiku
Clé : platform.claude.com/settings/keys

OpenRouter

Accès API unifié à plusieurs fournisseurs de modèles.

Authentification : jeton
URL de base : https://openrouter.ai/api
Modèles : Opus / Sonnet / Haiku
Clé : openrouter.ai/workspaces/default/keys

Vous pouvez remplacer les Role Models pour router vers d'autres modèles OpenRouter (par exemple, google/gemini-2.5-pro).

Zhipu GLM (Chine)

URL de base : https://open.bigmodel.cn/api/anthropic
Modèle : GLM-5
Clé : bigmodel.cn/usercenter/proj-mgmt/apikeys
Documentation : docs.bigmodel.cn

Zhipu GLM (Global)

URL de base : https://api.z.ai/api/anthropic
Modèle : GLM-5
Clé : z.ai/manage-apikey/apikey-list
Documentation : docs.z.ai

Kimi

URL de base : https://api.kimi.com/coding/
Modèle : Kimi K2.5
Clé : kimi.com/code/console
Documentation : kimi.com/code/docs

Moonshot

URL de base : https://api.moonshot.cn/anthropic
Modèle : Kimi K2.5
Clé : platform.moonshot.cn/console/api-keys
Documentation : platform.moonshot.cn/docs

Kimi et Moonshot proposent tous deux Kimi K2.5, mais utilisent des points de terminaison et une authentification différents. Choisissez en fonction de l'origine de votre clé.

MiniMax (Chine)

URL de base : https://api.minimaxi.com/anthropic
Modèle : MiniMax-M2.7
Clé : platform.minimaxi.com
Documentation : platform.minimaxi.com/docs

MiniMax (Global)

URL de base : https://api.minimax.io/anthropic
Modèle : MiniMax-M2.7
Clé : platform.minimax.io
Documentation : platform.minimax.io/docs

Xiaomi MiMo

URL de base : https://api.xiaomimimo.com/anthropic
Modèle : MiMo V2 Pro
Clé : platform.xiaomimimo.com
Documentation : platform.xiaomimimo.com/docs

Xiaomi MiMo (Offre par jeton)

URL de base : https://token-plan-cn.xiaomimimo.com/anthropic
Modèle : MiMo V2 Pro
Clé : platform.xiaomimimo.com
Documentation : platform.xiaomimimo.com/docs

Compatible Anthropic (point de terminaison personnalisé)

Pour tout service compatible avec le format API d'Anthropic.

Authentification : clé API ou jeton (interchangeable)
URL de base : configurée manuellement
Modèles : spécifiés manuellement

Utilisez cette option si votre fournisseur n'est pas répertorié mais prend en charge des API compatibles Anthropic.

Options avancées

Dans le panneau de configuration du fournisseur, développez Advanced Options pour accéder à un éditeur JSON :

Mappage des Role Models :
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
Variables d'environnement personnalisées (par exemple, API_TIMEOUT_MS)

La plupart des utilisateurs n'ont pas besoin de les modifier — les valeurs par défaut fonctionnent bien telles quelles.

Utiliser les modèles BYOA dans Manager

Après la configuration :

Désactiver le mode Auto

Désactivez le mode Auto dans la zone de saisie du chat.

Ouvrir Task Model

Ouvrez le menu déroulant Task Model.

Sélectionner un modèle BYOA

Choisissez un modèle BYOA activé. Les tâches Worker s'exécuteront avec ce modèle.

Les modèles apparaissent sous la forme :

GPT-5.4 Codex-CLI (depuis Codex)
Claude-Opus-4.7 ClaudeCode-CLI (depuis Claude Code)

Le survol affiche des détails tels que la source CLI, le nom du modèle et le fournisseur.

Sécurité et confidentialité

Stockage local uniquement : les clés API sont stockées en local et ne sont jamais téléchargées.
Clés Claude Code : stockées de manière sécurisée, non écrites dans des fichiers de configuration en clair.
Authentification Codex : entièrement gérée par votre environnement local ; Verdent n'accède pas aux clés OpenAI.