مهارات وكيل 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؟