الاتصال بـ Google Gemini

فكّر في Hermes Agent كجهاز تحكم عن بُعد شامل—يمكنه التحكم في العديد من خدمات الذكاء الاصطناعي، واليوم سنقوم بربطه مع Google Gemini، نموذج الذكاء الاصطناعي القوي من جوجل.

لماذا نستخدم Gemini مع Hermes؟

Gemini سريع وذكي ورائع في التعامل مع النصوص والصور وحتى الفيديوهات. من خلال ربطه مع Hermes، تحصل على وكيل ذكاء اصطناعي يمكنه تصفح الويب واستخدام الأدوات وتذكّر السياق عبر المحادثات الطويلة—كل ذلك مدعوم بعقل Gemini.

أفضل جزء؟ Hermes يتحدث مع Gemini باستخدام لغة Gemini الأصلية (API)، وليس عبر طبقة ترجمة. هذا يعني استدعاء أدوات أكثر سلاسة، وبثًا أفضل، ومشاكل أقل عندما يحتاج وكيلك إلى تنفيذ مهام معقدة.

ما الذي ستحتاجه

قبل أن نبدأ، جهّز هذه الأشياء الثلاثة:

1. مفتاح API من Google AI Studio – احصل عليه مجانًا من aistudio.google.com/apikey
2. مشروع Google Cloud مع تفعيل الفوترة – موصى به، لأن الخطة المجانية صغيرة جدًا لجلسات الوكيل الطويلة
3. تثبيت Hermes – لا حاجة لحزم إضافية!

الخطوة 1: أضف مفتاح API الخاص بك

افتح الطرفية وأضف مفتاحك إلى ملف البيئة الخاص بـ Hermes:

echo "GOOGLE_API_KEY=your_api_key_here" >> ~/.hermes/.env

Hermes يتحقق من كل من GOOGLE_API_KEY و GEMINI_API_KEY، لذا أي منهما يعمل.

الخطوة 2: اختر Gemini كمزود الخدمة

شغّل هذا الأمر لفتح منتقي النماذج:

hermes model

ثم اتبع هذه الخطوات:

• اختر “More providers…”
• حدد “Google AI Studio”
• سيتحقق Hermes من مفتاحك ويعرض نماذج Gemini المتاحة
• اختر نموذجًا (مثل gemini-3-flash-preview)

الخطوة 3: ابدأ المحادثة

بمجرد الاختيار، شغّل فقط:

hermes chat

هذا كل شيء! أنت الآن تتحدث مع Gemini عبر Hermes.

ماذا يحدث خلف الكواليس؟

إذا ألقيت نظرة على ملف الإعدادات الخاص بك (~/.hermes/config.yaml)، سترى شيئًا مثل:

model:
  default: gemini-3-flash-preview
  provider: gemini
  base_url: https://generativelanguage.googleapis.com/v1beta

هذا يخبر Hermes باستخدام نقطة نهاية Gemini الأصلية. Hermes يترجم رسائله الداخلية إلى صيغة Gemini تلقائيًا—لذا لا داعي للقلق بشأن التفاصيل التقنية.

ملاحظة سريعة حول نقاط النهاية

تقدم جوجل أيضًا نقطة نهاية متوافقة مع OpenAI. لكن بالنسبة لـ Hermes، فضل دائمًا النقطة الأصلية (https://generativelanguage.googleapis.com/v1beta). المحوّل الأصلي يمنحك استدعاء أدوات أفضل، وبثًا أفضل، ودعمًا للبيانات الوصفية—أشياء تجعل وكيلك يعمل بشكل موثوق.

إذا كنت قد عيّنت سابقًا GEMINI_BASE_URL إلى رابط /openai، غيّره مرة أخرى:

GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta

الخلاصة

ربط Gemini مع Hermes يستغرق أقل من دقيقة:

1. أضف مفتاح API الخاص بك إلى ~/.hermes/.env
2. شغّل hermes model واختر Google AI Studio
3. اختر نموذجًا وابدأ المحادثة

نصيحة عملية: ابدأ بالخطة المجانية لاختبار الأمور، لكن انتقل إلى مشروع مع تفعيل الفوترة بمجرد تشغيل مهام وكيل حقيقية. الخطة المجانية من Gemini تنفد بسرعة عندما يقوم وكيلك باستدعاءات متعددة في كل جولة—ستشكر نفسك لاحقًا!

---