مهارات وكيل Data Manager API هي وحدات قابلة للنقل ومستقلة ذاتيًا تتضمّن معلومات وتعليمات ومهام سير عمل خاصة بواجهة Data Manager API. تعمل مهارات وكيل Data Manager API مع مساعدين مستندين إلى الذكاء الاصطناعي يتوافقون مع معيار مهارات الوكيل المفتوح، بما في ذلك Google Antigravity وClaude Code.
تم تصميم مهارات الوكيل هذه لمساعدة المساعدين المستندين إلى الذكاء الاصطناعي في فهم أفضل الممارسات المتعلّقة بواجهة Data Manager API، وضبط الأدوات، وتنفيذ مهام سير العمل بدقة أعلى وتكلفة أقل للرموز المميّزة.
المهارات المتاحة
يقدّم فريق Data Manager API مجموعة من المهارات اللازمة للاستفادة من Data Manager API:
| المهارة | الوصف |
|---|---|
data-manager-api-setup |
تقدّم هذه الصفحة إرشادات للمطوّرين حول خطوات تثبيت مكتبة العميل والمصادقة لإعداد Data Manager API. |
data-manager-api-event-ingestion |
تساعد في تنفيذ عملية نقل الأحداث والإحالات الناجحة إلى منتجات Google باستخدام Data Manager API. |
data-manager-api-audience-ingestion |
تساعد في إنشاء قوائم المستخدِمين وإدارة بيانات الجمهور باستخدام Data Manager API لحالات الاستخدام، مثل "مطابقة العملاء". |
البدء
ثبِّت مهارات الوكيل المناسبة لبيئة التطوير.
تثبيت مهارات وكيل Data Manager API
في معظم الحالات، يمكن تثبيت مهارات وكيل Data Manager API في المحرّر المفضّل لديك باستخدام أمر واحد:
Antigravity
نفِّذ الأمر التالي في دليل مشروعك:
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
المؤشر
يمكنك تثبيت مهارات وكيل Data Manager API مباشرةً من خلال إضافة نقطة نهاية مستودع GitHub الخاصة بالمهارة (على سبيل المثال، https://github.com/google/skills) في إعدادات المحرّر ضمن القواعد المخصّصة. لمزيد من التفاصيل، يُرجى الاطّلاع على
مستندات Cursor حول تثبيت المهارات من GitHub.
يمكنك أيضًا تثبيت المهارات باستخدام NPX:
npx skills add google/skills/skills/ads --agent=cursor
الوكلاء الآخرون
بالنسبة إلى المساعدين الآخرين المستندين إلى الذكاء الاصطناعي والمتوافقين مع معيار Agent Skills المفتوح، يمكنك تثبيت المهارات باستخدام NPX:
npx skills add google/skills/skills/ads
تعديل مهارات وكيل Data Manager API
يمكنك الحصول على جميع التحديثات المتاحة وتنظيف المهارات القديمة من خلال تنفيذ الأمر update:
npx skills update --all
استخدام مهارات وكيل Data Manager API
تم تصميم مساعدات الذكاء الاصطناعي لاستخدام المهارات تلقائيًا عندما ترصد أنّ وصف المهارة يتطابق مع طلبك الحالي. تبقى المهارات المثبّتة على مستوى العالم غير نشطة في المشاريع غير ذات الصلة ما لم يتطابق سياق طلبك مع مهام Data Manager API.
يمكن أيضًا استدعاء المهارات يدويًا في محادثة الوكيل. في العديد من الأجهزة الذكية، يمكنك استخدام المفتاح / لفتح قائمة بالمهارات المثبّتة.
المكوّنات الأساسية للمهارة
كل مهارة من مهارات الوكيل هي حزمة متخصّصة توفّر للمساعد المستند إلى الذكاء الاصطناعي المكوّنات التالية:
- تعليمات متخصّصة: إرشادات تفصيلية لمساعد الذكاء الاصطناعي حول كيفية تنفيذ مهام معيّنة، مثل إعداد إذن الوصول إلى واجهة برمجة التطبيقات وتنسيق بيانات المستخدمين وتجزئتها وتنفيذ عمليات سير عمل الإدخال.
- أفضل الممارسات: اقتراحات التكامل العادي التي يحدّدها فريق Data Manager API.
- المستندات المرجعية: أدلة إعداد مكتبة العملاء وعمليات ربط الحقول الخاصة بنقل البيانات ونماذج الرموز البرمجية المضمّنة في المهارات لتزويد المساعد بمراجع دقيقة وحديثة
مزايا استخدام المهارات
توسّع مهارات الوكيل إمكانات المساعد من خلال توفير معرفة متخصّصة عند الطلب بدون الحاجة إلى تحميل تعليمات ضخمة في كل محادثة.
تكاليف الرموز المميزة المخفَّضة
غالبًا ما تؤدي عمليات الدمج التقليدية للذكاء الاصطناعي إلى تحميل كميات هائلة من المستندات مسبقًا، ما يؤدي إلى استهلاك عدد كبير من الرموز المميزة وزيادة تكاليف الجلسة. تستخدم مهارات الوكيل الكشف التدريجي لتقليل هذا الحمل الزائد:
- يتحقّق مساعد الذكاء الاصطناعي في البداية فقط من اسم المهارة ووصفها لمعرفة ما إذا كانت مرتبطة بطلبك.
- لا تتم إضافة التعليمات والمراجع الكاملة للمهارة إلى قدرة الاستيعاب النشطة إلا عندما يحدّد المساعد أنّها ضرورية لمهمتك المحدّدة، ما يؤدي إلى توفير مساحة السياق.
التنفيذ الموجّه بالذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف نيتك بلغة طبيعية. توجّه المهارات مساعدك المستند إلى الذكاء الاصطناعي لمساعدتك في مهام واجهة Data Manager API، مثل ما يلي:
- اكتب نصًا برمجيًا بلغة Python لاستيعاب الإحالات الناجحة غير الإلكترونية في "إعلانات Google" باستخدام Data Manager API.
- نقل رمز
OfflineUserDataJobServiceفي "إعلانات Google" الخاص بميزة "مطابقة العملاء" إلى Data Manager API - كيف يمكنني استرداد حالة معالجة طلب نقل حدث في Data Manager API؟