Visão geral
O Agentic UI Toolkit da Plataforma Google Maps é um kit de ferramentas para desenvolvedores projetado 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, use o kit de ferramentas para traduzir "instruções baseadas em intenção" de um LLM em mapas e exibições de lugares dinâmicos e sensíveis ao contexto, mantendo o engajamento do usuário na experiência de chat.
Os casos de uso comuns são:
- Assistentes de IA: complementam as respostas de texto com contexto visual para consultas locais, como hotéis e restaurantes.
- Planejadores de viagem: mostram mapas, rotas e Place Details inline.
- Desenvolvimento com pouco código: reduz o atrito de orquestrar manualmente várias APIs Maps em pontos de contato da Web e de dispositivos móveis.
Principais conceitos
1. Interface pronta para agentes
Crie recursos visuais escalonáveis e de alta qualidade, como cards de lugares, visualizações de mapas imersivas e prévias de trajetos, projetados especificamente para experiências em tempo real com tecnologia de LLM.
2. Experiências ricas em contexto
Ajude os usuários a descobrir e decidir sem sair da conversa. Forneça um contexto avançado de mapas inline, como galerias de fotos, classificações ou opções de trajeto, para manter os usuários engajados e dar a eles a confiança necessária para agir.
3. Componentes inteligentes
O Agentic UI Toolkit lida com lógica geoespacial complexa automaticamente, adaptando instantaneamente o contexto e o layout à intenção do usuário e aplicando estilos para garantir que cada interação esteja conectada à sua marca.
4. Independente de LLM
O Agentic UI Toolkit é independente de modelo para seu conjunto de soluções de IA. Seja usando o Gemini, modelos da OpenAI ou da Anthropic, e independentemente da fonte de dados de embasamento, o kit de ferramentas oferece uma camada de apresentação dedicada para visualizar dados de local.
5. Arquitetura de modelos do lado do servidor
A arquitetura de modelo do lado do servidor acelera a renderização de componentes ao realizar a expansão de modelos e a resolução de parâmetros no lado do servidor. Isso melhora a latência para experiências de conversa em tempo real.
Primeiros passos
Para começar a usar o Agentic UI Toolkit, é necessário inicializá-lo com uma chave de API do Google Gemini e uma chave de API da Plataforma Google Maps.
Para mais informações, consulte Começar.
Resultados da interface
O Agentic UI Toolkit oferece um pacote abrangente de recursos de interface especializados prontos para uso. Esses componentes estão disponíveis na Web, no Android e no iOS.
- Place Detail, compact: informações específicas de um ponto de interesse (PDI) em um card compacto.
- Mapas inline: localizador de pontos ou áreas
- Mapa inline + trajeto: prévias de navegação ou jornada
- Detalhes do mapa inline: detalhes ou contexto do local usando imagens avançadas.
Instruções do sistema
O Agentic UI Toolkit fornece "instruções do sistema" para orientar o LLM host sobre quando e como criar a interface.
Diretrizes
O modelo de host precisa entender os seguintes conceitos:
- Como combinar componentes com a intenção do usuário, como usar o mapa inline para consultas de orientação.
- Como mapear parâmetros de linguagem natural para o esquema, como definir o modo mapa como satélite se o usuário pedir "paisagem".
Esquema de uso de ferramentas
O Agentic UI Toolkit expõe um catálogo de definições compatíveis com o esquema de uso de ferramentas de LLM padrão, como a chamada de função.
Políticas e Termos de Serviço
Esta biblioteca usa os 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 o Grounding Lite e o Embasamento com o Google Maps, têm requisitos adicionais dos 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, como os Serviços de Suporte Técnico, os Contratos de Nível de Serviço e a Política de Descontinuação, não se aplicam ao código nesta biblioteca.
Suporte
Essa biblioteca é oferecida por uma licença de código aberto. Ele não é regido pelas Diretrizes de Serviços de Suporte Técnico da Plataforma Google Maps, pelo SLA ou pela Política de Descontinuação. No entanto, todos os serviços da Plataforma Google Maps usados pela biblioteca permanecem sujeitos aos Termos de Serviço da Plataforma Google Maps.
Requisitos de atribuição para fontes do Google Maps
Cada resposta de ferramenta do Agentic UI Toolkit inclui fontes. Ao apresentar resultados que usam ferramentas fornecidas pelo kit de ferramentas, é necessário incluir as fontes associadas do Google Maps de uma forma que atenda aos seguintes requisitos:
- As fontes do Google Maps precisam seguir imediatamente o conteúdo gerado que elas apoiam.
- As fontes do Google Maps precisam ser visíveis em uma interação do usuário.
Compartilhar feedback
Para enviar feedback sobre o Maps Agentic UI Toolkit, use os seguintes formulários: