مهارتهای عامل «پلاتفرم Google Maps» (GitHub) ماژولهای قابلحمل و مستقل از دانش، دستورالعملها، و گردشهای کاری مختص «پلاتفرم Google Maps» هستند. این دستورالعملها برای کمک به دستیارهای هوش مصنوعی طراحی شدهاند تا روالهای مطلوب Google Maps Platform را درک کنند و کارهای پیچیده را با دقت بالاتر و هزینه کمتر توکن اجرا کنند.
مهارتهای دردسترس
«پلاتفرم Google Maps» مجموعهای از مهارتها را برای محصولات اصلی ارائه میدهد. مهارتهای مربوط به محصولات و ویژگیهای بیشتر بهزودی ارائه میشود!
| مهارت | شرح |
|---|---|
google-maps-platform |
مجموعهای از مهارتها برای معماری و پیادهسازی کد آماده تولید بااستفاده از میاناهای برنامهسازی کاربردی و کیتهای توسعه نرمافزار Google Maps Platform در سراسر وب، Android، iOS، و میاناهای برنامهسازی کاربردی سرویسهای وب برای هریک از موارد زیر: نقشه، مکان، نشانی، زمینکدیابی، مسیریابی/ زمان تخمینی رسیدن (ازجمله مسیریابی زیستمحیطی)، جستجوی اطراف، نقشه سهبعدی/ نمای خیابان/ نقشه ایستا، خوشهبندی نشانگر، سبک سفارشی، طراحی، حصارکشی جغرافیایی، نقشه حرارتی، یا محیطی (کیفیت هوا/ گرده/ خورشیدی/ آبوهوا). همه کدهای غیربدیهی ازطریق سرویس «دستیار کد پلاتفرم Google Maps» در اسناد تازه بازیابیشده مستقر میشوند (بدون اتکا به حافظه دادههای آموزشی). |
شروع کنید
مهارتهای عامل Google Maps Platform با هر دستیار هوش مصنوعی که از مهارتها پشتیبانی میکند، ازجمله Gemini، Cursor، Windsurf، Copilot، و Claude، کار میکند.
نصب کردن مهارتهای عامل «پلاتفرم Google Maps»
در بیشتر موارد، مهارتهای عامل Google Maps Platform را میتوان با یک فرمان نصب کرد:
Skills CLI
برای
پرطرفدارترین ابزارهای کمک هوش مصنوعی،
میتوانید از skills CLI برای نصب مهارتهای عامل «پلاتفرم Google Maps» استفاده کنید.
دستور زیر را در دایرکتوری ریشه پروژهتان اجرا کنید:
npx skills add googlemaps/agent-skills
این روش بهعنوان فرمان پایانه یا پیامواره زبان طبیعی برای عامل در موارد زیر آزمایش شده است:
- AI Studio
- Antigravity
- کد Claude
- Replit (دستورالعملهای جایگزین: استفاده از میانای کاربر «ویرایشگر پروژه»)
Gemini CLI
این مخزن بهعنوان افزونه Gemini CLI پیکربندی شده است. میتوانید آن را بااستفاده از Gemini CLI اضافه کنید:
gemini extensions install https://github.com/googlemaps/agent-skills
دوستداشتنی
مهارتهای عامل Google Maps Platform را در Lovable بااستفاده از میانای کاربر تنظیمات «مهارتها» نصب کنید:
- دیدن
https://lovable.dev/settings/skills - در بخش «مهارتهای Workspace»، روی افزودن > وارد کردن از GitHub کلیک کنید.
- نشانی وب مهارت اصلی
google-maps-platformرا جایگذاری کنید:
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform
استفاده از مهارتهای عامل «پلاتفرم Google Maps»
راهاندازی خودکار یا فراخوانی دستی مهارتهای نماینده
دستیارهای هوش مصنوعی بهگونهای طراحی شدهاند که هرگاه تشخیص دهند شرح مهارتی با درخواست فعلی شما مطابقت دارد، بهطور خودکار از آن مهارت استفاده کنند. بااینحال، مهارتها را میتوان بهصورت دستی نیز فراخوانی کرد. این کار معمولاً با تایپ کردن / در گپ نماینده
و جستجوی نام مهارت انجام میشود.
برای مثال، پساز نصب، میتوانید عبارت زیر را در گپ نمایندهتان تایپ کنید تا ویژگی جدیدی را در برنامهای که میسازید درخواست کنید:
/google-maps-platform Add a 3D map featuring a marker for the user's location
استفاده از مهارتها در کنار سرور MCP در Code Assist
مهارتهای عامل برای تکمیل سرور MCP دستیار کد طراحی شدهاند:
مهارتهای نماینده «پلاتفرم Google Maps»: دستورالعملهای سریع و شیوههای توصیهشدهای را ارائه میدهد که به نماینده میگوید چگونه کارهای «پلاتفرم Google Maps» را ازطریق شفافسازی تدریجی با مصرف بهینه از توکن انجام دهد. این دستورالعملها به عامل آموزش میدهند که چگونه از ابزارهای سرور MCP بهطور مؤثر استفاده کند.
سرور Code Assist MCP: برای گردشهای کاری توسعه با کمک هوش مصنوعی طراحی شده است و به دستیارهای هوش مصنوعی امکان میدهد بهصورت برنامهنویسیشده با پروژهها، منابع، و دادههای Google Maps Platform شما تعامل داشته باشند.
افزودن مهارت عامل Developer Knowledge
برای اینکه به دستیار هوش مصنوعی خود اجازه دهید در کتابخانه گستردهتر اسناد رسمی توسعهدهنده Google (ازجمله اسناد Google Maps Platform در developers.google.com) نیز جستجو کند، مهارت عامل retrieving-developer-knowledge را در کنار مهارتهای عامل Google Maps Platform نصب کنید. این مهارت به دستیار شما آموزش میدهد که چگونه از سرور Developer Knowledge MCP پرسمان کند تا پاسخهایی که شامل Google Maps Platform و سایر محصولات Google (مانند Firebase یا Google Cloud) میشوند، بتوانند بهجای تکیه صرف بر دادههای آموزشی، از اسناد رسمی استفاده کنند. برای مثال:
Using the official docs, compare Grounding with Google Maps in the Gemini API
with Maps Grounding Lite, then add the better fit to my Node.js agent
بهروزرسانی مهارتهای عامل «پلاتفرم Google Maps»
با اجرای فرمان update میتوانید همه بهروزرسانیهای دردسترس را دریافت کنید و مهارتهای قدیمی را پاک کنید:
Skills CLI
npx skills update google-maps-platform
Gemini CLI
gemini extensions update
اجزای اصلی مهارت
هر مهارت عامل یک بسته تخصصی است که میتواند مؤلفههای زیر را به دستیار هوش مصنوعی ارائه دهد:
- دستورالعملهای تخصصی: راهنمایی دقیق درباره دستیابی به تکالیف خاص، مانند پیادهسازی «تکمیل خودکار جا» یا تولید نقشه با «نشانگرهای پیشرفته».
- روالهای مطلوب: الگوهای عملکرد و امنیت داخلی برای اطمینان از اینکه برنامهتان از همان ابتدا از توصیههای «پلاتفرم Google Maps»، ازجمله بهینهسازی هزینه، پیروی میکند.
- دستورگانهای خودکارسازی: کد اجرایی که به عامل هوش مصنوعی شما اجازه میدهد راهاندازی یا پیکربندی محیط محلی را بهطور خودکار انجام دهد.
- استحکام در دنیای واقعی: الگوهای مدیریت خطا و استثنا که مستقیماً از پیادهسازیهای مخزن متنباز درستیسنجیشده استخراج شدهاند.
مزایای استفاده از مهارتها
استفاده از مهارتهای نماینده تلاش دستی برای جستجوی اسناد را کاهش میدهد و درعینحال کارایی تعاملات هوش مصنوعی شما را بهبود میبخشد.
کاهش هزینه توکن
ادغامهای هوش مصنوعی سنتی اغلب مقادیر زیادی از اسناد را ازقبل بارگیری میکنند که این امر باعث مصرف تعداد زیادی از توکنها و افزایش هزینههای جلسه میشود. مهارتهای عامل از شفافسازی تدریجی برای بهحداقل رساندن این سربار استفاده میکنند:
- نماینده در ابتدا فقط فرادادههای خلاصه را «اسکن» میکند تا ببیند آیا مهارتی مرتبط است یا نه.
- دستورالعملها و منابع دقیق فقط زمانی بار میشود که عامل تشخیص دهد برای تکلیف خاص شما ضروری است.
پیادهسازی با راهنمایی هوش مصنوعی
بهجای جستجوی دستی در اسناد، میتوانید قصد خود را به زبان طبیعی توصیف کنید. مهارتها دستیار هوش مصنوعی شما را برای انجام کارهایی مثل موارد زیر راهنمایی میکنند:
- افزودن نقشه با نشانگر به برنامه وب من.
- «تکمیل خودکار جا» را برای ورودی نشانی پیادهسازی کنید.
- کمکم کن تصویر نقشه ثابتی تولید کنم.
برای مشاهده فهرست کامل مهارتهای عامل Google Maps Platform، به مهارتهای دردسترس مراجعه کنید.
مراحل بعدی
- با نحوه استفاده از مهارتهای نماینده با Gemini CLI آشنا شوید.
- با نحوه استفاده از مهارتهای عامل با Antigravity آشنا شوید.