gwscli: كل أدوات Google Workspace في واجهة سطر أوامر واحدة مخصصة للوكلاء البرمجيين (مع Claude Code)

BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00أصبحت Google Workspace الآن أفضل بكثير بالنسبة لعملاء الذكاء الاصطناعي لأنهم أطلقوا
00:00:04أداة CLI قوية تتيح لعميلك التفاعل مع أي واجهة برمجة تطبيقات لـ Google Workspace.
00:00:09سواء قراءة الملفات من Drive، إرسال رسائل البريد الإلكتروني، وحتى إنشاء العروض التقديمية، وكل ذلك مبني من الصفر
00:00:14لأجل عملاء الذكاء الاصطناعي، مما يعني أنها تستهلك أقل قدر ممكن من الرموز (tokens) وتنشئ الأوامر ديناميكياً
00:00:19أثناء التشغيل لضمان تحديث واجهات البرمجية دائماً. ولكن الآن مع قيام شركة كبرى مثل Google
00:00:24بإنشاء CLI لما كان سابقاً، ولا يزال، خادم MCP، فماذا يعني ذلك
00:00:29لمستقبل MCP؟ اضغط على زر الاشتراك ولنكتشف ذلك.
00:00:33في الشهر الماضي، نشرت فيديو حول قيام Playwright بإنشاء CLI لما كان سابقاً خادم MCP.
00:00:42والآن يبدو أن Google Workspace قامت بالشيء نفسه، والناس على تويتر يتفاعلون بجنون مع الخبر.
00:00:46إنها أداة CLI بناها “جاستن” الذي كتب مقالاً يشرح فيه كل ما فعله
00:00:52لجعلها مخصصة للعملاء تحديداً، وهو ما سنتحدث عنه لاحقاً. لكنها تحتوي على أكثر من 100
00:00:57مهارة يمكنك تحميلها من skills SH، وهو ما جعل “g-man” سعيداً جداً بالطبع.
00:01:01ولكن قبل أن نتعمق في قدراتها، نحتاج إلى المرور بعملية الإعداد لأننا كما نعلم جميعاً
00:01:06عن أدوات Google Cloud، فإن الأمر ليس بهذه البساطة. دعوني أريكم.
00:01:10أولاً، والأهم من ذلك، ستحتاج إلى الوصول إلى لوحة تحكم Google Cloud. يمكنك إنشاء
00:01:15مشروع جديد أو استخدام مشروع موجود. أنا أنشأت واحداً جديداً. ثم ستحتاج لتثبيت gcloud CLI،
00:01:21والذي يمكنك القيام به عبر brew إذا كنت تستخدم الماك. ومع تثبيت Google Workspace CLI،
00:01:26سيتعين عليك تشغيل هذا الأمر للمرور بعملية الإعداد، وهي واضحة تماماً.
00:01:31استخدم بريدك للمصادقة، اختر مشروع GCP أو أنشئ واحداً، ثم اختر واجهات البرمجية التي تريد
00:01:37الوصول إليها. وبمجرد الانتهاء من هذه المرحلة، سيتعين عليك الذهاب إلى بيانات اعتماد الخدمات
00:01:42وإنشاء معرف عميل auth جديد، والذي أعتقد أنه يمكن أن يكون لأي نوع تطبيق. اخترت “ويب”،
00:01:48ولكنني متأكد أنه سيعمل مع سطح المكتب لأن كل ما تحتاجه هو معرف العميل والأسرار.
00:01:53بعد ذلك، تأتي المرحلة التالية حيث تصبح الأمور معقدة قليلاً، فبعد
00:01:57تشغيل هذا الأمر، سيتعين عليك اختيار نطاق المصادقة. لهذا العرض التوضيحي، اخترت كل شيء،
00:02:02وهو أمر غير مثالي، لكنني كنت أختبر واجهة البرمجية فقط. ثم ستحصل على رابط URL ضخم للمصادقة في
00:02:08متصفحك. أولاً، تأكد من عدم وجود أخطاء مطبعية فيه لأنك قد
00:02:12تواجه بعض الأخطاء، لكن عليك تدوين رقم المنفذ (port) بعد localhost، وهو في حالتي 51065.
00:02:18وبالعودة إلى لوحة سحابة جوجل، انقر على شاشة موافقة OAuth،
00:02:23ثم انقر على العملاء، واختر عملاء الويب الخاص بك. وهنا في الأسفل حيث مكتوب روابط إعادة التوجيه
00:02:28المصرح بها، قم بتغييرها إلى رقم المنفذ هذا. أي 51065، ولم ننتهِ تماماً بعد.
00:02:33اذهب إلى الجمهور، وانزل للأسفل وأضف بريدك الإلكتروني هنا إذا لم يكن موجوداً بالفعل.
00:02:37الآن، إذا كان لديك تطبيق منشور بالفعل، فلن تواجه هذه المشكلة،
00:02:40ولكن بما أنني أختبر واجهة البرمجية فقط، فأنا أستخدمها في وضع الاختبار.
00:02:44لذا أحتاج لإضافة بريدي وبريد جميع المستخدمين الذين أريدهم أن يستخدموا CLI هنا.
00:02:48بعد الانتهاء من ذلك، يمكنك نسخ هذا الرابط واتباع الخطوات لتهيئة الـ CLI.
00:02:52وبمجرد الانتهاء، يجب أن تظهر لك حالة “نجاح”. إذا لم تظهر لك هذه الشاشة،
00:02:56فانتظر بضع ثوانٍ وحاول مجدداً، لأن تسجيل رابط إعادة التوجيه يستغرق بعض الوقت.
00:03:01هذه العملية برمتها، أي مجرد الإعداد، استغرقت مني أطول وقت لفهمها،
00:03:06مما يظهر أنني لا أستخدم أدوات Google Cloud كثيراً، ولكن بمجرد الانتهاء،
00:03:11يجب أن ترى تفاصيلك هنا، مما يعني أن المتعة الحقيقية قد بدأت. انظروا لهذا.
00:03:15سأبدأ بأمر بسيط وأطلب من Claude تزويدي بمعلومات عن آخر 10 رسائل بريد إلكتروني وصلتني.
00:03:19آمل ألا يكون هناك شيء حساس هناك. وبإستخدام GWS CLI،
00:03:24أعطاني معلومات عن كل بريد متضمنة المرسل والموضوع والتاريخ والتصنيفات.
00:03:28ويمكننا أن نرى أنه لأداء هذه المهمة، استهلك فقط 9% من السياق الإجمالي لمجرد
00:03:33عدم وجود أدوات MCP هنا. معظم السياق استُهلك في الرسائل. حسناً، دعونا نجرب
00:03:38شيئاً آخر. سأطلب من Claude كتابة مسودة بريد إلكتروني بموضوع “أنا أحب Claude” ومحتوى
00:03:44عبارة عن قصيدة لطيفة. مجدداً، يستخدم GWS CLI، ويكتب بعض كود Python باستخدام bash. والآن بعد انتهائه،
00:03:50نرى أن لدي مسودة بريد جديدة هنا كتبها Claude. دعوني أقرب الصورة قليلاً. إنها تحتوي
00:03:56على بريد وقصيدة تعبر عن مدى حبي لـ Claude. هناك شيء مثير للاهتمام حقاً في
00:04:00الطريقة التي يستخدم بها Claude أداة GWS CLI. إذا نظرنا إلى الأوامر التي نفذها سابقاً،
00:04:05يمكننا أن نرى هنا وجود الكثير من الأوامر الفرعية وهناك علامة params مع JSON بداخلها.
00:04:11المثير للاهتمام هو أنني لو أردت كبشر القيام بالشيء نفسه
00:04:16عبر كتابة gws help للاطلاع على كل الأوامر الفرعية، فلن أحصل عليها جميعاً. سأحصل على القليل فقط.
00:04:23وإذا أردت التعمق في أمر محدد، سيتعين علي استخدام help للحصول على معلومات
00:04:28أكثر وتكرار ذلك مراراً وتكراراً. لكن العميل الذكي قادر على الحصول
00:04:32على هذه المعلومات بسرعة كبيرة. حتى أنه يعرف البارامترات الدقيقة للحصول على البيانات الصحيحة،
00:04:37أعني انظروا لهذا. كتبت الطلب هنا، فاستخدم help مرة واحدة واستطاع فهم
00:04:43كل هذا من تلك المرة فقط. سندخل في تفاصيل أكثر حول كيفية قيامه بذلك،
00:04:48ولكن يمكننا أن نرى هنا أن قسم المساعدة في CLI يوضح الاستخدام ويذكر الخدمة
00:04:53والمصدر والمصدر الفرعي. يمكننا رؤية “الخدمة” بالأسفل هنا. وإذا أردت مزيداً من المعلومات،
00:04:57يمكننا أيضاً النظر في gws schema مع الخدمة والمصدر والطريقة. حسناً، لنجرب شيئاً
00:05:03أخيراً. سأطلب من Claude إنشاء مستند عروض تقديمية جديد يحتوي على شريحة واحدة بها
00:05:08عنوان “قطط Claude” وأربع شرائح أخرى تحتوي على صور قطط. مجدداً، يستخدم gws CLI طالباً
00:05:15المساعدة، ثم يتعمق في مساعدة أوامر الشرائح والعروض. والآن انتهى من إعداد
00:05:20عرضنا التقديمي. لنلقهِ نظرة عليه في المتصفح. ها هو ذا. ترون أنني قمت سابقاً
00:05:24باختبار “كلاب Claude”، لكن لنجرب هذا. لدينا العنوان “قطط Claude” مع عنوان فرعي،
00:05:30مجموعة لطيفة من خمس شرائح تحتوي على صور قطط. هذا رائع حقاً. وقد
00:05:36استهلكنا 15% فقط من السياق. لذا يمكننا الاستمرار والقيام بأشياء مختلفة. مثل هنا،
00:05:42أنشأت مستند جداول بيانات Google يحتوي على تعداد سكان كل ولاية أمريكية مع
00:05:47الإجمالي في الأسفل، بل وجدولت أحداثاً في تقويمي. لعلك لاحظت أنني فعلت كل هذا
00:05:52دون تثبيت أي مهارات خاصة بـ Google Workspace، لكن المشروع يحتوي بالفعل على الكثير
00:05:58من المهارات المتاحة التي تضم مساعدين، وشخصيات، ووصفات لإجراءات أكثر تعقيداً مثل حجز
00:06:05وقت للتركيز وإعادة جدولة اجتماع. فكيف جعل “جاستن” هذا يعمل بهذا الإتقان؟ أولاً،
00:06:10أعطى الأولوية لـ JSON المتداخل، وهو صعب القراءة للبشر، لكنه أسهل بكثير للعملاء البرمجيين. كما
00:06:16جعل التوثيق قابلاً للاستعلام في وقت التشغيل، وهو ما مررنا به سابقاً، لكن قسم المخطط (schema)
00:06:21هنا يضمن أنه في حال حدوث تحديث أو إدخال العميل لبارامتر خاطئ،
00:06:26فإنه سيعرف تماماً أين يذهب للتحقق من الصحيح دون أي ارتباك. كما أن
00:06:31البارامترات أو الحقول يمكن استخدامها لتقليل كمية المعلومات العائدة من واجهة البرمجية.
00:06:36لذا يمكن للعميل حصر المعلومات في ما يحتاجه فقط بدلاً من الحصول على معلومات إضافية
00:06:42لا يحتاجها، مما يقلل من استهلاك الرموز (tokens). وبالطبع يستخدم مهارات لتقديم
00:06:47توجيهات خاصة بالعميل الذكي، والتي لم أستخدمها في العرض، لكنها توفر معلومات أكثر مما
00:06:53يمكن للعميل الحصول عليه عبر علامة help. إذاً، من الواضح أن خوادم MCP انتهت والمهارات و CLI هي المستقبل،
00:06:59صحيح؟ حسناً، ليس تماماً، لأنه مع MCP، يمكن للعميل استدعاء الدوال مباشرة
00:07:06بدلاً من الاضطرار لبناء أوامر shell وتمرير JSON، وهو ما تفعله CLI. أدوات MCP
00:07:11أفضل أيضاً لربط الخطوات المعقدة. وبالطبع لست بحاجة إلى طرفية (terminal) لتشغيلها،
00:07:16ولهذا السبب يوفر Google Workspace CLI خيار MCP. ومع ذلك، تستهلك الـ CLIs رموزاً أقل بكثير،
00:07:24حتى مع تفعيل أداة البحث عن الأدوات. كما أنها محمولة، أي يمكنها العمل مع أي بيئة
00:07:28للعملاء أو حتى بدونها إذا كنت لا ترغب في استخدام واحدة. ومن السهل إعادة إنتاج
00:07:34الأوامر بشكل مستقل لتصحيح الأخطاء. لذا أعتقد أن الأمر يعتمد حقاً على حالة الاستخدام، لكن واجهتني
00:07:40بعض المشاكل عند استخدام CLI، مثل احتواء الروابط المنشأة على أخطاء مطبعية، ولا أدري حقاً كيف
00:07:47حدث ذلك. كما أن موضوع رابط إعادة التوجيه ومنفذ localhost استغرق مني وقتاً لفهمه. لست
00:07:52متأكداً إن كان هذا خاصاً بأدوات Google Cloud أم بـ CLI فقط، لكنه لم يكن ممتعاً. وواجهت أيضاً
00:07:59مشكلة في عدم تحديث الرموز بشكل صحيح لدرجة أنني أنشأت بلاغاً (issue) على GitHub. حسناً،
00:08:05في الواقع Claude هو من كتبه لي، أنا لم أكتب أي شيء، ولكن بالنسبة لمشروع عمره أقل من
00:08:10أسبوع ولديه أكثر من 10 آلاف نجمة على GitHub، فمن الواضح أن أمامه مستقبلاً واعداً.
00:08:16وبالحديث عن المستقبل الواعد، إذا أردت يوماً إنشاء تطبيق Electron مدعوم بـ bun،
00:08:21لتحصل على السرعة وحجم الحزمة الصغير، فراجع الفيديو الذي صنعته حول
00:08:26Electrobahn والذي يوضح لك كيفية استخدامه لمشروع Vite بسيط.

