Visão geral
O kit de ferramentas de interface do usuário com agente da Plataforma Google Maps é um kit de ferramentas para desenvolvedores criado especificamente para a era da IA de conversação. Ele fornece um conjunto de instruções do sistema de 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 intenção" de um LLM em mapas e telas de lugares dinâmicos e sensíveis ao contexto, mantendo os usuários engajados na experiência de chat.
Os casos de uso comuns incluem:
- Assistentes de IA:aumentam as respostas de texto com contexto visual para consultas locais (por exemplo, hotéis, restaurantes).
- Planejadores de viagens:mostram mapas, rotas e detalhes de lugares inline.
- Desenvolvimento com pouco código:reduz a dificuldade de orquestrar manualmente várias APIs do Maps.
Principais conceitos
1. Interface pronta para agentes
Ative recursos visuais escalonáveis e de alta qualidade, como cards de lugares, visualizações imersivas de mapas e prévias de rotas, projetados especificamente para experiências em tempo real com tecnologia de LLM.
2. Experiências ricas em contexto
Capacite os usuários a descobrir e decidir sem sair da conversa. 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á a eles a confiança necessária para agir.
3. Componentes inteligentes
O kit de ferramentas de interface do usuário agentic processa automaticamente a lógica geoespacial complexa, adaptando instantaneamente o contexto e o layout à intenção do usuário, além de aplicar estilos para garantir que cada interação pareça conectada à sua marca.
4. Independente de LLM
O Agentic UI Toolkit é independente de modelo para seu conjunto de soluções de IA. Se você usa o Gemini ou modelos da OpenAI ou da Anthropic, e independente da sua fonte de dados fundamentados, o kit de ferramentas de interface do usuário 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 de UI generativa, é necessário inicializá-lo com uma única chave de API. Isso abstrai os serviços do Maps subjacentes para que você não precise gerenciar APIs separadas.
Consulte o Guia para iniciantes para instruções detalhadas.
Resultados da interface
O kit de ferramentas de interface agêntica oferece um conjunto abrangente de recursos especializados de interface prontos para uso.
- Detalhes do lugar (compacto): informações específicas de um PDI em um card compacto.
- Mapas inline: localizador de pontos ou áreas.
- Mapa + rota inline: prévias de navegação ou trajeto.
- Detalhe do mapa em linha: ambiente ou contexto do local usando imagens avançadas.
Instruções do sistema
O kit de ferramentas de UI agentic fornece "instruções do sistema" para orientar o LLM host sobre quando e como construir a UI.
Diretrizes
O modelo de host precisa entender:
Qual componente corresponde a qual intenção do usuário (por exemplo, usar o mapa inline para consultas de orientação).
Mapeamento de parâmetros da linguagem natural para o esquema (por exemplo, se o usuário pedir "panorâmico", defina o modo mapa como satélite).
Esquema de uso da ferramenta
O kit de ferramentas de UI agentic expõe um catálogo de definições compatíveis com o esquema de uso de ferramentas padrão do LLM (por exemplo, chamada de função).
Políticas e Termos de Serviço
Essa biblioteca usa os serviços da Plataforma Google Maps. O uso dos serviços da Plataforma Google Maps por esta biblioteca está sujeito aos Termos de Serviço da Plataforma Google Maps. Algumas APIs e serviços de back-end, como o Grounding Lite e o embasamento com o Google Maps, têm outros requisitos de Termos 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 nesta biblioteca.
Suporte
Essa biblioteca é oferecida por uma licença de código aberto. Ela não é regida pelas 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 da ferramenta do kit de ferramentas de interface do usuário do agente inclui fontes. Ao apresentar resultados que usam ferramentas fornecidas pelo kit, inclua as fontes associadas do Google Maps de uma forma que atenda aos seguintes requisitos:
- As fontes do Google Maps precisam aparecer imediatamente após o conteúdo gerado que elas embasam.
- As fontes do Google Maps precisam estar visíveis em uma interação do usuário.