أدوات البرمجة

Hermes Agent

ربط Hermes Agent بـ TokenLab

استخدم TokenLab كمزود نموذج مسمى (named model provider) في Hermes مع الاحتفاظ بحساباتك الحالية وأذونات الأدوات الخاصة بك.

دع الوكيل الخاص بي يقوم بالإعداد

انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:

Read this guide and help me connect Hermes to TokenLab:
https://tokenlab.sh/docs/ar/integrations/hermes-agent
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

تثبيت أو التحقق من Hermes

اتبع دليل التثبيت الرسمي. يوفر الدليل برامج تثبيت لسطح المكتب لأنظمة Apple Silicon macOS وWindows، ومسار CLI لأنظمة Linux وWindows الأصلية. تحقق من المتطلبات الخاصة بنظامك؛ وتخطَّ التثبيت إذا كان Hermes مثبتاً بالفعل.

اختياري: إعداد قابل للعكس

استخدم مساعد Hermes المضمن في TokenLab Skills 0.1.3 لإصدار Hermes الرسمي 0.21.3. يقوم المساعد بمعاينة التغيير ونسخه احتياطياً، ويضيف مزوداً مسمى فقط، ويحافظ على تعليقات YAML والحسابات والنموذج الافتراضي والأذونات. اقرأ مرجع الإعداد أولاً.

قم بتعيين SKILL_DIR إلى مجلد tokenlab-api-integration المثبت، و HERMES_PYTHON إلى إصدار Python في تثبيت Hermes كما هو موضح بواسطة hermes --version: venv/bin/python على macOS/Linux أو venv\Scripts\python.exe على Windows. يستخدم PowerShell المتغيرين $SkillDir و $HermesPython. استخدم تلك البيئة الموجودة؛ المساعد لا يقوم بتثبيت حزم Python عالمية.

"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna
"$HERMES_PYTHON" "$SKILL_DIR/scripts/configure_hermes.py" --model gpt-5.6-luna --apply
& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna
& $HermesPython "$SkillDir/scripts/configure_hermes.py" --model gpt-5.6-luna --apply

بعد التطبيق، تخطَّ الدمج اليدوي أدناه. اتبع أوامر الصفحة الرئيسية والتحميل التي يطبعها المساعد؛ فهو يكتشف active_profile. فحص التكوين لا يتحقق من صحة المفتاح. قم بمعاينة الاستعادة باستخدام --restore ثم أضف --apply لاستعادة البايتات الأصلية. التعارضات، والتعديلات اللاحقة، والإعدادات المُدارة، وWSL توقف الإعداد التلقائي؛ احتفظ بتلك الإعدادات واستخدم المسار اليدوي.

تكوين مزود مسمى

ابحث عن دليل Hermes النشط: HERMES_HOME عند تعيينه، وإلا فاستخدم ~/.hermes (في Windows: %LOCALAPPDATA%\hermes). قم بنسخ config.yaml احتياطياً، ثم ادمج الإدخالات التالية دون استبدال الإعدادات الأخرى. يستخدم المثال Chat Completions؛ اختر نموذجاً حالياً يدعم هذا التنسيق واستدعاء الأدوات.

قم بنسخ التكوين النشط احتياطياً. أضف إدخال TokenLab فقط وحافظ على المزودين الحاليين، والحسابات، واختيار النموذج الافتراضي، والأذونات. إذا كان الاسم مستخدماً بالفعل، فاختر اسماً آخر وقم بتحديث الأوامر. للتراجع عن الإعداد، قم بإزالة الإدخال الذي أضفته فقط أو استعد نسخته الاحتياطية السابقة.

providers:
  tokenlab:
    api: https://api.tokenlab.sh/v1
    key_env: TOKENLAB_API_KEY
    transport: chat_completions
    default_model: gpt-5.6-luna

أنشئ مفتاحاً في API keys. أدخله محلياً كـ TOKENLAB_API_KEY في ملف .env الخاص بدليل Hermes أو في بيئة العملية التي تبدأ Hermes. لا تقم أبداً بلصق المفتاح في محادثة أو وضعه في ملف YAML الخاص بالمزود.

التحقق من التكوين، ثم إجراء طلب

تحقق من المزود المضاف باستخدام hermes config get providers.tokenlab.api؛ يجب أن يظهر https://api.tokenlab.sh/v1. حافظ على قسم model الحالي دون تغيير. ابدأ جلسة جديدة مع المزود والنموذج الصريح أدناه؛ ابدأ التشغيل بشكل طبيعي بدون هذه الأعلام لاستخدام افتراضياتك السابقة. فحص التكوين لا يتحقق من صحة المفتاح.

hermes chat --provider custom:tokenlab --model gpt-5.6-luna

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

الاستعادة أو استكشاف الأخطاء وإصلاحها

إذا كان المزود غير معروف، تحقق من الإصدار المثبت وتنسيق المزود الحالي. بالنسبة لأخطاء المصادقة، تحقق من البيئة المحلية وحالة المفتاح دون طباعة المفتاح. للتراجع عن الإعداد، استعد اختيار النموذج السابق وقم بإزالة إدخالات TokenLab التي أضفتها فقط.

إنشاء الصور والفيديو في نفس الوكيل

يمكن لـ Hermes أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. ادمج هذا الإدخال في نفس ملف config.yaml:

mcp_servers:
  tokenlab:
    command: "npx"
    args: ["-y", "@tokenlabai/mcp-server@0.6.48"]
    env:
      TOKENLAB_MCP_TOOL_PROFILE: "core"
      TOKENLAB_API_KEY: "<TOKENLAB_API_KEY>"

يقوم Hermes بتمرير env المدرج فقط إلى الخادم، لذا استبدل <TOKENLAB_API_KEY> بمفتاحك في هذا الملف المحلي ولا تشاركه. قم بتشغيل hermes mcp test tokenlab أو /reload-mcp في جلسة مفتوحة. ثم جرب:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

يعيد create_video معرف مهمة (task ID). يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً. يضيف دليل Skill إرشادات التكامل. لا يلزم وجود MCP أو Skills لاختيار هذا المزود.

في هذه الصفحة