# أحضر وكيلك الخاص (BYOA) (/ar/docs/verdent-manager/configuration/byoa)

> شغّل مهام Worker الخاصة بـ Manager على بيئات تشغيل الوكيل الخاصة بك مثل Codex أو Claude Code



## ما هو BYOA؟ [#ما-هو-byoa]

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

<Note>
  تبحث عن استخدام مفتاح API الخاص بمزوّدك مع وكلاء Verdent المدمجين بدلاً من ذلك؟ راجع [BYOK](/docs/verdent-manager/configuration/byok).
</Note>

## أنواع الوكلاء المدعومة [#أنواع-الوكلاء-المدعومة]

| الوكيل        | الوصف                                             | المتطلبات الأساسية                             |
| ------------- | ------------------------------------------------- | ---------------------------------------------- |
| الوكيل المدمج | الوكيل الافتراضي الذي يوفّره 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]

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

### المتطلبات الأساسية [#المتطلبات-الأساسية]

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

### خطوات الإعداد [#خطوات-الإعداد]

<Steps>
  <Step title="افتح إعدادات CLI Agents">
    انتقل إلى **Settings → Models → CLI Agents**.
  </Step>

  <Step title="أضف Codex إذا لم يكن موجوداً">
    إذا لم تكن بطاقة Codex ظاهرة، حدد **Add CLI Agent**. يفحص Verdent نظامك `PATH` بحثاً عن الأمر `codex`.
  </Step>

  <Step title="فعّل Codex">
    شغّل مفتاح **Codex**.
  </Step>

  <Step title="اختر النماذج">
    يكشف Verdent النماذج المتاحة تلقائياً. اختر النماذج التي تريد استخدامها.
  </Step>
</Steps>

### اكتشاف النماذج [#اكتشاف-النماذج]

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

### المصادقة [#المصادقة]

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

## Claude Code [#claude-code]

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

### المتطلبات الأساسية [#المتطلبات-الأساسية-1]

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

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

```bash
npx -y @agentclientprotocol/claude-agent-acp
```

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

### خطوات الإعداد [#خطوات-الإعداد-1]

<Steps>
  <Step title="افتح إعدادات CLI Agents">
    انتقل إلى **Settings → Models → CLI Agents**.
  </Step>

  <Step title="أضف Claude Code إذا لم يكن موجوداً">
    إذا لم تكن بطاقة Claude Code ظاهرة، حدد **Add CLI Agent**. يكتشف Verdent `npx`.
  </Step>

  <Step title="فعّل Claude Code">
    شغّل مفتاح **Claude Code**.
  </Step>

  <Step title="أضف مزوّداً">
    حدد **Add provider** واختر مزوّداً (على سبيل المثال، Anthropic).
  </Step>

  <Step title="أدخل بيانات الاعتماد">
    أدخل مفتاح API. تُملأ القيم الافتراضية تلقائياً.
  </Step>

  <Step title="اختبر واحفظ">
    اختياريّاً، حدد **Test Connection**، ثم حدد **Save**.
  </Step>
</Steps>

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

### المزوّدون المدعومون [#المزوّدون-المدعومون]

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

#### Anthropic [#anthropic]

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

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

#### OpenRouter [#openrouter]

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

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

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

#### Zhipu GLM (الصين) [#zhipu-glm-الصين]

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

#### Zhipu GLM (عالمي) [#zhipu-glm-عالمي]

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

#### Kimi [#kimi]

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

#### Moonshot [#moonshot]

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

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

#### MiniMax (الصين) [#minimax-الصين]

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

#### MiniMax (عالمي) [#minimax-عالمي]

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

#### Xiaomi MiMo [#xiaomi-mimo]

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

#### Xiaomi MiMo (خطة الرموز) [#xiaomi-mimo-خطة-الرموز]

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

#### متوافق مع Anthropic (نقطة نهاية مخصّصة) [#متوافق-مع-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 [#استخدام-نماذج-byoa-في-manager]

بعد التهيئة:

<Steps>
  <Step title="عطّل وضع Auto">
    أوقف تشغيل وضع **Auto** في مربع إدخال المحادثة.
  </Step>

  <Step title="افتح Task Model">
    افتح القائمة المنسدلة **Task Model**.
  </Step>

  <Step title="اختر نموذج BYOA">
    اختر أي نموذج BYOA مفعّل. ستعمل مهام Worker باستخدام هذا النموذج.
  </Step>
</Steps>

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

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

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

## الأمان والخصوصية [#الأمان-والخصوصية]

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

## الأسئلة الشائعة [#الأسئلة-الشائعة]

### لم يُكتشف CLI Agent؟ [#لم-يُكتشف-cli-agent]

تأكد من توفر الأوامر في `PATH`:

* يتطلب Claude Code وجود `npx` (تثبيت Node.js)
* يتطلب Codex تثبيت واجهة سطر الأوامر `codex`

نفّذ:

```bash
which npx
which codex
```

### فشل اختبار الاتصال؟ [#فشل-اختبار-الاتصال]

* تحقق من مفتاح API
* تحقق من عنوان URL الأساسي
* تأكد من إمكانية الوصول إلى الشبكة لنقطة نهاية API
* تحقق من تهيئة الوكيل الوسيط (proxy) إن وُجد

### أُضيف المزوّد لكن النماذج غير ظاهرة؟ [#أُضيف-المزوّد-لكن-النماذج-غير-ظاهرة]

* تأكد من تفعيل Claude Code
* تأكد من تفعيل نماذج المزوّد
* أعد تشغيل Verdent إذا لزم الأمر