أحضر وكيلك الخاص (BYOA)

ما هو BYOA؟

يتيح لك BYOA (أحضر وكيلك الخاص) اختيار بيئة تشغيل الوكيل التي تشغّل Workers الخاصة بـ Manager. فبدلاً من الاعتماد فقط على وكلاء Verdent الافتراضيين، يمكن لمهام Worker التي يوزّعها Manager أن تعمل على وكيل تستخدمه مسبقاً أو مرخّص لك باستخدامه.

تبحث عن استخدام مفتاح API الخاص بمزوّدك مع وكلاء Verdent المدمجين بدلاً من ذلك؟ راجع BYOK.

أنواع الوكلاء المدعومة

الوكيل	الوصف	المتطلبات الأساسية
الوكيل المدمج	الوكيل الافتراضي الذي يوفّره Verdent	لا توجد
Claude Code	واجهة سطر الأوامر Claude Code الخاصة بـ Anthropic	تثبيت Node.js (لـ `npx`)
Codex	واجهة سطر الأوامر Codex الخاصة بـ OpenAI	تثبيت واجهة سطر الأوامر Codex وضبط بيئة OpenAI

حالات الاستخدام

الوصول إلى نماذج محددة — إظهار إصدارات نماذج غير مضمّنة في المجموعة الافتراضية لـ Verdent من خلال محدد النموذج.
توحيد على مستوى الفريق — استخدام ترخيص مؤسسي مشترك بحيث يُفوَّتر استخدام الفريق مركزياً.
سير عمل مألوف — الحفاظ على تجربتك الحالية مع Claude Code أو Codex مع السماح لـ Manager بتوزيع مهام Worker عليها.

وصول سريع

إعدادات BYOA: Settings → Models → CLI Agents
اختيار النموذج في محادثة Manager: أوقف تشغيل وضع Auto في مربع الإدخال لاختيار Task Model
مفاتيح API المُهيَّأة في BYOA تُخزَّن محلياً فقط ولا تُرفَع أبداً إلى خوادم Verdent

Codex

Codex هو واجهة سطر أوامر الوكيل الخاصة بالبرمجة من OpenAI. وعلى عكس Claude Code، لا يتطلب Codex مفتاح API داخل Verdent — فهو يستخدم المصادقة المهيّأة مسبقاً في بيئة Codex المحلية لديك.

المتطلبات الأساسية

تثبيت واجهة سطر الأوامر Codex (يجب أن يكون codex متاحاً على PATH الخاص بك)
مصادقة واجهة سطر الأوامر Codex وقابليتها للاستخدام في المحطة الطرفية لديك

خطوات الإعداد

افتح إعدادات CLI Agents

انتقل إلى Settings → Models → CLI Agents.

أضف Codex إذا لم يكن موجوداً

إذا لم تكن بطاقة Codex ظاهرة، حدد Add CLI Agent. يفحص Verdent نظامك PATH بحثاً عن الأمر codex.

فعّل Codex

شغّل مفتاح Codex.

اختر النماذج

يكشف Verdent النماذج المتاحة تلقائياً. اختر النماذج التي تريد استخدامها.

اكتشاف النماذج

تُكتشف نماذج Codex ديناميكياً. بعد تشغيل Codex، يجلب Verdent النماذج المتاحة عبر API الخاصة به /models. إذا أُضيفت نماذج جديدة من جانب Codex، حدد Refresh Models لتحديث القائمة.

المصادقة

لا يتولى Verdent إدارة مصادقة Codex. يعتمد Codex على بيئة الصدفة المحلية لديك (وغالباً OPENAI_API_KEY أو تدفق تسجيل الدخول المدمج فيه). ما دام codex يعمل في المحطة الطرفية لديك، فإن التكامل يعمل.

Claude Code

Claude Code هو الوكيل الأغنى بالميزات في BYOA ويدعم عدة مزوّدين. يمكنك الاتصال بـ Anthropic وOpenRouter وZhipu GLM وغيرها، والتبديل بينها في محدد النموذج.

المتطلبات الأساسية

تثبيت Node.js (يلزم فقط npx)

يشغّل Verdent Claude Code عبر:

npx -y @agentclientprotocol/claude-agent-acp

لا يلزم أي تثبيت عام.

خطوات الإعداد

افتح إعدادات CLI Agents

انتقل إلى Settings → Models → CLI Agents.

أضف Claude Code إذا لم يكن موجوداً

إذا لم تكن بطاقة Claude Code ظاهرة، حدد Add CLI Agent. يكتشف Verdent npx.

فعّل Claude Code

شغّل مفتاح Claude Code.

أضف مزوّداً

حدد Add provider واختر مزوّداً (على سبيل المثال، Anthropic).

أدخل بيانات الاعتماد

أدخل مفتاح API. تُملأ القيم الافتراضية تلقائياً.

اختبر واحفظ

اختياريّاً، حدد Test Connection، ثم حدد Save.

