<!-- Canonical URL: https://ask.atlascloud.ai/ar/integrate-hermes-agent-atlascloud -->

# كيف يتم دمج Hermes Agent مع Atlas Cloud؟

> قم بتوصيل وكيل Hermes بـ Atlas Cloud عن طريق تخزين مفتاح Atlas Cloud في ~/.hermes/.env، واختيار المزود: مخصص، وتعيين عنوان URL الأساسي إلى https://api.atlascloud.ai/v1، واختيار معرف نموذج مباشر من /v1/models.

يمكن لوكيل Hermes استخدام [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) كمزود استدلال مخصص متوافق مع OpenAI. يتطلب التكامل ثلاثة أشياء: مفتاح API من Atlas Cloud، وعنوان URL الأساسي `https://api.atlascloud.ai/v1`، و[معرّف نموذج من قائمة نماذج Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). بمجرد وضع هذه العناصر في تكوين `model:` الحالي لوكيل Hermes، يمكن للوكيل العمل عبر Atlas Cloud دون الحاجة إلى SDK خاص بالمزود.

> **النقاط الأساسية**
>
> * قم بتثبيت وكيل Hermes باستخدام المثبت الرسمي، ثم احتفظ بمفتاح Atlas Cloud في `~/.hermes/.env` بدلاً من وضعه في نظام التحكم بالمصادر.
> * قم بتكوين وكيل Hermes باستخدام `provider: custom` و `base_url: https://api.atlascloud.ai/v1`.
> * استعلم عن `/v1/models` قبل اختيار النموذج. تتغير أسماء النماذج أسرع من كود التكامل، لذا فإن الاستجابة المباشرة أكثر أمانًا من نسخ معرّف قديم من دليل تعليمي.
> * قم بتشغيل `hermes doctor` قبل بدء تشغيل وكيل طويل الأمد، ثم استخدم `hermes` لاختبار المحادثة الأولى.
> * تجعل واجهة API الموحدة من Atlas Cloud من الممكن تغيير نموذج اللغة لاحقًا دون إعادة بناء تكامل Hermes.

## ما هما وكيل Hermes و Atlas Cloud؟

