Навыки агента платформы Google Карт

Навыки агента платформы Google Карт (GitHub) – это переносимые автономные модули знаний, инструкций и рабочих процессов, связанных с платформой Google Карт. Они помогут ИИ-помощникам понимать, как лучше всего использовать платформу Google Карт, и выполнять сложные задачи с большей точностью и меньшими затратами токенов.

Доступные навыки

Платформа Google Карт предоставляет набор навыков для основных продуктов. Скоро появятся навыки для других продуктов и функций.

Навык Описание
google-maps-platform Набор навыков для разработки и внедрения готового к использованию кода с помощью API и SDK платформы Google Карт для веб-сервисов, Android и iOS, а также API веб-сервисов для любого из следующих решений: карты, места, адреса, геокодирование, маршруты/расчетное время прибытия (включая экологичные маршруты), поиск поблизости, 3D/Просмотр улиц/статическая карта, библиотека кластеризации маркеров, собственный стиль, рисование, геозоны, тепловая карта или окружающая среда (качество воздуха/пыльца/солнечная активность/погода). Весь нетривиальный код основан на недавно полученных документах, предоставленных сервисом Code Assist платформы Google Карт (без использования памяти данных для обучения).

Начать

Навыки агента платформы Google Карт работают с любым ИИ-помощником, который поддерживает навыки, включая Gemini, Cursor, Windsurf, Copilot и Claude.

Как установить навыки агента платформы Google Карт

В большинстве случаев навыки агента платформы Google Карт можно установить с помощью одной команды:

CLI Навыков

Для самых популярных инструментов с ИИ-помощником вы можете использовать CLI skills, чтобы установить навыки агента платформы Google Карт. Выполните следующую команду в корневом каталоге проекта:

npx skills add googlemaps/agent-skills

Этот метод был протестирован в качестве команды терминала или запроса на естественном языке к агенту в следующих средах:

Gemini CLI

Это хранилище настроено как расширение Gemini CLI. Вы можете добавить его с помощью Gemini CLI:

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

Lovable

Установите навыки агента платформы Google Карт в Lovable с помощью интерфейса настроек навыков.

  1. Посетить https://lovable.dev/settings/skills
  2. В разделе "Навыки Workspace" нажмите Добавить > Импортировать из GitHub.
  3. Вставьте 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

Как использовать навыки вместе с MCP-сервером Code Assist

Навыки агента дополняют MCP-сервер Code Assist.

  • Навыки агента платформы Google Карт. Краткие инструкции и рекомендации, которые объясняют агенту, как выполнять задачи платформы Google Карт, используя эффективное с точки зрения токенов прогрессивное раскрытие информации. Они обучают агента, как эффективно использовать инструменты MCP-сервера.

  • Сервер MCP Code Assist. Разработан для рабочих процессов с использованием ИИ. Позволяет ИИ-помощникам программно взаимодействовать с вашими проектами, ресурсами и данными платформы Google Карт.

Добавьте навык Developer Knowledge

Чтобы ИИ-помощник мог искать информацию в официальной документации Google для разработчиков, в том числе в документации по платформе Google Карт на сайте developers.google.com, установите навык агента retrieving-developer-knowledge вместе с навыками агента платформы Google Карт. Этот навык учит Ассистента запрашивать информацию у сервера MCP Developer Knowledge, чтобы ответы, охватывающие платформу Google Карт и другие продукты 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 Карт

Чтобы получить все доступные обновления и удалить устаревшие навыки, выполните команду update:

CLI Навыков

npx skills update google-maps-platform

Gemini CLI

gemini extensions update

Основные компоненты навыка

Каждый навык агента – это специализированный пакет, который может предоставить ИИ-помощнику следующие компоненты:

  • Специализированные инструкции. Подробные руководства по выполнению определенных задач, например по реализации автозаполнения мест или созданию карты с расширенными маркерами.
  • Рекомендации. Встроенные шаблоны безопасности и производительности, которые гарантируют, что ваше приложение с самого начала будет соответствовать рекомендациям платформы Google Карт, включая оптимизацию затрат.
  • Скрипты автоматизации. Исполняемый код, который позволяет ИИ-агенту автоматически настраивать локальную среду.
  • Надежность в реальных условиях. Шаблоны обработки ошибок и исключений, полученные непосредственно из проверенных реализаций репозиториев с открытым исходным кодом.

Преимущества использования навыков

Использование навыков агента снижает необходимость вручную искать документацию и повышает эффективность взаимодействия с ИИ.

Снижение стоимости токенов

Обычно при интеграции ИИ загружается большой объем документации, что приводит к значительному расходу токенов и увеличению стоимости сеанса. Чтобы минимизировать эти затраты, навыки агента используют постепенное раскрытие:

  • Сначала агент только сканирует краткие метаданные, чтобы определить, подходит ли навык.
  • Подробные инструкции и ресурсы загружаются, только когда агент определяет, что они необходимы для выполнения конкретной задачи.

Реализация с помощью ИИ

Вместо того чтобы вручную искать информацию в документации, вы можете описать свое намерение на естественном языке. Навыки помогают ИИ-помощнику выполнять такие задачи, как:

  • Добавление карты с маркером в веб-приложение
  • Реализуйте автозаполнение мест для ввода адресов.
  • Помоги мне создать изображение со статической картой.

Полный список навыков агента платформы Google Карт приведен в разделе Доступные навыки.

Дальнейшие действия