كيفية تشغيل Hermes Agent باستخدام DeepSeek API من Atlas Cloud

لقد قمت بتثبيت Hermes Agent، الوكيل المستقل مفتوح المصدر من Nous Research، والآن تحتاج إلى نموذج خلفه يكون رخيصًا بما يكفي لتركه يعمل طوال اليوم وقويًا بما يكفي للتعامل مع استدعاءات الأدوات الحقيقية. DeepSeek V4 هو خيار واضح من حيث التكلفة، وتخدم Atlas Cloud عائلة DeepSeek من خلال نقطة نهاية واحدة متوافقة مع OpenAI جنبًا إلى جنب مع أكثر من 300 نموذج آخر. يرشدك هذا الدليل خلال ربط Hermes Agent بـ DeepSeek على Atlas Cloud، من عنوان URL الأساسي ومعرفات النموذج إلى config.yaml عامل، بحيث يعمل الوكيل على بنية تحتية جاهزة للإنتاج دون الحاجة إلى SDK ثانٍ.

ما الذي تقوم بتوصيله

Hermes Agent هو وكيل مستمر ذاتي التحسين يعمل على الخادم الخاص بك. إنه مصمم ليكون محايدًا للنموذج والمزود، لذلك لا يهمه ما إذا كانت رموز DeepSeek تأتي مباشرة من DeepSeek أو عبر بوابة، طالما أن نقطة النهاية تتحدث شكل OpenAI API.

Atlas Cloud هي منصة استدلال AI كاملة النماذج تعرض نماذج النصوص والصور والفيديو من خلال مفتاح API واحد متوافق مع OpenAI وحساب فوترة واحد. نظرًا لأن السطح متوافق مع OpenAI، فإن توصيل Hermes هو تغيير في عنوان URL الأساسي والمفتاح، وليس إعادة كتابة.

هذا الاقتران مهم لوكيل مستمر. تم بناء Hermes ليعمل لأسابيع في كل مرة، ويجمع الذاكرة والمهارات القابلة لإعادة الاستخدام، لذلك فإن النموذج الذي يقف وراءه هو تكلفة متكررة بدلاً من استدعاء لمرة واحدة. يحافظ DeepSeek V4 على هذه التكلفة المتكررة منخفضة دون التخلي عن جودة استدعاء الأدوات، وتوجيهه عبر Atlas Cloud يعني أن نفس المفتاح الذي يجيب على دور الدردشة يمكنه لاحقًا إنشاء صورة أو مقطع فيديو عندما تتطلب مهارة ذلك. أنت لا تختار نموذجًا رخيصًا فحسب، بل تختار نقطة نهاية لن يتجاوزها الوكيل.

هناك حقيقتان تحددان الإعداد بأكمله، وكلاهما يستحق الحصول عليهما بشكل صحيح تمامًا قبل أن تلمس ملف التكوين:

• عنوان URL الأساسي لـ Atlas Cloud هو https://api.atlascloud.ai/v1.
• تحمل معرفات نموذج DeepSeek على Atlas Cloud البادئة deepseek-ai/، على سبيل المثال deepseek-ai/deepseek-v4-pro. هذا يختلف عن deepseek-v4-pro المجرد الذي يستخدمه Hermes مع مزود DeepSeek المدمج، والذي يشير إلى نقطة نهاية DeepSeek الخاصة. عند التوجيه عبر Atlas Cloud، تستخدم المعرف الكامل المسبوق ومزودًا مخصصًا متوافقًا مع OpenAI، وليس المدمج.

الخطوة 1: احصل على مفتاح Atlas Cloud API الخاص بك

سجل الدخول إلى console.atlascloud.ai، افتح API Keys، انقر فوق Create API Key، وانسخه في مكان آمن. الوصول هو الدفع حسب الاستخدام، لذلك لا يوجد إيداع ولا حد أدنى للإنفاق. تقوم بالتسجيل، وتحصل على مفتاح، وتدفع لكل طلب.

احتفظ بالمفتاح خارج التحكم في الإصدار. يفصل Hermes الأسرار عن الإعدادات عن قصد: يحتوي config.yaml على بنية غير حساسة وهو آمن للالتزام أو المشاركة، بينما يحتوي ~/.hermes/.env على المفاتيح ويتم تجاهله بواسطة git افتراضيًا. وضع مفتاح Atlas Cloud في .env والإشارة إليه بالاسم من التكوين هو ما يسمح لك بإصدار إعداد وكيلك دون تسريب بيانات الاعتماد.

textCopy
1echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env

الخطوة 2: تأكيد معرفات نموذج DeepSeek التي يمكنك استدعاؤها

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

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

الاستعلام عن القائمة أولاً ليس عملاً روتينيًا. تتغير معرفات النموذج مع شحن الإصدارات الجديدة، والمعرف القديم من منشور مدونة أو برنامج نصي قديم هو السبب الأكثر شيوعًا لفشل الاستدعاء الأول. نقطة النهاية /v1/models هي الحقيقة المطلقة لما ستقبله واجهة برمجة التطبيقات اليوم، لذا فإن التحقق منها قبل تحرير التكوين يوفر جولة من أخطاء النموذج غير المعروف. إدخالات DeepSeek التي ستستخدمها غالبًا هي هذه:

يبلغ سعر DeepSeek V4 Pro 1.68 دولارًا لكل مليون رمز إدخال و 3.38 دولارًا لكل مليون رمز إخراج على Atlas Cloud، بينما يبلغ سعر V4 Flash 0.14 دولارًا للإدخال و 0.28 دولارًا للإخراج. هذه الفجوة هي السبب الرئيسي لتقسيم العمل الرئيسي والمساعد بين الاثنين، وهو ما يفعله التكوين أدناه.

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