[وكيل Hermes](https://github.com/NousResearch/hermes-agent) هو وكيل مفتوح المصدر يتطور ذاتيًا، تم بناؤه بواسطة Nous Research. يتضمن واجهة طرفية، وذاكرة دائمة، ومهارات، وأتمتة مجدولة، وبوابات مراسلة، ودعمًا لمزودي استدلال متعددين. تؤكد وثائق وكيل Hermes الحالية على إمكانية تغيير النماذج دون إعادة كتابة الوكيل.

[المنصة الرئيسية لـ Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) توفّر مئات نماذج اللغة والصور والفيديو والصوت من خلال واجهة API موحدة. بالنسبة لوكيل Hermes، الجزء المهم هو سطح الاستدلال المتوافق مع OpenAI: يمكن لـ Hermes التعامل مع Atlas Cloud كمزود مخصص وإرسال حركة مرور عادية لإتمام المحادثة إليه.

يكون هذا الاقتران مفيدًا عندما تريد أن يظل وكيل Hermes مستقلاً عن بائع نموذج واحد. يظل تكوين الوكيل مستقرًا، بينما يمكن أن يتغير نموذج Atlas Cloud المحدد مع تغير المتطلبات أو الأسعار أو التوفر.

## قبل البدء

ستحتاج إلى:

1. بيئة Linux أو macOS أو WSL2 أو Windows مدعومة.
2. تثبيت عامل وكيل Hermes يعمل.
3. حساب ومفتاح API من Atlas Cloud.
4. رصيد كافٍ في Atlas Cloud أو وصول إلى الحساب للنموذج الذي تختاره.

لا تقم بلصق مفتاح API حقيقي في مستودع عام أو مشكلة أو لقطة شاشة أو ملف تكوين مشترك. يدعم وكيل Hermes ملف `.env` محليًا خصيصًا بحيث يمكن أن تظل الأسرار منفصلة عن التكوين العادي.

## الخطوة 1: تثبيت وكيل Hermes

على Linux أو macOS أو WSL2، استخدم المثبت الذي نشرته Nous Research:

```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

أعد تحميل الصدفة بعد التثبيت:

```bash
source ~/.zshrc
```

إذا كنت تستخدم Bash، فأعد تحميل `~/.bashrc` بدلاً من ذلك. ثم تأكد من أن واجهة سطر الأوامر متاحة:

```bash
hermes --help
```

يدعم المشروع الرسمي أيضًا Windows الأصلي من خلال مثبت PowerShell الخاص به. اتبع [وثائق تثبيت وكيل Hermes](https://hermes-agent.nousresearch.com/docs/) الحالية بدلاً من ترجمة أمر Unix إلى PowerShell بنفسك.

## الخطوة 2: إنشاء مفتاح API لـ Atlas Cloud

سجل الدخول إلى وحدة تحكم Atlas Cloud وأنشئ مفتاح API لنشر وكيل Hermes هذا. استخدم مفتاحًا مخصصًا عندما تسمح عناصر التحكم في حسابك بذلك؛ فصل حركة مرور الوكيل يسهل التدوير والمراجعة لاحقًا.

قم بتخزين المفتاح في ملف البيئة المحلي لوكيل Hermes:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'استبدل-هذا-بمفتاح-أطلس-كلاود-الخاص-بك' >> ~/.hermes/.env
```

استبدل العنصر النائب محليًا. لا تقم بتضمين المفتاح الحقيقي في `config.yaml` إذا كان هذا الملف سيتم نسخه احتياطيًا أو مزامنته أو إرساله.

لماذا استخدام `OPENAI_API_KEY`؟ مسار المزود المخصص الحالي لوكيل Hermes يحل متغير البيئة هذا عند تكوين عنوان URL أساسي صريح متوافق مع OpenAI. يستخدم Atlas Cloud مصادقة رمز الحامل على تلك الواجهة المتوافقة.

## الخطوة 3: الحصول على معرّف نموذج حي من Atlas Cloud

لا تخمن معرّف النموذج. تحقق من [قائمة نماذج Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new)، ثم اسأل API عن الكتالوج الحالي:

```bash
export ATLASCLOUD_API_KEY='استبدل-هذا-بمفتاح-أطلس-كلاود-الخاص-بك'

curl https://api.atlascloud.ai/v1/models \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
```

اختر نموذج نصي يدعم السلوك الذي يحتاجه نشر Hermes الخاص بك، خاصة استخدام الأدوات والاستدلال وطول السياق وزمن الوصول المتوقع. انسخ `id` الدقيق الذي يعيده API.

بالنسبة لوكيل دائم، ابدأ بنموذج عام قادر على استخدام الأدوات بدلاً من التحسين فقط لأرخص سعر رمز. بعد أن يعمل التكامل، يمكنك اختبار نماذج أقل تكلفة للتلخيص أو المهام الروتينية الأخرى.

## الخطوة 4: توجيه وكيل Hermes إلى Atlas Cloud

افتح `~/.hermes/config.yaml` وقم بتكوين قسم `model:` الحالي على المستوى الأعلى:

```yaml
model:
  default: "استبدل-هذا-بمعرّف-نموذج-حي-من-أطلس-كلاود"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

احتفظ بالمفتاح في `~/.hermes/.env`؛ ملف YAML يحتاج فقط إلى المزود ونقطة النهاية ومعرّف النموذج.

هذه التفاصيل مهمة لأن أمثلة وكيل Hermes الأقدم قد تستخدم كتلة `inference:`. يستخدم نموذج التكوين الرسمي الحالي `model:`. إذا كان إصدارك المثبت يتصرف بشكل مختلف، فقم بتشغيل `hermes update` وتحقق من وثائق التكوين المرفقة بهذا الإصدار قبل تغيير المزيد من الإعدادات.

## الخطوة 5: تشخيص التكوين

قم بتشغيل الفحوصات المضمنة في وكيل Hermes:

```bash
hermes doctor
```

ثم ابدأ الوكيل:

```bash
hermes
```

أرسل طلب اختبار صغير لا يحتاج إلى أدوات خارجية، مثل:

```text
أجب باسم النموذج الذي تستخدمه، ثم لخص الأدوات المتاحة في جلسة Hermes هذه.
```

تؤكد الاستجابة المتدفقة العادية أن Hermes يمكنه المصادقة والوصول إلى نقطة نهاية Atlas Cloud واستدعاء النموذج المكوّن.

## مشاكل التكامل الشائعة

### أخطاء المصادقة

تأكد من أن `OPENAI_API_KEY` موجود في `~/.hermes/.env`، ويحتوي على مفتاح Atlas Cloud بدون علامات اقتباس أو مسافات إضافية، ويتم تحميله بواسطة تثبيت Hermes الذي تستخدمه. قم بتدوير المفتاح إذا تم كشفه.

### أخطاء نموذج غير معروف

اتصل بـ `https://api.atlascloud.ai/v1/models` مرة أخرى وانسخ المعرّف الحي الدقيق. لا تقم بإزالة بادئة المزود أو تقصير المعرف ما لم يستخدم استجابة API نفسها النموذج الأقصر.

### Hermes يستدعي المزود الخطأ

تأكد من أن التكوين النشط يحتوي على كليهما:

```yaml
provider: "custom"
base_url: "https://api.atlascloud.ai/v1"
```

يمكن أن يؤدي اختيار مزود مدمج إلى توجيه الطلب إلى نقطة نهاية ذلك المزود بدلاً من Atlas Cloud.

### التكوين يطابق دليلًا تعليميًا قديمًا ولكنه يفشل

يتطور وكيل Hermes بسرعة. قارن ملفك بـ [مرجع التكوين الرسمي](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) الحالي واستخدم `hermes config get` لفحص الملف الشخصي النشط. على وجه الخصوص، تحقق مما إذا كان إصدارك يتوقع بنية `model:` الحالية.

## كيفية تغيير النماذج دون إعادة بناء التكامل

بمجرد تكوين Atlas Cloud كمزود مخصص، يتطلب تبديل النماذج فقط معرّفًا جديدًا من [كتالوج النماذج الحي](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new):

1. استعلم عن `/v1/models`.
2. حدّث `model.default` في `~/.hermes/config.yaml`.
3. قم بتشغيل `hermes doctor`.
4. ابدأ محادثة اختبارية جديدة.

تظل نقطة النهاية ومعالجة بيانات الاعتماد كما هي. هذه هي القيمة العملية لواجهة API موحدة للوكيل: يصبح تقييم النموذج تغيير تكوين بدلاً من تكامل SDK جديد.

## متى يكون هذا الإعداد مناسبًا؟

يكون تكامل Atlas Cloud مناسبًا بشدة عندما:

* تريد أن يصل وكيل Hermes إلى عائلات نماذج متعددة من خلال حساب واحد.
* تتوقع قياس أداء النموذج الرئيسي أو استبداله بمرور الوقت.
* تريد نقطة نهاية متوافقة مع OpenAI بدلاً من كود عميل خاص بالمزود.
* قد تحتاج مهارات Hermes المستقبلية إلى الوصول إلى نماذج الصور أو الفيديو من نفس المنصة.

قد يكون التكامل المباشر مع مزود النموذج أبسط إذا كان الوكيل سيستخدم مزودًا واحدًا بشكل دائم ولا تحتاج إلى كتالوج النماذج الأوسع لـ Atlas Cloud. يعتمد الاختيار الصحيح على ما إذا كانت المرونة والوصول المركزي أكثر أهمية من وجود إعداد أقصر مزود واحد ممكن.

## قائمة التحقق النهائية

قبل ترك وكيل Hermes يعمل دون مراقبة، تحقق من جميع العناصر الخمسة:

- تم تخزين مفتاح Atlas Cloud خارج نظام التحكم بالمصادر.
- تم تعيين `provider` على `custom`.
- `base_url` هو بالضبط `https://api.atlascloud.ai/v1`.
- `model.default` يطابق معرّفًا من نقطة نهاية النماذج الحية.
- `hermes doctor` ومحادثة بسيطة كلاهما ناجح.

مع اكتمال هذه الفحوصات، يتم دمج وكيل Hermes مع Atlas Cloud. يمكنك الآن تقييم نماذج لغة مختلفة خلف نفس الوكيل دون تغيير أدواته أو ذاكرته أو مهاراته أو واجهة المستخدم.

## FAQ

### هل يحتوي وكيل Hermes على مزود Atlas Cloud مدمج؟

لا يتطلب الأمر وجود مزود مخصص لـ Atlas Cloud. يمكن لـ Hermes Agent الاتصال من خلال مزوده المخصص المتوافق مع OpenAI باستخدام الرابط الأساسي لـ Atlas Cloud ومفتاح API.

### ما هو الرابط الأساسي لـ Atlas Cloud لـ Hermes Agent؟

استخدم https://api.atlascloud.ai/v1 كعنوان URL الأساسي المتوافق مع OpenAI.

### أين يجب تخزين مفتاح API الخاص بـ Atlas Cloud؟

قم بتخزينه في ~/.hermes/.env باسم OPENAI_API_KEY واحتفظ بالمفتاح الحقيقي بعيدًا عن ملفات التكوين ولقطات الشاشة والتحكم في الإصدارات.

### ما هو نموذج Atlas Cloud الذي يجب أن يستخدمه Hermes Agent؟

استعلم عن https://api.atlascloud.ai/v1/models واختر نموذجًا نصيًا حاليًا يلبي متطلباتك من حيث استخدام الأدوات، والاستدلال، والسياق، وزمن الاستجابة، والتكلفة.

### كيف يمكنني التحقق من التكامل؟

شغّل hermes doctor، ابدأ Hermes باستخدام الأمر hermes، وأرسل طلب اختبار صغير. عادةً ما تشير أخطاء المصادقة أو النموذج غير المعروف إلى مفتاح API أو عنوان URL الأساسي أو معرف النموذج.