"مساعد Google" ليس روبوت دردشة عاديًا. وهو نظام متخصص للتحكّم في المهام في هندسة الإعلانات المستندة إلى الذكاء الاصطناعي، تم إنشاؤه استنادًا إلى إطارات عمل الوكلاء Google Antigravity وClaude Code (الإصدار 4.0.0).
الصورة الكبيرة: حلّ المشاكل المتعلقة بالامتثال العالي
المشكلة الأساسية التي يحلّها هذا "المساعد" هي الحمل المعرفي الزائد والجهد التقني.
تُعدّ Google Ads API إحدى أقوى واجهات برمجة التطبيقات المتاحة، ولكنّها أيضًا من أكثرها تعقيدًا. تتضمّن هذه الواجهة ميزة التحكم الصارم في الإصدارات، ولغة طلبات فريدة (GAQL)، وبُنى Protocol Buffers متداخلة بشكل كبير، ومتطلبات أمان صارمة. يستغرق المطوّر عادةً نسبة كبيرة من وقته في التعامل مع واجهة برمجة التطبيقات من خلال تصحيح أخطاء gRPC، والبحث عن توافق الحقول، وإصلاح مشاكل المدقّق اللغوي بدلاً من إنشاء منطق النشاط التجاري الفعلي.
يحلّ "مساعد Google" هذه المشكلة في الإصدار 4.0.0 من خلال تقديم بنية إضافات معيارية تستند إلى مهارات متخصّصة ومختبَرة، بالإضافة إلى أوامر مدمجة تبدأ بعلامة الشرطة المائلة. يعمل هذا المكوّن كبرنامج وسيط آلي متخصص، ويتولّى المهام الشاقة المتعلقة بالتحقّق من صحة الإصدار واكتشاف المخطط وتدقيق الرموز البرمجية، ما يتيح للمطوّر العمل على مستوى الهدف بدلاً من مستوى البنية.
استنادًا إلى المخططات الرسمية، وليس التخمين
غالبًا ما تواجه النماذج اللغوية الكبيرة العادية صعوبة في التعامل مع واجهات برمجة التطبيقات الخاصة بمجالات معيّنة لأنّها تعتمد بشكل كامل على بيانات التدريب العامة التي تصبح قديمة بسرعة عند إصدار إصدارات جديدة من واجهات برمجة التطبيقات.
تعمل أداة "مساعد المطوّر" في Google Ads API على حلّ هذه المشكلة من خلال الجمع بين قواعد التصميم المضمّنة في Google Ads API والفحص الديناميكي لمخطط Protobuf المحلي:
- التحقّق من الصحة بشكل حاسم: بدلاً من الاعتماد على التخمين التكراري من خلال نماذج اللغات الكبيرة (LLM) عبر عدة رحلات ذهاب وإياب، ينفّذ المساعد عملية تحقّق محلية من 4 خطوات تتحقّق من توافق الحقول وعلاقات الموارد وقواعد عدم الظهور وتقسيم التواريخ في خطوة واحدة.
- عمليات بحث دقيقة عن المخططات حسب الإصدار: تفحص هذه الميزة تعريفات موارد Protobuf وأنواع البيانات وقيم التعداد مباشرةً من مخططات واجهة برمجة التطبيقات الرسمية لإصدار واجهة برمجة التطبيقات النشط، ما يمنع تكرار طلبات البحث عن البيانات الوصفية البعيدة.
- الاستناد إلى مكتبة العملاء الرسمية: يتم إنشاء الرموز البرمجية مباشرةً بالاستناد إلى مكتبات العملاء الرسمية في "إعلانات Google" على مستوى Python وJava وPHP و.NET وRuby.
التشبيه: مختبر الأبحاث والتشخيص المتخصّص
يمكن اعتبار المساعد بمثابة مختبر أبحاث عالي التقنية للجراح.
- الجراح (المطوّر): أنت تعرف بالضبط العملية التي يجب إجراؤها (على سبيل المثال، "أحتاج إلى تحليل أداء "حملات الأداء الأفضل"").
- معدات المختبر (واجهة برمجة التطبيقات): هذه هي الأدوات الفعّالة اللازمة لإجراء الجراحة، ولكنها معقّدة وتتطلب معايرة دقيقة.
- مساعد المختبر (هذه الأداة): قبل فحص المريض، يستخدم مساعد المختبر مهارات متخصصة وأوامر مدمجة لإجراء ما يلي:
- التحقّق من الأدلة: يتم تلقائيًا التحقّق من أحدث بروتوكولات واجهة برمجة التطبيقات وفحص بنى الموارد أثناء التنفيذ (
inspect_object//inspect-object). - الاختبار المُسبَق للأدوات: تنفِّذ هذه الميزة عمليات تجريبية حتمية على طلبات البحث باستخدام التحقّق المباشر من صحة واجهة برمجة التطبيقات (
validate_gaql//validate-gaql) لرصد الأخطاء قبل حدوثها. - تعقيم البيئة: ينسّق الرمز البرمجي وينظّفه باستخدام مسارات تدقيق صارمة (
ruffتدقيق) كي لا يتسبّب في حدوث أخطاء في النظام. - مراقبة المؤشرات الحيوية: تراقب هذه الميزة استثناءات واجهة برمجة التطبيقات وتنفّذ إجراءات متقدّمة لتشخيص العمليات المعقّدة، مثل الإحالات الناجحة غير الإلكترونية (
troubleshoot_conversions//troubleshoot-conversions). - شرح المفاهيم: يشرح هذا الخيار المفاهيم المعقّدة بلغة بسيطة
باستخدام تشبيهات من الحياة اليومية (
/explainو/step-by-stepو/assistant-tutorial).
- التحقّق من الأدلة: يتم تلقائيًا التحقّق من أحدث بروتوكولات واجهة برمجة التطبيقات وفحص بنى الموارد أثناء التنفيذ (
الترابط: جسر "السلامة أولاً"
يعمل "المساعد" كجسر يربط أربعة "عالم" مختلف ضمن مشروعك، وتتحكّم فيه عقود (AGENTS.md / CLAUDE.md):
- سياق المستخدم: يستمع إلى أهدافك العالية المستوى ويحوّلها إلى استراتيجية فنية.
- مساحة العمل المحلية: تتضمّن "عيونًا وأيديًا" في دليل مشروعك. يمكنه قراءة الرموز البرمجية الحالية وكتابة رموز برمجية جديدة لاستخدامها لاحقًا، مع الحفاظ على عزل صارم.
- واجهة برمجة التطبيقات Google Ads API: تتصل هذه الواجهة بواجهة برمجة التطبيقات النشطة لتشغيل تقارير للقراءة فقط واختبار طلبات البحث في حسابك. لإجراء عملية التحقّق الفوري من صحة الحقول، يفحص التطبيق مخططات Protobuf المحلية مباشرةً.
- حراس البوابة الأمنية: تم تصميمه خصيصًا ليتّبع بروتوكولات صارمة. لن يسمح لك بتشغيل نص برمجي إذا لم يتم تدقيقه، ولن يسمح لك بإرسال طلب بحث إذا لم يجتَز عملية التحقّق من صحة التنسيق آليًا.
المهام التي ينفّذها "مساعد Google"
ببساطة، المساعد هو وسيلة الحماية والتسريع.
- تجنُّب الأخطاء: تتحقّق هذه الأداة من صحة الرموز البرمجية وطلبات البحث مقارنةً بمخططات واجهة برمجة التطبيقات النشطة قبل تنفيذها، ما يمنع حدوث أخطاء في البنية والتوافق قبل أن تصل إلى واجهة برمجة التطبيقات المباشرة.
- معرفة الخريطة: يفهم هذا النظام الجغرافيا الخاصة بواجهة Google Ads API، أي مكان تخزين البيانات وكيفية طلبها بكفاءة.
- أتمتة المهام المملّة: يكتب هذا البرنامج رمزًا معياريًا لمكتبة العميل، وينسّق التقارير في جداول طرفية منظَّمة، ويتعامل مع تفاصيل مكتبة العميل.
- تحديد المشاكل في سير العمل المعقّد وحلّها: يجري هذا الحلّ عمليات تشخيص مفصّلة لعمليات تحميل الإحالات الناجحة غير الإلكترونية، ويحلّ تسلسلات الحسابات في "مركز عملائي"، ويضبط بنى الحملات المعقّدة، مثل فلاتر بيانات "حملات الأداء الأفضل" واستبعادات عناوين URL.
- بث التقارير المخصّصة المباشرة: يمكنك طلب بيانات الأداء باللغة الإنجليزية العادية، وسينشئ المساعد طلبات بحث GAQL ويتحقّق من صحتها وينفّذها مباشرةً في حسابك، ثم يبث النتائج المنسّقة إلى جهازك أو يصدّرها إلى ملف CSV.
- الحفاظ على التحديث: من خلال فحص مخططات Protobuf المحلية والمستندات الخاصة بإصدار واجهة برمجة التطبيقات النشط، يساعدك ذلك في تجنُّب الحقول المتوقّفة والقواعد القديمة.
يحوّل "مساعد المطوّر" في Google Ads API الصراع بين المطوّر وواجهة برمجة التطبيقات إلى تعاون بين المطوّر والذكاء الاصطناعي، ما يؤدي إلى إنتاج رمز برمجي آمن وسليم من الناحية المعمارية.
البنية والأداء (الإصدار 4.0.0)
ينقل الإصدار 4.0.0 المساعد من إعداد مشروع مستقل إلى بنية إضافات حديثة وشاملة:
- الحدّ الأدنى من استخدام موارد النظام: يتم تشغيل المهارات وأوامر التشخيص بشكل مؤقت كعمليات ثانوية بسيطة عند طلبها فقط، ما يؤدي إلى خفض استخدام موارد النظام إلى الحدّ الأدنى عند عدم النشاط.
- الإفصاح التدريجي عن السياق: يتم تحميل القواعد والمخططات عند الطلب فقط عندما تكون ذات صلة بمهمتك النشطة، ما يقلّل بشكل كبير من استهلاك الرموز المميزة ووقت استجابة الطلب.
- تقليل عمليات الإدخال/الإخراج على القرص: يؤدي التخلص من ملفات حزمة تطوير البرامج (SDK) غير الضرورية من شجرة المكوّنات الإضافية إلى منع أدوات الفهرسة والتدقيق والتحقّق من الملفات في بيئة التطوير المتكاملة من فحص عشرات الآلاف من الملفات غير المستخدَمة.
- التوافق مع أنظمة أساسية متعددة: تعمل بسلاسة على بيئات Google Antigravity وClaude Code باستخدام نصوص برمجية موحَّدة للتثبيت على أنظمة Linux وmacOS وWindows.
الخطوات التالية
- تثبيت أداة "مساعد المطوّر" في Google Ads API وإعدادها
- مزيد من المعلومات عن مهارات وكيل Google Ads API
- مزيد من المعلومات عن خادم MCP في Google Ads API