Key Takeaway

تعد أداة gwscli نقلة نوعية في تمكين وكلاء الذكاء الاصطناعي من إدارة بيئة Google Workspace بكفاءة عالية واستهلاك منخفض للموارد، مما يفتح آفاقاً جديدة للأتمتة البرمجية.

Highlights

إطلاق أداة gwscli القوية التي تمكن وكلاء الذكاء الاصطناعي من التفاعل مع كافة خدمات Google Workspace عبر سطر الأوامر.

تصميم الأداة يركز على كفاءة استهلاك الرموز (tokens) من خلال إنشاء الأوامر ديناميكياً وتقليل البيانات غير الضرورية.

القدرة على تنفيذ مهام معقدة مثل قراءة البريد الإلكتروني، إنشاء مسودات، وبناء عروض تقديمية كاملة باستخدام نماذج مثل Claude.

توفير أكثر من 100 مهارة جاهزة للاستخدام تتيح أتمتة إجراءات متقدمة مثل جدولة الاجتماعات وحجز أوقات التركيز.

المقارنة بين نهج CLI ونهج بروتوكول سياق النموذج (MCP)، مع توضيح مزايا المحمولية وقلة التكاليف في واجهة سطر الأوامر.

تحقيق المشروع لانتشار واسع بأكثر من 10 آلاف نجمة على GitHub في أقل من أسبوع رغم وجود بعض التحديات التقنية في الإعداد.

Timeline

مقدمة عن gwscli ومستقبل وكلاء الذكاء الاصطناعي

يبدأ الفيديو باستعراض أداة Google Workspace CLI الجديدة المصممة خصيصاً لتسهيل تفاعل عملاء الذكاء الاصطناعي مع واجهات برمجة تطبيقات جوجل. يوضح المتحدث أن هذه الأداة تتيح وظائف شاملة مثل قراءة ملفات Drive وإرسال البريد الإلكتروني مع التركيز على تقليل استهلاك الرموز (tokens). يشير التقرير إلى أن الأداة تعتمد على بناء الأوامر ديناميكياً لضمان التوافق الدائم مع التحديثات البرمجية المستمرة من جوجل. يتساءل المذيع عن تأثير هذا التوجه على مستقبل بروتوكول MCP بعد تبني شركات كبرى مثل جوجل لنهج CLI. يختتم هذا القسم بالإشارة إلى الحماس الكبير على منصات التواصل الاجتماعي ووجود مهارات متعددة متاحة للتحميل عبر موقع skills.sh.

دليل الإعداد التقني وخطوات المصادقة المعقدة

ينتقل المتحدث لشرح عملية الإعداد التي يصفها بالمعقدة نظراً لطبيعة أدوات Google Cloud التي تتطلب دقة عالية. تبدأ الخطوات بإنشاء مشروع في لوحة تحكم Google Cloud وتثبيت gcloud CLI عبر برمجية brew لمستخدمي الماك. يركز الشرح على ضرورة إعداد معرف عميل OAuth وتحديد نطاقات المصادقة (scopes) المناسبة للوصول إلى البيانات المطلوبة. تبرز صعوبة خاصة في التعامل مع روابط إعادة التوجيه ومنفذ localhost الذي يجب مطابقته بدقة في إعدادات شاشة موافقة OAuth. يؤكد المتحدث على أهمية إضافة البريد الإلكتروني للمستخدمين في وضع الاختبار لضمان نجاح عملية التهيئة والحصول على حالة "نجاح" النهائية.

