Навыки агента платформы 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
Этот метод был протестирован в качестве команды терминала или запроса на естественном языке к агенту в следующих средах:
- AI Studio
- Antigravity
- Claude Code
- Replit (альтернативные инструкции: Использование интерфейса редактора проектов)
Gemini CLI
Это хранилище настроено как расширение Gemini CLI. Вы можете добавить его с помощью Gemini CLI:
gemini extensions install https://github.com/googlemaps/agent-skills
Lovable
Установите навыки агента платформы Google Карт в Lovable с помощью интерфейса настроек навыков.
- Посетить
https://lovable.dev/settings/skills - В разделе "Навыки Workspace" нажмите Добавить > Импортировать из GitHub.
- Вставьте 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 Карт приведен в разделе Доступные навыки.
Дальнейшие действия
- Подробнее о том, как использовать навыки агента с Gemini CLI…
- Подробнее о том, как использовать навыки агента в Antigravity…