إنّ مهارات وكيل "منصة خرائط Google" (GitHub) هي وحدات محمولة ومستقلة تتضمّن تعليمات وسير عمل ومعارف خاصة بـ "منصة خرائط Google". وهي مصمّمة لمساعدة مساعدي الذكاء الاصطناعي في فهم أفضل ممارسات "منصة خرائط Google" وتنفيذ المهام المعقّدة بدقة أعلى وتكلفة أقل للرموز.
المهارات المتاحة
توفّر "منصة خرائط Google" مجموعة من المهارات للمنتجات الأساسية. وستتوفّر قريبًا مهارات للمنتجات والميزات الإضافية.
| المهارة | الوصف |
|---|---|
google-maps-platform |
مجموعة من المهارات لتصميم وتنفيذ رمز جاهز للاستخدام في بيئة الإنتاج باستخدام واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) الخاصة بـ "منصة خرائط Google" على الويب وأجهزة Android وiOS وواجهات برمجة تطبيقات خدمات الويب لأي مما يلي: الخريطة أو المكان أو العنوان أو الترميز الجغرافي أو التوجيه/الوقت المقدَّر للوصول (بما في ذلك التوجيه الصديق للبيئة) أو البحث عن أماكن قريبة أو الخريطة الثلاثية الأبعاد/خريطة التجوّل الافتراضي/الخريطة الثابتة أو تجميع العلامات أو الأنماط المخصّصة أو الرسم أو السياج الجغرافي أو الخريطة الحرارية أو المعلومات البيئية (جودة الهواء/حبوب اللقاح/الطاقة الشمسية/الطقس). |
البدء
تعمل مهارات وكيل "منصة خرائط Google" مع أي مساعد ذكاء اصطناعي يتيح استخدام المهارات، بما في ذلك Gemini وCursor وWindsurf وCopilot وClaude.
تثبيت مهارات وكيل "منصة خرائط Google"
في معظم الحالات، يمكن تثبيت مهارات وكيل "منصة خرائط Google" باستخدام أمر واحد:
واجهة سطر الأوامر (CLI) للمهارات
بالنسبة إلى
معظم الأدوات الشائعة التي تساعد في استخدام الذكاء الاصطناعي،
يمكنك استخدام واجهة سطر الأوامر skills لتثبيت مهارات وكيل "منصة خرائط Google".
نفِّذ الأمر التالي في دليل مشروعك الرئيسي:
npx skills add googlemaps/agent-skills
تم اختبار هذه الطريقة كأمر في المحطة الطرفية أو كطلب باللغة الطبيعية للوكيل في:
- Google AI Studio
- Antigravity
- Claude Code
- Replit (تعليمات بديلة: استخدِم واجهة مستخدم "محرّر المشاريع")
Gemini CLI
تم ضبط هذا المستودع كإضافة Gemini CLI. يمكنك إضافته باستخدام Gemini CLI:
gemini extensions install https://github.com/googlemaps/agent-skills
Lovable
ثبِّت مهارات وكيل "منصة خرائط Google" في Lovable باستخدام واجهة مستخدم إعدادات المهارات:
- انتقِل إلى
https://lovable.dev/settings/skills - ضمن مهارات مساحة العمل، انقر على إضافة > استيراد من 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
استخدام المهارات جنبًا إلى جنب مع خادم Code Assist MCP
تم تصميم مهارات الوكيل لتكمّل الـ Code Assist MCP server:
مهارات وكيل "منصة خرائط Google": تقدّم التعليمات السريعة و أفضل الممارسات التي توضّح للوكيل كيفية تنفيذ مهام "منصة خرائط Google" من خلال الكشف التدريجي عن المعلومات بطريقة فعّالة من حيث الرموز. وتعلّم الوكيل كيفية استخدام أدوات خادم MCP بفعالية.
خادم Code Assist MCP: تم تصميمه لسير عمل التطوير بمساعدة الذكاء الاصطناعي ، ما يتيح لمساعدي الذكاء الاصطناعي التفاعل مع مشاريع "منصة خرائط Google" ومواردها وبياناتها آليًا.
تعديل مهارات وكيل "منصة خرائط Google"
يمكنك الحصول على جميع التعديلات المتاحة وتنظيف المهارات القديمة عن طريق تنفيذ الأمر update:
واجهة سطر الأوامر (CLI) للمهارات
npx skills update google-maps-platform
Gemini CLI
gemini extensions update
المكوّنات الأساسية للمهارة
كل مهارة وكيل هي حزمة متخصّصة يمكنها تزويد مساعد الذكاء الاصطناعي بالمكوّنات التالية:
- تعليمات متخصّصة: إرشادات تفصيلية حول إنجاز مهام معيّنة، مثل تنفيذ ميزة "الإكمال التلقائي للأماكن" أو إنشاء خريطة تتضمّن علامات متقدّمة.
- أفضل الممارسات: أنماط الأمان والأداء المضمّنة لضمان اتّباع تطبيقك لتوصيات "منصة خرائط Google" منذ البداية، بما في ذلك تحسين التكلفة.
- برامج التشغيل الآلي: رمز قابل للتنفيذ يتيح لوكيل الذكاء الاصطناعي إجراء إعداد البيئة المحلية أو ضبطها تلقائيًا.
- الموثوقية في العالم الحقيقي: أنماط معالجة الأخطاء والاستثناءات المستخلَصة مباشرةً من عمليات تنفيذ المستودعات المفتوحة المصدر التي تم التحقّق منها.
مزايا استخدام المهارات
يقلّل استخدام مهارات الوكيل من الجهد اليدوي المطلوب للبحث في المستندات، مع تحسين كفاءة تفاعلاتك مع الذكاء الاصطناعي.
تكاليف أقل للرموز
غالبًا ما تحمّل عمليات الدمج التقليدية للذكاء الاصطناعي كميات كبيرة من المستندات مسبقًا، ما يستهلك عددًا كبيرًا من الرموز ويزيد من تكاليف الجلسة. تستخدم مهارات الوكيل الكشف التدريجي عن المعلومات لتقليل هذا العبء:
- في البداية، "يفحص" الوكيل البيانات الوصفية الموجزة فقط لمعرفة ما إذا كانت المهارة ذات صلة.
- لا يتم تحميل التعليمات والموارد التفصيلية إلا عندما يحدّد الوكيل أنّها ضرورية لمهمتك المحدّدة.
التنفيذ بمساعدة الذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف هدفك بلغة طبيعية. توجّه المهارات مساعد الذكاء الاصطناعي لتنفيذ مهام مثل ما يلي:
- أضِف خريطة تتضمّن علامة إلى تطبيق الويب الخاص بي.
- نفِّذ ميزة "الإكمال التلقائي للأماكن" لإدخال العنوان.
- ساعدني في إنشاء صورة خريطة ثابتة.
للاطّلاع على قائمة كاملة بمهارات وكيل "منصة خرائط Google"، يُرجى الاطّلاع على المهارات المتاحة.
الخطوات التالية
- تعرَّف على كيفية استخدام مهارات الوكيل مع Gemini CLI.
- تعرَّف على كيفية استخدام مهارات الوكيل مع Antigravity.