تجارب عملية: إدارة البريد وإنشاء المسودات بواسطة Claude

يستعرض هذا الجزء قدرات الأداة الفعلية من خلال طلب معلومات من نموذج Claude حول آخر عشر رسائل بريد إلكتروني واردة. تظهر النتائج قدرة gwscli على استخراج بيانات المرسل والموضوع والتاريخ بكفاءة مع استهلاك 9% فقط من سياق النموذج. يقوم Claude بعد ذلك بإنشاء مسودة بريد إلكتروني تحتوي على قصيدة، مستخدماً أوامر bash وكود Python للتفاعل مع الواجهة البرمجية. يلاحظ المتحدث أن الوكيل الذكي يتفوق على البشر في فهم الأوامر الفرعية والمعاملات المعقدة (params) من خلال قراءة المخطط (schema) مرة واحدة. يوضح هذا القسم كيف يقلل استخدام gwscli من الحاجة للبحث المتكرر في ملفات المساعدة التقليدية بفضل هيكلة البيانات الموجهة للآلات.

إنشاء العروض التقديمية والأتمتة المتقدمة

يقدم الفيديو عرضاً مبهراً لإنشاء عرض تقديمي كامل حول موضوع "القطط" يتضمن شرائح وعناوين وصوراً تم جلبها آلياً. يوضح المتحدث أن العملية استهلكت 15% فقط من السياق، مما يسمح بتنفيذ مهام إضافية مثل إنشاء جداول بيانات لتعداد سكان الولايات الأمريكية. يتم تسليط الضوء على "المهارات" المدمجة التي تسمح بتنفيذ إجراءات مركبة مثل إعادة جدولة الاجتماعات دون الحاجة لبرمجة يدوية لكل خطوة. يشرح المطور "جاستن" كيف تم تحسين الأداة لتعطي الأولوية لبيانات JSON المتداخلة التي يسهل على النماذج البرمجية قراءتها وفهمها. تضمن هذه الهيكلة قدرة الوكيل على تصحيح مساره تلقائياً في حال إدخال معامل خاطئ عبر الرجوع للمخطط المحدث في وقت التشغيل.

مقارنة بين CLI وMCP والتقييم النهائي

يختتم المتحدث الفيديو بمقارنة تحليلية بين واجهة سطر الأوامر (CLI) وبروتوكول سياق النموذج (MCP) لتحديد الأنسب للاستخدام. يوضح أن MCP يتفوق في استدعاء الدوال مباشرة وربط الخطوات المعقدة دون الحاجة لطرفية، بينما تتميز CLI بالمحمولية العالية واستهلاك أقل للرموز. يشير التقرير إلى بعض العيوب التي واجهها المتحدث مثل الأخطاء المطبعية في الروابط المنشأة ومشكلات تحديث رموز الوصول (tokens). رغم هذه التحديات، يؤكد المتحدث أن المشروع يحظى بمستقبل واعد جداً نظراً لسرعة نموه واهتمام المطورين به على GitHub. ينتهي الفيديو بنصيحة للمشاهدين حول تطوير تطبيقات Electron واستخدام أدوات حديثة لتعزيز كفاءة مشاريعهم البرمجية.

Community Posts

View all posts