Bring Your Own Agent (BYOA)

Cos'è BYOA?

BYOA (Bring Your Own Agent) ti permette di scegliere quale runtime Agent alimenta i Worker di Manager. Invece di usare solo gli Agent predefiniti di Verdent, le attività Worker inviate da Manager possono essere eseguite su un Agent che già utilizzi o per cui hai una licenza.

Vuoi invece usare la tua chiave API del provider con gli agent integrati di Verdent? Vedi BYOK.

Tipi di Agent supportati

Agent	Descrizione	Prerequisiti
Built-in Agent	Agent predefinito fornito da Verdent	Nessuno
Claude Code	CLI Claude Code di Anthropic	Node.js installato (per `npx`)
Codex	CLI Codex di OpenAI	CLI Codex installata e ambiente OpenAI configurato

Casi d'uso

Accedere a modelli specifici — Esponi versioni di modelli non incluse nel set predefinito di Verdent tramite il selettore dei modelli.
Standardizzazione del team — Usa una licenza aziendale condivisa in modo che l'utilizzo del team venga fatturato in modo centralizzato.
Flusso di lavoro familiare — Mantieni la tua esperienza esistente con Claude Code o Codex, lasciando che Manager vi invii le attività Worker.

Accesso rapido

Impostazioni BYOA: Settings → Models → CLI Agents
Selezione del modello nella chat di Manager: disattiva la modalità Auto nella casella di input per scegliere un Task Model
Le chiavi API configurate in BYOA sono salvate solo localmente e non vengono mai caricate sui server di Verdent

Codex

Codex è la CLI dell'agente di coding di OpenAI. A differenza di Claude Code, Codex non richiede una chiave API all'interno di Verdent — utilizza l'autenticazione già configurata nel tuo ambiente Codex locale.

Prerequisiti

CLI Codex installata (codex deve essere disponibile nel tuo PATH)
CLI Codex autenticata e utilizzabile nel tuo terminale

Passaggi di configurazione

Apri le impostazioni CLI Agents

Vai su Settings → Models → CLI Agents.

Aggiungi Codex se manca

Se la scheda Codex non è visibile, seleziona Add CLI Agent. Verdent esegue una scansione del tuo PATH di sistema per trovare il comando codex.

Abilita Codex

Attiva l'interruttore Codex.

Seleziona i modelli

Verdent rileva automaticamente i modelli disponibili. Seleziona quelli che vuoi usare.

Individuazione dei modelli

I modelli Codex vengono individuati dinamicamente. Dopo aver avviato Codex, Verdent recupera i modelli disponibili tramite la sua API /models. Se sul lato Codex vengono aggiunti nuovi modelli, seleziona Refresh Models per aggiornare l'elenco.

Autenticazione

Verdent non gestisce l'autenticazione di Codex. Codex si basa sull'ambiente shell locale (tipicamente OPENAI_API_KEY o il suo flusso di login integrato). Finché codex funziona nel tuo terminale, l'integrazione funziona.

Claude Code

Claude Code è l'Agent più ricco di funzionalità in BYOA e supporta più provider. Puoi collegare Anthropic, OpenRouter, Zhipu GLM e altri, e passare dall'uno all'altro nel selettore dei modelli.

Prerequisiti

Node.js installato (è richiesto solo npx)

Verdent avvia Claude Code tramite:

npx -y @agentclientprotocol/claude-agent-acp

Non è richiesta alcuna installazione globale.

Passaggi di configurazione

Apri le impostazioni CLI Agents

Vai su Settings → Models → CLI Agents.

Aggiungi Claude Code se manca

Se la scheda Claude Code non è visibile, seleziona Add CLI Agent. Verdent rileva npx.

Abilita Claude Code

Attiva l'interruttore Claude Code.

Aggiungi un provider

Seleziona Add provider e scegli un provider (per esempio, Anthropic).

Inserisci le credenziali

Inserisci la chiave API. I valori predefiniti vengono compilati automaticamente.

Testa e salva

Facoltativamente seleziona Test Connection, poi seleziona Save.

Dopo il salvataggio, i modelli sotto il provider compaiono nell'elenco dei modelli. I modelli abilitati sono selezionati per impostazione predefinita, ma possono essere attivati o disattivati manualmente.