بعد الحفظ، تظهر النماذج التابعة للمزوّد في قائمة النماذج. تُحدَّد النماذج المفعّلة افتراضياً، لكن يمكن تبديلها يدوياً.

المزوّدون المدعومون

يدعم Claude Code عدة مزوّدين. يمكنك تهيئة عدة مزوّدين في الوقت نفسه، وتظهر جميع النماذج في المحدد.

Anthropic

API الرسمية من Anthropic لنماذج Claude.

المصادقة: مفتاح API
عنوان URL الأساسي: https://api.anthropic.com
النماذج: Opus / Sonnet / Haiku
المفتاح: platform.claude.com/settings/keys

OpenRouter

وصول API موحّد إلى عدة مزوّدي نماذج.

المصادقة: رمز
عنوان URL الأساسي: https://openrouter.ai/api
النماذج: Opus / Sonnet / Haiku
المفتاح: openrouter.ai/workspaces/default/keys

يمكنك تجاوز Role Models للتوجيه إلى نماذج OpenRouter أخرى (على سبيل المثال، google/gemini-2.5-pro).

Zhipu GLM (الصين)

عنوان URL الأساسي: https://open.bigmodel.cn/api/anthropic
النموذج: GLM-5
المفتاح: bigmodel.cn/usercenter/proj-mgmt/apikeys
الوثائق: docs.bigmodel.cn

Zhipu GLM (عالمي)

عنوان URL الأساسي: https://api.z.ai/api/anthropic
النموذج: GLM-5
المفتاح: z.ai/manage-apikey/apikey-list
الوثائق: docs.z.ai

Kimi

عنوان URL الأساسي: https://api.kimi.com/coding/
النموذج: Kimi K2.5
المفتاح: kimi.com/code/console
الوثائق: kimi.com/code/docs

Moonshot

عنوان URL الأساسي: https://api.moonshot.cn/anthropic
النموذج: Kimi K2.5
المفتاح: platform.moonshot.cn/console/api-keys
الوثائق: platform.moonshot.cn/docs

يوفّر كلٌّ من Kimi وMoonshot نموذج Kimi K2.5، لكنهما يستخدمان نقاط نهاية ومصادقة مختلفة. اختر بناءً على مصدر مفتاحك.

MiniMax (الصين)

عنوان URL الأساسي: https://api.minimaxi.com/anthropic
النموذج: MiniMax-M2.7
المفتاح: platform.minimaxi.com
الوثائق: platform.minimaxi.com/docs

MiniMax (عالمي)

عنوان URL الأساسي: https://api.minimax.io/anthropic
النموذج: MiniMax-M2.7
المفتاح: platform.minimax.io
الوثائق: platform.minimax.io/docs

Xiaomi MiMo

عنوان URL الأساسي: https://api.xiaomimimo.com/anthropic
النموذج: MiMo V2 Pro
المفتاح: platform.xiaomimimo.com
الوثائق: platform.xiaomimimo.com/docs

Xiaomi MiMo (خطة الرموز)

عنوان URL الأساسي: https://token-plan-cn.xiaomimimo.com/anthropic
النموذج: MiMo V2 Pro
المفتاح: platform.xiaomimimo.com
الوثائق: platform.xiaomimimo.com/docs

متوافق مع Anthropic (نقطة نهاية مخصّصة)

لأي خدمة متوافقة مع تنسيق API الخاص بـ Anthropic.

المصادقة: مفتاح API أو رمز (قابل للتبديل)
عنوان URL الأساسي: يُهيّأ يدوياً
النماذج: تُحدَّد يدوياً

استخدم هذا الخيار إذا لم يكن مزوّدك مذكوراً في القائمة لكنه يدعم API متوافقة مع Anthropic.

خيارات متقدّمة

في لوحة تهيئة المزوّد، وسّع Advanced Options للوصول إلى محرر JSON:

تعيين Role Models:
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
متغيرات بيئة مخصّصة (على سبيل المثال، API_TIMEOUT_MS)

لا يحتاج معظم المستخدمين إلى تعديل هذه الخيارات — تعمل القيم الافتراضية جيداً من دون تغيير.

استخدام نماذج BYOA في Manager

بعد التهيئة:

عطّل وضع Auto

أوقف تشغيل وضع Auto في مربع إدخال المحادثة.

افتح Task Model

افتح القائمة المنسدلة Task Model.

اختر نموذج BYOA

اختر أي نموذج BYOA مفعّل. ستعمل مهام Worker باستخدام هذا النموذج.

تظهر النماذج على النحو التالي:

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

يعرض التمرير بالماوس تفاصيل مثل مصدر واجهة سطر الأوامر واسم النموذج والمزوّد.

الأمان والخصوصية

التخزين المحلي فقط: تُخزَّن مفاتيح API محلياً ولا تُرفَع مطلقاً.
مفاتيح Claude Code: تُخزَّن بأمان، ولا تُكتب في ملفات تهيئة نصية عادية.
مصادقة Codex: تُدار بالكامل من قبل بيئتك المحلية؛ لا يصل Verdent إلى مفاتيح OpenAI.