الاتصال بـ Google Vertex AI

فكّر في Google Vertex AI على أنه “صالة رجال الأعمال” لنماذج Gemini من Google — نفس النماذج الرائعة، لكن مع مزايا خاصة بالمؤسسات مثل أسعار ثابتة، وفوترة عبر حسابك في Google Cloud، وبدون مفاجآت مزعجة بخصوص حدود الاستخدام.

لماذا لا نستخدم مفتاح API عاديًا فقط؟

إذا كنت قد استخدمت مزودي خدمات ذكاء اصطناعي آخرين، فأنت معتاد على نسخ مفتاح API ثابت في ملف الإعدادات. لكن Vertex لا يعمل بهذه الطريقة. بدلاً من مفتاح لا يتغير أبدًا، يستخدم Vertex رموز OAuth2 قصيرة العمر — مثل بطاقة صعود إلى الطائرة تنتهي صلاحيتها بعد حوالي ساعة.

الخبر الجيد؟ يتولى Hermes Agent عملية إنشاء هذه الرموز وتجديدها تلقائيًا. أنت لا تلمس أي رمز أبدًا. وهذا أيضًا هو السبب في أنك لا تستطيع مجرد لصق رمز مؤقت في حقل api_key لمزود مخصص — لأنه سينتهي في منتصف المحادثة ويكسر جلستك.

ما الذي ستحتاجه (المتطلبات الأساسية)

• مشروع Google Cloud مع تفعيل Vertex AI API وتفعيل الفوترة
• أحد أنواع بيانات الاعتماد التالية:
  • ملف مفتاح حساب الخدمة JSON (موصى به للخوادم)
  • بيانات الاعتماد الافتراضية للتطبيق (ADC) عبر gcloud auth application-default login (ممتاز للتطوير المحلي)

هذا كل شيء. سيقوم Hermes بتثبيت google-auth تلقائيًا في أول مرة تختار فيها Vertex.

بدء سريع: خياران

الخيار أ — ملف JSON لحساب الخدمة (للخوادم/البوابات)

فقط أضف سطرًا واحدًا إلى ملف ~/.hermes/.env:

echo "VERTEX_CREDENTIALS_PATH=/path/to/service-account.json" >> ~/.hermes/.env

الخيار ب — بيانات الاعتماد الافتراضية للتطبيق (للتطوير المحلي)

شغّل هذا في الطرفية:

gcloud auth application-default login

ثم اختر Vertex كمزود خدمة:

hermes model

اختر “More providers…” ← “Google Vertex AI” ← أدخل معرف مشروع GCP الخاص بك (أو اتركه فارغًا لاستخدام المعرف الموجود في بيانات الاعتماد) ← اختر منطقة (الافتراضي: global) ← حدد نموذج Gemini.

أخيرًا، ابدأ الدردشة:

hermes chat

أين توجد الإعدادات (شرح مبسط)

يقسم Hermes إعدادات Vertex إلى ملفين بناءً على درجة الحساسية:

~/.hermes/.env — يحتوي على المؤشر السري (المسار إلى بيانات الاعتماد):

# استخدم واحدًا من هذه (يتم التحقق بالترتيب التالي)؛ احذفهما معًا لاستخدام ADC:
VERTEX_CREDENTIALS_PATH=/path/to/service-account.json
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

~/.hermes/config.yaml — يحتوي على إعدادات التوجيه غير السرية (معرف المشروع والمنطقة):

model:
  default: google/gemini-...

ملخص ونصيحة عملية

يمنحك Vertex AI موثوقية بمستوى المؤسسات مع نماذج Gemini، ويتولى Hermes تجديد رموز OAuth2 المعقدة تلقائيًا. كل ما عليك فعله هو توجيه Hermes إلى بيانات الاعتماد مرة واحدة، وستكون جاهزًا.

نصيحة احترافية: إذا كنت تشغّل Hermes على خادم أو بوابة، استخدم دائمًا طريقة ملف JSON لحساب الخدمة (الخيار أ) — فهي أكثر أمانًا ويمكن التنبؤ بها من ADC. وإذا واجهت أي مشكلة، شغّل hermes setup لإصلاح التثبيت المُدار إذا فشل التثبيت البطيء لـ google-auth. بناءً سعيدًا!

---