مهارات وكيل الذكاء الاصطناعي في Google Ads API هي وحدات مستقلة وقابلة للنقل تتضمّن معلومات وتعليمات وسير عمل خاصة بـ Google Ads API. تعمل هذه المهارات مع وكلاء الترميز بالذكاء الاصطناعي الذين يتوافقون مع معيار Agent Skills المفتوح، بما في ذلك Google Antigravity وClaude Code وCodex وCursor.
تساعد مهارات وكيل الذكاء الاصطناعي هذه وكلاء الترميز المستندين إلى الذكاء الاصطناعي في فهم أفضل الممارسات المتعلّقة بواجهة Google Ads API، وضبط الأدوات، وتنفيذ مهام سير العمل بدقة أعلى وتكلفة أقل للرموز المميّزة. للاطّلاع على قائمة بالمهارات المتاحة، يُرجى مراجعة المهارات المتاحة.
البدء
ثبِّت مهارات وكيل الذكاء الاصطناعي المناسبة لبيئة التطوير لديك.
تثبيت مهارات وكيل الذكاء الاصطناعي في Google Ads API
في معظم الحالات، يمكنك تثبيت مهارات وكيل الذكاء الاصطناعي في Google Ads API في المحرّر المفضّل لديك باستخدام أمر واحد:
Antigravity
تُعدّ مهارات وكيل الذكاء الاصطناعي في Google Ads API من ضمن حِزم التكامل في Build with Google لمنصة Antigravity. يمكنك تفعيل هذه الحزمة للوصول على المستوى العام في نقطتين:
- أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار الخاص بمجموعة Google Ads API.
- في "الإعدادات":
- انتقِل إلى الإعدادات > التخصيصات.
- ضمن إضافات Build with Google، انقر على تخصيص، ثم انقر على تنزيل لدمج Google Ads API.
إذا كنت تفضّل الوصول على مستوى المشروع، نفِّذ الأمر التالي في دليل مشروعك:
npx skills add google/skills/skills/ads --agent=antigravity
Claude Code
npx skills add google/skills/skills/ads --agent=claude-code
Codex
npx skills add google/skills/skills/ads --agent=codex
المؤشر
يمكنك تثبيت مهارات وكيل الذكاء الاصطناعي في Google Ads API مباشرةً من خلال إضافة نقطة نهاية مستودع GitHub الخاصة بالمهارة (مثلاً، https://github.com/google/skills) في إعدادات المحرّر ضمن القواعد المخصّصة. لمزيد من التفاصيل، يُرجى الاطّلاع على
مستندات Cursor حول تثبيت المهارات من GitHub.
يمكنك أيضًا تثبيت المهارات باستخدام الأمر npx (يتطلب
Node.js):
npx skills add google/skills/skills/ads --agent=cursor
وكلاء آخرون
بالنسبة إلى وكلاء الترميز الآخرين بالذكاء الاصطناعي الذين يتوافقون مع معيار
Agent Skills المفتوح، يمكنك تثبيت
المهارات باستخدام الأمر npx (يتطلب Node.js):
npx skills add google/skills/skills/ads
تعديل مهارات وكيل الذكاء الاصطناعي في Google Ads API
يمكنك الحصول على جميع التحديثات المتاحة وإزالة المهارات القديمة من خلال تشغيل الأمر
update:
Antigravity
تتم إدارة عمليات الدمج المفعَّلة من خلال Build with Google وتحديثها تلقائيًا من قِبل المحرِّر.
إذا ثبّت مهارات وكيل الذكاء الاصطناعي باستخدام الأمر npx، يمكنك الحصول على
جميع التحديثات المتاحة من خلال تشغيل الأمر update:
npx skills update --all
Claude Code
npx skills update --all
Codex
npx skills update --all
المؤشر
npx skills update --all
وكلاء آخرون
بالنسبة إلى وكلاء الترميز الآخرين المستنِدين إلى الذكاء الاصطناعي والذين يتوافقون مع معيار Agent Skills المفتوح، يمكنك تعديل جميع المهارات النشطة باستخدام الأمر npx:
npx skills update --all
استخدام مهارات وكيل الذكاء الاصطناعي في Google Ads API
يستخدم وكلاء الترميز بالذكاء الاصطناعي المهارات تلقائيًا عندما يكتشفون أنّ وصف المهارة يتطابق مع طلبك الحالي. تظل المهارات المثبّتة على مستوى العالم غير نشطة في المشاريع غير ذات الصلة ما لم يتطابق سياق طلبك مع مهام Google Ads API.
يمكنك أيضًا تفعيل المهارات يدويًا من خلال إدخال / في محادثة وكيل الذكاء الاصطناعي والبحث عن اسم المهارة.
المكوّنات الأساسية للمهارة
كل مهارة لوكيل الذكاء الاصطناعي هي حزمة متخصّصة تزوّد وكيل الترميز بالذكاء الاصطناعي بالمكوّنات التالية:
- تعليمات متخصّصة: تعليمات مفصّلة للطلبات يتم إدخالها في نافذة السياق لتوجيه المساعد في إنشاء طلبات بحث GAQL وضبط بيانات اعتماد OAuth ومعالجة رموز الأخطاء الشائعة.
- أفضل الممارسات: هي اقتراحات عادية بشأن الأداء والأمان والتكامل يحدّدها فريق علاقات المطوّرين في Google Ads API.
- نصوص برمجية مبرمَجة: نصوص برمجية قابلة للتنفيذ (مثل تلك المخصّصة للتحقّق من صحة البيئة أو إعداد مساحة العمل) مضمّنة في حِزم المهارات لتنفيذ المهام محليًا
مزايا استخدام المهارات
توسّع مهارات وكيل الذكاء الاصطناعي إمكانات وكيل الترميز بالذكاء الاصطناعي من خلال توفير معرفة متخصّصة عند الطلب بدون الحاجة إلى تحميل تعليمات ضخمة في كل محادثة.
تكاليف الرموز المميّزة المخفّضة
غالبًا ما تحمّل عمليات دمج الذكاء الاصطناعي التقليدية كميات هائلة من المستندات مقدمًا، ما يستهلك عددًا كبيرًا من الرموز المميّزة ويزيد من تكاليف الجلسات. تستخدم مهارات وكيل الذكاء الاصطناعي الإفصاح التدريجي لتقليل هذا العبء:
- يتحقّق المساعد المستنِد إلى الذكاء الاصطناعي في البداية من اسم المهارة ووصفها فقط لمعرفة ما إذا كانت مناسبة لطلبك.
- لا تتم إضافة التعليمات والمراجع الكاملة للمهارة إلى نافذة السياق النشطة إلا عندما يحدّد المساعد أنّها ضرورية لمهمتك المحدّدة، ما يوفّر مساحة في السياق.
تنفيذ موجَّه بالذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف نيتك بلغة طبيعية. توجّه المهارات مساعدك المستنِد إلى الذكاء الاصطناعي لتنفيذ مهام مثل:
- أريد إنشاء طلب بحث GAQL لاسترداد مقاييس أداء الحملات من حسابي.
- اكتب نصًا برمجيًا بلغة Python باستخدام مكتبات برامج لإنشاء حملة جديدة.
- استرداد الإحالات الناجحة وبيانات التشخيص الخاصة بالحملات باستخدام Google Ads API
للحصول على قائمة كاملة بالمهارات المتاحة، يُرجى الاطّلاع على المهارات المتاحة.
استخدام المهارات مع خادم MCP في Google Ads API
تُكمّل مهارات وكيل الذكاء الاصطناعي خادم بروتوكول سياق النموذج (MCP) في Google Ads API:
- خادم MCP في Google Ads API: تم تصميمه لسير عمل التطوير بمساعدة الذكاء الاصطناعي، ما يتيح للمساعدين المستندين إلى الذكاء الاصطناعي التفاعل مع موارد Google Ads API والحملات والمقاييس آليًا.
- مهارات وكيل الذكاء الاصطناعي في Google Ads API: يمكنك تقديم تعليمات للطلبات وأفضل الممارسات المقترَحة التي توجّه وكيل الترميز المستنِد إلى الذكاء الاصطناعي لتنفيذ المهام من خلال الإفصاح التدريجي الفعّال عن الرموز المميّزة. وهي توجّه وكيل الترميز المستنِد إلى الذكاء الاصطناعي حول كيفية استخدام أدوات مثل خادم MCP ومكتبات العملاء بفعالية.
المهارات المتاحة
يوفّر فريق العمل لواجهة برمجة التطبيقات في Google Ads مجموعة من المهارات لإنشاء التطبيقات باستخدام Google Ads API:
| المهارة | الوصف |
|---|---|
google-ads-api-account-diagnostics |
تشخيص مشاكل الأداء في حساب "إعلانات Google"، مثل فقدان الإحالات الناجحة، وانخفاض عدد العملاء المحتملين، ونسبة ظهور الإعلان المفقودة بسبب ترتيب الإعلان أو عروض الأسعار أو الميزانيات، وذلك باستخدام خادم MCP في Google Ads API |
google-ads-api-mcp-setup |
يساعد في إعداد خادم Model Context Protocol (MCP) الخاص بواجهة Google Ads API وضبطه، ما يسهّل عملية المصادقة والإعداد في البيئات المحلية. |
google-ads-api-quickstart |
يقدّم لك هذا الدليل إرشادات حول إعداد بيئة المطوّر وضبط بيانات الاعتماد وإجراء أول طلب بيانات من Google Ads API. |
الخطوات التالية
- ربط برنامج الذكاء الاصطناعي بخادم MCP في "إعلانات Google"
- مساعد الدراسة عن Google Ads API Developer Assistant
- تثبيت Google Ads API Developer Assistant واستخدامه
- كيفية استخدام مهارات وكيل الذكاء الاصطناعي مع Claude Code
- كيفية استخدام مهارات وكيل الذكاء الاصطناعي مع Google Antigravity