مهارت‌های عامل «پلاتفرم Google Maps»

مهارت‌های عامل «پلاتفرم Google Maps» (GitHub) پیمانه‌های قابل‌حمل و مستقل از دانش، دستورالعمل‌ها، و گردش‌های کاری مختص «پلاتفرم Google Maps» هستند. این دستورالعمل‌ها برای کمک به دستیارهای هوش مصنوعی در درک روال‌های مطلوب Google Maps Platform و اجرای کارهای پیچیده با دقت بالاتر و هزینه کمتر توکن طراحی شده‌اند.

مهارت‌های دردسترس

«پلاتفرم Google Maps» مجموعه‌ای از مهارت‌ها را برای محصولات اصلی ارائه می‌دهد. مهارت‌های مربوط به محصولات و ویژگی‌های بیشتر به‌زودی ارائه می‌شود!

مهارت شرح
google-maps-platform مجموعه‌ای از مهارت‌ها برای معماری و پیاده‌سازی کد آماده تولید بااستفاده از میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار Google Maps Platform در سراسر وب، Android،‏ iOS، و میاناهای برنامه‌سازی کاربردی سرویس‌های وب برای هریک از موارد زیر: نقشه، مکان، نشانی، زمین‌کدیابی، مسیریابی/زمان تخمینی رسیدن (ازجمله مسیریابی زیست‌محیطی)، جستجوی اطراف، نقشه سه‌بعدی/ «نمای خیابان»/ نقشه ایستا، خوشه‌بندی نشانگرها، سبک سفارشی، طراحی، حصارکشی جغرافیایی، نقشه حرارتی، یا محیطی (کیفیت هوا/گرده/خورشیدی/آب‌وهوا).

شروع کنید

مهارت‌های عامل 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

این روش به‌عنوان فرمان پایانه یا پیام‌واره زبان طبیعی برای نماینده در این موارد آزمایش شده است:

Gemini CLI

این مخزن به‌عنوان افزونه Gemini CLI پیکربندی شده است. می‌توانید آن را بااستفاده از Gemini CLI اضافه کنید:

gemini extensions install https://github.com/googlemaps/agent-skills

دوست‌داشتنی

مهارت‌های عامل Google Maps Platform را در Lovable بااستفاده از واسط کاربر تنظیمات «مهارت‌ها» نصب کنید:

  1. دیدن https://lovable.dev/settings/skills
  2. در بخش «مهارت‌های Workspace»، روی افزودن > وارد کردن از GitHub کلیک کنید.
  3. نشانی وب مهارت اصلی 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 در Code Assist طراحی شده‌اند:

  • مهارت‌های نماینده «پلاتفرم Google Maps»: دستورالعمل‌های سریع و شیوه‌های توصیه‌شده را ارائه دهید که به نماینده می‌گوید چگونه کارهای «پلاتفرم Google Maps» را ازطریق شفاف‌سازی تدریجی با مصرف بهینه از شناسه انجام دهد. این دستورالعمل‌ها به عامل آموزش می‌دهند که چگونه از ابزارهای سرور MCP به‌طور مؤثر استفاده کند.

  • سرور Code Assist MCP: برای گردش‌های کاری توسعه با کمک هوش مصنوعی طراحی شده است و به دستیارهای هوش مصنوعی امکان می‌دهد به‌صورت برنامه‌نویسی‌شده با پروژه‌ها، منابع، و داده‌های Google Maps Platform شما تعامل داشته باشند.

به‌روزرسانی مهارت‌های عامل «پلاتفرم Google Maps»

با اجرای فرمان update می‌توانید همه به‌روزرسانی‌های دردسترس را دریافت کنید و مهارت‌های قدیمی را پاک‌سازی کنید:

Skills CLI

npx skills update google-maps-platform

Gemini CLI

gemini extensions update

اجزای اصلی مهارت

هر مهارت عامل یک بسته تخصصی است که می‌تواند مؤلفه‌های زیر را برای دستیار هوش مصنوعی فراهم کند:

  • دستورالعمل‌های تخصصی: راهنمایی دقیق درباره انجام کارهای خاص، مثل پیاده‌سازی «تکمیل خودکار جا» یا تولید نقشه با «نشانگرهای پیشرفته».
  • روال‌های مطلوب: الگوهای عملکرد و امنیت داخلی برای اطمینان از اینکه برنامه‌تان از همان ابتدا از توصیه‌های «پلاتفرم Google Maps»، ازجمله بهینه‌سازی هزینه، پیروی می‌کند.
  • دستورگان‌های خودکارسازی: کد اجرایی که به عامل هوش مصنوعی شما اجازه می‌دهد راه‌اندازی یا پیکربندی محیط محلی را به‌طور خودکار انجام دهد.
  • استحکام در دنیای واقعی: الگوهای مدیریت خطا و استثنا که مستقیماً از پیاده‌سازی‌های مخزن متن‌باز تأییدشده استخراج شده‌اند.

مزایای استفاده از مهارت‌ها

استفاده از مهارت‌های نماینده تلاش دستی برای جستجوی اسناد را کاهش می‌دهد و درعین‌حال کارایی تعاملات هوش مصنوعی شما را بهبود می‌بخشد.

کاهش هزینه توکن

ادغام‌های هوش مصنوعی سنتی اغلب مقادیر زیادی از اسناد را ازقبل بارگیری می‌کنند که باعث مصرف تعداد زیادی ژتون و افزایش هزینه‌های جلسه می‌شود. مهارت‌های عامل از شفاف‌سازی تدریجی برای به‌حداقل رساندن این سربار استفاده می‌کنند:

  • عامل در ابتدا فقط فراداده‌های خلاصه را «اسکن» می‌کند تا ببیند آیا مهارتی مرتبط است یا نه.
  • دستورالعمل‌ها و منابع دقیق فقط زمانی بار می‌شود که عامل تشخیص دهد برای تکلیف خاص شما ضروری است.

پیاده‌سازی با راهنمایی هوش مصنوعی

به‌جای جستجوی دستی در اسناد، می‌توانید قصدتان را به زبان طبیعی شرح دهید. مهارت‌ها دستیار هوش مصنوعی شما را برای انجام کارهایی مثل موارد زیر راهنمایی می‌کنند:

  • افزودن نقشه با نشانگر به برنامه وب من.
  • «تکمیل خودکار جا» را برای ورودی نشانی پیاده‌سازی کنید.
  • کمکم کن تصویر نقشه ثابتی تولید کنم.

برای مشاهده فهرست کامل مهارت‌های عامل Google Maps Platform، مهارت‌های دردسترس را ببینید.

مراحل بعدی