مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google"

لإنشاء عمليات تكامل لإعداد التقارير وإدارة المواقع في "إحصاءات Google" بدقة أعلى ونفقات أقل للرموز المميّزة، يمكنك تزويد وكيل الترميز المستند إلى الذكاء الاصطناعي بمهارات وكيل الذكاء الاصطناعي في "إحصاءات Google". تم تصميم مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" للمطوّرين الذين يستخدمون Google Analytics Data API وGoogle Analytics Admin API، وهي عبارة عن وحدات محمولة ومستقلة من التعليمات وسير العمل ومراجع مكتبة البرامج.

تعمل مهارات وكيل الذكاء الاصطناعي هذه مع وكلاء الترميز بالذكاء الاصطناعي الذين يتوافقون مع معيار open Agent Skills، بما في ذلك Google Antigravity وClaude Code وCodex وCursor. للاطّلاع على قائمة بالمهارات المنشورة، يُرجى الانتقال إلى المهارات المتاحة.

قبل البدء

قبل تثبيت مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" وتشغيلها، يجب إكمال المتطلبات الأساسية التالية:

  • ثبِّت وكيل ترميز بالذكاء الاصطناعي يتوافق مع معيار Agent Skills المفتوح، مثل Google Antigravity أو Claude Code أو Codex أو Cursor.
  • ثبِّت Node.js الذي يتضمّن الأمر npx لتثبيت المهارات وتحديثها من سطر الأوامر.
  • أنشئ مشروعًا أو اختَره مع إمكانية الوصول إلى موقع على "إحصاءات Google" عند تشغيل سير عمل واجهة برمجة التطبيقات.

البدء

تثبيت مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" وتحديثها واستدعاؤها في بيئة التطوير

تثبيت مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google"

ثبِّت حزمة مهارات "إحصاءات Google" في دليل مشروعك باستخدام الأمر npx، أو اضبط المحرِّر مباشرةً:

Antigravity

نفِّذ الأمر التالي في دليل المشروع:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

نفِّذ الأمر التالي في دليل المشروع:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

نفِّذ الأمر التالي في دليل المشروع:

npx skills add google/skills/skills/analytics --agent=codex

المؤشر