Provider supportati

Claude Code supporta più provider. Puoi configurarne diversi contemporaneamente e tutti i modelli compaiono nel selettore.

Anthropic

API ufficiale di Anthropic per i modelli Claude.

Auth: Chiave API
Base URL: https://api.anthropic.com
Modelli: Opus / Sonnet / Haiku
Chiave: platform.claude.com/settings/keys

OpenRouter

Accesso unificato tramite API a più provider di modelli.

Auth: Token
Base URL: https://openrouter.ai/api
Modelli: Opus / Sonnet / Haiku
Chiave: openrouter.ai/workspaces/default/keys

Puoi sovrascrivere i Role Models per instradare verso altri modelli OpenRouter (per esempio, google/gemini-2.5-pro).

Zhipu GLM (Cina)

Base URL: https://open.bigmodel.cn/api/anthropic
Modello: GLM-5
Chiave: bigmodel.cn/usercenter/proj-mgmt/apikeys
Documentazione: docs.bigmodel.cn

Zhipu GLM (Globale)

Base URL: https://api.z.ai/api/anthropic
Modello: GLM-5
Chiave: z.ai/manage-apikey/apikey-list
Documentazione: docs.z.ai

Kimi

Base URL: https://api.kimi.com/coding/
Modello: Kimi K2.5
Chiave: kimi.com/code/console
Documentazione: kimi.com/code/docs

Moonshot

Base URL: https://api.moonshot.cn/anthropic
Modello: Kimi K2.5
Chiave: platform.moonshot.cn/console/api-keys
Documentazione: platform.moonshot.cn/docs

Sia Kimi che Moonshot forniscono Kimi K2.5, ma usano endpoint e autenticazione diversi. Scegli in base alla provenienza della tua chiave.

MiniMax (Cina)

Base URL: https://api.minimaxi.com/anthropic
Modello: MiniMax-M2.7
Chiave: platform.minimaxi.com
Documentazione: platform.minimaxi.com/docs

MiniMax (Globale)

Base URL: https://api.minimax.io/anthropic
Modello: MiniMax-M2.7
Chiave: platform.minimax.io
Documentazione: platform.minimax.io/docs

Xiaomi MiMo

Base URL: https://api.xiaomimimo.com/anthropic
Modello: MiMo V2 Pro
Chiave: platform.xiaomimimo.com
Documentazione: platform.xiaomimimo.com/docs

Xiaomi MiMo (Token Plan)

Base URL: https://token-plan-cn.xiaomimimo.com/anthropic
Modello: MiMo V2 Pro
Chiave: platform.xiaomimimo.com
Documentazione: platform.xiaomimimo.com/docs

Compatibile con Anthropic (endpoint personalizzato)

Per qualsiasi servizio compatibile con il formato API di Anthropic.

Auth: Chiave API o Token (commutabile)
Base URL: configurato manualmente
Modelli: specificati manualmente

Usa questa opzione se il tuo provider non è elencato ma supporta API compatibili con Anthropic.

Opzioni avanzate

Nel pannello di configurazione del provider, espandi Advanced Options per accedere a un editor JSON:

Mappatura dei Role Models:
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
Variabili d'ambiente personalizzate (per esempio, API_TIMEOUT_MS)

La maggior parte degli utenti non ha bisogno di modificarle — i valori predefiniti funzionano bene fin da subito.

Usare i modelli BYOA in Manager

Dopo la configurazione:

Disattiva la modalità Auto

Disattiva la modalità Auto nell'input della chat.

Apri Task Model

Apri il menu a discesa Task Model.

Seleziona un modello BYOA

Scegli un qualsiasi modello BYOA abilitato. Le attività Worker verranno eseguite usando quel modello.

I modelli compaiono come:

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

Passandoci sopra con il mouse vengono mostrati dettagli come la fonte CLI, il nome del modello e il provider.

Sicurezza e privacy

Solo archiviazione locale: le chiavi API sono salvate localmente e non vengono mai caricate.
Chiavi Claude Code: salvate in modo sicuro, non scritte in file di configurazione in chiaro.
Autenticazione Codex: gestita interamente dal tuo ambiente locale; Verdent non accede alle chiavi OpenAI.