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. Elas foram projetadas 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 Uma coleção de habilidades para arquitetar e implementar código pronto para produção usando APIs e SDKs da Plataforma Google Maps na Web, no Android, no iOS e em APIs de serviços da Web para qualquer um destes: mapa, lugar, endereço, geocodificação, rota/ETA (incluindo rotas ecológicas), pesquisa por proximidade, mapa 3D/Street View/estático, agrupamento de marcadores, estilo personalizado, 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 as 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 populares, você pode usar a skills CLI 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:

CLI do Gemini

Esse repositório está configurado como uma extensão da CLI do Gemini. Você pode adicioná-lo 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. Acesse https://lovable.dev/settings/skills
  2. Em "Habilidades do espaço de trabalho", clique em Adicionar > Importar do GitHub.
  3. Cole o URL da habilidade principal google-maps-platform:
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform

Atualizar as habilidades do agente da Plataforma Google Maps

Para conferir todas as atualizações disponíveis e limpar habilidades desatualizadas, execute o comando update:

CLI de habilidades 

npx skills update

CLI do Gemini 

gemini extensions update

Usar as habilidades do agente da Plataforma Google Maps

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.

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 destilados 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 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:

  • Adicionar um mapa com um marcador ao meu app da Web.
  • Implementar o Place Autocomplete para entrada de endereço.
  • Me ajude a gerar uma imagem de mapa estático. Para uma lista completa das habilidades do agente da Plataforma Google Maps, consulte Habilidades disponíveis.

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. Elas 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.

Próximas etapas