Google Chat — الذكاء الاصطناعي في Google Workspace

تخيّل أن مساعدك الذكي يحصل أخيرًا على مقعد في طاولة المكتب—داخل Google Chat تحديدًا، حيث يتحدث فريقك طوال اليوم.

هذا بالضبط ما يقدّمه Hermes Agent. بدلًا من إعداد خادم ويب عام، أو نفق، أو التعامل مع شهادات TLS، يمكنك ربط بوتك بـ Google Chat بنفس الطريقة التي توصّل بها سماعات الرأس: إنه يعمل فورًا. يستمع Hermes عبر اشتراك خاص، وعندما يراسل أحدهم البوت، يرد عبر REST API الخاص بـ Chat. لا منافذ مكشوفة، لا قواعد جدار حماية، لا ذعر في منتصف الليل بسبب “لماذا رابطي معطّل؟”.

ما ستحتاجه

مشروع Google Cloud (الخطة المجانية كافية)
حساب Google Workspace (شخصي أو عمل، مع صلاحيات إدارية)
حوالي 15 دقيقة

الخطوة 1: إنشاء مشروع Google Cloud

اذهب إلى console.cloud.google.com وأنشئ مشروعًا. دوّن معرّف المشروع—ستستخدمه في كل مكان. اعتبره عنوان منزل البوت.

الخطوة 2: تفعيل واجهتين برمجيتين

في APIs & Services ← Library، فعّل:

Google Chat API
Cloud Pub/Sub API

كلاهما مجاني لحركة مرور البوتات الشخصية. اضغط، فعّل، انتهى الأمر.

الخطوة 3: إنشاء حساب خدمة (بطاقة هوية البوت)

اذهب إلى IAM & Admin ← Service Accounts ← Create Service Account. سمّه hermes-chat-bot. تخطَّ صلاحيات مستوى المشروع—لست بحاجة إليها.

ثم أنشئ مفتاح JSON وحمّله. خزّنه في مكان آمن:

mkdir -p ~/.hermes
mv ~/Downloads/hermes-chat-bot-key.json ~/.hermes/google-chat-sa.json
chmod 600 ~/.hermes/google-chat-sa.json

خطأ شائع: البحث عن دور IAM باسم “Chat Bot Caller”. هذا الدور غير موجود. صلاحية البوت تأتي من إضافته إلى مساحة، وليس من أدوار IAM. لا تُعقّد الأمور.

الخطوة 4: إنشاء موضوع Pub/Sub والاشتراك

في Pub/Sub ← Topics ← Create topic، استخدم hermes-chat-events كمعرّف الموضوع. ثم أنشئ اشتراك سحب:

معرّف الاشتراك: hermes-chat-events-sub
نوع التسليم: Pull
الاحتفاظ بالرسائل: 7 أيام

هذا الاشتراك هو المكان الذي تُسقط فيه Google Chat الرسائل الواردة. يسحب Hermes منها، مثل تفقّد صندوق البريد.

الخطوة 5: ربط Hermes Agent

الآن يأتي السحر. شغّل:

hermes gateway setup

اختر Google Chat، وسيرشدك المعالج خلال الباقي. سيطلب منك معرّف مشروعك، واسم الاشتراك، ومسار ملف JSON لحساب الخدمة. هذا كل شيء.

النتيجة

أصبح لديك الآن بوت ذكاء اصطناعي داخل Google Chat. يمكن لفريقك مناداته بـ @، وطرح الأسئلة، وتشغيل الأتمتة، أو تفويض المهام—كل ذلك دون مغادرة نافذة المحادثة. لا أنفاق، لا عنوان IP عام، لا تجديد شهادات.

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

يحوّل Hermes Agent Google Chat إلى مركز قيادة لسير عمل الذكاء الاصطناعي لديك. الإعداد بسيط عن قصد: حساب خدمة للهوية، واشتراك للاستماع، وREST API للرد.

نصيحة عملية: بعد إنهاء الإعداد، اختبر البوت برسالة مباشرة واحدة قبل إضافته إلى مساحة جماعية. إذا ردّ، فأنت في المأمن. إذا لم يرد، تحقق من أن حساب الخدمة لديه دور roles/pubsub.subscriber على الاشتراك—هذا هو السبب الأول للصمت.

الآن اذهب وامنح فريقك زميلًا ذكيًا يحضر الاجتماعات فعلًا.