جعبه‌ابزار «دستیار کدنویسی پلاتفرم Google Maps» (آزمایشی)

جعبه‌ابزار Google Maps Platform Code Assist یک سرور «پروتکل بافتار مدل» (MCP) است که پاسخ‌های مدل‌های زبانی بزرگ (LLM) را که برای توسعه برنامه‌ها با Google Maps Platform استفاده می‌شوند بهبود می‌بخشد. این کار با استناد پاسخ‌ها به اسناد رسمی و به‌روز و نمونه‌های کد انجام می‌شود.

ازآنجایی‌که سرور MCP هنگام درخواست مدل به محتوا دسترسی پیدا می‌کند، بافت LLM دررابطه‌با Google Maps Platform نباید به داده‌های دردسترس در تاریخ آموزش مدل محدود شود.

منابع Google Maps Platform که سرور MCP می‌تواند به آن‌ها دسترسی داشته باشد عبارت‌اند از:

  • اسناد پلاتفرم Google Maps
  • شرایط خدمات Google Maps Platform
  • مرکز اعتماد «پلاتفرم Google Maps»
  • مخزن‌های کد در سازمان‌های رسمی GitHub پلاتفرم Google Maps

ابزارها

Maps Code Assist ابزارهایی را ارائه می‌دهد که به مدل‌های زبانی بزرگ امکان می‌دهد به قابلیت‌های زیر دسترسی داشته باشند:

  • retrieve-instructions: ابزار کمکی که مشتری برای دریافت دستورالعمل‌های مهم سیستم درباره نحوه استدلال بهتر درباره هدف کاربر و تدوین کردن پیام‌های مؤثر برای ابزار retrieve-google-maps-platform-docs استفاده می‌کند.
  • retrieve-google-maps-platform-docs: ابزار اصلی. این ابزار یک پُرسمان زبان طبیعی را می‌گیرد و آن را به موتور «تولید با کمک بازیابی» (RAG) میزبانی‌شده ارسال می‌کند. موتور RAG نسخه‌های جدید اسناد رسمی، آموزش‌ها، و نمونه کدهای Google Maps Platform را جستجو می‌کند و بافت مربوطه را به مدل زبانی بزرگ برمی‌گرداند تا پاسخ دقیقی تولید کند.

صورت‌حساب

درحالی‌که «دستیار کد Maps» در مرحله «آزمایشی» است، استفاده از آن هزینه‌ای ندارد.

خط‌مشی‌ها و شرایط خدمات

«دستیار کد Maps» تابع شرایط خدمات پلاتفرم Google Maps، ازجمله شرایط خدمات خاص سرویس برای این سرویس است. این بخش الزامات تکمیلی استفاده از سرویس را برای Maps Code Assist، ازجمله مدل‌های زبانی بزرگ سازگار و الزامات ذکر منبع، شرح می‌دهد.

الزامات مدل‌های زبانی بزرگ سازگار

فقط می‌توانید از Maps Code Assist با مدل زبانی بزرگی استفاده کنید که با «شرایط خدمات پلاتفرم Google Maps» مطابقت داشته باشد.

برای مثال، مسئولیت دارید مطمئن شوید که «محتوای Google Maps» توسط «مدل زبانی بزرگ» انتخابی شما ذخیره، نگهداری، یا برای بهبود آن استفاده نمی‌شود. قبل‌از استفاده از Maps Code Assist، باید «شرایط خدمات» هر مدلی را که قصد دارید با Maps Code Assist استفاده کنید مرور کنید. نباید از «دستیار کد Maps» با هیچ مدلی که از داده‌های ورودی در مدل برای آموزش یا بهبود مدل استفاده می‌کند استفاده کنید. مسئولیت اطمینان از اینکه استفاده شما از مدل کاملاً با محدودیت‌های «محتوای Google Maps» در «شرایط خدمات Google Maps Platform»، ازجمله شرایط خاص سرویس، مطابقت دارد برعهده شما است.

الزامات ذکر منبع برای منابع Google Maps

هنگام ارائه نتایجی که از ابزارهای ارائه‌شده توسط Maps Code Assist استفاده می‌کنند، باید منابع Google Maps مرتبط را اضافه کنید.

پیکربندی مدل‌های زبانی بزرگ برای دسترسی به سرور MCP‏ Maps Code Assist

با دنبال کردن اسناد پیکربندی MCP مربوطه و استفاده از نقطه پایانی سرور Code Assist MCP، می‌توانید LLM را برای دسترسی به سرور MCP پیکربندی کنید: https://mapscodeassist.googleapis.com/mcp.

سرور MCP «دستیار کدنویسی Maps» از انتقال HTTP جاری‌شدنی استفاده می‌کند. برای اطلاعات بیشتر، پیکربندی MCP در برنامه هوش مصنوعی را ببینید.

موارد استفاده نمونه

پس‌از پیکربندی، می‌توانید درباره «پلاتفرم Google Maps» از مدل زبانی بزرگتان سؤال بپرسید. چند پیام‌واره نمونه در اینجا آمده است:

  • «چگونه به برنامه Android خود نقشه اضافه کنم؟»
  • «بهترین روش برای دریافت مکان فعلی کاربر روی نقشه در iOS چیست؟»
  • «مثالی از استفاده از سرویس مسیرها در Maps JavaScript API ارائه بده.»

ابزارهای دردسترس

برای مشاهده جزئیات ابزارهای MCP دردسترس و شرح آن‌ها برای سرور MCP «دستیار کد Maps»، به مرجع MCP «دستیار کد Maps» مراجعه کنید.

فهرست کردن ابزارها با درخواست اچ‌تی‌تی‌پی

برای تأیید اینکه سرور کار می‌کند و دیدن فهرست ابزارهای دردسترس، می‌توانید درخواست اچ‌تی‌تی‌پی tools/list را مستقیماً به سرور MCP راه دور «دستیار کد Maps» ارسال کنید. روش tools/list به اصالت‌سنجی نیاز ندارد.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": "1"
  }' \
  https://mapscodeassist.googleapis.com/mcp

هم‌رسانی بازخورد

برای هم‌رسانی بازخورد درباره «دستیار کد Maps»، از فرم‌های زیر استفاده کنید: