# كيفية تشغيل Hermes Agent باستخدام DeepSeek API من Atlas Cloud > دليل خطوة بخطوة لتشغيل Hermes Agent مفتوح المصدر على نماذج DeepSeek V4 من خلال واجهة برمجة تطبيقات Atlas Cloud المتوافقة مع OpenAI، مع أمثلة التكوين والتسعير. لقد قمت بتثبيت Hermes Agent، الوكيل المستقل مفتوح المصدر من Nous Research، والآن تحتاج إلى نموذج خلفه يكون رخيصًا بما يكفي لتركه يعمل طوال اليوم وقويًا بما يكفي للتعامل مع استدعاءات الأدوات الحقيقية. [DeepSeek](https://www.atlascloud.ai/models/list/llm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=run-hermes-agent-deepseek-api-atlascloud) 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` والإشارة إليه بالاسم من التكوين هو ما يسمح لك بإصدار إعداد وكيلك دون تسريب بيانات الاعتماد. ``` echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env ``` ## الخطوة 2: تأكيد معرفات نموذج DeepSeek التي يمكنك استدعاؤها تنشر Atlas Cloud قائمة النماذج الحية الخاصة بها في نقطة نهاية عامة، لذلك لا تضطر أبدًا إلى تخمين معرف. يعيد استدعاء سريع السلاسل الدقيقة التي تقبلها واجهة برمجة التطبيقات. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` الاستعلام عن القائمة أولاً ليس عملاً روتينيًا. تتغير معرفات النموذج مع شحن الإصدارات الجديدة، والمعرف القديم من منشور مدونة أو برنامج نصي قديم هو السبب الأكثر شيوعًا لفشل الاستدعاء الأول. نقطة النهاية `/v1/models` هي الحقيقة المطلقة لما ستقبله واجهة برمجة التطبيقات اليوم، لذا فإن التحقق منها قبل تحرير التكوين يوفر جولة من أخطاء النموذج غير المعروف. إدخالات DeepSeek التي ستستخدمها غالبًا هي هذه: | معرف النموذج | الأفضل لـ | نافذة السياق | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | حلقة الوكيل الرئيسية، الترميز، استدعاءات الأدوات | 1 مليون رمز | | `deepseek-ai/deepseek-v4-flash` | المهام المساعدة، الإنتاجية العالية | 1 مليون رمز | | `deepseek-ai/deepseek-v3.2` | الدردشة العامة الحساسة للتكلفة | 163 ألف رمز | يبلغ سعر 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 المسبوق. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` احفظ الملف، ثم ابدأ الوكيل. ``` hermes ``` إذا أعادت الرسالة الأولى ردًا عاديًا، فإن التوصيل صحيح. إذا تلقيت خطأ في المصادقة، فإن المفتاح في `.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 بحيث تحافظ الحلقة الرئيسية على النموذج الأقوى بينما تعمل المهام الخلفية بجزء صغير من التكلفة. ``` auxiliary: web_extract: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash timeout: 120 ``` تقبل كل فتحة مساعدة مزودها الخاص، ونموذجها، وعنوان URL الأساسي، والمفتاح، وسلسلة الاحتياطي، بحيث يمكنك ضبط كل مهمة خلفية بشكل مستقل. ## الخطوة 5: أضف احتياطيًا للمرونة سيصل الوكيل طويل الأمد في النهاية إلى حد معدل أو اتصال انتهت مهلته. تحافظ سلسلة الاحتياطي على عمله بدلاً من إظهار الأخطاء. هنا تحاول مهمة الضغط V4 Flash أولاً، ثم تعود إلى نموذج Atlas Cloud ثانٍ قبل الاستسلام. ``` auxiliary: compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash fallback_chain: - provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v3.2 ``` يحاول Hermes كل إدخال بالترتيب حتى ينجح أحدهم، لذلك فإن تعثر مزود واحد لا يعطل الوكيل. بالنسبة لوكيل يعمل دون مراقبة وفقًا لجدول زمني، هذا هو الفرق بين وظيفة cron التي تتعافى بهدوء وتلك التي تموت في الساعة 3 صباحًا وتترك لك تتبعًا للمكدس في الصباح. ## متى يكون هذا الإعداد مناسبًا يعد تشغيل Hermes على DeepSeek عبر Atlas Cloud منطقيًا عندما تريد مفتاحًا واحدًا وفاتورة واحدة عبر كل ما يلمسه الوكيل. نظرًا لأن نفس نقطة النهاية تخدم أيضًا نماذج الصور والفيديو، يمكن لوكيل يبدأ بالنص فقط لاحقًا إنشاء صور أو مقاطع دون تكامل جديد أو حساب بائع ثانٍ. إذا كان وكيلك سيستدعي DeepSeek فقط ولا شيء آخر، فإن مزود DeepSeek المدمج الذي يشير إلى واجهة برمجة تطبيقات DeepSeek الخاصة هو المسار الأبسط. يكتسب مسار Atlas Cloud مكانه بمجرد أن ترغب في إضافة نماذج عبر الوسائط المتعددة خلف سطح واحد متوافق مع OpenAI. يمكنك تأكيد كل معرف نموذج وسعر مباشر بنفسك على atlascloud.ai/models قبل الالتزام بأي من هذا في ملف التكوين، وهي العادة التي تستحق الحفاظ عليها مع تطور تشكيلة DeepSeek. للحصول على إرشادات التنفيذ ذات الصلة، راجع [التبديل من تطبيق متوافق مع OpenAI إلى نماذج لغوية كبيرة أخرى](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) و [تقييم واجهة برمجة تطبيقات الاستدلال بالذكاء الاصطناعي للإنتاج](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).