نظرًا لأن Atlas Cloud هي نقطة نهاية مخصصة متوافقة مع OpenAI بدلاً من مزود DeepSeek المدمج في Hermes، فإنك تحددها صراحة في ~/.hermes/config.yaml. يحدد كتلة المزود عنوان URL الأساسي ومتغير البيئة الذي يحتوي على مفتاحك، وتحدد كتلة النموذج معرف DeepSeek المسبوق.

textCopy
1inference:
2  provider: atlascloud
3  base_url: https://api.atlascloud.ai/v1
4  api_key_env: ATLASCLOUD_API_KEY
5  model:
6    default: deepseek-ai/deepseek-v4-pro

احفظ الملف، ثم ابدأ الوكيل.

textCopy
1hermes

إذا أعادت الرسالة الأولى ردًا عاديًا، فإن التوصيل صحيح. إذا تلقيت خطأ في المصادقة، فإن المفتاح في .env خاطئ أو لم يتم تحميله؛ إذا تلقيت خطأ في النموذج غير المعروف، أعد التحقق من البادئة deepseek-ai/ مقابل إخراج /v1/models من الخطوة 2.

الخطأ الأكثر شيوعًا هنا هو الوصول إلى مزود deepseek المدمج في Hermes مع توقع أن تجيب Atlas Cloud. المزود المدمج موصل بشكل مباشر بنقطة نهاية DeepSeek الخاصة وأسماء نماذجها المجردة، لذلك سيقوم بفوترة حساب DeepSeek الخاص بك بسعادة ويتجاهل Atlas Cloud تمامًا. التوجيه عبر Atlas Cloud هو اختيار متعمد لمزود مخصص: base_url الخاص بك، ومفتاح Atlas Cloud الخاص بك، ومعرفات النموذج deepseek-ai/ المسبوقة. حافظ على هذه الثلاثة معًا ولن تختلط المساران أبدًا.

الخطوة 4: أرسل عملًا رخيصًا إلى Flash

يقوم Hermes بالكثير من الاستدعاءات منخفضة القيمة خلف الكواليس: تلخيص الويب، تحليل الرؤية، ضغط السياق، الموافقة على الأوامر. دفع أسعار V4 Pro لهذه المهام هو إهدار. وجه الفتحات المساعدة إلى V4 Flash بحيث تحافظ الحلقة الرئيسية على النموذج الأقوى بينما تعمل المهام الخلفية بجزء صغير من التكلفة.

textCopy
1auxiliary:
2  web_extract:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7  compression:
8    provider: atlascloud
9    base_url: https://api.atlascloud.ai/v1
10    api_key_env: ATLASCLOUD_API_KEY
11    model: deepseek-ai/deepseek-v4-flash
12    timeout: 120

تقبل كل فتحة مساعدة مزودها الخاص، ونموذجها، وعنوان URL الأساسي، والمفتاح، وسلسلة الاحتياطي، بحيث يمكنك ضبط كل مهمة خلفية بشكل مستقل.

الخطوة 5: أضف احتياطيًا للمرونة

سيصل الوكيل طويل الأمد في النهاية إلى حد معدل أو اتصال انتهت مهلته. تحافظ سلسلة الاحتياطي على عمله بدلاً من إظهار الأخطاء. هنا تحاول مهمة الضغط V4 Flash أولاً، ثم تعود إلى نموذج Atlas Cloud ثانٍ قبل الاستسلام.

textCopy
1auxiliary:
2  compression:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7    fallback_chain:
8      - provider: atlascloud
9        base_url: https://api.atlascloud.ai/v1
10        api_key_env: ATLASCLOUD_API_KEY
11        model: deepseek-ai/deepseek-v3.2

يحاول Hermes كل إدخال بالترتيب حتى ينجح أحدهم، لذلك فإن تعثر مزود واحد لا يعطل الوكيل. بالنسبة لوكيل يعمل دون مراقبة وفقًا لجدول زمني، هذا هو الفرق بين وظيفة cron التي تتعافى بهدوء وتلك التي تموت في الساعة 3 صباحًا وتترك لك تتبعًا للمكدس في الصباح.

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

يعد تشغيل Hermes على DeepSeek عبر Atlas Cloud منطقيًا عندما تريد مفتاحًا واحدًا وفاتورة واحدة عبر كل ما يلمسه الوكيل. نظرًا لأن نفس نقطة النهاية تخدم أيضًا نماذج الصور والفيديو، يمكن لوكيل يبدأ بالنص فقط لاحقًا إنشاء صور أو مقاطع دون تكامل جديد أو حساب بائع ثانٍ. إذا كان وكيلك سيستدعي DeepSeek فقط ولا شيء آخر، فإن مزود DeepSeek المدمج الذي يشير إلى واجهة برمجة تطبيقات DeepSeek الخاصة هو المسار الأبسط. يكتسب مسار Atlas Cloud مكانه بمجرد أن ترغب في إضافة نماذج عبر الوسائط المتعددة خلف سطح واحد متوافق مع OpenAI.

يمكنك تأكيد كل معرف نموذج وسعر مباشر بنفسك على atlascloud.ai/models قبل الالتزام بأي من هذا في ملف التكوين، وهي العادة التي تستحق الحفاظ عليها مع تطور تشكيلة DeepSeek.