As habilidades do agente da Plataforma Google Maps (GitHub) são módulos portáteis e autônomos de conhecimento, instruções e fluxos de trabalho específicos da Plataforma Google Maps. Eles foram projetados para ajudar os assistentes de IA a entender as práticas recomendadas da Plataforma Google Maps e executar tarefas complexas com mais precisão e menor custo de token.
Habilidades disponíveis
A Plataforma Google Maps oferece um conjunto de habilidades para produtos principais. Em breve, vamos lançar habilidades para outros produtos e recursos.
| Habilidade | Descrição |
|---|---|
google-maps-platform |
Um conjunto de habilidades para arquitetar e implementar código pronto para produção usando as APIs e os SDKs da Plataforma Google Maps na Web, no Android, no iOS e nas APIs de serviços da Web para qualquer um dos seguintes itens: mapa, lugar, endereço, geocodificação, trajeto/horário previsto de chegada (incluindo trajetos ecológicos), pesquisa por perto, mapa 3D/Street View/estático, clustering de marcadores, estilo personalizado, desenho, fronteira geográfica virtual, mapa de calor ou ambiental (qualidade do ar/pólen/solar/clima). |
Primeiros passos
As habilidades do agente da Plataforma Google Maps funcionam com qualquer assistente de IA que ofereça suporte a habilidades, incluindo Gemini, Cursor, Windsurf, Copilot e Claude.
Instalar habilidades do agente da Plataforma Google Maps
Na maioria dos casos, as habilidades do agente da Plataforma Google Maps podem ser instaladas com um único comando:
CLI de habilidades
Para as
ferramentas de assistência de IA mais usadas,
você pode usar a CLI skills para instalar as habilidades do agente da Plataforma Google Maps.
Execute o seguinte no diretório raiz do seu projeto:
npx skills add googlemaps/agent-skills
Esse método foi testado como um comando de terminal ou um comando de linguagem natural para o agente em:
- AI Studio
- Antigravity
- Claude Code
- Replit (instruções alternativas: Usar a interface do editor de projetos)
CLI do Gemini
Esse repositório é configurado como uma extensão da CLI do Gemini. Você pode adicioná-la usando a CLI do Gemini:
gemini extensions install https://github.com/googlemaps/agent-skills
Lovable
Instale as habilidades do agente da Plataforma Google Maps no Lovable usando a interface de configurações de habilidades:
- Visitar
https://lovable.dev/settings/skills - Em "Habilidades do Workspace", clique em Adicionar > Importar do GitHub.
- Cole o URL da habilidade principal de
google-maps-platform:
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform
Usar as habilidades do agente da Plataforma Google Maps
Acionar automaticamente ou invocar manualmente as habilidades do agente
Os assistentes de IA são projetados para usar habilidades automaticamente sempre que detectam que
a descrição de uma habilidade corresponde à sua solicitação atual. No entanto, as habilidades também podem ser
invocadas manualmente. Para fazer isso, digite / no chat do agente e pesquise o nome da habilidade.
Por exemplo, após a instalação, você pode digitar o seguinte no chat do agente para solicitar um novo recurso no aplicativo que está criando:
/google-maps-platform Add a 3D map featuring a marker for the user's location
Usar habilidades com o servidor MCP do Code Assist
As habilidades do agente foram projetadas para complementar o servidor MCP do Code Assist:
Habilidades do agente da Plataforma Google Maps: forneça instruções rápidas e práticas recomendadas que informam a um agente como realizar tarefas da Plataforma Google Maps usando a divulgação progressiva eficiente em termos de tokens. Eles ensinam o agente a usar as ferramentas do servidor MCP de maneira eficaz.
Servidor MCP do Code Assist: projetado para fluxos de trabalho de desenvolvimento assistido por IA, permitindo que assistentes de IA interajam com seus projetos, recursos e dados da Plataforma Google Maps de maneira programática.
Atualizar as habilidades do agente da Plataforma Google Maps
Para conferir todas as atualizações disponíveis e limpar as habilidades desatualizadas, execute
o comando update:
CLI de habilidades
npx skills update google-maps-platform
CLI do Gemini
gemini extensions update
Principais componentes de uma habilidade
Cada habilidade de agente é um pacote especializado que pode fornecer ao assistente de IA os seguintes componentes:
- Instruções especializadas: orientações detalhadas sobre como realizar tarefas específicas, como implementar o Place Autocomplete ou gerar um mapa com Marcadores Avançados.
- Práticas recomendadas: padrões de segurança e desempenho integrados para garantir que seu app siga as recomendações da Plataforma Google Maps desde o início, incluindo a otimização de custos.
- Scripts de automação: código executável que permite que seu agente de IA realize a configuração ou a configuração do ambiente local automaticamente.
- Robustez no mundo real: padrões de tratamento de erros e exceções extraídos diretamente de implementações de repositórios de código aberto verificados.
Benefícios de usar habilidades
Usar as habilidades do agente reduz o esforço manual de pesquisar documentação e melhora a eficiência das suas interações com a IA.
Custos de token reduzidos
As integrações convencionais de IA geralmente carregam grandes quantidades de documentação antecipadamente, o que consome muitos tokens e aumenta os custos da sessão. As habilidades do agente usam a divulgação progressiva para minimizar essa sobrecarga:
- Inicialmente, o agente apenas "verifica" metadados breves para saber se uma habilidade é relevante.
- Instruções e recursos detalhados só são carregados quando o agente determina que são necessários para sua tarefa específica.
Implementação guiada por IA
Em vez de pesquisar manualmente na documentação, descreva sua intenção em linguagem natural. As habilidades orientam o assistente de IA a realizar tarefas como:
- Adicione um mapa com um marcador ao meu app da Web.
- Implementar o Place Autocomplete para entrada de endereço.
- Quero ajuda para gerar uma imagem de mapa estática.
Para uma lista completa das habilidades do agente da Plataforma Google Maps, consulte Habilidades disponíveis.
Próximas etapas
- Saiba como usar as habilidades do agente com a CLI do Gemini.
- Saiba como usar as habilidades do agente com o Antigravity.