Habilidades dos agentes da Plataforma Google Maps

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.

Skill Descrição
google-maps-platform Um conjunto de habilidades para arquitetar e implementar código pronto para produção usando APIs e SDKs da Plataforma Google Maps na Web, Android, iOS e APIs de serviços da Web para qualquer um dos seguintes: mapa, lugar, endereço, geocodificação, rotas/ETA (incluindo rotas ecológicas), pesquisa nas proximidades, mapa 3D/Street View/estático, agrupamento de marcadores, estilização personalizada, desenho, geofencing, 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, é possível usar a CLI skills para instalar as habilidades do agente da Plataforma Google Maps. Execute o seguinte no diretório raiz do 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:

CLI do Gemini

Esse repositório está configurado como uma extensão da CLI do Gemini. Você pode adicionar 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:

  1. Visitar https://lovable.dev/settings/skills
  2. Em "Habilidades do Workspace", clique em Adicionar > Importar do GitHub.
  3. Cole o URL da principal habilidade do 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, depois da instalação, digite o seguinte no chat do agente para pedir um novo recurso no aplicativo que você 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 skill

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 verificadas de repositórios de código aberto.

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 o disclosure progressivo 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.
  • Implemente o Place Autocomplete para entrada de endereços.
  • Me ajude a gerar uma imagem estática do mapa.

Para uma lista completa das habilidades do agente da Plataforma Google Maps, consulte Habilidades disponíveis.

Próximas etapas