Bring Your Own Agent (BYOA)

Manager'ın Worker görevlerini Codex veya Claude Code gibi kendi Agent çalışma zamanlarınızda çalıştırın

BYOA nedir?

BYOA (Bring Your Own Agent), Manager'ın Worker'larına hangi Agent çalışma zamanının güç vereceğini seçmenizi sağlar. Yalnızca Verdent'in varsayılan Agent'larını kullanmak yerine, Manager tarafından gönderilen Worker görevleri, halihazırda kullandığınız veya lisansınızın bulunduğu bir Agent üzerinde çalışabilir.

Bunun yerine kendi sağlayıcı API anahtarınızı Verdent'in yerleşik aracılarıyla kullanmak mı istiyorsunuz? BYOK bölümüne bakın.

Desteklenen Agent türleri

Agent	Açıklama	Önkoşullar
Built-in Agent	Verdent tarafından sağlanan varsayılan Agent	Yok
Claude Code	Anthropic'in Claude Code CLI'si	Node.js kurulu olmalı (`npx` için)
Codex	OpenAI Codex CLI	Codex CLI kurulu ve OpenAI ortamı yapılandırılmış olmalı

Kullanım senaryoları

Belirli modellere erişim — Verdent'in varsayılan setinde bulunmayan model sürümlerini model seçici aracılığıyla kullanıma açın.
Ekip standardizasyonu — Paylaşılan bir kurumsal lisans kullanarak ekip kullanımının merkezi olarak faturalandırılmasını sağlayın.
Tanıdık iş akışı — Mevcut Claude Code veya Codex deneyiminizi korurken Manager'ın Worker görevlerini ona göndermesine izin verin.

Hızlı erişim

BYOA ayarları: Settings → Models → CLI Agents
Manager sohbetinde model seçimi: bir Task Model seçmek için giriş kutusundaki Auto modunu kapatın
BYOA'da yapılandırılan API anahtarları yalnızca yerel olarak saklanır ve hiçbir zaman Verdent sunucularına yüklenmez

Codex

Codex, OpenAI'nin kodlama aracısı CLI'sidir. Claude Code'un aksine, Codex Verdent içinde bir API anahtarı gerektirmez — yerel Codex ortamınızda zaten kurulu olan kimlik doğrulamayı kullanır.

Önkoşullar

Codex CLI kurulu (codex komutu PATH üzerinde erişilebilir olmalı)
Codex CLI kimliği doğrulanmış ve terminalinizde kullanılabilir durumda

Kurulum adımları

CLI Agents ayarlarını açın

Settings → Models → CLI Agents bölümüne gidin.

Codex yoksa ekleyin

Codex kartı görünmüyorsa Add CLI Agent'a tıklayın. Verdent, codex komutu için sistem PATH ortamınızı tarar.

Codex'i etkinleştirin

Codex anahtarını açın.

Modelleri seçin

Verdent kullanılabilir modelleri otomatik olarak algılar. Kullanmak istediklerinizi seçin.

Model keşfi

Codex modelleri dinamik olarak keşfedilir. Codex başlatıldıktan sonra Verdent, /models API'si aracılığıyla kullanılabilir modelleri getirir. Codex tarafında yeni modeller eklenirse, listeyi güncellemek için Refresh Models'a tıklayın.

Kimlik doğrulama

Verdent, Codex kimlik doğrulamasını yönetmez. Codex, yerel kabuk ortamınıza (genellikle OPENAI_API_KEY veya yerleşik oturum açma akışı) dayanır. codex terminalinizde çalıştığı sürece entegrasyon çalışır.

Claude Code

Claude Code, BYOA'daki en zengin özelliklere sahip Agent'tır ve birden fazla sağlayıcıyı destekler. Anthropic, OpenRouter, Zhipu GLM ve diğerlerini bağlayabilir ve model seçicide aralarında geçiş yapabilirsiniz.

Önkoşullar

Node.js kurulu (yalnızca npx gereklidir)

Verdent, Claude Code'u şu şekilde başlatır:

npx -y @agentclientprotocol/claude-agent-acp

Genel kurulum gerekmez.

Kurulum adımları

CLI Agents ayarlarını açın

Settings → Models → CLI Agents bölümüne gidin.

Claude Code yoksa ekleyin

Claude Code kartı görünmüyorsa Add CLI Agent'a tıklayın. Verdent, npx komutunu algılar.

Claude Code'u etkinleştirin

Claude Code anahtarını açın.

Bir sağlayıcı ekleyin

Add provider'a tıklayın ve bir sağlayıcı seçin (örneğin Anthropic).

Kimlik bilgilerini girin

