مهارات وكيل "منصة خرائط Google" (GitHub) هي وحدات محمولة ومستقلة من المعرفة والتعليمات وسير العمل الخاصة بـ "منصة خرائط Google". تم تصميمها لمساعدة المساعدين المستندين إلى الذكاء الاصطناعي في فهم أفضل الممارسات المتعلّقة بـ "منصة خرائط Google" وتنفيذ المهام المعقّدة بدقة أعلى وتكلفة أقل للرموز المميّزة.
المهارات المتاحة
توفّر "منصة خرائط Google" مجموعة من المهارات للمنتجات الأساسية. ستتوفّر قريبًا مهارات لمنتجات وميزات إضافية.
| المهارة | الوصف |
|---|---|
google-maps-platform |
مجموعة من المهارات لتصميم وتنفيذ رموز برمجية جاهزة للإنتاج باستخدام واجهات برمجة التطبيقات وحزم تطوير البرامج (SDK) في "منصة خرائط Google" على الويب وAndroid وiOS وواجهات برمجة تطبيقات خدمات الويب لأي مما يلي: الخريطة أو المكان أو العنوان أو الترميز الجغرافي أو تحديد أفضل مسار/الوقت المقدر للوصول (بما في ذلك المسار الصديق للبيئة) أو البحث في الجوار أو الخريطة الثلاثية الأبعاد/"التجوّل الافتراضي"/الخريطة الثابتة أو أداة تجميع محدّدات المواقع أو الأنماط المخصّصة أو الرسم أو وضع حدود جغرافية أو خريطة التمثيل اللوني أو البيئة (جودة الهواء/حبوب اللقاح/الطاقة الشمسية/الطقس). |
البدء
تعمل مهارات وكيل "منصة خرائط Google" مع أي مساعد مستنِد إلى الذكاء الاصطناعي يتوافق مع المهارات، بما في ذلك Gemini وCursor وWindsurf وCopilot وClaude.
تثبيت مهارات وكيل "منصة خرائط Google"
في معظم الحالات، يمكن تثبيت مهارات وكيل "منصة خرائط Google" باستخدام أمر واحد:
واجهة سطر الأوامر في Skills
بالنسبة إلى
أدوات المساعدة المستندة إلى الذكاء الاصطناعي الأكثر رواجًا،
يمكنك استخدام واجهة سطر الأوامر (CLI) في skills لتثبيت مهارات وكيل "منصة خرائط Google".
نفِّذ الأمر التالي في الدليل الجذري لمشروعك:
npx skills add googlemaps/agent-skills
تم اختبار هذه الطريقة كأمر في الوحدة الطرفية أو كطلب باللغة الطبيعية للوكيل في:
- AI Studio
- Antigravity
- Claude Code
- Replit (تعليمات بديلة: استخدام واجهة مستخدم Project Editor)
Gemini CLI
تم ضبط هذا المستودع على أنّه إضافة Gemini CLI. يمكنك إضافته باستخدام Gemini CLI:
gemini extensions install https://github.com/googlemaps/agent-skills
Lovable
ثبِّت مهارات وكيل "منصة خرائط Google" في Lovable باستخدام واجهة مستخدم إعدادات المهارات:
- زيارة
https://lovable.dev/settings/skills - ضمن "مهارات Workspace"، انقر على إضافة > استيراد من GitHub.
- يُرجى لصق عنوان URL للمهارة الرئيسية "
google-maps-platform":
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform
استخدام مهارات وكيل "منصة خرائط Google"
تفعيل مهارات الوكيل تلقائيًا أو يدويًا
تم تصميم المساعدين المستنِدين إلى الذكاء الاصطناعي لاستخدام المهارات تلقائيًا عندما يكتشفون
أنّ وصف المهارة يتطابق مع طلبك الحالي. ومع ذلك، يمكن أيضًا استدعاء
المهارات يدويًا. يتم ذلك عادةً من خلال كتابة / في محادثة موظّف الدعم
والبحث عن اسم المهارة.
على سبيل المثال، بعد التثبيت، يمكنك كتابة ما يلي في محادثة الوكيل لطلب ميزة جديدة في التطبيق الذي تنشئه:
/google-maps-platform Add a 3D map featuring a marker for the user's location
استخدام المهارات مع خادم MCP في Code Assist
تم تصميم مهارات الوكيل لتتكامل مع خادم MCP في Code Assist:
مهارات وكيل "منصة خرائط Google": يمكنك تقديم تعليمات سريعة وممارسات مقترَحة توضّح للوكيل كيفية تنفيذ مهام "منصة خرائط Google" من خلال الإفصاح التدريجي الفعّال عن الرموز المميّزة. وتُعلّم الوكيل كيفية استخدام أدوات خادم MCP بفعالية.
خادم MCP لـ Code Assist: تم تصميمه لسير عمل التطوير المستنِد إلى الذكاء الاصطناعي، ما يتيح للمساعدين المستنِدين إلى الذكاء الاصطناعي التفاعل مع مشاريعك ومواردك وبياناتك على "منصة خرائط Google" آليًا.
تعديل مهارات وكيل "منصة خرائط Google"
يمكنك الحصول على جميع التحديثات المتاحة وحذف المهارات القديمة من خلال تشغيل الأمر update:
واجهة سطر الأوامر في Skills
npx skills update google-maps-platform
Gemini CLI
gemini extensions update
المكوّنات الأساسية للمهارة
كل مهارة للوكيل هي حزمة متخصّصة يمكنها تزويد المساعد المستنِد إلى الذكاء الاصطناعي بالمكوّنات التالية:
- تعليمات متخصّصة: إرشادات مفصّلة حول تنفيذ مهام محدّدة، مثل تنفيذ ميزة "الإكمال التلقائي للأماكن" أو إنشاء خريطة باستخدام علامات متقدّمة
- أفضل الممارسات: أنماط أمان وأداء مدمجة لضمان اتّباع تطبيقك اقتراحات "منصة خرائط Google" من البداية، بما في ذلك تحسين التكلفة
- النصوص البرمجية للتشغيل الآلي: هي رموز برمجية قابلة للتنفيذ تتيح لوكيل الذكاء الاصطناعي إعداد البيئة المحلية أو ضبطها تلقائيًا.
- الفعالية في العالم الحقيقي: أنماط معالجة الأخطاء والاستثناءات المستخلصة مباشرةً من عمليات تنفيذ مستودعات مفتوحة المصدر تم التحقّق منها
مزايا استخدام المهارات
يؤدي استخدام مهارات الوكيل إلى تقليل الجهد اليدوي في البحث في المستندات مع تحسين كفاءة تفاعلاتك مع الذكاء الاصطناعي.
تكاليف الرموز المميّزة المخفّضة
غالبًا ما تحمّل عمليات دمج الذكاء الاصطناعي التقليدية كميات هائلة من المستندات مسبقًا، ما يستهلك عددًا كبيرًا من الرموز المميّزة ويزيد من تكاليف الجلسات. تستخدم مهارات الوكيل الإفصاح التدريجي لتقليل هذا العبء:
- في البداية، "يفحص" الوكيل البيانات الوصفية الموجزة فقط لمعرفة ما إذا كانت المهارة ذات صلة.
- لا يتم تحميل التعليمات والمراجع المفصّلة إلا عندما يحدّد الوكيل أنّها ضرورية لمهمتك المحدّدة.
تنفيذ موجَّه بالذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف نيتك بلغة طبيعية. توجّه المهارات مساعدك المستنِد إلى الذكاء الاصطناعي لتنفيذ مهام مثل ما يلي:
- أريد إضافة خريطة مع علامة إلى تطبيق الويب الخاص بي.
- استخدِم ميزة "الإكمال التلقائي للأماكن" لإدخال العناوين.
- ساعدني في إنشاء صورة خريطة ثابتة.
للحصول على قائمة كاملة بمهارات وكيل "منصة خرائط Google"، يُرجى الاطّلاع على المهارات المتاحة.