أضِف عنوان URL لمستودع المهارات (https://github.com/google/skills) في إعدادات المحرّر ضمن القواعد المخصّصة. للحصول على التعليمات، يُرجى الاطّلاع على مستندات Cursor حول تثبيت المهارات من GitHub.

ويمكنك بدلاً من ذلك تثبيت المهارات في دليل مشروعك باستخدام الأمر npx:

npx skills add google/skills/skills/analytics --agent=cursor

وكلاء آخرون

بالنسبة إلى وكلاء الترميز الآخرين المستندين إلى الذكاء الاصطناعي والمتوافقين مع معيار Agent Skills المفتوح، نفِّذ الأمر التالي في دليل مشروعك:

npx skills add google/skills/skills/analytics

تعديل مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google"

نزِّل التحديثات المتاحة وأزِل المهارات القديمة من خلال تنفيذ الأمر التالي:

npx skills update --all

استخدام مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google"

يُحمّل وكلاء الترميز المستندون إلى الذكاء الاصطناعي المهارات تلقائيًا عندما يرصدون أنّ وصف المهارة يتطابق مع طلبك. تبقى المهارات المثبّتة على مستوى العالم غير نشطة في المشاريع غير ذات الصلة ما لم يتضمّن طلبك مهام "إحصاءات Google".

لاستدعاء مهارة يدويًا في برامج الترميز المستنِدة إلى الذكاء الاصطناعي المتوافقة، أدخِل الرمز / في حقل إدخال المحادثة واختَر المهارة حسب الاسم.

المكوّنات الأساسية للمهارة

توفّر كل مهارة من مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" لوكيل الترميز المستنِد إلى الذكاء الاصطناعي المكوّنات التالية:

  • تعليمات متخصّصة: إرشادات مفصّلة لتفعيل واجهات برمجة تطبيقات "إحصاءات Google" باستخدام gcloud CLI، وضبط بيانات الاعتماد التلقائية للتطبيق (ADC)، وإنشاء طلبات بحث runReport، والتحقّق من توافق الحقول
  • أفضل الممارسات: اختيار إصدار واجهة برمجة التطبيقات المقترَح (نقاط نهاية v1beta لضمان الاستقرار العام ونقاط نهاية v1alpha لميزات Admin API المتاحة للاستخدام قبل إطلاقها)، وإنشاء طلبات ذات أنواع بيانات محدّدة، وإجراءات التحقّق من المخطّط.
  • المستندات المرجعية: أدلة تثبيت مكتبة البرامج الخاصة باللغة ونماذج الرموز البرمجية للغات Python وJava وNode.js وPHP وGo و‎.NET وRuby في دليل references/ لكل مهارة.

مزايا مهارات وكيل الذكاء الاصطناعي

توسّع مهارات وكيل الذكاء الاصطناعي قدرات وكيل الترميز بالذكاء الاصطناعي من خلال تزويده بمعلومات متخصّصة من "إحصاءات Google" عند الطلب، بدون تحميل مجموعات كبيرة من المستندات في كل محادثة.

تكاليف الرموز المميّزة المخفّضة

يؤدي تحميل مستندات مرجع واجهة برمجة التطبيقات الكاملة مسبقًا إلى استهلاك الرموز المميّزة السياقية وزيادة تكاليف الجلسة. تستخدم مهارات وكيل الذكاء الاصطناعي الإفصاح التدريجي لتقليل استخدام السياق:

  • عند بدء التشغيل، يقرأ وكيل الترميز المستنِد إلى الذكاء الاصطناعي اسم كل مهارة ووصفها القصير فقط للتحقّق مما إذا كانت المهارة تتطابق مع طلبك.
  • يحمّل الوكيل تعليمات SKILL.md الكاملة والملفات المرجعية الخاصة باللغة في نافذة السياق النشطة فقط عندما تتطلّب مهمتك ذلك.

تنفيذ موجَّه بالذكاء الاصطناعي

صِف هدفك بلغة طبيعية، وستوجّه المهارات المثبَّتة وكيل الذكاء الاصطناعي المسؤول عن الترميز خلال مهام تنفيذ "إحصاءات Google"، مثل ما يلي:

  • أريد تفعيل Google Analytics Data API في مشروعي وكتابة نص برمجي بلغة Python يرسل طلبات بحث عن مقياسَي activeUsers وsessions حسب سمات city وdate.
  • تحقَّق مما إذا كانت السمة itemName متوافقة مع المقياسَين activeUsers وtotalRevenue لموقعي على "إحصاءات Google" باستخدام الطريقة checkCompatibility.
  • يمكنك إدراج جميع ملخّصات حسابات "إحصاءات Google" والمواقع الفرعية التي يمكن الوصول إليها في Node.js باستخدام Google Analytics Admin API.
  • ضبط السمات المخصّصة ومصادر البيانات ورموز Measurement Protocol السرية لموقعي على "إحصاءات Google"

استخدام المهارات مع خادم MCP في "إحصاءات Google"

تكمّل مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" خادم "بروتوكول سياق النموذج" (MCP) في "إحصاءات Google":

  • خادم MCP في "إحصاءات Google": يربط وكيل الترميز المستند إلى الذكاء الاصطناعي مباشرةً بمواقع "إحصاءات Google" النشطة ليتمكّن الوكيل من فحص ملخّصات الحسابات وتفاصيل المواقع والسمات والمقاييس المخصّصة والتقارير المباشرة.
  • مهارات وكيل الذكاء الاصطناعي في "إحصاءات Google": توفّر تعليمات فعّالة من حيث الرموز المميّزة ومراجع لمكتبات العملاء توجّه وكيل الترميز المستند إلى الذكاء الاصطناعي عند تفعيل واجهات برمجة التطبيقات وضبط مصادقة ADC والتحقّق من توافق الحقول وكتابة الرمز البرمجي للتطبيق.

المهارات المتاحة

تحتفظ Google بمهارات وكيل الذكاء الاصطناعي في "إحصاءات Google" التالية في مستودع google/skills:

المهارة الوصف
google-analytics-data-api-basics يتم تفعيل Google Analytics Data API‏ (analyticsdata.googleapis.com) باستخدام gcloud CLI، وضبط ADC باستخدام نطاق OAuth 2.0‏ analytics.readonly، وتثبيت مكتبات برامج v1beta الرسمية (Python وJava وPHP وNode.js وGo و‎.NET وRuby). يوجّه الوكيل في إنشاء طلبات بحث runReport والتحقّق من توافق الحقول مع الطريقتَين getMetadata وcheckCompatibility.
google-analytics-admin-api-basics تتيح هذه الخطوة تفعيل Google Analytics Admin API ‏(analyticsadmin.googleapis.com) باستخدام gcloud CLI، وضبط "بيانات الاعتماد التلقائية للتطبيق" (ADC) باستخدام نطاقَي OAuth 2.0 ‏analytics.readonly وanalytics.edit، وتثبيت مكتبات برامج v1beta وv1alpha الرسمية (Python وJava وPHP وNode.js وGo و‎.NET وRuby). يوجّه وكيلك في إدراج ملخّصات الحسابات وإدارة المواقع ومصادر البيانات والسمات المخصّصة والمقاييس المخصّصة والأحداث الرئيسية وواجهات برمجة التطبيقات السرّية في Measurement Protocol وروابط المنتجات.

الخطوات التالية