API anahtarını girin. Varsayılan değerler otomatik olarak doldurulur.

Test edin ve kaydedin

İsteğe bağlı olarak Test Connection'a tıklayın, ardından Save'e tıklayın.

Kaydettikten sonra, sağlayıcı altındaki modeller model listesinde görünür. Etkinleştirilen modeller varsayılan olarak seçilidir ancak manuel olarak değiştirilebilir.

Desteklenen sağlayıcılar

Claude Code birden fazla sağlayıcıyı destekler. Aynı anda birkaçını yapılandırabilirsiniz ve tüm modeller seçicide görünür.

Anthropic

Claude modelleri için resmi Anthropic API'si.

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

OpenRouter

Birden fazla model sağlayıcısına birleşik API erişimi.

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

Diğer OpenRouter modellerine yönlendirmek için Role Models'i geçersiz kılabilirsiniz (örneğin google/gemini-2.5-pro).

Zhipu GLM (China)

Base URL: https://open.bigmodel.cn/api/anthropic
Model: GLM-5
Key: bigmodel.cn/usercenter/proj-mgmt/apikeys
Docs: docs.bigmodel.cn

Zhipu GLM (Global)

Base URL: https://api.z.ai/api/anthropic
Model: GLM-5
Key: z.ai/manage-apikey/apikey-list
Docs: docs.z.ai

Kimi

Base URL: https://api.kimi.com/coding/
Model: Kimi K2.5
Key: kimi.com/code/console
Docs: kimi.com/code/docs

Moonshot

Base URL: https://api.moonshot.cn/anthropic
Model: Kimi K2.5
Key: platform.moonshot.cn/console/api-keys
Docs: platform.moonshot.cn/docs

Kimi ve Moonshot'un her ikisi de Kimi K2.5 sağlar ancak farklı uç noktalar ve kimlik doğrulama kullanır. Anahtarınızın nereden geldiğine göre seçim yapın.

MiniMax (China)

Base URL: https://api.minimaxi.com/anthropic
Model: MiniMax-M2.7
Key: platform.minimaxi.com
Docs: platform.minimaxi.com/docs

MiniMax (Global)

Base URL: https://api.minimax.io/anthropic
Model: MiniMax-M2.7
Key: platform.minimax.io
Docs: platform.minimax.io/docs

Xiaomi MiMo

Base URL: https://api.xiaomimimo.com/anthropic
Model: MiMo V2 Pro
Key: platform.xiaomimimo.com
Docs: platform.xiaomimimo.com/docs

Xiaomi MiMo (Token Plan)

Base URL: https://token-plan-cn.xiaomimimo.com/anthropic
Model: MiMo V2 Pro
Key: platform.xiaomimimo.com
Docs: platform.xiaomimimo.com/docs

Anthropic-Compatible (Custom Endpoint)

Anthropic API formatıyla uyumlu herhangi bir hizmet için.

Auth: API Key veya Token (değiştirilebilir)
Base URL: manuel olarak yapılandırılır
Models: manuel olarak belirtilir

Sağlayıcınız listede yoksa ancak Anthropic uyumlu API'leri destekliyorsa bunu kullanın.

Gelişmiş seçenekler

Sağlayıcı yapılandırma panelinde, bir JSON düzenleyiciye erişmek için Advanced Options'ı genişletin:

Role Models eşlemesi:
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
Özel ortam değişkenleri (örneğin API_TIMEOUT_MS)

Çoğu kullanıcının bunları değiştirmesi gerekmez — varsayılanlar kutudan çıktığı haliyle iyi çalışır.

Manager'da BYOA modellerini kullanma

Yapılandırmadan sonra:

Auto modunu devre dışı bırakın

Sohbet girişinde Auto modunu kapatın.

Task Model'i açın

Task Model açılır menüsünü açın.

Bir BYOA modeli seçin

Etkinleştirilmiş herhangi bir BYOA modelini seçin. Worker görevleri o modeli kullanarak çalışır.

Modeller şu şekilde görünür:

GPT-5.4 Codex-CLI (Codex'ten)
Claude-Opus-4.7 ClaudeCode-CLI (Claude Code'dan)

Üzerine gelindiğinde CLI kaynağı, model adı ve sağlayıcı gibi ayrıntılar gösterilir.

Güvenlik ve gizlilik

Yalnızca yerel depolama: API anahtarları yerel olarak saklanır ve hiçbir zaman yüklenmez.
Claude Code anahtarları: güvenli bir şekilde saklanır, düz yapılandırma dosyalarına yazılmaz.
Codex kimlik doğrulaması: tamamen yerel ortamınız tarafından yönetilir; Verdent OpenAI anahtarlarına erişmez.