نمای کلی
جعبه‌ابزار میانای کاربر عامل‌گرای «پلاتفرم Maps» جعبه‌ابزار توسعه‌دهنده‌ای است که به‌طور خاص برای عصر هوش مصنوعی مکالمه‌ای طراحی شده است. این ابزار مجموعه‌ای از دستورالعمل‌های سیستم LLM و کتابخانه‌ای از عناصر رابط کاربری ارائه می‌دهد که به مدل‌های زبانی بزرگ (LLM) و عامل‌های هوش مصنوعی کمک می‌کند پاسخ‌های تصویری تعاملی و هم‌زمان برای داده‌های زمین‌مکانی بسازند.
به‌جای کدبندی سخت عناصر دیداری، می‌توانید از جعبه‌ابزار برای ترجمه «دستورالعمل‌های مبتنی بر هدف» از مدل زبانی بزرگ به نقشه‌ها و نمایشگرهای مکان پویا و زمینه‌آگاه استفاده کنید و کاربران را در تجربه گپ درگیر نگه دارید.
موارد استفاده رایج شامل موارد زیر است:
- دستیارهای هوش مصنوعی: افزودن بافت تصویری به پاسخ‌های نوشتاری برای پُرسمان‌های محلی، مثل هتل‌ها و رستوران‌ها.
- برنامه‌ریزان سفر: نمایش نقشه‌ها، مسیرها، و جزئیات مکان به‌صورت درون‌خطی.
- توسعه با کد کم: کاهش اصطکاک هماهنگی دستی چندین «میانای برنامه‌سازی کاربردی» Maps در نقاط تماس وب و تلفن همراه.
مفاهیم کلیدی
۱. میانای کاربر آماده عامل
عناصر دیداری با کیفیت بالا و مقیاس‌پذیر—مانند کارت‌های مکان، نمای نقشه فراگیر، و پیش‌نمایش مسیر—بسازید که به‌طور ویژه برای تجربه‌های هم‌زمان با بهره‌گیری از مدل زبانی بزرگ طراحی شده‌اند.
۲. تجربه‌های غنی از بافتار
به کاربران کمک کنید بدون ترک گپ، کاوش کنند و تصمیم بگیرند. برای حفظ تعامل کاربران و اطمینان دادن به آن‌ها برای اقدام کردن، بافت غنی درون‌خطی نقشه، مثل گالری عکس، رده‌بندی، یا گزینه‌های مسیر ارائه دهید.
۳. عناصر هوشمند
ابزارک «میانای کاربری عامل» به‌طور خودکار از عهده منطق پیچیده فضایی-مکانی برمی‌آید و درعین‌حال با سبک‌دهی کردن، زمینه و چیدمان را فوراً با هدف کاربر تطبیق می‌دهد تا هر تعاملی با نمانام شما مرتبط باشد.
۴. مستقل از مدل زبانی بزرگ
جعبه‌ابزار «میانای کاربر عامل‌گرا» نسبت‌به پشته هوش مصنوعی شما مدل‌ناشناس است. چه از Gemini استفاده کنید، چه از مدل‌های OpenAI یا Anthropic، و صرف‌نظر از منبع داده‌های زمینه‌ای شما، این ابزارک یک لایه ارائه اختصاصی برای دیداری‌سازی داده‌های مکان ارائه می‌دهد.
۵. معماری الگوی سمت سرور
معماری الگوی سمت سرور با انجام ازهم بازکردن الگو و حل پارامتر در سمت سرور، سرعت پردازش عنصر را افزایش می‌دهد. این کار باعث بهبود تأخیر برای تجربه‌های مکالمه‌ای هم‌زمان می‌شود.
شروع کنید
برای شروع استفاده از کیت ابزار «واسط کاربر عامل»، باید آن را با کلید Google Gemini API و کلید Google Maps Platform API مقداردهی اولیه کنید.
برای اطلاعات بیشتر، به شروع به کار مراجعه کنید.
نتایج میانای کاربر
جعبه‌ابزار «میانای کاربر عامل‌گرا» مجموعه‌ای جامع از قابلیت‌های تخصصی میانای کاربر را به‌صورت آماده ارائه می‌دهد. این عناصر در سراسر وب، Android، و iOS دردسترس هستند.
- جزئیات مکان، فشرده: اطلاعات خاص مکان موردعلاقه (POI) در کارتی فشرده
- نقشه‌های به‌خط: مکان‌یاب نقطه یا ناحیه
- نقشه به‌خط + مسیر: پیش‌نمایش‌های پیمایش یا سفر
- جزئیات نقشه درون‌خطی: جزئیات مکان یا زمینه بااستفاده از تصاویر غنی
دستورالعمل‌های سیستم
ابزارک Agentic UI «دستورالعمل‌های سیستم» را برای راهنمایی مدل زبانی بزرگ میزبان درباره زمان و نحوه ساختن میانای کاربری ارائه می‌دهد.
رهنمودها
مدل میزبان باید مفاهیم زیر را درک کند:
- نحوه مطابقت دادن عناصر با هدف کاربر، مثلاً استفاده از «نقشه درون‌خط» برای پُرسمان‌های جهت‌یابی.
- نحوه نگاشت پارامترها از زبان طبیعی به طرحواره، مثلاً تنظیم حالت نقشه روی ماهواره اگر کاربر درخواست «منظره زیبا» کند.
طرحواره استفاده از ابزار
جعبه ابزار «میانای کاربر عامل» کاتالوگی از تعاریف سازگار با طرحواره استاندارد استفاده از ابزار LLM، مانند فراخوانی تابع، را آشکار می‌کند.
خط‌مشی‌ها و شرایط خدمات
این کتابخانه از سرویس‌های «پلاتفرم Google Maps» استفاده می‌کند. استفاده از خدمات «پلاتفرم Google Maps» ازطریق این کتابخانه تابع «پلاتفرم Google Maps» شرایط خدمات است. برخی‌از میاناهای برنامه‌سازی کاربردی و سرویس‌های زیرینه، مثل Grounding Lite و Grounding with Google Maps، شرایط خدمات اضافی دارند که باید رعایت شوند.
این کتابخانه «سرویس اصلی پلاتفرم Google Maps» نیست. بنابراین، «شرایط خدمات پلاتفرم Google Maps»—مثل «خدمات پشتیبانی فنی»، «قراردادهای سطح خدمات»، و «خط‌مشی منسوخ‌سازی»—برای کد موجود در این کتابخانه اعمال نمی‌شود.
پشتیبانی
این کتابخانه ازطریق پروانه متن‌باز ارائه می‌شود. این سرویس تحت حاکمیت «دستورالعمل‌های خدمات پشتیبانی فنی پلاتفرم Google Maps»، SLA، یا خط‌مشی منسوخ شدن قرار ندارد. بااین‌حال، هرگونه سرویس «پلاتفرم Google Maps» که کتابخانه استفاده می‌کند همچنان مشمول «شرایط خدمات پلاتفرم Google Maps» است.
الزامات ارجاع برای منابع Google Maps
هر پاسخ ابزار از ابزار کار میانای کاربر عامل‌گرا شامل منابع است. هنگام ارائه نتایجی که از ابزارهای ارائه‌شده توسط جعبه‌ابزار استفاده می‌کنند، باید منابع مرتبط Google Maps را به گونه‌ای که الزامات زیر را برآورده کند، اضافه کنید:
- منابع Google Maps باید بلافاصله پس‌از محتوای تولیدشده‌ای که منابع پشتیبانی می‌کنند، ذکر شوند.
- منابع Google Maps باید در یک تعامل کاربر قابل‌مشاهده باشند.
هم‌رسانی بازخورد
برای هم‌رسانی بازخورد درباره ابزار کار میانای کاربر عامل‌گرای Maps، از فرم‌های زیر استفاده کنید: