Kit de ferramentas de interface do Maps Agentic (experimental)

Visão geral

O kit de ferramentas da interface agêntica da Plataforma Google Maps é um kit de ferramentas para desenvolvedores projetado especificamente para a era da IA conversacional. Ele oferece um conjunto de instruções do sistema LLM e uma biblioteca de componentes de interface que ajudam modelos de linguagem grandes (LLMs) e agentes de IA a criar respostas visuais interativas em tempo real para dados geoespaciais.

Em vez de codificar elementos visuais, os desenvolvedores podem usar o kit de ferramentas para traduzir "instruções baseadas em intents" de um LLM em mapas dinâmicos e sensíveis ao contexto e exibir lugares, mantendo os usuários engajados na experiência de chat.

Os casos de uso comuns incluem:

  • Assistentes de IA:aumentar as respostas de texto com contexto visual para consultas locais (por exemplo, hotéis, restaurantes).
  • Planejadores de viagens:mostrar mapas, rotas e detalhes de lugares inline.
  • Desenvolvimento com pouco código:reduzir o atrito da orquestração manual de várias APIs Maps.

Principais conceitos

1. Interface pronta para agentes

Ative recursos visuais escalonáveis e de alta qualidade, como cartões de lugares, visualizações de mapas imersivas e prévias de rotas, projetados especificamente para experiências em tempo real com tecnologia LLM.

2. Experiências ricas em contexto

Permita que os usuários descubram e decidam sem sair do chat. Fornecer um contexto de mapas inline avançado, como galerias de fotos, classificações ou opções de rotas, mantém os usuários engajados e dá confiança para que eles tomem medidas.

3. Componentes inteligentes

O kit de ferramentas da interface agêntica processa a lógica geoespacial complexa automaticamente, adaptando instantaneamente o contexto e o layout à intent do usuário, enquanto o estilo garante que cada interação esteja conectada à sua marca.

4. Independente de LLM

O kit de ferramentas da interface agêntica é independente de modelo para seu conjunto de soluções de IA. Se você usa o Gemini ou modelos da OpenAI ou da Anthropic, e independentemente da fonte de dados fundamentada, o kit de ferramentas da interface agêntica fornece a camada de apresentação dedicada para visualizar dados de localização.

Primeiros passos

Para começar a usar o kit de ferramentas da interface agêntica, inicialize-o com uma chave da API Google Gemini e uma chave da API Plataforma Google Maps.

Consulte o Guia para iniciantes para instruções detalhadas.

Resultados da interface

O kit de ferramentas da interface agêntica oferece um conjunto abrangente de recursos de interface especializados.

  • Detalhes do lugar (compacto): informações específicas de PDI em um cartão compacto.
  • Mapas inline: localizador de pontos ou áreas.
  • Mapa inline + rota: navegação ou prévias de trajetos.
  • Detalhes do mapa inline: contexto ou ambiente do local usando imagens avançadas.

Instruções do sistema

O kit de ferramentas da interface agêntica fornece "instruções do sistema" para orientar o LLM do host sobre quando e como construir a interface.

Diretrizes

O modelo do host precisa entender:

  1. Qual componente corresponde a qual intent do usuário (por exemplo, usar o mapa inline para consultas de orientação).

  2. Mapeamento de parâmetros da linguagem natural para o esquema (por exemplo, se o usuário pedir "cênico", defina o modo do mapa como satélite).

Esquema de uso da ferramenta

O kit de ferramentas da interface agêntica expõe um catálogo de definições compatíveis com o esquema de uso de ferramentas LLM padrão (por exemplo, chamadas de função).

Políticas e Termos de Serviço

Esta biblioteca usa serviços da Plataforma Google Maps. O uso dos serviços da Plataforma Google Maps por meio dessa biblioteca está sujeito aos Termos de Serviço da Plataforma Google Maps . Algumas APIs e serviços de back-end, como Grounding Lite e embasamento com o Google Maps, têm requisitos adicionais dos termos adicionais de serviço que também precisam ser atendidos.

Essa biblioteca não é um serviço principal da Plataforma Google Maps. Portanto, os Termos de Serviço da Plataforma Google Maps (por exemplo, Serviços de Suporte Técnico, Contratos de Nível de Serviço e Política de Suspensão de Uso) não se aplicam ao código nessa biblioteca.

Suporte

Essa biblioteca é oferecida por meio de uma licença de código aberto. Ela não é regida por as Diretrizes de Serviços de Suporte Técnico da Plataforma Google Maps, pelo SLA, ou pela Política de Suspensão de Uso. No entanto, todos os serviços da Plataforma Google Maps usados pela biblioteca continuam sujeitos aos Termos de Serviço da Plataforma Google Maps.

Requisitos de atribuição para fontes do Google Maps

Cada resposta de ferramenta do kit de ferramentas da interface agêntica inclui fontes. Ao apresentar resultados que usam ferramentas fornecidas pelo kit, inclua as fontes associadas do Google Maps de uma maneira que atenda aos seguintes requisitos:

  • As fontes do Google Maps precisam seguir imediatamente o conteúdo gerado que elas oferecem suporte.
  • As fontes do Google Maps precisam ser visualizadas em uma interação do usuário.

Enviar comentários

Para enviar feedback sobre o kit de ferramentas da interface agêntica do Maps, use os seguintes formulários: